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.

The following topics are covered in this section:

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

---

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. The rinstall program will retry any failed transfers on a file-by-file basis.

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:         NEED-TO-SPECIFY
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

---

FTP/rinstall Transfer Modes

You must select a transfer mode to be used by the install tools. The transfer modes control how and when the files are downloaded from the server. Here is an explanation of the transfer modes:

• Bulk Transfer mode

  With this mode you get all of the product files before running the install script. All of the product install files will be downloaded. This is required to make a complete product tape. You should use bulk transfer if one of the following is true:

  • The machine you want to install on does not have FTP connectivity
  • Or, your FTP connection is not that reliable
  • Or, you wish to make a product release tape.
• Efficient Transfer Mode

  With this mode you get only the product files necessary to complete the install. The rinstall script will invoke the install script. You will tailor the install at this time. The install script will determine which files are needed. This information is passed back to rinstall to download the specific files needed to install the tailored product.

  You should use efficient transfer if:

  • You want the install script to get all of the components required to do a tailored install. This eliminates transfers of unnecessary files.

    The rinstall program will need to run the install program on the local machine to allow you to tailor the install. If you are not going to install the product on the same machine you are running rinstall, you need to:

  • Continue past any disk space error messages from the install program.
  • For Apex/Summit layered products, answer no when asked if it is a layered product.
• Very_Efficient Transfer Mode

  This mode is similar to efficient transfer mode. In this mode, the install script gets the component files as it needs them and deletes each component file after it has been used. This results in the minimum amount of disk space being used during the install process.

  You should use very_efficient transfer if all of the following are true:

  • You want the install script to get each component file as it needs them. This is the optimal disk saving way to install products.
  • And, you have FTP connectivity on the install machine.

---

Install Scenario #1 - Direct Internet Access

The install machine 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 like this:

% sh rinstall

Or, like this:

% chmod a+x rinstall
% ./rinstall

Set the FTP user password to your E-mail address. Set the transfer mode to very_efficient. 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)

The install machine does not have access to the Internet. You have a UNIX machine with a locally attached tape drive. In many cases, the machine 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 transfer mode to bulk or efficient. Set the Rational directory to the default. Select the product. Finally, select the `st' key to start the transfer, but defer the install.

1 . If you used bulk transfer mode you can create a product install tape using duptape. The duptape script will be transferred over after the product is transferred.

% ./duptape
# Recommended. Must use bulk transfer.

With this tape, you can install the product as described in Installation Quick Start.

As an alternate method, you can make a simple tar tape of the files and include network_install script on the tape. This method takes more disk space on the installation machine. This method is required if you use efficient transfer mode.

1 . Run rinstall as described in scenario above.

2 . Use the tar command (not duptape) to make a network_install tape. This is required when using efficient transfer mode.

% tar -cvf tape_device network_install file*

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

% mkdir rational_dir/tmp
% cd 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 machine 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 network_install script on this tape.

Once you have established an FTP connection to ftp.rational.com, you have two ways to make a tape. This depends on whether there is a product directory for a tar.gz file.

1 . If there is a product directory, do this:

ftp> cd /public/apex/releases/SYS_TYPE
ftp> prompt
ftp> cd apex.x.y.z
ftp> get network_install
ftp> bin
ftp> mget file*
ftp> quit

Using tar, put all of the files (network_install and file*) on a tape. (First alternate):

% tar -cvf tape_device network_install file*

2 . If there is no product directory, but there is a product.tar.gz file, then get that file.

ftp> cd /public/apex/releases/SYS_TYPE
ftp> get network_install
ftp> bin
ftp> get product.x.y.z.tar.gz
ftp> quit

Using tar, put the two files (product.x.y.z.tar.gz and network_install) on a tape. (Second alternate):

% tar -cvf tape_device network_install *tar.gz

To install either kind of tape, untar all the files into a directory and run network_install:

% tar -xvf tape_device
% sh network_install

---

Install Scenario #4 - Firewall Access to the Internet

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

• Your internet access gateway machine 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 machine from your gateway machine. 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 machine 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 machine. 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 machine 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 will need to find out what patches have already been installed by looking in the install/patches directory of the product. For Apex and Apex layered products, you can run the command:

apexinit -info

Alternatively you can execute Help > On Version.

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 each Apex and Apex layered product are listed in the ftp directory where the release is stored. For example, the Apex 3.0.0b/Solaris patches would be listed in /public/apex/releases/sol/apex.3.0.0b/README.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 machine where the files are downloaded, move them to such a machine first. It is best to be in an Apex shell when you run the each install script but it is not mandatory.

Using the ftp Command

This is the same as the web browser approach. You use the UNIX 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. You can subscribe to our list server to get e-mail notification about Apex, Summit and layered product patches as they become available.

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/apex/releases/<sys>/apex.<version>/README.patch_info.

---

Getting Announcements from Rational

We will announce new Apex products, layered products, new releases, patches, and critical technical information about these products through e-mail.

To sign up for automatic notification, send an e-mail message to majordomo@rational.com with the words subscribe apex-announcements in the body of the message.

If you already subscribe to this list and wish to be removed, send an e-mail message to majordomo@rational.com with the words unsubscribe apex-announcements in the body of the message.

We will not advertise on this list.