Installing Releases and Patches Using FTP

Rational provides product releases, update releases and patches on our FTP server (ftp.rational.com). This chapter describes how to use the FTP server to install products, updates, patches or make a product release tape.

Warning: The information in this chapter does not apply to Beta versions of this release.

The following topics are covered in this section:

• Getting The FTP Install Script, rinstall
• Install Scenario #1 - Direct Internet Access
• Install Scenario #2 - Indirect Internet Access (UNIX/Linux)
• Install Scenario #3 - Indirect Internet Access (PC)
• Install Scenario #4 - Firewall Access to the Internet
• Installing Patches

---

Getting The FTP Install Script, rinstall

To install a product release using Rational's FTP server, perform the following:

1 . Rational recommends that you start from an empty directory in the rational_dir directory. The rinstall program creates files in whatever directory you are. If you start with an empty directory these files are easier to detect.

% cd rational_dir
% mkdir tmp
% cd tmp

2 . Get the rinstall script from the server using a web browser. You will need internet connectivity to do this.

ftp://ftp.rational.com/rinstall

Select the rinstall URL and do a File > Save As...

Or use the ftp command:

ftp ftp.rational.com

(login as user ftp. Use your internet E-mail address as the password. for example, ace@company.com)

ftp> get rinstall
ftp> quit

Using a web browser, you must do a File > Save As... from the menu bar after selecting rinstall.

The rinstall script automates the process of downloading product files from the FTP server. It is a menu-driven script. It lets you select the product you want to install from an up to date list of products that are currently available from the FTP server. The script has a number of settings to allow you to customize its operations.

Each of the menu items is set by entering an alphabetic key. Here is a sample of the rinstall menu:

Key  FTP Install Options        Current Settings

---  ---------------------      ----------------

f )  FTP command:               ftp ftp.rational.com

u )  FTP user:                  anonymous

p )  FTP user password:         NEED-TO-SPECIFY

uf)  user FTP command:          none

t )  FTP transfer mode:         N/A

d )  FTP storage directory:     /vendor/rational/tmp

n )  number of retries:         5

rd)  Rational directory:        NEED-TO-SPECIFY

sp)  Select a product to install

bg)  change to background.      Run in foreground

td)  time delay:                none

r )  reset to factory defaults

si)  show tracking information

q )  quit rinstall

Note: Transfer modes are not applicable to the download of Rational Rose, and selecting one mode over another has no effect on the install.

---

Install Scenario #1 - Direct Internet Access

The install computer has access to the Internet. You can install a release using the FTP server. Think of the internet and the FTP server as the install device.

Run the rinstall script:  

% sh rinstall 

or with

% chmod a+x rinstall
% ./rinstall

Set the FTP user password to your E-mail address. Set the Rational directory (for example, /vendor/rational). Select a product to install and follow the instructions given by rinstall to complete the install.

---

Install Scenario #2 - Indirect Internet Access (UNIX/Linux)

The install computer does not have access to the Internet. You have a UNIX/Linux computer with a locally attached tape drive. In many cases, the computer you want to install products on does not have access to ftp.rational.com. You can use rinstall to get all of the product files, defer the install step, and write the files to a tape.

Set the FTP user password. Set the Rational directory to the default. Select the product. Finally, select the st key to start the transfer, but defer the install.

As an alternate method, you can make a simple tar tape of the release file (that is, Rose2002_GA.2002.05.00.$ARCH.tar.gz) and include network_install script on the tape. This method takes more disk space on the installation computer.

1 . Run rinstall as described in scenario above.

2 . Use the tar command to make a network install tape.

% tar -cvf tape_device network_install release_file_name

3 . Install the product using the network_install tape. It would be best to make a temporary storage directory to do the network install from. Do this on the installation computer:

% mkdir rational_dir/tmp
% cd rational_dir/tmp
% tar -xvf tape_device
% ./network_install

Follow the instructions given by this script.

---

Install Scenario #3 - Indirect Internet Access (PC)

The install computer does not have access to the internet and you cannot run the rinstall script (for example, you have a PC).

You need to get all of the files for a particular product copied over from the FTP server and dump the files to a tape. You need to include the product.I.J.K.install script on this tape.

Once you have established an FTP connection to ftp.rational.com, follow these instructions:

