Chatta subito con l'assistenza
Chat con il supporto

SharePlex 11.0 - SharePlex Installation and Setup Guide

About this Guide Conventions used in this guide Revision History 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 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 Advanced SharePlex Demonstrations for PostgreSQL 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

Uninstall SharePlex from UNIX/Linux

Remove SharePlex from Unix/Linux

Perform the following steps to remove SharePlex from Unix or Linux platforms:

  1. Log on as a user who has privileges to remove the SharePlex directories.
  2. Run sp_ctrl.
  3. Issue the shutdown command to shut down SharePlex.

    sp_ctrl> shutdown

  4. Exit sp_ctrl.
  5. Use the following command to make certain that no SharePlex processes are running.

    # ps -ef | grep sp_

  6. Kill any processes that are still running.
  7. Remove the SharePlex product directory, variable-data directory, and the hidden .shareplex directory from the system.
  8. Drop the SharePlex database user from the database.

Note: If desired, remove any objects that SharePlex installs in the database. These objects begin with SHAREPLEX_ or shareplex_. You can remove any such objects using standard SQL commands.

Important!

Points to remember when removing the SharePlex objects from the PostgreSQL database:

  • Remove the replication slot that was created during pg_setup using the following query:

    select pg_drop_replication_slot(<slot_name>);

  • Remove replication origins created by the Post-process:

    • Get replication origin names using the following query:

      Select a roname from pg_replication_origin that is similar to "sp_post_%";

    • Remove these origins with the following query:

      select pg_replication_origin_drop(<origin_name>);

  • If the SP_CAP_DENIED_SESSION_PG parameter was used, remove the replication origin created:

    • Get replication origin names using the following query:

      Select a roname from pg_replication_origin that is similar to "sp_deny_%";

    • Remove these origins with the following query:
      select pg_replication_origin_drop(<origin_name>);

 

 

Advanced installer options

The use of additional command line options when installing SharePlex is usually not necessary. These options are typically employed when working with Support to resolve specific issues.

The installer command line options and their descriptions follow:

USAGE

tpm [<options>] [ [<package> | <location>] ... ]

 

OPTIONS

-v, --verbose Turns verbose mode on

-h, -?, --help Prints out this message

--debug Starts the interactive debugger

--info Print information about installed

 

packages

--install Perform product installation

--remove Perform product deinstallation

--commit Commit last installation

--revert Revert last installation

-t, --tmp <directory> Temporary directory location

-d, --directory <directory> Working directory

-f, --force Unconditionally update existing files

--no-cleanup Do not perform cleanup on failure

--nocleanup Same as --no-cleanup, for compatibility

--list List the content of the archive

--extract Extract the archive into the current directory

-r, --responses <yaml file> Use the responses from a specified file

-D, --defaults Accept default answers

-l, --log Leave the installation log file

DESCRIPTION

Provides package management facilities. Packages can be installed, removed, reverted or committed. The utility also figures out its role based on the command name of its invocation path. For example, "tpm-install" is treated as "tpm --install", "tpm-remove" as "tpm --remove", etc.

It can also be invoked as part of a self extracting package invocation, in which case it is treated as "tpm --install".

Note: All command line options for the .tpm file are preceded by two dashes.

Install SharePlex as root

You can install SharePlex as a root user. When you install as a root user, the installer prompts you to select whether or not to create the SharePlex user groups. When the installer creates the groups, it adds the SharePlex Administrator user to the spadmin group. For more information about these groups, see Assign SharePlex Users to Security Groups.

In a cluster, the installer adds the SharePlex groups to the primary node, but you must add them to the other nodes yourself.

Additionally, see Network Checklist for instructions on adding the groups to a nameserver.

To install as root:

    1. Log in to the system as a root user.
    2. Copy the SharePlex installer file to a temporary directory where you have write permissions. The installer file has a naming format of:

      SharePlex-release#-platform.tpm

    3. Change the permissions of the file as follows:

      # chmod 555 SharePlex-release#-platform.tpm

    4. Run the installer as directed in Install SharePlex .

Run the installer in unattended mode

SharePlex can be installed unattended through the use of a response file. This installation method speeds the installation of multiple SharePlex instances. The file supplies responses to the standard installer prompts, while providing on screen status information.

Note:When running in unattended mode, the installation process does not call the system password utility. If you create a new SharePlex user during the installation, that user will remain locked until the password is set manually.

Response files that you can edit are located in the install subdirectory of the SharePlex product (installation) directory:

/productdir/install

Enter Responses in the File

Important! The response file contains two sections. Only the top section is user configurable. Do not edit the bottom section. The bottom section begins with the line "Do not change settings that appear below."

Edit the top section of the response file to provide the responses for the installation. Only edit the values to the right of the colon, and make certain there is a space between the colon and the response.

The following example is for non-root installation:

# Please modify the following settings for your particular system to
# install the SharePlex. Only values to the right of a
# colon may be editted. Incorrect changes on the left side may make
# the installer output questions and wait for answeres, thus becoming
# interactive instead of silent.
#
the SharePlex Admin group: spadmin
product directory location: /home/splex/proddir
variable data directory location: /home/splex/vardir
# not required for Open Target installations #
ORACLE_SID that corresponds to this installation: oracledb
# not required for Open Target installations #
ORACLE_HOME directory that corresponds to this ORACLE_SID: /home/oracle/products/version
TCP/IP port number for SharePlex communications: 2100
# To specify the platform for license key [ Oracle, File, JMS, Kafka, SQL Server, Postgres, MySQL, Event Hubs, All Platforms ]
the platform for license key: Oracle
the License key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
# only change the current version number of SharePlex in place of 11.0.0
# do not change the value from yes to no
valid SharePlex v. 11.0.0 license: yes
# Do not change settings below.
#
Proceed with installation: yes
Proceed with upgrade: no
OK to upgrade: no

To run the response file:

From the command shell of the operating system, run the .tpm installation file with the -r option followed by the full path to the response file.

# ./installation_file -r /users/shareplex/product.rsp

 

Next steps:

For additional setup requirements, see the Next Steps section in one of the following depending on the platform:

Install SharePlex on Linux/Unix for Oracle Database

Install SharePlex on Linux/Unix for PostgreSQL as a Source and Open Target Databases

Related Documents

The document was helpful.

Seleziona valutazione

I easily found the information I needed.

Seleziona valutazione