How to Remotely Install Remote Agents on Solaris OS, Red Hat Linux, and IBM AIX (N1 Grid Service Provisioning System 5.0 Installation Guide)

N1 Grid Service Provisioning System 5.0 Installation Guide

Previous: Non-Interactive Installation of a Remote Agent on Solaris OS, Red Hat Linux, and IBM AIX Systems
Next: Starting Applications on Solaris OS, Red Hat Linux, and IBM AIX Systems

How to Remotely Install Remote Agents on Solaris OS, Red Hat Linux, and IBM AIX

The installation scripts for the Remote Agent are specific to the operating system of the target machine. You need to complete these steps for each operating system running on your target machines.

Before You Begin

The target machine must meet the following requirements:

The UNIX utility sshd must be running and have direct IP connectivity to the source machine.
Support for the UNIX hostname command must exist, so that the remote installation script can call this command. The Remote Agent must be configured to listen on the IP address of the host name returned by the hostname command.

The Master Server machine must have the UNIX utilities ssh and scp installed and in the path at the time of execution.

The remote installation program uses environment variables to manage the installation and configuration of the Remote Agent. You can set the environment variables in a parameters file, at the command line, or use the default values provided by the installation script. Following are the required environment variables and their default values:

CR_RA_CTYPE=raw – The Remote Agent connects to the Master Server or Local Distributor using no encryption. Other values for this variable are ssh and ssl.
CR_RA_SUID=y – Installs the Remote Agent with setuid root privilege. To specify a value of yes, you must run the installation script as the root user.
CR_RA_INSTALLER_HOSTS=host1,host3.enterprise.com,10.10.0.207 – If you do not supply host names on the command line or as an environment variable, the installation script exits with an error.

Steps

On the Master Server machine, access the installation scripts.
- If you are installing from a CD, insert the appropriate CD:
  - To install the Remote Agent on a Solaris OS, SPARC server, insert the N1 Grid Service Provisioning System 5.0: Solaris, SPARC CD.
  - To install the Remote Agent on a Solaris OS, x86 server, insert the N1 Grid Service Provisioning System 5.0: Solaris, x86 CD.
  - To install the Remote Agent on IBM AIX or Red Hat Linux, insert the N1 Grid Service Provisioning System 5.0: IBM-AIX, Red Hat Linux CD.
- If you are installing from the image that you downloaded, change to the directory where you saved the downloaded image.

Change to the directory on the software CD or within the downloaded image where the installation script is located.
% cd /script-directory
script-directory is one of the following values:
- solaris_sparc
- solaris_x86
- aix
- linux

Copy the installation script to the Master Server.
% cp cr_ra_opsystem_5.0.sh N1SPS5.0-MasterServer-home/server/bin
N1SPS5.0-MasterServer-home is the directory where you installed the Master Server and opsystem is one of the following values:
- solaris_sparc – installs the Remote Agent on SPARC based hardware running the Solaris OS
- solaris_x86 – installs the Remote Agent on x86 based hardware running the Solaris OS
- aix – installs the Remote Agent on IBM AIX
- linux – installs the Remote Agent on Red Hat Linux

Change directories to where the scripts are located.
% cd N1SPS5.0-MasterServer-home/server/bin
N1SPS5.0-MasterServer-home is the directory where you installed the Master Server.

Determine how to provide configuration information to the installation script.

Create a new parameters file or edit the sample parameters file that was installed by the N1 Grid Service Provisioning System 5.0. When you install the Master Server, a parameters file is installed. The file is named N1SPS5.0-MasterServer-home/server/bin/cr_ra_remote_params.sh. You can use the default values that are provided in this file or edit the file and add your custom values. You can also create a new parameters file to use. The contents of the sample parameters file are in Sample Remote Agent Parameters File for Solaris OS, Red Hat Linux, and IBM AIX Systems. The parameters file must be an executable file.

Set the environment variables.

% export CR_RA_INSTALLER_USER=username
% export CR_RA_INSTALLER_WORKDIR=/working_directory
% export CR_RA_INSTALLER_LEAVEFILES=yes_or_no
% export CR_RA_INSTALLER_HOSTS=hostnames.enterprise.com,10.10.0.207

Start the remote installation.
% cr_ra_remote.sh -paramfile path-to-file/parameters-file.sh –f cr_ra_opsystem_5.0.sh hostnames
- cr_ra_opsystem_5.0.sh is the installation script that you copied from the N1 Grid Service Provisioning System 5.0 CD or downloaded image.
- path-to-file/parameters-file is the path to the parameters file and the name of the parameters file that you want the installation program to use to obtain the configuration information. If you set the environment variables or you want the installation script to use the default values, you do not need to specify a parameters file.
- hostnames are the host names of the machines on which to perform the installation. Separate the hostnames by a space. If you specified the host names in the CR_RA_INSTALLER_HOSTS parameter, either in the parameters file or as an environment variable, you do not need to specify the hos tnames on the command line. If you specify host names on the command line, those hosts are installed and any hosts specified in the CR_RA_INSTALLER_HOSTS parameter are not be installed.

Make a note of the location of the log file.

The installation program notifies you that it is creating a log file and displays the location of the log file. Note the location of the file so that you can view it later.

If prompted by the installation program, provide passwords for the remote machine.

The installation script generates log files on the remote machine.