ftp> cd /public/rose/rose2002unix/releases/SYS_TYPE
ftp> prompt
ftp> get product.I.J.K.install
ftp> bin
ftp> get product.I.J.K.tar.gz
ftp> quit

Using tar, put the two files (product.I.J.K.tar.gz and product.I.J.K.install) on a tape:

% tar -cvf tape_device product.I.J.K.install *tar.gz

To extract the release files and begin installation:

% tar -xvf tape_device
% sh product.I.J.K.install

---

Install Scenario #4 - Firewall Access to the Internet

The install computer has access to the Internet through a firewall. Assuming your computer gives you access via these steps, you can use rinstall:

• Your internet access gateway computer is called gateway.
• Your gateway user name is george.
• Your gateway password is a secret (shown as *****).
• You need to type the command `ftp@ftp.rational.com george@company.com' to get logged into Rational's FTP server.

The top part of the rinstall menu shows 4 different settings:

Key  FTP Install Options        Current Settings

---  ---------------------      ----------------

f )  FTP command:               ftp ftp.rational.com

u )  FTP user:                  anonymous

p )  FTP user password:         NEED-TO-SPECIFY

uf)  user FTP command:          none

The `f' key is used to set the FTP command:

Enter the FTP command to use: [ftp]  ftp
Enter the FTP server to use: [ftp.rational.com]  gateway

The `u' key is used to set the FTP user at the gateway:

Enter the FTP user: [anonymous] ftp@ftp.rational.com

The `uf' key is used to set the user FTP command to login to Rational's FTP computer from your gateway computer. You must set this before setting the password:

Enter a user defined FTP command or 0 to clear: []  
 ftp@ftp.rational.com george@company.com

The `p' key is used to set the FTP user password at the gateway:

Enter your complete E-mail address: []  *****

Can this be used to send you information via E-mail? no

Enter an E-mail address that can: [] george@company.com

Now, the top part of the rinstall menu will look something like this:

Key  FTP Install Options        Current Settings

---  ---------------------      ----------------

f )  FTP command:               ftp gateway

u )  FTP user:                  george

p )  FTP user password:         *****

uf)  user FTP command:          ftp@ftp.rational.com ...

All of this is subject to your network administrator. The specific way to use your gateway computer may be different.The rinstall program is trying to accommodate a wide range of needs.

---

Installing Patches

Users can install patches using rinstall, a web browser or the ftp command. In all cases, you must have an internet connection. Otherwise you will need to request a CD containing the patches through your usual Rational support channel.

Using The rinstall Command

It is easiest to use rinstall. To do so you must be on a UNIX/Linux computer. You must have an internet connection. All you need to do is select the product for which you want to install one or more patches. Use the 'ip' option when prompted by rinstall to install patches only. If the previously installed product is visible from the computer where you run the rinstall program it will know if you already have patches installed. It is smart enough to only install the patches you do not have. Otherwise, you can download all of the patches that you do not have. You would need to find out what patches have already been installed by doing the following:

% cd rational_dir/releases/rose.I.J.K/bin

% ./rose -info

Using A Web Browser

Download the tar.Z file, the inventory file and the install script for each patch you want to install. The patches for Rose are listed in the ftp directory where the release is stored. For example, the Rose patches would be listed in /public/rose2002unix/releases/sol/Rose2002_GA.2002.05.00.$ARCH.GA.patch_info. This is the file rinstall uses to locate patches for a product release. If you download all of these files you can then run the install script for each patch. You must run them in the order they are listed in the file (chronologically). If the product is not visible from the computer where the files are downloaded, move them to such a computer first.

Using The ftp Command

This is the same as the web browser approach. You use the UNIX/Linux ftp command to log into the ftp.rational.com server as user 'ftp' with your e-mail address as your password. You need to navigate to the various patch directories using the cd command inside the ftp command. This is not as easy as using a web browser.

Getting Patch Information

You can visit the Rational FTP server to get information about available patches.

To view the current list of available patches, visit the ftp://ftp.rational.com/patch_info/index.html patch information page on our FTP server. From this page you can navigate to the patches you are interested in. There you will find instructions for installing each patch.

Note: The definitive list of patches is located in the product release directory on the FTP server in the file: /public/rose2002unix/releases/sol/Rose2002_GA.2002.05.00.$ARCH.GA.patch_info.