Chat now with support
Chat with Support

SharePlex 9.2.4 - Installation and Setup for Oracle Source

About this Guide Conventions used in this guide SharePlex pre-installation checklist Download the SharePlex installer Installation and setup for Oracle cluster Installation and setup for remote capture Install SharePlex on Linux and UNIX Install SharePlex on Windows Assign SharePlex users to security groups Set up an Oracle environment for replication Set up replication from Oracle to a different target type Generic SharePlex demonstration-all platforms Advanced SharePlex demonstrations for Oracle Solve Installation Problems Database Setup Utilities General SharePlex Utilities Uninstall SharePlex Advanced installer options Install SharePlex as root Run the installer in unattended mode SharePlex installed items

Install SharePlex on Linux/UNIX for Oracle Database

Read this before you begin:

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 555installation_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. 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.

    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.

    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

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. For more information, see “Configure Security Features” in the SharePlex Administrator Guide.

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 Run SharePlex in the SharePlex Administrator’s Guide.

Install SharePlex on Linux for Open Target Databases

Read this before you begin:

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.

    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. 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.

    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.

    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

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. For more information, see “Configure Security Features” in the SharePlex Administrator Guide.

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 different 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.

Install SharePlex on Windows

Contents

 

Install SharePlex on Windows

Read this before you begin:

  • These instructions assume that you understand and satisfied all requirements in the SharePlex SharePlex preinstallation checklist.
  • Perform the installation steps on all Windows machines involved in SharePlex replication. On Windows, install SharePlex on all nodes of each cluster, on the same port number, with identical path names. This is required to make the binaries and the required MKS Toolkit components available to all nodes, and to establish Registry entries.

To run the installer

  1. Log in to Windows as the SharePlex Administrator.
  2. (Reinstallation only)

    1. Run SpUtils from the shortcut on the Windows desktop. If the system is running Windows 2008 or higher, run SpUtils as an Administrator.
    2. Select the SharePlex Services tab.
    3. Select the correct port, and then stop the SharePlex service.
    4. Close the utility.
  3. Run the sp_setup installation program and follow the prompts:

    Prompt Input
    Destination folder

    SharePlex installation directory (known as the product directory).

    Specify an empty existing directory or a new one to be created.

    Port number

    The port number on which this instance of SharePlex will run.

    The default is 2100. Do not use port 2101. That port is reserved for the SpRemote utility.

    Variable Data directory

    The directory where SharePlex stores its working files and data.

    Specify an empty existing directory or a new one to be created. To avoid permissions errors during runtime, do not install the variable-data directory in the Program Files directory.

    Program Manager group

    The folder in the Programs menu where SharePlex programs will be launched.

    MKS Platform Components

    Appears if SharePlex was never installed on the system or if this is a reinstallation. Accept the default Program Files location or specify a different one.

    If prompted to restart your system, you can postpone the restart until after you finish this installation.

    Confirm installation Confirm the installation information.
    SharePlex license

    Click Add License. Type or paste the following exactly as received from Quest Software, including any spaces:

    1. License Key: The license key, which is case sensitive.
    2. Customer Name: The Site Message text that was included with the license. The name is case-sensitive.
    3. Click OK.

    If you do not have a license, click Cancel. The installation succeeds without a license, but SharePlex cannot be started. You can add the license later from the License Key tab of the SpUtils utility, which is installed on the Windows desktop.

    Finish

    If you were prompted to restart the system after you installed the MKS Toolkit files, you may do so after exiting the installer.

    Proceed to Next Steps.

Next steps:

The following setup tasks must be finished before you start up replication.

Task Description
Install the SharePlex service For more information, see Install the SharePlex service.
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. For more information, see “Configure Security Features” in the SharePlex Administrator Guide.

Perform Database Setup and other setup tasks

If installing SharePlex for an Open Target database, perform required additional setup:

Set up replication from Oracle to a different target type

Set up in a cluster

For more information, see Installation and setup for Oracle cluster.

Assign users to security groups For more information, see Assign SharePlex users to security groups.
Repeat Repeat all of the installation procedures for all Windows 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 Run multiple instances of SharePlex in the SharePlex Administrator’s Guide. Each instance of SharePlex must be installed on a different port number.

Related Documents