Project

General

Profile

Ftpinstall » History » Version 1

Marc Mengel, 07/05/2016 12:00 PM
auto-upload

1 1 Marc Mengel
2 1 Marc Mengel
| [[upsv4TOC| !{width:84px;height:23px}images/navtoc.gif(TOC)!  ]] | [[uppinstall| !{width:81px;height:23px}images/navprev.gif(PREV)!  ]] | [[install_spec| !{width:81px;height:23px}images/navnext.gif(NEXT)!  ]] |
3 1 Marc Mengel
4 1 Marc Mengel
5 1 Marc Mengel
|.  !{width:60px;height:60px}images/CDlogo.gif(Fermilab CD logo)!  |\4. Complete Guide and Reference Manual for UPS and UPD|
6 1 Marc Mengel
7 1 Marc Mengel
8 1 Marc Mengel
h3. Chapter Contents
9 1 Marc Mengel
10 1 Marc Mengel
11 1 Marc Mengel
p<>. [[ftpinstall#8463|Chapter 8: Installing Products using FTP on a UPD Distribution Node]] 
12 1 Marc Mengel
   [[ftpinstall#66212|8.1 "Quick and Dirty" Download of Product from KITS pub area]] 
13 1 Marc Mengel
   [[ftpinstall#68417|8.2 UPS Product Components to Download]] 
14 1 Marc Mengel
   [[ftpinstall#37818|8.3 Installing Products from fnkits.fnal.gov]] 
15 1 Marc Mengel
     [[ftpinstall#38821|8.3.1 Download the Files from fnkits]] 
16 1 Marc Mengel
     [[ftpinstall#68621|8.3.2 Download Areas]] 
17 1 Marc Mengel
     [[ftpinstall#68635|8.3.3 Run ftp]] 
18 1 Marc Mengel
     [[ftpinstall#37860|8.3.4 Unwind the Files into your Products Area]] 
19 1 Marc Mengel
     [[ftpinstall#37895|8.3.5 Declare the Product to your Database]] 
20 1 Marc Mengel
   [[ftpinstall#37917|8.4 Installing Products from Other Product Distribution Nodes]] 
21 1 Marc Mengel
     [[ftpinstall#39328|8.4.1 Locate the Product Files on the Server]] 
22 1 Marc Mengel
     [[ftpinstall#65539|8.4.2 Download the Files from the Server]] 
23 1 Marc Mengel
     [[ftpinstall#39539|8.4.3 Unwind the Files into your Products Area]] 
24 1 Marc Mengel
     [[ftpinstall#39558|8.4.4 Declare the Product to your Database]] 
25 1 Marc Mengel
26 1 Marc Mengel
27 1 Marc Mengel
h1.  %(#8463)&nbsp;% Chapter 8: Installing Products using FTP on a UPD Distribution Node
28 1 Marc Mengel
29 1 Marc Mengel
30 1 Marc Mengel
p<>. %(#39475)&nbsp;% This chapter describes how to download a product using %{font-weight: bold;color: #000000}FTP% , install it, and declare it to a local %{font-weight: bold;color: #000000}UPS% database.
31 1 Marc Mengel
32 1 Marc Mengel
p<>. Please do not confuse this with installing products using tar as described in [[uppinstall|Chapter 7]] 
33 1 Marc Mengel
34 1 Marc Mengel
p<>. Anonymous %{font-weight: bold;color: #000000}FTP% is available on %{font-weight: normal;color: #000000}fnkits% , and may be available on other %{font-weight: bold;color: #000000}UPS% product distribution nodes. %{font-weight: bold;color: #000000}FTP% does not take advantage of the local node's %{font-weight: bold;color: #000000}UPD% configuration. It can be used only to retrieve products; it is left to the installer to unwind and declare them. Furthermore, if the table file and/or the %{font-family: monospace}ups% directory is (are) not included the tar file, each must be retrieved separately.
35 1 Marc Mengel
36 1 Marc Mengel
p<>. %(#39498)&nbsp;% 
37 1 Marc Mengel
38 1 Marc Mengel
p<>.  %{font-weight: bold;color: #000000} %(#39497)&nbsp;% On %{font-weight: normal;color: #000000}fnkits% , %{font-weight: bold;color: #000000}FTP% is most useful for off-site users who want to download %{font-weight: normal;color: #000000} "FermiTools":https://cdcvs.fnal.gov/redmine/projects/fermitools/wiki % products.% 
39 1 Marc Mengel
40 1 Marc Mengel
41 1 Marc Mengel
h2.  %(#66212)&nbsp;% 8.1 "Quick and Dirty" Download of Product from KITS pub area
42 1 Marc Mengel
43 1 Marc Mengel
44 1 Marc Mengel
p<>. %(#68486)&nbsp;% The hierarchy at " @ftp://ftp.fnal.gov/pub/@ ":ftp://ftp.fnal.gov/pub/ , contains the FermiTools products which are available to the general public.
45 1 Marc Mengel
46 1 Marc Mengel
p<>. Select a product/version/flavor, and you will find yourself at the download page for that product. Click on a file to download it. See section [[ftpinstall#37860|8.3.4 %{font-weight: normal;color: #000000}Unwind the Files into your Products Area% ]] for information on unwinding them in the proper order.
47 1 Marc Mengel
48 1 Marc Mengel
p<>. %(#68504)&nbsp;% If you're downloading the %{font-weight: bold;color: #000000}UPS% product itself, see [[bootstrap#8463|Chapter 14: %{font-weight: normal;color: #000000}Installing UPS and UPD from Bootstrap% ]] .
49 1 Marc Mengel
50 1 Marc Mengel
p<>. %(#68523)&nbsp;% If the product is installed in your machine's standard %{font-weight: bold;color: #000000}UPS% area in the standard way, you should be able to use the %{font-weight: bold;font-family: monospace}ups declare% command with only the following options and arguments to declare the product:
51 1 Marc Mengel
52 1 Marc Mengel
53 1 Marc Mengel
<pre>
54 1 Marc Mengel
% ups declare <product> <version> -r /path/to/prod/root/dir/ -c -f <flavor> -m <table_name>.table
55 1 Marc Mengel
</pre>
56 1 Marc Mengel
57 1 Marc Mengel
58 1 Marc Mengel
p<>. %(#68532)&nbsp;% If you need more information, see section [[gen_install#78351|4.4 %{font-weight: normal;color: #000000}Declaring an Instance Manually% ]] and/or [[upscommands#57664|23.5 %{font-weight: normal;color: #000000}ups declare% ]] .
59 1 Marc Mengel
60 1 Marc Mengel
p<>. %(#66215)&nbsp;% One of the features of %{font-weight: bold;color: #000000}UPS/UPD% is that it allows product developers to update certain portions of a product without cutting an entire new release of the product. Specifically, a developer can update any file within a product's %{font-family: monospace}ups% directory and reissue the %{font-family: monospace}ups% directory tar file, and/or update and reissue a product's table file independently of the product tar file. The disadvantage this feature presents is that you must download these elements separately when using %{font-weight: bold;color: #000000}FTP% to install a product.
61 1 Marc Mengel
62 1 Marc Mengel
p<>. %(#37804)&nbsp;% The files that are commonly found within a product's %{font-family: monospace}ups% directory include:
63 1 Marc Mengel
64 1 Marc Mengel
65 1 Marc Mengel
* a %{font-family: monospace}README% file which provides information about the product such as origin, developer, support level, and so on
66 1 Marc Mengel
* an %{font-family: monospace}INSTALL_NOTE% file, when needed, with instructions for installers
67 1 Marc Mengel
* (sometimes) a table file
68 1 Marc Mengel
69 1 Marc Mengel
70 1 Marc Mengel
h2.  %(#37818)&nbsp;% 8.3 Installing Products from fnkits.fnal.gov
71 1 Marc Mengel
72 1 Marc Mengel
73 1 Marc Mengel
p<>. %(#38786)&nbsp;% First, verify that your node is registered to obtain products from %{font-weight: normal;color: #000000}fnkits% . If not, complete the product distribution registration form at "":http://computing.fnal.gov/xms/?pid=1000373  %{font-family: monospace} "https://fermi.service-now.com/.":https://fermi.service-now.com/com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=83024353f10c10008638c2db58a72307 % 
74 1 Marc Mengel
75 1 Marc Mengel
p<>. %(#38802)&nbsp;%  !images/pointb.gif!  If you only want to access FermiTools products (which includes all products located under the %{font-family: monospace}/pub% directory), registration is not required.
76 1 Marc Mengel
77 1 Marc Mengel
p<>. %(#38256)&nbsp;% The naming conventions and file hierarchy on %{font-weight: normal;color: #000000}fnkits% have been constructed to make finding and downloading product files relatively easy. The procedure is demonstrated using the (fictional) product %{font-weight: bold;color: #000000}sister% , version v1_0, for flavor Linux+2. For the local database we use %{font-family: monospace}/fnal/ups/db% and we take the local product area to be %{font-family: monospace}/fnal/ups/products% .
78 1 Marc Mengel
79 1 Marc Mengel
80 1 Marc Mengel
h3.  %(#38821)&nbsp;% 8.3.1 Download the Files from fnkits
81 1 Marc Mengel
82 1 Marc Mengel
83 1 Marc Mengel
h3.  %(#68621)&nbsp;% 8.3.2 Download Areas
84 1 Marc Mengel
85 1 Marc Mengel
86 1 Marc Mengel
p<>. %(#68622)&nbsp;% Products are arranged (via symlinks) in several different file hierarchies to make browsing easier:
87 1 Marc Mengel
88 1 Marc Mengel
89 1 Marc Mengel
* The " @ftp://ftp.fnal.gov/products/@ ":ftp://ftp.fnal.gov/products/ directory contains products organized by product name and version.
90 1 Marc Mengel
* The " @ftp://ftp.fnal.gov/KITS/@ ":ftp://ftp.fnal.gov/KITS/ hierarchy contains products organized by operating system.
91 1 Marc Mengel
* The " @ftp://ftp.fnal.gov/pub/@ ":ftp://ftp.fnal.gov/pub/ hierarchy contains the FermiTools products which are available to the general public.
92 1 Marc Mengel
93 1 Marc Mengel
p<>. %(#38345)&nbsp;% You can click to download, or use the traditional %{font-weight: bold;font-family: monospace}ftp% command as described below.
94 1 Marc Mengel
95 1 Marc Mengel
96 1 Marc Mengel
h3.  %(#68635)&nbsp;% 8.3.3 Run ftp
97 1 Marc Mengel
98 1 Marc Mengel
99 1 Marc Mengel
p<>. %(#68639)&nbsp;% In order to download the product files from the server, you may use a web browser and go to **ftp://ftp.fnal.gov** or you can use the **ftp** command. First change to an appropriate directory and run %{font-weight: bold;color: #000000}FTP% to the machine, e.g.,:
100 1 Marc Mengel
101 1 Marc Mengel
102 1 Marc Mengel
<pre>
103 1 Marc Mengel
% cd /usr/tmp
104 1 Marc Mengel
% ftp fnkits.fnal.gov
105 1 Marc Mengel
</pre>
106 1 Marc Mengel
107 1 Marc Mengel
108 1 Marc Mengel
p<>. %(#38335)&nbsp;% Provide the username %{font-weight: normal;color: #000000}anonymous% , and use your < %{font-weight: normal;color: #000000}username>@<nodename>% as the password.
109 1 Marc Mengel
110 1 Marc Mengel
p<>. %(#37831)&nbsp;% Once you're logged on, you need to find the product you want. If you know the product's name, version, and flavor, you can just %{font-weight: bold;font-family: monospace}cd% to the appropriate directory. If not, you may need to browse a bit. The product pathnames are listed in section [[install_dist#74212|5.3.2 %{font-weight: normal;color: #000000}Product Pathnames for FTP Access% ]] .
111 1 Marc Mengel
112 1 Marc Mengel
p<>. %(#37839)&nbsp;% We want to install the product %{color: #000000}sister% version 1_0 for the flavor Linux+2, so we %{font-weight: bold;font-family: monospace}cd% to the appropriate directory under %{font-family: monospace}/products% and list the directory contents (this shows typical contents for products on %{font-weight: normal;color: #000000}fnkits% ):
113 1 Marc Mengel
114 1 Marc Mengel
115 1 Marc Mengel
<pre>
116 1 Marc Mengel
ftp> cd /products/sister/v1_0/Linux+2
117 1 Marc Mengel
ftp> ls -l
118 1 Marc Mengel
</pre>
119 1 Marc Mengel
120 1 Marc Mengel
121 1 Marc Mengel
<pre>
122 1 Marc Mengel
drwxr-xr-x   4 100      kits         512 Sep 10 19:53 sister_v0_1_Linux+2
123 1 Marc Mengel
-rw-rw-r-x   1 100      kits        1538 Sep 10 19:53 sister_v0_1_Linux+2.table
124 1 Marc Mengel
-rw-r--r-x   1 100      kits     9687040 Aug 19 21:05 sister_v0_1_Linux+2.tar
125 1 Marc Mengel
-rw-rw-r-x   1 100      kits       60928 Sep 10 19:53 sister_v0_1_Linux+2.ups.tar
126 1 Marc Mengel
</pre>
127 1 Marc Mengel
128 1 Marc Mengel
129 1 Marc Mengel
p<>. %(#38510)&nbsp;% The directory %{font-family: monospace}sister_v0_1_Linux+2% contains the unwound %{font-family: monospace}ups% directory files (to allow you to browse, read and/or download individually any of the files it contains). %{font-family: monospace}sister_v0_1_Linux+2.table% is the table file, %{font-family: monospace}sister_v0_1_Linux+2.tar% is the complete product tar file, and %{font-family: monospace}sister_v0_1_Linux+2.ups.tar% is a separate tar file of the %{font-family: monospace}ups% directory.
130 1 Marc Mengel
131 1 Marc Mengel
p<>. %(#37849)&nbsp;% Set the mode to "binary", and %{font-weight: bold;font-family: monospace}get% the two tar files:
132 1 Marc Mengel
133 1 Marc Mengel
134 1 Marc Mengel
<pre>
135 1 Marc Mengel
ftp> binary
136 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.tar
137 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.ups.tar
138 1 Marc Mengel
</pre>
139 1 Marc Mengel
140 1 Marc Mengel
141 1 Marc Mengel
p<>. %(#38634)&nbsp;% Then set the mode to "ascii", and get the table file:
142 1 Marc Mengel
143 1 Marc Mengel
144 1 Marc Mengel
<pre>
145 1 Marc Mengel
ftp> ascii
146 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.table
147 1 Marc Mengel
</pre>
148 1 Marc Mengel
149 1 Marc Mengel
150 1 Marc Mengel
p<>. %(#39526)&nbsp;% and exit:
151 1 Marc Mengel
152 1 Marc Mengel
153 1 Marc Mengel
<pre>
154 1 Marc Mengel
ftp> bye
155 1 Marc Mengel
</pre>
156 1 Marc Mengel
157 1 Marc Mengel
158 1 Marc Mengel
h3.  %(#37860)&nbsp;% 8.3.4 Unwind the Files into your Products Area
159 1 Marc Mengel
160 1 Marc Mengel
161 1 Marc Mengel
p<>. %(#38880)&nbsp;% You need to unwind/copy the product files on your local node in the right order to ensure that:
162 1 Marc Mengel
163 1 Marc Mengel
164 1 Marc Mengel
* the individually-downloaded table file takes precedence over any previously existing table file as well as over one which may be contained within the product tar file
165 1 Marc Mengel
* the product's %{font-family: monospace}ups.tar% file contents take precedence over any previously existing %{font-family: monospace}ups% directory contents as well as over that which is contained within the product tar file.
166 1 Marc Mengel
167 1 Marc Mengel
p<>. %(#38924)&nbsp;% This involves first unwinding the product tar file, then the %{font-family: monospace}ups% directory, and finally copying the table file to its correct location. This procedure is illustrated below.
168 1 Marc Mengel
169 1 Marc Mengel
p<>. %(#37864)&nbsp;%  !images/pointb.gif!  Note: From a technical standpoint, you are not required to follow any file naming/location conventions laid out in your system's %{font-family: monospace}updconfig% file, if any, since you are not using %{font-weight: bold;color: #000000}UPD% for the installation.
170 1 Marc Mengel
171 1 Marc Mengel
p<>. %(#38903)&nbsp;% First make the product root directory:
172 1 Marc Mengel
173 1 Marc Mengel
174 1 Marc Mengel
<pre>
175 1 Marc Mengel
% cd /fnal/ups/products
176 1 Marc Mengel
% mkdir -p sister/v0_1/Linux+2
177 1 Marc Mengel
</pre>
178 1 Marc Mengel
179 1 Marc Mengel
180 1 Marc Mengel
p<>. %(#37874)&nbsp;% Change to the product root directory and unwind the product tar file:
181 1 Marc Mengel
182 1 Marc Mengel
183 1 Marc Mengel
<pre>
184 1 Marc Mengel
% cd sister/v0_1/Linux+2
185 1 Marc Mengel
% tar xvf /usr/tmp/sister_v0_1_Linux+2.tar
186 1 Marc Mengel
</pre>
187 1 Marc Mengel
188 1 Marc Mengel
189 1 Marc Mengel
p<>. %(#38982)&nbsp;% Now change to the product's %{font-family: monospace}ups% directory (or make one if it doesn't exist) and unwind the product's %{font-family: monospace}ups.tar% tar file:
190 1 Marc Mengel
191 1 Marc Mengel
192 1 Marc Mengel
<pre>
193 1 Marc Mengel
% cd ups
194 1 Marc Mengel
% tar xvf /usr/tmp/sister_v0_1_Linux+2.ups.tar
195 1 Marc Mengel
</pre>
196 1 Marc Mengel
197 1 Marc Mengel
198 1 Marc Mengel
p<>. %(#37889)&nbsp;% Finally, change to the directory in which you want to put the table file and copy it in. Here we use the product directory under the database (the other commonly used location is under the product's %{font-family: monospace}ups% directory).
199 1 Marc Mengel
200 1 Marc Mengel
201 1 Marc Mengel
<pre>
202 1 Marc Mengel
% cd /fnal/ups/db/sister
203 1 Marc Mengel
% cp /usr/tmp/sister_v0_1_Linux+2.table ./sister.table
204 1 Marc Mengel
</pre>
205 1 Marc Mengel
206 1 Marc Mengel
207 1 Marc Mengel
h3.  %(#37895)&nbsp;% 8.3.5 Declare the Product to your Database
208 1 Marc Mengel
209 1 Marc Mengel
210 1 Marc Mengel
p<>. %(#37896)&nbsp;% You now need to declare the product instance to your %{font-weight: bold;color: #000000}UPS% database. Declaring a product instance is described in section [[gen_install#78351|4.4 %{font-weight: normal;color: #000000}Declaring an Instance Manually% ]] .
211 1 Marc Mengel
212 1 Marc Mengel
p<>. %(#65918)&nbsp;% To declare the downloaded product %{font-weight: bold;color: #000000}sister% to our %{font-family: monospace}/fnal/ups/db% database, we run the %{font-weight: bold;font-family: monospace}ups declare% command as follows:
213 1 Marc Mengel
214 1 Marc Mengel
215 1 Marc Mengel
<pre>
216 1 Marc Mengel
% ups declare sister v0_1 -f Linux+2 -z /fnal/ups/db \ 
217 1 Marc Mengel
  -r /fnal/ups/products/sister/v0_1/Linux+2  \ 
218 1 Marc Mengel
  -m sister.table
219 1 Marc Mengel
</pre>
220 1 Marc Mengel
221 1 Marc Mengel
222 1 Marc Mengel
p<>. Remember, the backslash \ is shown to make it easier to read the command. It is typed all on one line.
223 1 Marc Mengel
224 1 Marc Mengel
p<>. %(#65944)&nbsp;% The %{font-weight: bold;font-family: monospace}-U% and %{font-weight: bold;font-family: monospace}-M% options are not included since we put the table file and %{font-family: monospace}ups% directory in default locations where %{font-weight: bold;color: #000000}UPS% will find them.
225 1 Marc Mengel
226 1 Marc Mengel
227 1 Marc Mengel
h2.  %(#37917)&nbsp;% 8.4 Installing Products from Other Product Distribution Nodes
228 1 Marc Mengel
229 1 Marc Mengel
230 1 Marc Mengel
p<>. %(#37919)&nbsp;% The procedure for downloading from any standard %{font-weight: bold;color: #000000}UPS% product distribution node is basically the same as illustrated for %{font-weight: normal;color: #000000}fnkits% in section [[ftpinstall#37818|8.3 %{font-weight: normal;color: #000000}Installing Products from fnkits.fnal.gov% ]] . The %{font-weight: bold;color: #000000}UPD% configuration of the server node will most likely be different however, which means that the product and its associated files may be organized differently than on %{font-weight: normal;color: #000000}fnkits% . You may need to verify that your node is registered to obtain products from the server. Contact the server maintainer or other designated person for information regarding node/user registration.
231 1 Marc Mengel
232 1 Marc Mengel
233 1 Marc Mengel
h3.  %(#39328)&nbsp;% 8.4.1 Locate the Product Files on the Server
234 1 Marc Mengel
235 1 Marc Mengel
236 1 Marc Mengel
p<>. %(#39329)&nbsp;% The most reliable way to determine the location of the product files is to use the %{font-weight: bold;font-family: monospace}upd list% command, e.g.,:
237 1 Marc Mengel
238 1 Marc Mengel
239 1 Marc Mengel
<pre>
240 1 Marc Mengel
% upd list -h <hostname> -K+:@prod_dir:@ups_dir:@table_file  \
241 1 Marc Mengel
  sister v0_1 -f Linux+2
242 1 Marc Mengel
</pre>
243 1 Marc Mengel
244 1 Marc Mengel
245 1 Marc Mengel
p<>. %(#37926)&nbsp;% (The output is shown on separate lines for readability.)
246 1 Marc Mengel
247 1 Marc Mengel
248 1 Marc Mengel
<pre>
249 1 Marc Mengel
"/P/tar/sisterv0_1Linux+2.tar" 
250 1 Marc Mengel
"/P/ups/sisterv0_1Linux+2.ups.tar"  
251 1 Marc Mengel
"/P/table/sisterv0_1Linux+2.table"
252 1 Marc Mengel
</pre>
253 1 Marc Mengel
254 1 Marc Mengel
255 1 Marc Mengel
p<>. %(#37928)&nbsp;% In this example, files are organized on the server by type rather than by product:
256 1 Marc Mengel
257 1 Marc Mengel
258 1 Marc Mengel
* product tar files are stored under the %{font-family: monospace}/P/tar% hierarchy
259 1 Marc Mengel
* product %{font-family: monospace}ups% directory tar files are stored under the %{font-family: monospace}/P/ups% hierarchy
260 1 Marc Mengel
* table files are stored under the %{font-family: monospace}/P/table% directory.
261 1 Marc Mengel
262 1 Marc Mengel
263 1 Marc Mengel
h3.  %(#65539)&nbsp;% 8.4.2 Download the Files from the Server
264 1 Marc Mengel
265 1 Marc Mengel
266 1 Marc Mengel
p<>. %(#39336)&nbsp;% Let's take %{font-weight: normal;color: #000000}special.upd.host% as our server node. In order to download the product files from the server, first change to an appropriate directory and run %{font-weight: bold;color: #000000}FTP% to the machine, e.g.,:
267 1 Marc Mengel
268 1 Marc Mengel
269 1 Marc Mengel
<pre>
270 1 Marc Mengel
% cd /usr/tmp
271 1 Marc Mengel
% ftp special.upd.host
272 1 Marc Mengel
</pre>
273 1 Marc Mengel
274 1 Marc Mengel
275 1 Marc Mengel
p<>. %(#39375)&nbsp;% Provide the username %{font-weight: normal;color: #000000}anonymous% , and use your < %{font-weight: normal;color: #000000}username>@<nodename>% as the password.
276 1 Marc Mengel
277 1 Marc Mengel
p<>. %(#39521)&nbsp;% Once you're logged on, set the mode to "binary", and %{font-weight: bold;font-family: monospace}get% the two tar files:
278 1 Marc Mengel
279 1 Marc Mengel
280 1 Marc Mengel
<pre>
281 1 Marc Mengel
ftp> binary
282 1 Marc Mengel
ftp> cd /P/tar
283 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.tar
284 1 Marc Mengel
ftp> cd /P/ups
285 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.ups.tar
286 1 Marc Mengel
</pre>
287 1 Marc Mengel
288 1 Marc Mengel
289 1 Marc Mengel
p<>. %(#39397)&nbsp;% Then set the mode to "ascii", and get the table file:
290 1 Marc Mengel
291 1 Marc Mengel
292 1 Marc Mengel
<pre>
293 1 Marc Mengel
ftp> ascii
294 1 Marc Mengel
ftp> cd /P/table
295 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.table
296 1 Marc Mengel
</pre>
297 1 Marc Mengel
298 1 Marc Mengel
299 1 Marc Mengel
p<>. %(#39532)&nbsp;% and exit:
300 1 Marc Mengel
301 1 Marc Mengel
302 1 Marc Mengel
<pre>
303 1 Marc Mengel
ftp> bye
304 1 Marc Mengel
</pre>
305 1 Marc Mengel
306 1 Marc Mengel
307 1 Marc Mengel
h3.  %(#39539)&nbsp;% 8.4.3 Unwind the Files into your Products Area
308 1 Marc Mengel
309 1 Marc Mengel
310 1 Marc Mengel
p<>. %(#37751)&nbsp;% Unwind the tar files and copy the table file as shown in section [[ftpinstall#37860|8.3.4 %{font-weight: normal;color: #000000}Unwind the Files into your Products Area% ]] .
311 1 Marc Mengel
312 1 Marc Mengel
313 1 Marc Mengel
h3.  %(#39558)&nbsp;% 8.4.4 Declare the Product to your Database
314 1 Marc Mengel
315 1 Marc Mengel
316 1 Marc Mengel
p<>. %(#39555)&nbsp;% Declare them as shown in section [[ftpinstall#37895|8.3.5 %{font-weight: normal;color: #000000}Declare the Product to your Database% ]] .
317 1 Marc Mengel
318 1 Marc Mengel
p<>. %(#39536)&nbsp;% 
319 1 Marc Mengel
320 1 Marc Mengel
| [[upsv4TOC| !{width:84px;height:23px}images/navtoc.gif(TOC)!  ]] | [[uppinstall| !{width:81px;height:23px}images/navprev.gif(PREV)!  ]] | [[install_spec| !{width:81px;height:23px}images/navnext.gif(NEXT)!  ]] |
321 1 Marc Mengel
322 1 Marc Mengel
323 1 Marc Mengel
p<>. **This page last revised in May 2014** 
324 1 Marc Mengel
325 1 Marc Mengel
| [[upsv4TOC| !{width:84px;height:23px}images/navtoc.gif(TOC)!  ]] | [[uppinstall| !{width:81px;height:23px}images/navprev.gif(PREV)!  ]] | [[install_spec| !{width:81px;height:23px}images/navnext.gif(NEXT)!  ]] |
326 1 Marc Mengel
327 1 Marc Mengel
328 1 Marc Mengel
|.  !{width:60px;height:60px}images/CDlogo.gif(Fermilab CD logo)!  |\4. Complete Guide and Reference Manual for UPS and UPD|
329 1 Marc Mengel
330 1 Marc Mengel
331 1 Marc Mengel
h3. Chapter Contents
332 1 Marc Mengel
333 1 Marc Mengel
334 1 Marc Mengel
p<>. [[ftpinstall#8463|Chapter 8: Installing Products using FTP on a UPD Distribution Node]] 
335 1 Marc Mengel
   [[ftpinstall#66212|8.1 "Quick and Dirty" Download of Product from KITS pub area]] 
336 1 Marc Mengel
   [[ftpinstall#68417|8.2 UPS Product Components to Download]] 
337 1 Marc Mengel
   [[ftpinstall#37818|8.3 Installing Products from fnkits.fnal.gov]] 
338 1 Marc Mengel
     [[ftpinstall#38821|8.3.1 Download the Files from fnkits]] 
339 1 Marc Mengel
     [[ftpinstall#68621|8.3.2 Download Areas]] 
340 1 Marc Mengel
     [[ftpinstall#68635|8.3.3 Run ftp]] 
341 1 Marc Mengel
     [[ftpinstall#37860|8.3.4 Unwind the Files into your Products Area]] 
342 1 Marc Mengel
     [[ftpinstall#37895|8.3.5 Declare the Product to your Database]] 
343 1 Marc Mengel
   [[ftpinstall#37917|8.4 Installing Products from Other Product Distribution Nodes]] 
344 1 Marc Mengel
     [[ftpinstall#39328|8.4.1 Locate the Product Files on the Server]] 
345 1 Marc Mengel
     [[ftpinstall#65539|8.4.2 Download the Files from the Server]] 
346 1 Marc Mengel
     [[ftpinstall#39539|8.4.3 Unwind the Files into your Products Area]] 
347 1 Marc Mengel
     [[ftpinstall#39558|8.4.4 Declare the Product to your Database]] 
348 1 Marc Mengel
349 1 Marc Mengel
350 1 Marc Mengel
h1.  %(#8463)&nbsp;% Chapter 8: Installing Products using FTP on a UPD Distribution Node
351 1 Marc Mengel
352 1 Marc Mengel
353 1 Marc Mengel
p<>. %(#39475)&nbsp;% This chapter describes how to download a product using %{font-weight: bold;color: #000000}FTP% , install it, and declare it to a local %{font-weight: bold;color: #000000}UPS% database.
354 1 Marc Mengel
355 1 Marc Mengel
p<>. Please do not confuse this with installing products using tar as described in [[uppinstall|Chapter 7]] 
356 1 Marc Mengel
357 1 Marc Mengel
p<>. Anonymous %{font-weight: bold;color: #000000}FTP% is available on %{font-weight: normal;color: #000000}fnkits% , and may be available on other %{font-weight: bold;color: #000000}UPS% product distribution nodes. %{font-weight: bold;color: #000000}FTP% does not take advantage of the local node's %{font-weight: bold;color: #000000}UPD% configuration. It can be used only to retrieve products; it is left to the installer to unwind and declare them. Furthermore, if the table file and/or the %{font-family: monospace}ups% directory is (are) not included the tar file, each must be retrieved separately.
358 1 Marc Mengel
359 1 Marc Mengel
p<>. %(#39498)&nbsp;% 
360 1 Marc Mengel
361 1 Marc Mengel
p<>.  %{font-weight: bold;color: #000000} %(#39497)&nbsp;% On %{font-weight: normal;color: #000000}fnkits% , %{font-weight: bold;color: #000000}FTP% is most useful for off-site users who want to download %{font-weight: normal;color: #000000} "FermiTools":https://cdcvs.fnal.gov/redmine/projects/fermitools/wiki % products.% 
362 1 Marc Mengel
363 1 Marc Mengel
364 1 Marc Mengel
h2.  %(#66212)&nbsp;% 8.1 "Quick and Dirty" Download of Product from KITS pub area
365 1 Marc Mengel
366 1 Marc Mengel
367 1 Marc Mengel
p<>. %(#68486)&nbsp;% The hierarchy at " @ftp://ftp.fnal.gov/pub/@ ":ftp://ftp.fnal.gov/pub/ , contains the FermiTools products which are available to the general public.
368 1 Marc Mengel
369 1 Marc Mengel
p<>. Select a product/version/flavor, and you will find yourself at the download page for that product. Click on a file to download it. See section [[ftpinstall#37860|8.3.4 %{font-weight: normal;color: #000000}Unwind the Files into your Products Area% ]] for information on unwinding them in the proper order.
370 1 Marc Mengel
371 1 Marc Mengel
p<>. %(#68504)&nbsp;% If you're downloading the %{font-weight: bold;color: #000000}UPS% product itself, see [[bootstrap#8463|Chapter 14: %{font-weight: normal;color: #000000}Installing UPS and UPD from Bootstrap% ]] .
372 1 Marc Mengel
373 1 Marc Mengel
p<>. %(#68523)&nbsp;% If the product is installed in your machine's standard %{font-weight: bold;color: #000000}UPS% area in the standard way, you should be able to use the %{font-weight: bold;font-family: monospace}ups declare% command with only the following options and arguments to declare the product:
374 1 Marc Mengel
375 1 Marc Mengel
376 1 Marc Mengel
<pre>
377 1 Marc Mengel
% ups declare <product> <version> -r /path/to/prod/root/dir/ -c -f <flavor> -m <table_name>.table
378 1 Marc Mengel
</pre>
379 1 Marc Mengel
380 1 Marc Mengel
381 1 Marc Mengel
p<>. %(#68532)&nbsp;% If you need more information, see section [[gen_install#78351|4.4 %{font-weight: normal;color: #000000}Declaring an Instance Manually% ]] and/or [[upscommands#57664|23.5 %{font-weight: normal;color: #000000}ups declare% ]] .
382 1 Marc Mengel
383 1 Marc Mengel
p<>. %(#66215)&nbsp;% One of the features of %{font-weight: bold;color: #000000}UPS/UPD% is that it allows product developers to update certain portions of a product without cutting an entire new release of the product. Specifically, a developer can update any file within a product's %{font-family: monospace}ups% directory and reissue the %{font-family: monospace}ups% directory tar file, and/or update and reissue a product's table file independently of the product tar file. The disadvantage this feature presents is that you must download these elements separately when using %{font-weight: bold;color: #000000}FTP% to install a product.
384 1 Marc Mengel
385 1 Marc Mengel
p<>. %(#37804)&nbsp;% The files that are commonly found within a product's %{font-family: monospace}ups% directory include:
386 1 Marc Mengel
387 1 Marc Mengel
388 1 Marc Mengel
* a %{font-family: monospace}README% file which provides information about the product such as origin, developer, support level, and so on
389 1 Marc Mengel
* an %{font-family: monospace}INSTALL_NOTE% file, when needed, with instructions for installers
390 1 Marc Mengel
* (sometimes) a table file
391 1 Marc Mengel
392 1 Marc Mengel
393 1 Marc Mengel
h2.  %(#37818)&nbsp;% 8.3 Installing Products from fnkits.fnal.gov
394 1 Marc Mengel
395 1 Marc Mengel
396 1 Marc Mengel
p<>. %(#38786)&nbsp;% First, verify that your node is registered to obtain products from %{font-weight: normal;color: #000000}fnkits% . If not, complete the product distribution registration form at "":http://computing.fnal.gov/xms/?pid=1000373  %{font-family: monospace} "https://fermi.service-now.com/.":https://fermi.service-now.com/com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=83024353f10c10008638c2db58a72307 % 
397 1 Marc Mengel
398 1 Marc Mengel
p<>. %(#38802)&nbsp;%  !images/pointb.gif!  If you only want to access FermiTools products (which includes all products located under the %{font-family: monospace}/pub% directory), registration is not required.
399 1 Marc Mengel
400 1 Marc Mengel
p<>. %(#38256)&nbsp;% The naming conventions and file hierarchy on %{font-weight: normal;color: #000000}fnkits% have been constructed to make finding and downloading product files relatively easy. The procedure is demonstrated using the (fictional) product %{font-weight: bold;color: #000000}sister% , version v1_0, for flavor Linux+2. For the local database we use %{font-family: monospace}/fnal/ups/db% and we take the local product area to be %{font-family: monospace}/fnal/ups/products% .
401 1 Marc Mengel
402 1 Marc Mengel
403 1 Marc Mengel
h3.  %(#38821)&nbsp;% 8.3.1 Download the Files from fnkits
404 1 Marc Mengel
405 1 Marc Mengel
406 1 Marc Mengel
h3.  %(#68621)&nbsp;% 8.3.2 Download Areas
407 1 Marc Mengel
408 1 Marc Mengel
409 1 Marc Mengel
p<>. %(#68622)&nbsp;% Products are arranged (via symlinks) in several different file hierarchies to make browsing easier:
410 1 Marc Mengel
411 1 Marc Mengel
412 1 Marc Mengel
* The " @ftp://ftp.fnal.gov/products/@ ":ftp://ftp.fnal.gov/products/ directory contains products organized by product name and version.
413 1 Marc Mengel
* The " @ftp://ftp.fnal.gov/KITS/@ ":ftp://ftp.fnal.gov/KITS/ hierarchy contains products organized by operating system.
414 1 Marc Mengel
* The " @ftp://ftp.fnal.gov/pub/@ ":ftp://ftp.fnal.gov/pub/ hierarchy contains the FermiTools products which are available to the general public.
415 1 Marc Mengel
416 1 Marc Mengel
p<>. %(#38345)&nbsp;% You can click to download, or use the traditional %{font-weight: bold;font-family: monospace}ftp% command as described below.
417 1 Marc Mengel
418 1 Marc Mengel
419 1 Marc Mengel
h3.  %(#68635)&nbsp;% 8.3.3 Run ftp
420 1 Marc Mengel
421 1 Marc Mengel
422 1 Marc Mengel
p<>. %(#68639)&nbsp;% In order to download the product files from the server, you may use a web browser and go to **ftp://ftp.fnal.gov** or you can use the **ftp** command. First change to an appropriate directory and run %{font-weight: bold;color: #000000}FTP% to the machine, e.g.,:
423 1 Marc Mengel
424 1 Marc Mengel
425 1 Marc Mengel
<pre>
426 1 Marc Mengel
% cd /usr/tmp
427 1 Marc Mengel
% ftp fnkits.fnal.gov
428 1 Marc Mengel
</pre>
429 1 Marc Mengel
430 1 Marc Mengel
431 1 Marc Mengel
p<>. %(#38335)&nbsp;% Provide the username %{font-weight: normal;color: #000000}anonymous% , and use your < %{font-weight: normal;color: #000000}username>@<nodename>% as the password.
432 1 Marc Mengel
433 1 Marc Mengel
p<>. %(#37831)&nbsp;% Once you're logged on, you need to find the product you want. If you know the product's name, version, and flavor, you can just %{font-weight: bold;font-family: monospace}cd% to the appropriate directory. If not, you may need to browse a bit. The product pathnames are listed in section [[install_dist#74212|5.3.2 %{font-weight: normal;color: #000000}Product Pathnames for FTP Access% ]] .
434 1 Marc Mengel
435 1 Marc Mengel
p<>. %(#37839)&nbsp;% We want to install the product %{color: #000000}sister% version 1_0 for the flavor Linux+2, so we %{font-weight: bold;font-family: monospace}cd% to the appropriate directory under %{font-family: monospace}/products% and list the directory contents (this shows typical contents for products on %{font-weight: normal;color: #000000}fnkits% ):
436 1 Marc Mengel
437 1 Marc Mengel
438 1 Marc Mengel
<pre>
439 1 Marc Mengel
ftp> cd /products/sister/v1_0/Linux+2
440 1 Marc Mengel
ftp> ls -l
441 1 Marc Mengel
</pre>
442 1 Marc Mengel
443 1 Marc Mengel
444 1 Marc Mengel
<pre>
445 1 Marc Mengel
drwxr-xr-x   4 100      kits         512 Sep 10 19:53 sister_v0_1_Linux+2
446 1 Marc Mengel
-rw-rw-r-x   1 100      kits        1538 Sep 10 19:53 sister_v0_1_Linux+2.table
447 1 Marc Mengel
-rw-r--r-x   1 100      kits     9687040 Aug 19 21:05 sister_v0_1_Linux+2.tar
448 1 Marc Mengel
-rw-rw-r-x   1 100      kits       60928 Sep 10 19:53 sister_v0_1_Linux+2.ups.tar
449 1 Marc Mengel
</pre>
450 1 Marc Mengel
451 1 Marc Mengel
452 1 Marc Mengel
p<>. %(#38510)&nbsp;% The directory %{font-family: monospace}sister_v0_1_Linux+2% contains the unwound %{font-family: monospace}ups% directory files (to allow you to browse, read and/or download individually any of the files it contains). %{font-family: monospace}sister_v0_1_Linux+2.table% is the table file, %{font-family: monospace}sister_v0_1_Linux+2.tar% is the complete product tar file, and %{font-family: monospace}sister_v0_1_Linux+2.ups.tar% is a separate tar file of the %{font-family: monospace}ups% directory.
453 1 Marc Mengel
454 1 Marc Mengel
p<>. %(#37849)&nbsp;% Set the mode to "binary", and %{font-weight: bold;font-family: monospace}get% the two tar files:
455 1 Marc Mengel
456 1 Marc Mengel
457 1 Marc Mengel
<pre>
458 1 Marc Mengel
ftp> binary
459 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.tar
460 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.ups.tar
461 1 Marc Mengel
</pre>
462 1 Marc Mengel
463 1 Marc Mengel
464 1 Marc Mengel
p<>. %(#38634)&nbsp;% Then set the mode to "ascii", and get the table file:
465 1 Marc Mengel
466 1 Marc Mengel
467 1 Marc Mengel
<pre>
468 1 Marc Mengel
ftp> ascii
469 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.table
470 1 Marc Mengel
</pre>
471 1 Marc Mengel
472 1 Marc Mengel
473 1 Marc Mengel
p<>. %(#39526)&nbsp;% and exit:
474 1 Marc Mengel
475 1 Marc Mengel
476 1 Marc Mengel
<pre>
477 1 Marc Mengel
ftp> bye
478 1 Marc Mengel
</pre>
479 1 Marc Mengel
480 1 Marc Mengel
481 1 Marc Mengel
h3.  %(#37860)&nbsp;% 8.3.4 Unwind the Files into your Products Area
482 1 Marc Mengel
483 1 Marc Mengel
484 1 Marc Mengel
p<>. %(#38880)&nbsp;% You need to unwind/copy the product files on your local node in the right order to ensure that:
485 1 Marc Mengel
486 1 Marc Mengel
487 1 Marc Mengel
* the individually-downloaded table file takes precedence over any previously existing table file as well as over one which may be contained within the product tar file
488 1 Marc Mengel
* the product's %{font-family: monospace}ups.tar% file contents take precedence over any previously existing %{font-family: monospace}ups% directory contents as well as over that which is contained within the product tar file.
489 1 Marc Mengel
490 1 Marc Mengel
p<>. %(#38924)&nbsp;% This involves first unwinding the product tar file, then the %{font-family: monospace}ups% directory, and finally copying the table file to its correct location. This procedure is illustrated below.
491 1 Marc Mengel
492 1 Marc Mengel
p<>. %(#37864)&nbsp;%  !images/pointb.gif!  Note: From a technical standpoint, you are not required to follow any file naming/location conventions laid out in your system's %{font-family: monospace}updconfig% file, if any, since you are not using %{font-weight: bold;color: #000000}UPD% for the installation.
493 1 Marc Mengel
494 1 Marc Mengel
p<>. %(#38903)&nbsp;% First make the product root directory:
495 1 Marc Mengel
496 1 Marc Mengel
497 1 Marc Mengel
<pre>
498 1 Marc Mengel
% cd /fnal/ups/products
499 1 Marc Mengel
% mkdir -p sister/v0_1/Linux+2
500 1 Marc Mengel
</pre>
501 1 Marc Mengel
502 1 Marc Mengel
503 1 Marc Mengel
p<>. %(#37874)&nbsp;% Change to the product root directory and unwind the product tar file:
504 1 Marc Mengel
505 1 Marc Mengel
506 1 Marc Mengel
<pre>
507 1 Marc Mengel
% cd sister/v0_1/Linux+2
508 1 Marc Mengel
% tar xvf /usr/tmp/sister_v0_1_Linux+2.tar
509 1 Marc Mengel
</pre>
510 1 Marc Mengel
511 1 Marc Mengel
512 1 Marc Mengel
p<>. %(#38982)&nbsp;% Now change to the product's %{font-family: monospace}ups% directory (or make one if it doesn't exist) and unwind the product's %{font-family: monospace}ups.tar% tar file:
513 1 Marc Mengel
514 1 Marc Mengel
515 1 Marc Mengel
<pre>
516 1 Marc Mengel
% cd ups
517 1 Marc Mengel
% tar xvf /usr/tmp/sister_v0_1_Linux+2.ups.tar
518 1 Marc Mengel
</pre>
519 1 Marc Mengel
520 1 Marc Mengel
521 1 Marc Mengel
p<>. %(#37889)&nbsp;% Finally, change to the directory in which you want to put the table file and copy it in. Here we use the product directory under the database (the other commonly used location is under the product's %{font-family: monospace}ups% directory).
522 1 Marc Mengel
523 1 Marc Mengel
524 1 Marc Mengel
<pre>
525 1 Marc Mengel
% cd /fnal/ups/db/sister
526 1 Marc Mengel
% cp /usr/tmp/sister_v0_1_Linux+2.table ./sister.table
527 1 Marc Mengel
</pre>
528 1 Marc Mengel
529 1 Marc Mengel
530 1 Marc Mengel
h3.  %(#37895)&nbsp;% 8.3.5 Declare the Product to your Database
531 1 Marc Mengel
532 1 Marc Mengel
533 1 Marc Mengel
p<>. %(#37896)&nbsp;% You now need to declare the product instance to your %{font-weight: bold;color: #000000}UPS% database. Declaring a product instance is described in section [[gen_install#78351|4.4 %{font-weight: normal;color: #000000}Declaring an Instance Manually% ]] .
534 1 Marc Mengel
535 1 Marc Mengel
p<>. %(#65918)&nbsp;% To declare the downloaded product %{font-weight: bold;color: #000000}sister% to our %{font-family: monospace}/fnal/ups/db% database, we run the %{font-weight: bold;font-family: monospace}ups declare% command as follows:
536 1 Marc Mengel
537 1 Marc Mengel
538 1 Marc Mengel
<pre>
539 1 Marc Mengel
% ups declare sister v0_1 -f Linux+2 -z /fnal/ups/db \ 
540 1 Marc Mengel
  -r /fnal/ups/products/sister/v0_1/Linux+2  \ 
541 1 Marc Mengel
  -m sister.table
542 1 Marc Mengel
</pre>
543 1 Marc Mengel
544 1 Marc Mengel
545 1 Marc Mengel
p<>. Remember, the backslash \ is shown to make it easier to read the command. It is typed all on one line.
546 1 Marc Mengel
547 1 Marc Mengel
p<>. %(#65944)&nbsp;% The %{font-weight: bold;font-family: monospace}-U% and %{font-weight: bold;font-family: monospace}-M% options are not included since we put the table file and %{font-family: monospace}ups% directory in default locations where %{font-weight: bold;color: #000000}UPS% will find them.
548 1 Marc Mengel
549 1 Marc Mengel
550 1 Marc Mengel
h2.  %(#37917)&nbsp;% 8.4 Installing Products from Other Product Distribution Nodes
551 1 Marc Mengel
552 1 Marc Mengel
553 1 Marc Mengel
p<>. %(#37919)&nbsp;% The procedure for downloading from any standard %{font-weight: bold;color: #000000}UPS% product distribution node is basically the same as illustrated for %{font-weight: normal;color: #000000}fnkits% in section [[ftpinstall#37818|8.3 %{font-weight: normal;color: #000000}Installing Products from fnkits.fnal.gov% ]] . The %{font-weight: bold;color: #000000}UPD% configuration of the server node will most likely be different however, which means that the product and its associated files may be organized differently than on %{font-weight: normal;color: #000000}fnkits% . You may need to verify that your node is registered to obtain products from the server. Contact the server maintainer or other designated person for information regarding node/user registration.
554 1 Marc Mengel
555 1 Marc Mengel
556 1 Marc Mengel
h3.  %(#39328)&nbsp;% 8.4.1 Locate the Product Files on the Server
557 1 Marc Mengel
558 1 Marc Mengel
559 1 Marc Mengel
p<>. %(#39329)&nbsp;% The most reliable way to determine the location of the product files is to use the %{font-weight: bold;font-family: monospace}upd list% command, e.g.,:
560 1 Marc Mengel
561 1 Marc Mengel
562 1 Marc Mengel
<pre>
563 1 Marc Mengel
% upd list -h <hostname> -K+:@prod_dir:@ups_dir:@table_file  \
564 1 Marc Mengel
  sister v0_1 -f Linux+2
565 1 Marc Mengel
</pre>
566 1 Marc Mengel
567 1 Marc Mengel
568 1 Marc Mengel
p<>. %(#37926)&nbsp;% (The output is shown on separate lines for readability.)
569 1 Marc Mengel
570 1 Marc Mengel
571 1 Marc Mengel
<pre>
572 1 Marc Mengel
"/P/tar/sisterv0_1Linux+2.tar" 
573 1 Marc Mengel
"/P/ups/sisterv0_1Linux+2.ups.tar"  
574 1 Marc Mengel
"/P/table/sisterv0_1Linux+2.table"
575 1 Marc Mengel
</pre>
576 1 Marc Mengel
577 1 Marc Mengel
578 1 Marc Mengel
p<>. %(#37928)&nbsp;% In this example, files are organized on the server by type rather than by product:
579 1 Marc Mengel
580 1 Marc Mengel
581 1 Marc Mengel
* product tar files are stored under the %{font-family: monospace}/P/tar% hierarchy
582 1 Marc Mengel
* product %{font-family: monospace}ups% directory tar files are stored under the %{font-family: monospace}/P/ups% hierarchy
583 1 Marc Mengel
* table files are stored under the %{font-family: monospace}/P/table% directory.
584 1 Marc Mengel
585 1 Marc Mengel
586 1 Marc Mengel
h3.  %(#65539)&nbsp;% 8.4.2 Download the Files from the Server
587 1 Marc Mengel
588 1 Marc Mengel
589 1 Marc Mengel
p<>. %(#39336)&nbsp;% Let's take %{font-weight: normal;color: #000000}special.upd.host% as our server node. In order to download the product files from the server, first change to an appropriate directory and run %{font-weight: bold;color: #000000}FTP% to the machine, e.g.,:
590 1 Marc Mengel
591 1 Marc Mengel
592 1 Marc Mengel
<pre>
593 1 Marc Mengel
% cd /usr/tmp
594 1 Marc Mengel
% ftp special.upd.host
595 1 Marc Mengel
</pre>
596 1 Marc Mengel
597 1 Marc Mengel
598 1 Marc Mengel
p<>. %(#39375)&nbsp;% Provide the username %{font-weight: normal;color: #000000}anonymous% , and use your < %{font-weight: normal;color: #000000}username>@<nodename>% as the password.
599 1 Marc Mengel
600 1 Marc Mengel
p<>. %(#39521)&nbsp;% Once you're logged on, set the mode to "binary", and %{font-weight: bold;font-family: monospace}get% the two tar files:
601 1 Marc Mengel
602 1 Marc Mengel
603 1 Marc Mengel
<pre>
604 1 Marc Mengel
ftp> binary
605 1 Marc Mengel
ftp> cd /P/tar
606 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.tar
607 1 Marc Mengel
ftp> cd /P/ups
608 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.ups.tar
609 1 Marc Mengel
</pre>
610 1 Marc Mengel
611 1 Marc Mengel
612 1 Marc Mengel
p<>. %(#39397)&nbsp;% Then set the mode to "ascii", and get the table file:
613 1 Marc Mengel
614 1 Marc Mengel
615 1 Marc Mengel
<pre>
616 1 Marc Mengel
ftp> ascii
617 1 Marc Mengel
ftp> cd /P/table
618 1 Marc Mengel
ftp> get sister_v0_1_Linux+2.table
619 1 Marc Mengel
</pre>
620 1 Marc Mengel
621 1 Marc Mengel
622 1 Marc Mengel
p<>. %(#39532)&nbsp;% and exit:
623 1 Marc Mengel
624 1 Marc Mengel
625 1 Marc Mengel
<pre>
626 1 Marc Mengel
ftp> bye
627 1 Marc Mengel
</pre>
628 1 Marc Mengel
629 1 Marc Mengel
630 1 Marc Mengel
h3.  %(#39539)&nbsp;% 8.4.3 Unwind the Files into your Products Area
631 1 Marc Mengel
632 1 Marc Mengel
633 1 Marc Mengel
p<>. %(#37751)&nbsp;% Unwind the tar files and copy the table file as shown in section [[ftpinstall#37860|8.3.4 %{font-weight: normal;color: #000000}Unwind the Files into your Products Area% ]] .
634 1 Marc Mengel
635 1 Marc Mengel
636 1 Marc Mengel
h3.  %(#39558)&nbsp;% 8.4.4 Declare the Product to your Database
637 1 Marc Mengel
638 1 Marc Mengel
639 1 Marc Mengel
p<>. %(#39555)&nbsp;% Declare them as shown in section [[ftpinstall#37895|8.3.5 %{font-weight: normal;color: #000000}Declare the Product to your Database% ]] .
640 1 Marc Mengel
641 1 Marc Mengel
p<>. %(#39536)&nbsp;% 
642 1 Marc Mengel
643 1 Marc Mengel
| [[upsv4TOC| !{width:84px;height:23px}images/navtoc.gif(TOC)!  ]] | [[uppinstall| !{width:81px;height:23px}images/navprev.gif(PREV)!  ]] | [[install_spec| !{width:81px;height:23px}images/navnext.gif(NEXT)!  ]] |
644 1 Marc Mengel
645 1 Marc Mengel
646 1 Marc Mengel
p<>. **This page last revised in May 2014** 
647 1 Marc Mengel