There are different installers for SharePlex based on the type of operating system. This topic helps you understand the differences and the naming conventions used.
The SharePlex installer on Linux and Unix, as applicable, is a self-extracting installation file with the extension .tpm.
Oracle and Open Target:
There is a separate SharePlex installer build for each supported platform.
SharePlex-release#-build#-platform-chipset.tpm
For Oracle Solaris (Sun), there is a separate SharePlex installer build for each supported operating system version. If the operating system version that you have is not listed, choose the highest number that is below your version.
SharePlex-release#-build#-platform-version-chipset.tpm
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 example: ./SharePlex-12.1.0-b1-rhel-amd64-m64.tpm -t <directory>
Note: The installation file (.tpm) file for the PostgreSQL database is available only for the Linux platform.
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:
Note: Cygwin binaries will be present in the SharePlex installation directory.
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.
Download the SharePlex installation package that matches the operating system you are using.
Additionally, download any SharePlex patches, so that you can install them after you install the base software.
Perform the below steps to download the SharePlex patches:
Go to the Quest Software Support page: http://support.quest.com/
Click Download Software.
Click the arrow in the Download column for the version you need. You can also click the file name for access to more information and to download the file(s).
You are ready to begin the installation process. Be sure to thoroughly read the version specific Release Notes prior to running the installer.
Read this before you begin:
You can run the installer in either of the following ways:
In interactive mode, you are prompted for each part of the installation information.
Perform the following steps to run the installer in an interactive mode:
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.
If sp_cop is running, shut it down.
sp_ctrl> shutdown
Grant executable permissions to the file.
#chmod 555installation_file
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
Verify that the information shown on the first screen corresponds to the Oracle version and platform you are upgrading.
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. For more information, see Installation and Setup for HA Cluster. |
|
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. For more information, see Installation and Setup for HA Cluster. |
|
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 Installer checklist for Oracle. |
|
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. For licensing on a cluster, see Installation and Setup for HA Cluster At any point before you run SharePlex you can add the license key with the splex_add_key utility. For more information, see the SharePlex License Utilities section in the SharePlex Reference Guide. |
| Please specify platform for license key (select a number): |
Select the appropriate number from the following list of platforms to install the license key: 1) Oracle 2) PostgreSQL 3) SQL Server 4) MySQL 5) MariaDB 6) Snowflake 7) Kafka 8) Event Hubs 9) JMS 10) File - Local Storage 11) File - Cloud Storage 12) All Platforms q) Quit License Utility NOTE: To install a trial version of SharePlex, users need to select the All Platforms option. |
|
License key |
Enter the license key you received from Quest. |
The installer displays the location of the install log file and then quits.
See Next steps.
The following setup tasks must be finished before you start up replication:
| Task | Description |
|---|---|
| Patch SharePlex | If you downloaded patches for this version of SharePlex, apply them now. |
| Run sp_security |
Run “sp_security –setup” to specify whether or not to enable SSL/TLS for all network traffic. When enabled, SSL/TLS is used for network communications between the SharePlex instances on the source and target systems. |
| Run Database Setup |
Run the Database Setup utility for Oracle (ora_setup) to establish a database account and connection information for SharePlex. For more information, see Database setup for Oracle. |
| (Heterogeneous replication) |
Install SharePlex on the Open Target system and perform database setup operations. See: |
| Assign users to security groups | For more information, see Assign SharePlex Users to Security Groups. |
| Multi-instance configurations |
To install multiple instances of SharePlex on this system, such as to support consolidated replication, see the Run SharePlex section in SharePlex Administrator’s Guide. |
Read this before you begin:
You can run the installer in either of the following ways:
In interactive mode, you are prompted for each part of the installation information.
Perform the following steps to run the installer in interactive mode:
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.
Grant executable permissions to the file.
# chmod 555 installation_file
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
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. |
| 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. |
| SharePlex Admin group |
Enter the DBA-privileged group to which the SharePlex Administrator user belongs, which will own the SharePlex binaries. |
| 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. For more information, see the SharePlex License Utilities section in the SharePlex Reference Guide. |
| Please specify platform for license key (select a number): |
Select the appropriate number from the following list of platforms to install the license key: 1) Oracle 2) PostgreSQL 3) SQL Server 4) MySQL 5) MariaDB 6) Snowflake 7) Kafka 8) Event Hubs 9) JMS 10) File - Local Storage 11) File - Cloud Storage 12) All Platforms q) Quit License Utility NOTE: To install a trial version of SharePlex, users need to select the All Platforms option. |
| License key |
Enter the license key you received from Quest. |
The installer displays the location of the install log file and then quits.
See Next Steps.
The following setup tasks must be finished before you start up replication:
| Task | Description |
|---|---|
| Patch SharePlex | If you downloaded patches for this version of SharePlex, apply them now. |
| Run sp_security |
Run “sp_security –setup” to specify whether or not to enable SSL/TLS for all network traffic. When enabled, SSL/TLS is used for network communications between the SharePlex instances on the source and target systems. |
| Assign users to security groups | For more information, see Assign SharePlex Users to Security Groups. |
| Perform Database Setup and other setup tasks |
See: Set up Replication from Oracle to a Supported Target Type |
| Repeat | Repeat all of the installation procedures for all Unix and Linux machines that will be involved in SharePlex replication. |
| Multi-instance configurations |
To install multiple instances of SharePlex on this system, such as to support consolidated replication, see the SharePlex Administrator’s Guide for the correct setup. |
