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:
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:
# To install SharePlex with the unattended option please
# modify the settings below. You may safely modify only the values
# to the right of the colon, and the colon must be immediately
# followed by a space. Editing the values to the left of the colon
# may impact the unattended install causing the process to become
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
the License key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
the customer name associated with this license key: SharePlex_Trial
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
For additional setup requirements, see the Next Steps section in one of the following depending on the platform:
Read this before you begin:
To run the installer
Run the sp_setup installation program and follow the prompts:
SharePlex installation directory (known as the product directory).
Specify an empty existing directory or a new one to be created.
|Component selection||Specify the database for which you are installing SharePlex.|
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.|
Click Add License. Type or paste the following exactly as received from Quest Software, including any spaces:
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.
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.
The following setup tasks must be finished before you start up replication.
|Run setup for the database||
Run Database Setup to set up an account and some objects in the database to support SharePlex:
For other Open Target target databases, use the connection command to supply connection information for the Post process to use. This can be done at any time before starting replication. See the SharePlex Administration Guide for more information about configuring an Open Target database for Post.
|Install the SharePlex service||SharePlex is not installed as a Windows service during an initial installation. To install the SharePlex service, see Install the SharePlex service.|
|Patch SharePlex||If you downloaded patches for this version of SharePlex, apply them now.|
Setup in a cluster
If installing SharePlex in a cluster, see Set up SharePlex in a Windows cluster.
|Set up security||See Assign SharePlex users to security groups.|
|Configure the MKS Toolkit||See Change global settings in the MKS toolkit.|
|Repeat||Repeat all of the installation procedures for all Windows machines that will be involved in SharePlex replication.|
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. Each instance of SharePlex must be installed on a different port number.
In the following procedures, you will:
SharePlex gets its environment information from the Windows Registry. The SharePlex environment variables SP_SYS_VARDIR and SP_SYS_HOST_NAME must be set in the Registry to the global cluster package name that is associated with the floating IP address. The global cluster package name is the alias that you created in the hosts file, as directed in the Installer Checklist.
Important! Do not set these parameters as environment variables, and do not set them on any systems outside the cluster, even if those systems are running SharePlex.
To set the SharePlex variables in the Registry
Locate the following SharePlex entry:
Expand the SharePlex node, then highlight the port number.