import repository from arizona
[raven.git] / webpage / util.html
1 <html>
2 <head>
3 <title> Stork Project </title>
4 <LINK href="stork.css" rel="stylesheet" type="text/css">
5
6 </head>
7
8 <body>
9
10
11 <div class="display" align="center">
12         <table border="0">
13         <tr>
14                 <td width="170" valign="top">
15
16                                 <br/>
17                                 <table cellpadding="3" width="170" id="links" class="links">
18                                         <tr>
19                                                 <td align="right">
20
21                                                         <ul class="links">
22
23                                                                 <a href = "index.html"><h3>Stork</h3></a>
24                                                                 <li class="links"><a href="tutmain.html">Stork Tutorial</a></li>
25                                                                 <li class="links"><a href="advanced.html">Advanced Usage</a></li>
26                                                                 <li class="links"><a href="arch.html">Stork Architecture</a></li>
27                                                                 <li class="links"><a href="filelist.html">Stork File List</a></li>
28                                                                 <li class="links"><a href="about.html">About Us</a></li>
29                                                                 <li class="links"><a href="apps.html">Related Links</a></li>
30                                                                 <li class="links"><a href="contact.html">Contact Stork</a></li>
31                                                                 <h4>Links</h4>
32                                                                 <li class="links"><a href="http://appmanager.berkeley.intel-research.net/plcontrol/apps.php?appid=1029">
33                                                                 Slice Status</a></li>
34                                                                 <li class="links"><a href="https://stork-repository.cs.arizona.edu">Stork Repository</a></li>
35                                                         </ul>
36
37                                                  </td>
38                                         </tr>
39                                 </table>
40                                 <br/>
41                 </td>
42
43                 <td valign="top">
44                 <table class="info" cellpadding="0" width="700" >
45                 <tr  height="75"><td colspan="3"><img style="margin-left: -0px;" src="images/stork-header.png" alt="stork logo"/></td></tr>
46                 <tr  bgcolor="#444444" class="headerrow" width="100%" height="2">
47
48                         <th colspan="2"> Using Stork </th>
49
50                 </tr>
51                 <tr valign="top" align="left">
52
53                         <td>
54                                 <table cellpadding="8" id="content" class="content">
55                                         <tr>
56                                                 <td>
57
58                                                         <h1><a name = "top"></a>Stork's Enduser Utilities - Storkutil</h1>
59
60         <a name="enduser"><p></a>
61         Stork's enduser utilities will help you manage your nodes more
62         easily and efficiently. It can help you organize your nodes, as well as
63         perform package installations and upgrades across all your nodes in a few
64         simple steps. The enduser tarball can be downloaded
65         <a href="downloads/stork-enduser-tar-latest.tar.gz">here</a>.
66
67         <p>This page constains a list of <a href="#commands">storkutil commands</a> and
68         <a href="#options">storkutil options</a>.
69         For a general runthrough to get you started using
70         Stork and Storkutil, check the <a href="tut.html">Stork tutorial</a> page.
71 <p><img src="blkfade.gif" width="100%"></img>
72         <h2>Storkutil Commands</h2>
73         The following commands can be used in conjunction with storkutil:
74
75 <a name="commands"></a><center><h2>General Commands</h2></center>
76
77         <p><u><b>Genpair</u></b>:<code>./storkutil.py <b>genpair</b> <i>USERNAME</i></code>
78         <br>The <code>genpair</code> commad generates public and privatekeys for the given username. The
79         generated keys will be of the form USERNAME.publickey and USERNAME.privatekey.
80         The privatekey is used to sign your files. The username exsits
81         so that users can recognize each other without having to base interaction
82         solely on public and private keys. Note that after generating
83         a new pair of keys, Stork will ask you whether or not you want these keys to be your default identity:
84
85 <p><table width=400 height=150 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
86 <td width="100%" align="left" valign="top" bgcolor="teal">
87 <span style="color: white">
88 <code><b>./storkutil.py genpair foo</b>
89 <br>Generated foo.privatekey...
90 <br>Extracted foo.publickey...
91 <br>Would you like to make 'foo' your default identity? (y/n) >
92 <br>y
93 <br>'foo' is now your default identity
94 <br>
95 <br><b>./storkutil.py genpair foo</b>
96 <br>Error: Key files for 'foo' already exist
97 </code>
98 </span></td></tr></table>
99
100         <p>The genpair command is an important one. Stork will not function until you have generated a
101         pair of keys for use in signing and checking.
102
103         <p><u><b>Setdefault:</u></b><code> ./storkutil.py <b>setdefault</b> <i>USERNAME</i></code>
104         <br>If you have already generated a public and private key using <code>genpair</code>, but have
105         not set these keys as your default, or if you wish to change you default, you may use this command to
106         set a pair of keys as the default.
107
108 <p><table width=400 height=60 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
109 <td width="100%" align="left" valign="top" bgcolor="teal">
110 <span style="color: white">
111 <code><b>./storkutil.py setdefault foo</b>
112 <br>Previous Identity: someguy
113 <br>'foo' is now your default identity</code>
114 </span></td></tr></table>
115
116         <p><u><b>View</u></b><code> ./storkutil.py view (tpfile|groups|packages)</code>
117         <br>View is a command which will display your default tpfile, pacgroup file or pacpackages files, depending on the
118         arguement.
119 <p><table width=400 height=60 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
120 <td width="100%" align="left" valign="top" bgcolor="teal">
121 <span style="color: white">
122                                                                 <code><b>./storkutil.py view tpfile</b>
123                                                                 <br>Viewing: foo.~~.tpfile
124                                                                 <br><br>TRUSTED PACKAGES FILE
125                                                                 <br>    ALLOW package1.tar.gz
126                                                                 <br>    ALLOW package2.tar.gz</code>
127
128 </span></td></tr></table>
129
130 <center><h2>Trusted Packages Files</h2></center>
131
132         <p><u><b>Addfile:</u></b><code> ./storkutil.py <b>addfile</b> <i>FILE [FILE2] ...</i></code>
133         <br> Addfile will add a file to your <a href="filelist.html#tpfile">trusted packages file</a>.
134         If your trusted packages file has not yet been
135         created, then <code>addfile</code> will create it under your default username. The created file will have
136         the form <i>username.~publickey~.tpfile</i>. The ~publickey~ portion will probably be an unrecognizable string
137         of letters and numbers, but your username will be included at the beginning of the prefix.
138
139 <p><table width=500 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
140 <td width="100%" align="left" valign="top" bgcolor="teal">
141 <span style="color: white">
142 <code><b>./storkutil.py addfile package1.tar.gz package2.tar.gz</b>
143 <br>No tpfile found for foo.  Generating new tpfile.
144 <br>File 'foo.tpfile' successfully signed
145 <br>File 'foo.tpfile' has been copied to 'foo.~~~.tpfile'
146 <br>Unembeded trusted packages file 'foo.tpfile' removed.</code>
147 </span></td></tr></table>
148
149 <p>This script will run whenever Stork fails to find a trusted package
150 file for the default user. It will then continue to the regular package adding script:
151
152 <p><table width=400 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
153 <td width="100%" align="left" valign="top" bgcolor="teal">
154 <span style="color:ffffff">
155 <code>Using trustedpackages file './foo.~~~.tpfile'.
156 <br>Successfully added file 'mypackage.tar.gz'.
157 <br>File './foo.~~~.tpfile' successfully signed</code>
158 </span></td></tr></table>
159
160
161         <p><u><b>Removefile:</u></b> <code>./storkutil.py <b>removefile</b> <i>FILE [FILE]</i></code>
162         <br>Removefile is essentially the opposite of addfile. Removefile will remove a file
163         (or multiple files) from your trusted packages file.
164
165 <p><table width=400 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
166 <td width="100%" align="left" valign="top" bgcolor="teal">
167 <span style="color: white">
168 <code><b>./storkutil.py removefile mypackage.tar.gz</b>
169 <br>Using trustedpackages file './foo.~~~.tpfile'.
170         <br>Successfully removed file 'mypackage.tar.gz'.
171         <br>File './foo.~~~.tpfile' successfully signed</code>
172 </span></td></tr></table>
173
174 Note that if a tpfile hasn't been created through the <code>addfile</code> command, <code>removefile</code> will,
175 expectedly, fail to run.
176
177         <p><u><b>Adduser:</u></b><code> ./storkutil.py <b>adduser</b> <i>USER USER.publickey</i> (allow|deny|any) <i>AFFECTEDPACKAGES</i></code>
178         <br>Adduser allows the user to trust (or distrust) other users explicitly through the tpfile. This is useful when you
179         want to allow a certain user to dictate when updates are necessary (for instance, trusting the Stork user
180         to know what Stork packages are valid).
181
182 <p><table width=500 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
183 <td width="100%" align="left" valign="top" bgcolor="teal">
184 <span style="color: white">
185 <code><b>./storkutil.py adduser someguy someguy.publickey allow \*</b>
186 <br>Using trustedpackages file './foo.~~~.tpfile'.
187 <br>Successfully added user 'someguy'.
188 <br>File './foo.~~~.tpfile' successfully signed
189 </code>
190 </span></td></tr></table>
191         <p>You can also use the * character as a wildcard when allowing packages from users (example: \*.tar.gz).
192         Just be sure to use the shell escape instead of * by itself.
193
194         <p><u><b>Removeuser:</u></b><code> ./storkutil.py <b>removeuser</b> <i>USER</i></code>
195         Removeuser removes a user from your trusted packages file. Note that if the tpfile has not yet been created
196         through <code>adduser</code> or <code>addfile</code>, <code>removeuser</code> will not execute.
197 <p><table width=400 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
198 <td width="100%" align="left" valign="top" bgcolor="teal">
199 <span style="color: white">
200 <code><b>./storkutil.py removeuser someguy</b>
201 <br>Using trustedpackages file 'foo.~~~.tpfile'.
202 <br>Successfully removed user 'someguy'.
203 <br>File 'foo.~~~.tpfile' successfully signed</code>
204 </span></td></tr></table>
205
206         <p><u><b>Extract:</u></b><code> ./storkutil.py <b>extract</b> <i>TPFILE NEWFILE</i></code>
207         The <code>extract</code> command extracts your trusted package information from your TPFile, and stores it in
208         the file provided in the command (NEWFILE). NEWFILE can be manually modified and then signed, as a way to modify
209         your TPFile without the storkutil commands. For information of manually modifying your TPFile, see the
210         <a href="www.cs.arizona.edu/stork/tpfile.html">TPFile advanced usage</a> page.
211 <p><table width=400 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
212 <td width="100%" align="left" valign="top" bgcolor="teal">
213 <span style="color: white">
214 <code><b>./storkutil.py extract foo.<i>publickey</i>.tpfile extractedFile</b>
215 </code>
216 </span></td></tr></table>
217
218         <p><u><b>Sign:</u></b><code> ./storkutil.py <b>sign</b> <i>NEWFILE</i></code>
219         The <code>sign</code> command signs your extracted trusted package file with your
220         default username. Once this file has been signed, you can rename it
221         <i>username.publickey.</i>tpfile and have it act as the TPFile for your username.
222 <p><table width=400 height=70 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
223 <td width="100%" align="left" valign="top" bgcolor="teal">
224 <span style="color: white">
225 <code><b>./storkutil.py sign foo.<i>publickey</i>.tpfile extractedFile</b>
226 <br>File 'newFile' successfully signed
227 </code>
228 </span></td></tr></table>
229
230 <center><h2>Pacman</h2></center>
231 Pacman is Stork's package management utility, built into Storkutil.
232 Pacman can help you manage your packages
233         across all your nodes. Rather than installing or uninstalling packages on
234         each of your nodes individually, you can assign your nodes to groups and
235         instruct stork to install or remove packages on those groups. Pacman
236         is therefore efficient to use when a package needs to be installed on
237         a large number of nodes. Pacman also allows packages to be automatically
238         updated when the package creator updates them in the repository; this
239         allows Stork to work near autonomously when set up for use.
240         Pacman uses two files; groups and packages. Using storkutil, you can create these two
241         files and upload them. Stork will then distribute these files to your nodes
242         and perform the tasks you assigned.
243
244
245         <p><u><b>Pacgroups:</u></b><code> ./storkutil.py <b>pacgroups</b> (include|exclude|intersect|remove) <i>DESTINATIONGROUP NODEORGROUP [NODEORGROUP...]</i></code>
246         <br>Pacgroups is the first command associated with Pacman. The <code>pacgroups</code> command is used to organize
247         nodes into groups. The DESTINATIONGROUP parameter is the name of the group you wish to create; the NODEORGROUP parameter
248         is the node, or group of nodes, you wish to include (or exclude) in the destination group. You can also use the
249         <code>pacgroups intersect</code> command to include an intersection of two node groups in the destination group. Finally,
250         the <code>pacgroups remove</code> will remove a node or group of nodes from the destination group. You can use
251         the <code>view groups</code> command to view your pacman groups file.
252
253 <p><table width=400 height=200 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
254 <td width="100%" align="left" valign="top" bgcolor="teal">
255 <span style="color: white">
256 <code><b>./storkutil.py pacgroups include myGroup foo1.node foo2.node</b>
257 <br>Using groups file: ./foo.~~~.groups.pacman
258 <br>File Not Found, Creating New File
259 <br>File './foo.~~~.groups.pacman' successfully signed</code>
260 <p><code><b>./storkutil.py view groups</b>
261 <br>Viewing: foo.~~~.groups.pacman
262 <br>
263 <br>PACMAN GROUP FILE
264     <br>    GROUP:  myGroup
265          <br>       INCLUDE:        foo1.node
266              <br>   INCLUDE:        foo2.node
267 </code></span></td></tr></table>
268
269         <p><u><b>CoMon:</u></b><code> ./storkutil.py comon (include|exlude|intersect|remove) <i>DESTINATIONGROUP "COMONQUERY"</i></code>
270         <br>The <code>CoMon</code> command used pacgroups and the <a href="comon.cs.princeton.edu">CoMon project</a> to organize
271         nodes into groups. Using the command with the proper query will add all of the nodes returned by that query to the destination
272         group. It is suggested that you use the query on the CoMon query page first, because a malformed query will cause CoMon to include all
273         the current PlanetLab nodes. Also note that the query must be surrounded by quotation marks in the command line, or the single
274         '&' characters escape-sequenced.
275 <p><table width=400 height=200 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
276 <td width="100%" align="left" valign="top" bgcolor="teal">
277 <span style="color: white">
278 <code><b>./storkutil.py pacgroups include myGroup "select='resptime>2'"</b>
279 <br>Using groups file: ./foo.~~~.groups.pacman
280 <br>File Not Found, Creating New File
281 <br>File './foo.~~~.groups.pacman' successfully signed</code>
282 <p><code><b>./storkutil.py view groups</b>
283 <br>Viewing: foo.~~~.groups.pacman
284 <br>
285 <br>PACMAN GROUP FILE
286     <br>    GROUP:  myGroup
287          <br>       INCLUDE:        plnode02.cs.mu.oz.au
288                 <br>            INCLUDE:                plab4.engr.sjsu.edu
289                 <br>            INCLUDE:        planetlab-1.fokus.fraunhofer.de
290 </code></span></td></tr></table>
291
292         <p><u><b>Pacpackages:</u></b><code> ./storkutil.py <b>pacpackages</b> (node|group|all) <i>[NODEORGROUPNAME]</i> (install|remove|update) <i>PACKAGE</i></code>
293         <br>Pacpackages is the second command associated with Pacman. While <code>pacgroups</code> organizes nodes into groups,
294         <code>pacpackages</code> determines which packages should be installed or removed on which nodes. Pacpackages
295         accepts either a node or the name of a group (the group will have to be made first with pacgroups) to install, remove, or update a package on.
296
297 <p><table width=400 height=200 cellspacing=0 cellpadding=5 border=5 bordercolor="orange"><tr>
298 <td width="100%" align="left" valign="top" bgcolor="teal">
299 <span style="color: white">
300 <code><b>./storkutil.py pacpackages group myGroup install myPackage.tar.gz</b>
301 <br>Using Package File: ./foo.~~~.packages.pacman
302 <br>File Not Found, Creating New File
303 <br>File './foo.~~~.packages.pacman' successfully signed</code>
304 <p><code><b>./storkutil.py view packages</b>
305 <br>Viewing: foo..packages.pacman
306 <br>PACMAN PACKAGES FILE
307 <br>CONFIG ALL:
308 <br>UPDATE: stork-client
309 <br>UPDATE: arizona-lib
310 <br>CONFIG GROUP:   myGroup
311 <br> UPDATE: myPackage.tar.gz
312 </code></span></td></tr></table>
313
314
315
316
317                                                         <p><img src="blkfade.gif" width="100%"></img>
318                                         <a name="options"></a>          <h2>Storkutil Options</h2>
319
320
321
322
323
324
325                                                         The following are the options that can be used with storkutil, organized by type.
326                                                                           <center><h3>Messages</h3></center>
327                                                                            <p><b><code> --storkutilsetupcomplete=TRUE/FALSE</b></code>
328                                                                            Whether the setup of this utility was completed
329                                                          properly.
330                                                                           <p><b><code>--version</b></code> Show program's version number and exit
331                                                                           <p><b><code>-h, --help</b></code> Show this help message and exit
332                                                                           <p><b><code>-Q, --veryquiet</b></code> Be very quiet (shorter messages)
333                                                                           <p><b><code>-q, --quiet</b></code> Be quiet
334                                                                           <p><b><code>-v, --verbose</b></code> Be verbose (default)
335                                                                           <p><b><code>-V, --veryverbose</b></code> Be very verbose (useful for debugging)
336                                                                           <p><b><code>--ultraverbose</b></code> Be extremely verbose (might be useful for debugging)
337                                                                           <p><b><code>--width=CHARS</b></code> Set the width of the terminal in characters (default: 80)
338                                                                           <p><b><code>--disableerrorreporting</b></code>
339                                                                                                                         Disables sending of error reports to the Stork team (Reports are still
340                                                                                                                         generated, just not sent)
341
342
343                                                                           <center><h3>File Transfer Options</h3></center>
344                                                                           <p><b><code>--transfermethod=PROGRAM</b></code>
345                                                                                                                         Uses this method to transfer files (default ftp, http)
346                                                                           <p><b><code>--transfertempdir=PATH</b></code>
347                                                                                                                         Uses this path to temporarily save transfered files
348                                                                                                                         (default is /tmp/stork_trans_tmp)
349                                                                           <p><b><code>--bittorrenttrackerhost=TRACKERHOST</b></code>
350                                                                                                                         Uses this host name of the tracker server.
351                                                                           <p><b><code>--bittorrenttrackerport=TRACKERPORT</b></code>
352                                                                                                                         Uses this number to specify as the tracker port number for
353                                                                                                                         torrents.
354                                                                           <p><b><code>--bittorrentuploadrate=UPLOADRATE</b></code>
355                                                                                                                         The max upload rate for the bittorrent processes (0
356                                                                                                                         means no limit).
357                                                                           <p><b><code>--bittorrentseedlookuptimeout=SEEDLOOKUPTIMEOUT</b></code>
358                                                                                                                         The number of seconds bittorrent should timeout after
359                                                                                                                         not finding a seed.
360                                                                           <p><b><code>--transuser=USER</b></code> Uses this user to transfer files (the default is up to
361                                                                                                                         the transfer program)
362                                                                           <p><b><code>--nesthostname=HOSTNAME</b></code>
363                                                                                                                         Uses this host to transfer files
364                                                                           <p><b><code>--nestport=PORT</b></code> Uses this port to transfer files
365
366
367
368
369                                                                           <center><h3>Repository Options</h3></center>
370                                                                           <p><b><code>--packagemanagers=PACKAGEMANAGERS</b></code>
371                                                                                                                         Uses these programs to manage packages (default rpm,
372                                                                                                                         tar)
373                                                                           <p><b><code>--tarpackinfo=PATH</b></code>    Uses this path to store tar package info (default is
374                                                                                                                         /usr/local/stork/tar_packinfo)
375                                                                           <p><b><code>--localpackageinfo=PACKAGEDIR</b></code>
376                                                                                                                         Uses this location of local package information (default
377                                                                                                                         /usr/local/stork/var/packageinfo)
378                                                                           <p><b><code>--repositorypackagedir=DIR</b></code>
379                                                                                                                         Uses this repository name and location of packages (the switch
380                                                                                                                         may appear multiple times)
381                                                                           <p><b><code>--repositorypackageinfo=DIR</b></code>
382                                                                                                                         Uses this repository name and location of information about
383                                                                                                                         packages (the switch may appear multiple times)
384                                                                           <p><b><code>--noupdatepackageinfo</b></code>
385                                                                                                                         Does not attempt to update the package database
386
387
388
389                                                                           <h3><center>TPFiles, Config Files, Keys</center></h3>
390                                                                           <p><b><code>  --configurationfile=FILE</b></code>
391                                                                                  use a different config file
392                                                                                  (~/.storkutil/storkutil.conf is the default)
393                                                                           <p><b><code>--privatekey=PRIVATEKEYLOCATION</b></code>
394                                                                          The location of the private key to use.
395                                                                           <p><b><code>--publickey=PUBLICKEYLOCATION</b></code>
396                                                                         The location of the public key to use.
397                                                                           <p><b><code>--tpfile=TPFILELOCATION</b></code>
398                                                                         The location of the tpfile to use.
399                                                                           <p><b><code>--pacmanfile=PACMANFILE</b></code>
400                                                                          The location of the pacman file to use.
401                                                                           <p><b><code>-C FILE, --configfile=FILE</b></code>
402                                                                                                                         Use a different config file
403                                                                                                                         (/usr/local/stork/etc/stork.conf is the default)
404                                                                           <p><b><code>--noupdateonstart</b></code> Do not try to download latest custom configuration
405                                                                                                                         files and keys from repository upon start of stork.py
406                                                                           <p><b><code>--xmlsignaturedtd=FILENAME</b></code>
407                                                                                                                         The DTD file for signatures
408                                                                           <p><b><code>--tpdump</b></code> Dump trusted packages data
409                                                                           <p><b><code>--createblank </b></code> Create a blank trusted packages or pacman files
410                                                         instead of the default
411                                                   <p><b><code> --timestamp=TIMESTAMP</b></code>
412                                                                                                         Timestamp for added package.
413                                                                            <p><b><code>--orderby=ORDERBY</b></code>  Method (default | timestamp) to prioritize packages in
414                                                                                                         referenced trusted packages file.
415                                                                         <p><b><code>--tags=TAGS</b></code>           Specify tags when adding package
416                                                                           <p><b><code>--trustedpackagesdir=DIRECTORY</b></code>
417                                                                                                                         Uses a different directory to access trusted packages
418                                                                           <p><b><code>--trustedpackagesrepository=URL</b></code>
419                                                                                                                         Uses a different repository for trustedpackages files
420                                                                           <p><b><code>--trustedpackagesdtd=FILENAME</b></code>
421                                                                                                                         Sets the trustedpackages DTD file
422                                                                           <p><b><code>--noupdatetrustedpackages</b></code>
423                                                                                                                         Does not attempt to update the trustedpackages files
424                                                                           <p><b><code>--ignoremissingtpfiles</b></code>
425                                                                                                                         Ignores missing trusted packages files
426                                                                           <p><b><code>--certificate=STRING</b></code> Uses a different certificate for downloading conf files
427                                                                                                                         from repository.
428                                                                           <p><b><code>--repositorypath=STRING</b></code>
429                                                                                                                         Uses a different repository to download configuration
430                                                                                                                         files from.
431                                                                           <p><b><code>--keytype=KEYTYPE</b></code> Use this technique to sign files (default is rsa)
432                                                                           <p><b><code>--keygen=GENTYPE</b></code>  Use this option to use openssl to generate your
433                                                                                                                         public/private keypair (default is genrsa)
434
435                                                                           <p><b><code>--hashtype=HASHTYPE</b></code> Use this algorithm to generate hashes (default is
436                                                                                                                         -sha1)
437                                                                           <p><b><code>-u USERNAME, --username=USERNAME</b></code>
438                                                                                                                         Use this username for configuration files
439                                                                           <p><b><code>--publickeyfile=file</b></code>  use this public key file to determine which
440                                                                                                                         configuration files to use.  Recommended:
441                                                                                                                         /usr/local/stork/var/keys/[username].publickey
442
443                                                                           <h3><center>Miscellaneous</h3></center>
444                                                                           <b><code> --simulatenestfail</b></code>    simulate a nest failure during storknestrpm install
445
446
447
448
449
450
451
452                                                         <center><a href = "index.html">Home</a>     <a href = "#top">Top</a></center>
453
454
455                                                 </td>
456                                         </tr>
457                                 </table>
458                         </td>
459                 </tr>
460
461        </table>
462        </td>
463
464      </tr>
465      <tr>
466         <td></td>
467         <td>
468                 <a href="http://www.planet-lab.org"><img style="border: 0px; border-style: none;" src="images/powered_by_pl_grey.png" alt="powered by planetlab"></a>
469
470                                         <a href="http://www.cs.arizona.edu"><img style="position:relative; left: 20px; border: 0px; border-style: none;" src="images/template_logo_small_grey.png" alt="University of Arizona, Computer Science logo"></a>
471
472
473
474
475
476         </td>
477      </tr>
478
479 </table>
480
481 </div>
482
483
484 <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
485 </script>
486 <script type="text/javascript">
487 _uacct = "UA-1868232-1";
488 urchinTracker();
489 </script>
490 </body>
491 </html>