Add new and missing files to the package
[ltp-debian.git] / doc / automation-cookbook.html
blob38928afeea0bc0fc079e64088c17c1ea04599612
1 <html>
2 <head>
3 <title>autoltp cookbook</title>
5 </head>
6 <body bgcolor="#ffffff" vlink="#800000">
8 <div align="center"><big><big><big><b>LTP Automation<br>
9 using autoltp</b></big></big></big></div>
10 <br>
11 <br>
12 <big><big><b>Prerequisites</b></big></big>
13 <ul>
14 <li>All LTP installation prerequisites must be met<br>
15 </li>
16 <li>Perl modules Net::SFTP and Net::SSH::Perl <b>must</b> be <a
17 href="http://www.cpan.org/misc/cpan-faq.html#How_install_Perl_modules">installed</a>
18 on MASTER machine. (<a href="http://www.cpan.org/">www.cpan.org</a> for instructions/downloads)</li>
19 <li>MASTER and TARGET machines must have sftp and ssh capabilities.<br>
20 </li>
21 <li>IP addresses may replace hostnames in this document if name service
22 is unavailable.<br>
23 </li>
25 </ul>
26 <big><big><b>Install files</b></big></big>
27 <ul>
28 <li>Go to <a href="http://ltp.sf.net/" target="_top">http://ltp.sf.net</a>
29 -&gt; Downloads -&gt; Download latest version of LTP</li>
30 <li>Login as root on MASTER machine</li>
31 <li>Untar ltp-xxxxxxxx.tgz in /root</li>
33 <ul>
34 <li>tar -xzvf &lt;filename.tgz&gt;</li>
35 <li>mv ltp-&lt;yyyymmdd&gt;.tgz ltp <i>(&lt;yyyymmdd&gt; should be replaced
36 with the drop date you are using</i></li>
38 </ul>
40 </ul>
41 <big><big><b>Setup/Edit config files</b></big></big>
42 <ul>
44 <ul>
46 </ul>
48 </ul>
50 <ul>
52 <ul>
54 </ul>
56 </ul>
58 <ul>
59 <li>edit runalltests.sh and modify the run line to include the PAN_LOG
60 options:</li>
62 <ul>
63 <li>ex: <i>${LTPROOT}/pan/ltp-pan -l $PAN_LOG -e -S $instances $time -a
64 $$ -n $$ -f ${TMP}/alltests</i></li>
66 </ul>
67 <li>tar up the ltp directory (<i>this is the ltp.tgz that is copied to
68 the TARGET machines</i>)</li>
70 <ul>
71 <li>in the root directory of MASTER type tar -czvf ltp.tgz to tar up
72 the testcases</li>
73 <li>copy the resulting ltp.tgz to /tmp on MASTER (<i>autoltp will look
74 for /ltp.tgz in the tmp directory</i>)<br>
75 </li>
77 </ul>
79 <ul>
81 </ul>
83 </ul>
85 <ul>
87 <ul>
89 </ul>
91 </ul>
92 <big><big><b>Run LTP</b></big></big><br>
94 <ul>
95 <li>cd to /root/ltp/auto on MASTER</li>
96 <li>create a config file that contains the list of hosts (TARGETS) to
97 run LTP against</li>
99 <ul>
100 <li>example config file:<br>
101 host1,username,password,number of instances,time<br>
102 host2,username,password,number of instances,time</li>
103 <li>host is the hostname of a TARGET machine<br>
104 </li>
105 <li>username is usually root or a root privileged account</li>
106 <li>number of instances is how many copies of LTP you want running simultaneously</li>
107 <li>time is the duration of the ltp run where 10m = 10 minutes, 2h =
108 2 hours, etc</li>
109 </ul>
110 <li>run ./autoltp -f &lt;config file&gt;</li>
111 <li>autoltp will then attempt to make ssh/sftp connections with your TARGET
112 machines and run the LTP testcases<br>
113 </li>
114 </ul>
115 <ul>
117 </ul>
119 </body>
120 </html>