SharePlex 8.6.6 - Installation Guide

About the installers

There are different installers for SharePlex based on the platform type and data store type. This topic helps you understand the differences and the naming conventions used.

Linux and Unix

The SharePlex installer on Linux and Unix is a self-extracting installation file with the extension .tpm.

Oracle:

There is a separate SharePlex installer build for each supported Oracle database and platform.

SharePlex-release#-build#-DatabaseVersion-platform-version-chipset.tpm

Example: SharePlex-8.0.0-b86-oracle110-aix-52-ppc.tpm

Note: If the operating system version that you have is not listed, choose the highest number that is below your version.

Open Target:

The SharePlex Open Target installer supports all Open Target targets on all supported Linux platforms.

SPX-release#-build#-rh-40-amd64-m64.tpm

Important: If installing SharePlex for an Open Target and the source data is anything other than Oracle Unicode or US7ASCII, conversion must be performed before posting to the Open Target. In this case, you must use the Oracle installer rather than the Open Target installer and install an Oracle client on the target to perform the conversion. For more information, see the Open Target section of the Database checklist

The installer creates a temporary target directory, within the current directory, for extraction. This temporary target directory is removed upon installation completion. You can extract the files to a file system that is separate from the SharePlex installation location by using the -t option when running the .tpm file. For additional options, see Appendix A: Advanced SharePlex installer options.

Windows

On Windows, the SharePlex installer is named sp_setup_version.exe. It is a bundle that contains SharePlex binaries for all of the supported databases and versions.

The installer installs the following items:

• The SharePlex binaries and files
• The SharePlex for database program
• The MKS Platform Components program from Parametric Technology Corporation (default C:\Program Files\MKS Toolkit)
• Windows registry entries under \HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node.
• One or more SharePlex port_number Windows services (depending on the installed configuration)

Do not remove or modify any of these components while SharePlex is in production, including SharePlex Installer. These components all support SharePlex operation or upgrade.

UNIX Installation and Setup

Contents

Install SharePlex on Linux/UNIX for Oracle Database

Read this before you begin:

• These instructions assume that you understand and satisfied all requirements in the SharePlex preinstallation checklist.
• Perform the installation steps on all Unix and Linux machines involved in SharePlex replication. In a cluster, install on the primary node, which is the one to which the shared disk is mounted.
• These instructions assume installation as non-root. To install as root, see Appendix B: Install SharePlex as Root.
• The SharePlex security groups and SharePlex Administrator must exist on the system prior to installation. See Installer Checklist for more information.

• You can run the installer in either of the following ways:

  Run the installer in interactive mode

  Run the installer in unattended mode

Run the installer in interactive mode

In interactive mode, you are prompted for each part of the installation information.

1. Log in to the system as the user that will be named as the SharePlex Administrator during this installation. This user will own the installation files and binaries.

2. If sp_cop is running, shut it down.

   sp_ctrl> shutdown

3. Copy the installation file to a temporary directory where you have write permissions.

4. Grant executable permissions to the file.

   # chmod 555 installation_file

5. Run the .tpm file. If installing SharePlex in a cluster, run the installer from the primary node (the one to which the shared disk is mounted)

   # ./installation_file

6. Verify that the information shown on the first screen corresponds to the Oracle version and platform you are upgrading.

7. You are prompted for the following:

   Prompt	Input
   Installation type	Select <New Installation>.
   Product directory location (path)	Enter the path to the SharePlex installation directory. If the specified directory does not exist, the installer creates it. If the directory exists, it must be empty. The installer quits if the directory contains prior SharePlex installations or other files. In a cluster, install on the shared disk that you planned for in the Installer Checklist.
   Variable data directory location	Specify an empty directory. The installer creates the specified directory if it does not exist. Important! Do not install this directory into the SharePlex product directory. In a cluster, install the variable-data directory on the shared disk that you planned for in the Installer Checklist.
   SharePlex Admin group	Enter the DBA-privileged group to which the SharePlex Administrator user belongs, which will own the SharePlex binaries. If the default group of the SharePlex Administrator is oinstall, select any option, and make certain this user is listed under oinstall in the etc/group file. For more information, see the Installer Checklist
   ORACLE_SID of the database	Enter the Oracle SID of the database for which you are installing SharePlex. If you want to use one set of SharePlex binaries to replicate data on a system that contains multiple minor or patch release versions of Oracle Database, select the lowest patch release version that you want to include in replication. Alternatively, you can install separate instances of SharePlex for each Oracle version.
   ORACLE_HOME	Enter the path to the Oracle HOME directory of the selected Oracle SID.
   TCP/IP port for SharePlex	Enter the port number to use for SharePlex TCP/IP communications.
   License key (do you have?)	Press Enter to accept the default of Y (yes). If you do not have a license, enter no. At any point before you run SharePlex you can add the license key with the splex_add_key utility. See SharePlex license utilities.
   License key	Enter the license key you received from Quest.
   Customer name	Enter the SiteMessage text string provided by Quest with the license key.

The installer displays the location of the install log file and then quits.

See Next steps.

Next steps

Install SharePlex on Linux for Open Target Databases

Read this before you begin:

• These instructions assume that you understand and satisfied all requirements in the SharePlex preinstallation checklist.
• Perform the installation steps on all Unix and Linux machines that host Open Target targets involved in SharePlex replication. In a cluster, install on the primary node, which is the one to which the shared disk is mounted.
• These instructions assume installation as non-root. To install as root, see Appendix B: Install SharePlex as Root.
• The SharePlex security groups and SharePlex Administrator must exist on the system prior to installation. See Installer Checklist for more information.

• You can:

  Run the installer in interactive mode

  Run the installer in unattended mode

Run the installer in interactive mode

In interactive mode, you are prompted for each part of the installation information.

1. Log in to the system as the user that will be named as the SharePlex Administrator during this installation. This user will own the installation files and binaries.

2. (Reinstallations) If sp_cop is running, shut it down.
3. Copy the installation file to a temporary directory where you have write permissions.

4. Grant executable permissions to the file.

   # chmod 555 installation_file

5. Run the .tpm file. If installing SharePlex in a cluster, run the installer from the primary node (the one to which the shared disk is mounted)

   # ./installation_file

6. You are prompted for the following:

   Prompt for:	Input
   Installation type	Select <New Installation>.
   Product directory location (path)	Enter the path to the SharePlex installation directory. If the specified directory does not exist, the installer creates it. If the directory exists, it must be empty. The installer quits if the directory contains prior SharePlex installations or other files. In a cluster, install on the shared disk that you planned for in the Installer Checklist.
   Variable data directory location	Specify an empty directory. The installer creates the specified directory if it does not exist. Important! Do not install this directory into the SharePlex product directory. In a cluster, install the variable-data directory on the shared disk that you planned for in the Installer Checklist.
   SharePlex Admin group	Enter the DBA-privileged group to which the SharePlex Administrator user belongs, which will own the SharePlex binaries. If the default group of the SharePlex Administrator is oinstall, select any option, and make certain this user is listed under oinstall in the etc/group file. For more information, see the Installer Checklist
   TCP/IP port for SharePlex	Enter the port number to use for SharePlex TCP/IP communications.
   License key (do you have?)	Press Enter to accept the default of Y (yes). If you do not have a license, enter no. At any point before you run SharePlex you can add the license key with the splex_add_key utility. See SharePlex license utilities.
   License key	Enter the license key you received from Quest.
   Customer name	Enter the SiteMessage text string provided by Quest with the license key.

The installer displays the location of the install log file and then quits.

See Next steps.

Next steps