Create the <host_name>.properties file - Connect_CDC - connect_cdc_mimix_share - Latest

Connect CDC IBMi Installation Guide

Product type
Software
Portfolio
Integrate
Product family
Connect
Product
Connect > Connect CDC (MIMIX Share)
Version
Latest
Language
English
Product name
Connect CDC
Title
Connect CDC IBMi Installation Guide
Copyright
2023
First publish date
2003
Last edition
2024-07-19
Last publish date
2024-07-19T23:34:41.651897
Define a separate .properties file for the host listed in the host.list file where <host_name> is the name of the host machine to install Connect CDC. Each .properties file must be located in the current directory where the installer is running. Below is a sample .properties file named install_LTIAS03.properties for the host named LTIAS03. For usage notes, refer to Usage Notes for the .properties file. For keyword definitions, refer to Keywords for the <host_name>.properties file.
# Omni Installation Properties
PRODUCT_VERSION=5.8.00
HOST_USER=TEST
HOST_PASS=******   (comment: provide actual password)
HOST_NAME=LTIAS03
JAVA_PATH=/usr/bin/
INSTALL_CD=/home/test/V580/install
INSTALL_DIRECTORY=/home/test/V580
LISTENER_PORT=1780
INITIAL_MEMORY=32
MAXIMUM_MEMORY=*NOMAX
SSL_AUTH=N
SSL_ENCR=N
NUM_DRIVERS=0
COMMAND_LIBRARY=DVTIMV580
INSTALL_LIBRARY=SHAREV580
TARGET_ONLY=N
TRANSLATE_BINARY=N
INSTALL_JETTY=N
INSTALL_CLIENT=Y

Note: In the example shown above, The System i5 driver is installed automatically, as designated by NUM_DRIVERS=0. However, you can make an explicit specification for the driver, specified in place of NUM_DRIVERS=0, as shown below:

NUM_DRIVERS=1
DRIVER_ID_1=JTOpen400>
DRIVER_CLASSPATH_1=../jarfiles (my comment: since installer installs driver file this is a relative pointer to its location)
Table 1. Keywords or Input Parameters for the host.list file

Keyword or Input Parameter

Description

Remote

One of the following:

  • N–indicates the install will occur locally where the Installer program is running. This is the default.

  • Y–indicates the Installer program will install on a different host than where the installer is running. The originating host is a different host machine than the recipient host.

This remote keyword affects all installing hosts defined later in the host.list file until another remote keyword is specified.

Reconfigure

One of the following:

  • N–indicates the installer must perform a full install of Connect CDC. This is the default.

  • Y indicates that hosts have an existing Connect CDC installation and need to be reconfigured.

This reconfigure keyword affects all hosts defined later in the host.list file until another reconfigure keyword is specified.

host_filename = HOST_TYPE

Defines host (recipient host) on which to install Connect CDC.

  • host_filename–identifies the properties file containing the installation parameters for installing to one host. host_filename plus .properties comprises the properties filename.   

In the example above, there would be two property files names named vector.properties and mountain.properties.

  • HOST_TYPE–the recipient host operating system type. Valid operating system type is OS400. (See the Installation Guide for other types.)

Table 2. Keywords for the <host_name>.properties file

Keyword

Description

HOST_NAME

Network name or IP address of the host to install on.

HOST_USER

Required only for remote installs. Name of the remote user on the host that “owns” the installation.

This user does the remote connect and should either own the directory where Connect CDC is being installed or have permission to write to this directory.

HOST_PASS

Required only for remote installs. Password associated with HOST_USER.

Leave blank or enter <PROMPT> if you prefer to be prompted rather than save your password in a file.

JAVA_PATH

Directory where the Java executables are located on the recipient host. JAVA_PATH is required when installing to a remote host .

INSTALL_CD

Directory location of the omni.zip installation file.

The Installer requires the current working directory to be writable.

INSTALL_DIRECTORY

Directory on the installing host where Connect CDC will be installed.

LISTENER_PORT

TCP/IP port number to be reserved for Connect CDC Listener. Enter NONE if the installer is to skip the installation of the data movement kernel and Connect CDC Listener.

INITIAL_MEMORY

Initial memory setting of the Java heap memory (default, 32).

On IBM i, the number specifies the threshold at which the Java Virtual Machine begins collecting allocated memory no longer referenced and setting the memory as free and available.

MAXIMUM_MEMORY

If you enter any other value than *NOMAX, it is interpreted as a maximum memory setting.

SSL_AUTH

Flag of either “Y” or “N” that indicates whether SSL authentication is to be used. A “Y” value means that –Dssla will be passed to Connect CDC Listener.

SSL_ENCR

Flag of either “Y” or “N” that indicates whether SSL encryption is to be used. A “Y” value means that –Dssle will be passed to Connect CDC Listener.

INSTALL_CLIENT

Flag of either Y for yes or N for No, indicating whether to install the Connect CDC Console and Connect CDC Consoletools.

NUM_DRIVERS

On IBM i,specify 0 for NUM_DRIVERS. Connect CDCautomatically installs the driver.

DRIVER_ID_n

On IBM i,do not specify a DRIVER_ID for the JTOpen400 JDBC driver. Connect CDCautomatically installs the driver.

DRIVER_CLASSPATH_n

On IBM i, do not specify a DRIVER_CLASSPATH for the JTOpen400 JDBC driver. Connect CDC automatically installs the driver.

COMMAND_LIBRARY         

Name of an IBM i Command library.

This library is used by the installer to contain 2 command language programs, OMNIL and OMNIC. The former is a program that can be called to start the Connect CDC Listener, and the latter is a program that can be called to run the Connect CDC Console.

The installer creates this library if it does not already exist, and then creates a file called COMMANDS, if it does not already exist. The installer copies into COMMANDS the files that contain the command language source for the two programs and then generates the two programs.

TARGET_ONLY

Enter Y or N, depending on whether this is a target-only installation.

TRANSLATE_BINARY

Enter Y, unless you have been specifically advised by your support/services engineer.

INSTALL_JETTY

On IBM i, specify N.

INSTALL_LIBRARY

Library where the Delete Journal Receiver exit program is to be installed.

This library MUST be the same as the Change Selector install library (for example, OMNIENT). The Change Selector install library is specified on the server Properties window.