Installing, Upgrading, and Removing iGateway › iGateway Installation—UNIX

iGateway Installation—UNIX

For UNIX systems, you install iGateway specifying options for normal or silent installations using a self-extracting shell script.

Important! You need super user (root or equivalent) access rights to install, upgrade, or uninstall iGateway on a UNIX, Linux, or Solaris operating system successfully.

For iGateway, the CASHCOMP path (CA Shared Components Path) is automatically recognized if the environment variable is set.

By default, iGateway installs into the following directory:

<CASHCOMP PATH>\iTechnology

CASHCOMP PATH

Equates to /opt/CA/SharedComponents/iTechnology.

The installer provides an option to specify a different path.

During the iGateway installation or upgrade, select the following program features you installed:

• iGateway (Mandatory)
• SPIN (Optional)
• iAuthority (Optional)
• iRegistry (Optional)

When selected to install or upgrade, you see a description and the amount of hard drive space required for the installation.

Install iGateway in Normal Mode--UNIX

You have the following options to install iGateway in normal mode using the iGateway.sh script:

• As a member of the superuser (root or equivalent group)
• As a non-root user

If you install iGateway as a non-root user, the host-based authentication does not work. Host-based authentication is functionality in iGateway that provides administrative privileges.

To install iGateway on UNIX systems in normal mode

1. Copy the iGateway install script on the iSponsors folder on the DVD media for your corresponding operating system to a directory on your computer.
2. Execute the iGateway.sh script from a command prompt. Add additional switches as required.

   iGateway installs and the iGateway service starts automatically. The following are expected outputs from the installation:

   • An iTechnology.location file is created in /opt/CA/SharedComponents, which contains the location of the iGateway installation.
   • A profile.CA file is created in the /etc directory (if not present), which contains the information about the IGW_LOC, WD_SAVECORE, and WD_COREDIR variables.
   • An entry of profile.CA file is made in /etc/profile file (if not present).
   • The IGW_LOC variable is created and set to the installation directory.
3. After installation, enter the following in a browser window to display iSponsors that are installed in the iGateway installation directory:

   https://localhost:5250/igsponsor/
   

   Your installation is verified as working correctly.

iGateway.sh--Install iGateway on UNIX Using a Script File

The iGateway.sh script runs the installer to install iGateway.

Note: Use the /s option only when installing iGateway in silent mode.

This command has the following format:

./iGateway.sh [-tempdir path_tempdir] [-logfile path_logfile/logfilename] -s -nostart -Spin -iAuthority -iRegistry [-cashcomp path_cashcomp] [-igwpath path_igw] [-igwuser username]

-tempdir path_tempdir

(Optional) Indicates the absolute path of the temporary directory where iGateway will be unpacked, which is used for the installation. Untar iGateway files at path_tempdir. If path_tempdir is null, /tmp is assumed. The default location for extracting the tar install tarball is /tmp.

-logfile path_logfile/logfilename

(Optional) Indicates the absolute path where the log file is created and the file name of the log file.

Note: The path must exist before issuing this command.

-s

Identifies that the install is silent.

-nostart

Forces iGateway service not to start after installation or upgrade.

-Spin

Installs SPIN.

-iAuthority

Installs iAuthority.

-iRegistry

Installs iRegistry.

-cashcomp path_cashcomp

(Optional) Specifies one of the following ways in which CASHCOMP is handled:

• If CASHCOMP is not exported through /etc/profile.CA, create an entry of CASHCOMP in /etc/profile.CA with the path_cashcomp as the path
• If CASHCOMP is not exported through /etc/profile.CA and path_cashcomp is null, create an entry of CASHCOMP in /etc/profile.CA with the value /opt/CA/SharedComponents
• If CASHCOMP is defined in /etc/profile.CA, path_cashcomp is ignored and the existing value of CASHCOMP is used subsequently in the installation

-igwpath path_igw

(Optional) Identifies the path for the installation of iGateway in one of the following ways:

