import repository from arizona
[raven.git] / webpage / tutgui.html
1 <html>
2 <head>
3 <title>Stork Project - Installing the Slice Manager</title>
4 <LINK href="stork.css" rel="stylesheet" type="text/css">
5 <style type="text/css">
6         code.shell {
7                 padding : 0.8em;
8                 display : block;
9                 background : #EFEFFA;
10                 white-space : pre;
11         }
12         code.block {
13                 padding : 0.6em;
14                 display : block;
15                 background : #FFFCD4;
16                 white-space : pre;
17         }
18 </style>
19 </head>
20
21 <body>
22
23
24 <div class="display" align="center">
25         <table border="0">
26         <tr>
27                 <td width="170" valign="top">
28
29                                 <br/>
30                                 <table cellpadding="3" width="170" id="links" class="links">
31                                         <tr>
32                                                 <td align="right">
33
34                                                         <ul class="links">
35
36                                                                 <a href = "index.html"><h3>Stork</h3></a>
37                                                                 <li class="links"><a href="tutmain.html">Stork Tutorial</a></li>
38
39                                                                 <li class="links"><a href="advanced.html">Advanced Usage</a></li>
40                                                                 <li class="links"><a href="arch.html">Stork Architecture</a></li>
41                                                                 <li class="links"><a href="filelist.html">Stork File List</a></li>
42                                                                 <li class="links"><a href="about.html">About Us</a></li>
43                                                                 <li class="links"><a href="apps.html">Related Links</a></li>
44                                                                 <li class="links"><a href="contact.html">Contact Stork</a></li>
45                                                                 <h4>Links</h4>
46                                                                 <li class="links"><a href="http://appmanager.berkeley.intel-research.net/plcontrol/apps.php?appid=1029">
47                                                                 Slice Status</a></li>
48                                                                 <li class="links"><a href="https://stork-repository.cs.arizona.edu">Stork Repository</a></li>
49                                                         </ul>
50
51                                                  </td>
52                                         </tr>
53                                 </table>
54                                 <br/>
55                 </td>
56
57                 <td valign="top">
58                 <table class="info" cellpadding="0" width="700" >
59                 <tr  height="75"><td colspan="3"><img style="margin-left: -0px;" src="images/stork-header.png" alt="stork logo"/></td></tr>
60                 <tr  bgcolor="#444444" class="headerrow" width="100%" height="2">
61
62                         <th colspan="2">Stork Slice Manager</th>
63
64                 </tr>
65                 <tr valign="top" align="left">
66
67                         <td>
68                                 <table cellpadding="8" id="content" class="content">
69                                         <tr>
70                                                 <td>
71
72                                                         <h1><a name = "top"></a>Installing the Stork Slice Manager</h1>
73
74                                                         <div style="background-color : #fffacd">Note: The Stork Slice Manager currently is not
75                                                         supported on Windows. Windows support will be included in a future release.</div>
76
77                                                         <h3>1. Install dependencies</h3>
78                                                         The Stork Slice Manager requires the following:
79
80                                                         <style>
81                                                         #requirementlist {
82                                                                 margin-left : 1em;
83                                                         }
84                                                         .requirement {
85
86                                                         }
87                                                         .requirement .name {
88                                                                 font-weight : bold;
89                                                         }
90                                                         .requirement .description {
91                                                                 margin-left : 1em;
92                                                         }
93                                                         </style>
94
95                                                         <div id="requirementlist">
96                                                                 <div class="requirement">
97                                                                         <div class="name">- Python</div>
98                                                                 </div>
99
100                                                                 <div class="requirement">
101                                                                         <div class="name">- Tkinter</div>
102                                                                         <div class="description">If not already installed, installation instructions for various operating
103                                                                         systems are available at
104                                                                         <a href="http://tkinter.unpythonic.net/wiki/How_20to_20install_20Tkinter">http://tkinter.unpythonic.net/wiki/How_20to_20install_20Tkinter</a>,
105                                                                         e.g. on Fedora: <code>stork tkinter</code></div>
106                                                                 </div>
107
108                                                                 <div class="requirement">
109                                                                         <div class="name">- PyXML</div>
110                                                                         <div class="description">Available from <a href="http://pyxml.sourceforge.net/">http://pyxml.sourceforge.net/</a>
111                                                                         or through your operating system's package manager, e.g. on Fedora:
112                                                                         <code>stork PyXML</code>. Additionally, an rpm is available from the
113                                                                         <a href="downloads/">Stork downloads</a> page.</div>
114                                                                 </div>
115
116                                                                 <div class="requirement">
117                                                                         <div class="name">- cURL available at <code>/usr/bin/curl</code></div>
118                                                                         <div class="description">Available from <a href="http://curl.haxx.se/">http://curl.haxx.se/</a> or through your
119                                                                         operating system's package manager, e.g. on Fedora: <code>stork curl</code></div>
120                                                                 </div>
121                                                         </div>
122
123
124                                                         <h3>2. Download the stork-enduser-tar package</h3>
125
126                                                         <p>Download the latest <code>stork-enduser-tar-x-y.tar.gz</code> file from the
127                                                         <a href="downloads/">Stork downloads</a> page. The archive will unpack to a directory
128                                                          called <code>stork-enduser-tar-x</code>.</p>
129
130
131                                                         <h3>3. Run the Stork Slice Manager</h3>
132
133                                                         <p>Note: you can run the Stork Slice Manager from any directory, but you will always
134                                                         want to run it from the same directory. The Stork Slice Manager will create and look
135                                                          for your Stork keys in the directory it is run from.</p>
136
137                                                         <p>Change directory to the <code>stork-enduser-tar-x</code> you extracted and run the
138                                                         Stork Slice Manager with the command:</p>
139
140                                                         <p>
141                                                         <code class="shell"><b>./start_gui</b></code>
142                                                         </p>
143
144                                                         <p>This will start the Stork Slice Manager.
145
146
147                                                         <h3>4. Things to know about using the Stork Slice Manager</h3>
148
149                                                         <ul>
150                                                                 <li>If keys for the Stork username you entered are not found in the directory
151                                                                 you have run the Stork Slice Manager from, you will be prompted to create a
152                                                                 Stork key pair.
153                                                                 <li>When you synchronize with the Stork repository, your PlanetLab slice will
154                                                                 have it's plc_initscript_id set so that nodes added to your slice will have
155                                                                 Stork installed automatically.
156                                                                 <li>When you synchronize with the Stork repository, any nodes you added to
157                                                                 your groups will be automatically added to your PlanetLab slice.
158                                                                 <li>If you are behind a proxy, you will want to set the following environment
159                                                                     variables in your shell before starting the gui:
160                                                                     <code class="shell">export http_proxy=http://host:port/<br /><!--
161                                                                         -->export https_proxy=https://host:port/</code>
162                                                         </ul>
163
164
165                                                         <center><a href = "index.html">Home</a>     <a href = "#top">Top</a></center>
166
167
168                                                 </td>
169                                         </tr>
170                                 </table>
171                         </td>
172                 </tr>
173
174        </table>
175        </td>
176
177      </tr>
178      <tr>
179         <td></td>
180         <td>
181                 <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>
182
183                                         <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>
184
185
186
187
188
189         </td>
190      </tr>
191
192 </table>
193
194 </div>
195
196
197 <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
198 </script>
199 <script type="text/javascript">
200 _uacct = "UA-1868232-1";
201 urchinTracker();
202 </script>
203 </body>
204 </html>