aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNuoHan Qiao <qiaonuohan@cn.fujitsu.com>2015-12-16 01:59:24 -0500
committerNuoHan Qiao <qiaonuohan@cn.fujitsu.com>2015-12-24 03:27:32 -0500
commite5bdf56529ad1482d892e56df09261f35baf8ca4 (patch)
treeba616cc89d97a018523580aadec0e2b232e54988
parent560bf29c660b537254a9face5f95adea66b9031d (diff)
fix README
Change-Id: I2ed2d1c013ffa4f7634656dca0623c42cb745da8 Signed-off-by: NuoHan Qiao <qiaonuohan@cn.fujitsu.com>
-rw-r--r--README90
1 files changed, 55 insertions, 35 deletions
diff --git a/README b/README
index f3eaee1..ab92653 100644
--- a/README
+++ b/README
@@ -3,60 +3,80 @@ Jenkins-based Test Automation for AGL
0. Software requirements
-------------
-Debian Wheezy 64-bit.
+1) Any 64-bit Linux with Docker version 1.8.3 or above.
+2) Web browser with javascript and CSS support.
1. Installation
-------------
-run ./debian_install.sh under root, answer simple questions.
+1) Run install.sh from top directory. This will launch "docker build" command
+ and install AGL-JTA to docker container.
-It will install all the needed packages.
+ Please modify Dockerfile to suit your needs.
-Since AGL cross SDK will be used during the test, it is supposed to be
-installed manually.
+2) Issue the following commands from top directory:
+
+ jta-host-scripts/docker-create-containter.sh
+ jta-host-scripts/docker-start-container.sh
+
+ Web interface will be available at http://localhost:8080
+
+ Directory userdata/ will be mounted to /userdata inside docker
+
+3) Install AGL cross SDK to /userdata/toolchains/poky-agl inside docker
+ container manually.
2. Configuration
-------------
-Fix /home/jenkins/overlays/boards/porter.board according to your test
-enviroment. The following is a brief introduction of some important
-environment variables:
-
-TRANSPORT: defines how JTA should communicate with the board. Currently only
- ssh is supported
-IPADDR: IP address or host name of board
-LOGIN: user name for ssh login
-PASSWORD: password for ssh login
-JTA_HOME: path to the directory on device the tests will run from
-LTP_EXPECT_FAIL_CASES:
- expectly failed cases in LTP, Functional.LTP.Syscalls and
- Functional.LTP.Net_Stress will not report the failure of
- these cases
-REMOTE_HOST: IP address or host name of the remote host, used for LTP network
- test
-REMOTE_PASSWD: password for login to remote host as root
-
-Refer to jta-guide.pdf for more detailed information
-
-
-3. Test
+Refer manual (docs/jta-docs.pdf) configuration and using.
+
+1) docker configuration
+ docker-create-containter.sh configures Docker to use host network
+ (--net="host" option).
+
+ Container is configured to run ssh server at 2222 port. Modify
+ container-cfg/sshd_config file if you need to configure ssh server
+ differently.
+
+2) target(porter) configration
+ Fix /userdata/conf/boards/porter.board inside docker according to your test
+ enviroment. The following is a brief introduction of some important
+ environment variables:
+
+ IPADDR: IP address or host name of board
+ SSH_PORT port for ssh login
+ LOGIN: user name for ssh login
+ JTA_HOME: path to the directory on device the tests will run from
+ PASSWORD: password for ssh login
+ TRANSPORT: defines how JTA should communicate with the board. Currently
+ only ssh is supported
+ LTP_EXPECT_FAIL_CASES:
+ expectly failed cases in LTP, Functional.LTP.Syscalls and
+ Functional.LTP.Net_Stress will not report the failure of
+ these cases
+ REMOTE_HOST: IP address or host name of the remote host, used for LTP
+ network test
+ REMOTE_PASSWD: password for login to remote host as root
+
+
+3. Test example
-------------
Currently Functional.LTP.Syscalls and Functional.LTP.Net_Stress are available
-to be tested on porter. But make sure LTP_EXPECT_FAIL_CASES is set correctly.
+to be tested on porter. Make sure LTP_EXPECT_FAIL_CASES is set correctly.
The following is the step to run the test.
-1) Logon JTA web interface, the interface is available on local machine at port
- 8080.
+1) Logon JTA web interface, http://localhost:8080
2) Click "Functional" tag on JTA web interface and Click Functional.LTP.Syscalls
or Functional.LTP.Net_Stress to switch to the test
3) Click "Run Test Now"
-4) Choice "porter" in "Device"(we configured in "2. Configuration"), check
+4) Choice "porter" in "Device" (we configured in "2. Configuration"), check
"Rebuild" and Choice "testplan_default" in "TESTPLAN"
5) Click "Run test", and then the test will start
-6) After finishing the test, Please check /home/jenkins/logs/*/testlogs for
- more detailed information
+6) After finishing the test, Please check /userdata/logs/*/testlogs for more
+ detailed information
-4. JTA Quickstart guide
+4. JTA manual
-------------
-See jta-guide.pdf for basic usage and configuration.
+See docs/jta-docs.pdf for basic usage and configuration.
See How-to-Add-Test-Cases-on-JTA in docs for adding test cases.