• If path_igw has a value, iGateway is installed at path_igw and a symlink to this install location in $CASHCOMP is created
• If path_igw is null, iGateway is installed at $CASHCOMP/iTechnology

  Note: Symlink to the iGateway installation is created at $CASHCOMP only if the install location of iGateway differs from $CASCHCOMP/iTechnology.

$CASHCOMP is derived in the following way:

• The value of CASHCOMP is defined in /etc/profile.CA.
• If CASHCOMP is not exported in /etc/profile.CA, path_cashcomp identified in the command line is used.
• If both of these values are not available, CASHCOMP defaults to /opt/CA/SharedComponents.

-igwuser username

(Optional) Identifies the user installing iGateway, without administrative privileges. Pass this argument when installing iGateway for a non-root user.

The following conditions apply when installing iGateway using this option:

• If the username is specified and the user exists on the system, the installer sets the owner of iGateway to that user.
• If the username is specified and the user does not exist on the system, the installer creates the user and sets the owner of iGateway to that user. An entry for the user appears in the /etc/passwd file.No password is set by iGateway. The user can set the password using the passwd command.
• If the username is not specified, the default username is assumed as igwuser and all the owner/group is set to igwuser.
• If -igwuser username is not provided, iGateway is installed for the root user.
• If -igwuser username is provided and the username is root, iGateway is installed for the root user.
• All files in the iGateway installation folder are set to the same user or group. For HPUX, the soft links are given root permission even if iGateway is installed by another user.

The following conditions apply when upgrading iGateway using this option:

• If iGateway was installed using the root user and the upgrade provides the igwuser username option with the username as the same as the root user, the upgrade continues.
• If iGateway was installed using the root user and the upgrade provides the igwuser username option with the username different from the root user, the upgrade aborts with a message indicating the upgrade is not allowed.
• If iGateway was installed using the root user and the upgrade provides the igwuser username option with the username not specified, the upgrade continues and sets the owner or group to the same as the original installation specified.
• If iGateway was installed using the igwuser username (non-root user) and the upgrade uses the same username, the upgrade continues.
• If iGateway was installed using the igwuser username (non-root user) and the upgrade uses a different username, the upgrade aborts with a message indicating the upgrade is not allowed.
• If iGateway was installed using the igwuser username (non-root user) and the upgrade does not specify the username, the upgrade continues and sets the owner or group to the same username as the original installation specified.

Install iGateway in Silent Mode--UNIX

You have the following options to install iGateway in silent mode using the iGateway.sh script:

• As a member of the superuser (root or equivalent group)
• As a non-root user

If you install iGateway as a non-root user, the host-based authentication does not work, except for HP-UX systems, which is computer dependent. Host-based authentication is functionality in iGateway that provides administrative privileges.

To install iGateway in silent mode on UNIX systems

1. Copy the iGateway install script on the iSponsors folder on the DVD media for your corresponding operating system to a directory on your computer.
2. Execute the iGateway.sh script from a command prompt using the /s switch. Add additional switches as required.

   iGateway installs and the iGateway service starts automatically.

   The following are expected outputs from the installation:

   • iGateway installs at location /opt/igwpath and creates a symbolic link to this location at /opt/CA/cashcomp (if cashcomp is already set, the symbolic link is created at the appropriate location)
   • SPIN and iAuthority are automatically installed.
   • An iTechnology.location file is created at /opt/CA/SharedComponents directory.
   • A profile.CA file is created in the /etc directory (if not present), which contains the information about the IGW_LOC, WD_SAVECORE, and WD_COREDIR variables.
   • An entry of profile.CA file is made in /etc/profile file (if not present).
   • The IGW_LOC variable is created and set to the installation directory.
3. After installation, enter the following web address in a browser window to display iSponsors that are installed in the iGateway installation directory:

   https://localhost:5250/igsponsor/
   

   Your installation is verified as working correctly.