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 Oracle 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 Oracle 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 Oracle Cluster At any point before you run SharePlex you can add the license key with the splex_add_key utility. For more information, see SharePlex License Utilities. |
| Please specify platform for license key (select a number): |
Please select the appropriate number from the following list of platforms to install the license key: 1) Oracle 2) File
3) JMS 4) Kafka 5) SQL Server 6) Postgres 7) MySQL 8) Snowflake 9) Event Hubs 10) All Platforms 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 SharePlex License Utilities. |
| Please specify platform for license key (select a number): |
Please select the appropriate number from the following list of platforms to install the license key: 1) Oracle 2) File
3) JMS 4) Kafka 5) SQL Server 6) Postgres 7) MySQL 8) Snowflake 9) Event Hubs 10) All Platforms 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 a Supported Source 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. |
The SharePlex security groups provide access control to the SharePlex command and control system. Without proper configuration of these groups, anyone with permissions on the system can use the commands that view, configure, and control data replication.
To monitor, control, or change SharePlex replication, a person must be assigned to one of the SharePlex security groups on the systems where he or she will be issuing commands. Each group corresponds to an authorization level, which determines which SharePlex commands a person can issue. To execute a command, a user must have that command’s authorization level or higher.
Use the authlevel command to determine your authorization level for issuing SharePlex commands on a system.
Refer to the following table to determine the group and authorization level that you want to grant each SharePlex user.
| Auth level | User type | User group | User roles |
|---|---|---|---|
| 1 | Administration | spadmin* |
You need at least one user with Administrator rights on each source and target system. Can issue all SharePlex commands. Commands that can only be issued by a SharePlex Administrator are:
The SharePlex Administrator user must be in the Oracle dba group. For Oracle RAC and ASM 11gR2 and above, the user must also be in the Oracle Inventory group. For example: $ useradd –g spadmin –G dba,oinstall. The membership in Oracle Inventory group must be listed explicitly in the etc/group file. On Unix and Linux, unless you install SharePlex as a root user, the SharePlex Administrator user and the SharePlex admin group must exist prior to installation. |
| 2 | Operator | spopr | Can issue all SharePlex commands except those listed above. |
| 3 | Viewer | spview | Can view lists, status screens, and logs to monitor replication only. |
Note: The default name for the SharePlex administrator group is spadmin, but you can designate any group or specify any name for that group during installation.
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center
