jdk/test/sanity/client/README
changeset 36744 a00905527ec2
equal deleted inserted replaced
36743:bdc3f1b79fb7 36744:a00905527ec2
       
     1 This suite contains automated client sanity tests which can be run using JTReg.
       
     2 
       
     3 Contact alexander.kouznetsov@oracle.com in case of issues.
       
     4 
       
     5 -------------------------------------------------------------------------------
       
     6 How to run:
       
     7 
       
     8 1) Download/Install the JDK to be tested in the system.
       
     9    (For example C:/java/jdk1.9.0 in windows or 
       
    10     /export/jdk/jdk1.9.0 in linux/mac/solaris)
       
    11 2) Download/Install JTReg harness, minimum required version is 4.1 b13.    
       
    12 3) Open terminal(cmd in windows, *not* cygwin) and go to the this directory.
       
    13 4) To run
       
    14     - see the notes below on how to prepare for the test run
       
    15     - set JT_HOME to <path/to/jtreg>, for example
       
    16         set JT_HOME=C:\Java\client\jtreg        (Windows)
       
    17     - run the command
       
    18         'sh <path/to/jtreg/bin/jtreg> -ea -k:\!screenshots -jdk:<Path/to/JDK> SwingSet'
       
    19  
       
    20        For example: 'sh C:/jtreg/bin/jtreg -ea -k:\!screenshots -jdk:C:/java/jdk1.9.0 SwingSet'             (Windows)
       
    21          'sh /export/jtreg/bin/jtreg -ea -k:\!screenshots -jdk:/export/jdk/jdk1.9.0 SwingSet'               (Linux/Solaris)
       
    22          'sh /export/jtreg/bin/jtreg -ea -k:\!screenshots -jdk:/export/jdk/jdk1.9.0/Contents/Home SwingSet' (Mac)
       
    23 
       
    24 Try to minimize all the other windows for no interference and test stability.
       
    25 Do not touch keyboard or mouse, open any window, nor lock the screen while the tests are running.
       
    26 The tests will be executed, and the results will be displayed in the terminal. 
       
    27 
       
    28 A report will be generated under 
       
    29             a) JTReg: "JTReport/index.html".
       
    30 The failure logs could be found under:
       
    31             a) JTReg: "JTWork/<testname>/<testname>.jtr"
       
    32             
       
    33 The following additional options might be useful:
       
    34 -retain:all         to keep work files for passed tests
       
    35 -k:\!screenshots    removal of this option will run tests that require full environment with Robot and screenshots
       
    36 -g                  to run JavaTest GUI
       
    37             
       
    38 -------------------------------------------------------------------------------
       
    39 
       
    40 The tests in the suite are based on SwingSet3 demo application. They use Jemmy to
       
    41 operate on controls of the demo and verify that it is behaving as expected. Both
       
    42 Jemmy and SwingSet3 sources are available as copies in lib folder.
       
    43 
       
    44 Original Jemmy repository is https://jemmy.java.net
       
    45 Original SwingSet3 repository is https://java.net/projects/swingset3