Install Connect CDC using the GUI installer - Connect_CDC - connect_cdc_mimix_share - Latest

The GUI Installer may be used to perform the installation on a remote machine running IBM i where the local machine runs UNIX or Windows.

The GUI Installer may be used to perform an initial full install of Connect CDC or a reconfiguration of an existing installation. If the installer finds an existing <host>.ini file (as described GUI or Batch Installer) created during a previous installation, a subsequent installation automatically runs reconfiguration. If you do not want to run reconfiguration, delete the <host>.ini file.

Described below are the GUI windows and the information requested for installing Connect CDC. The appearance of the window varies slightly depending on the platform.

1. Start the GUI installer.

   • When the originating host is UNIX, execute the GUI installer with the command:   

   sh ginstaller.sh

   • When the originating host is Windows, execute the command:

   ginstaller.cmd

   The installation wizard displays in which you set constants for the operating system.

   The following table describes the Welcome Window fields.

   Field	Description
   Host	Defaults to the local machine. For remote install, enter the name or IP address of the remote host.
   Operating System	Defaults to the operating system on the local machine. Select the operating system type that matches the installing host machine.
   User ID	(Remote installs only) Enter the userid for logging on to the remote host.
   User Password	(Remote installs only) Enter the password for logging on to the remote hosts.

2. Read and accept the license agreement.

   The Java binary directory window displays.

   

3. Enter the path where the Java program is located, for example:

   /usr/java8/bin/

   Note: For the Java installer, use the forward slash for all paths specified during install.
4. Click Next.

   The Installation Target Directory window displays.

   

5. Identify the directory where Connect CDC is to be installed. If installing remotely, the directory must be accessible to the remote host. As noted in Prepare your IBM i Environment, the installation directory must be created prior to the installation and must be created in the IBM i UNIX interface strqsh or iSeries Navigator under the integrated file system Root structure.

   Note the following:

   • The Browse button does not appear for remote installs or for reconfigurations.

   • For reconfigurations, The destination folder contains with information that was set during the previous installation or reconfiguration. It cannot be changed

6. Click Next.

   The OS400 Installation Parameters window displays.

7. Enter the name of the Install library where commands to start Connect CDC Listener and Connect CDC Console may be installed. The install creates and attempts to start the Connect CDC Listener in a subsystem called ConnectCDC from the Install library specified. If the Install library does not exist, the installer creates it. The recommended Install library is OMNIENT where the Change Selector is installed.

   Keep in mind the following:

   • You must install one exit program for each Connect CDC installation library on each IBM i source host where you want the journal receiver to be controlled by the Delete Journal Receiver exit program.

   • You should not install the Delete Journal Receiver exit program on an i5 system used as a target.

   • If you intend to have the system delete receivers you can use the Delete Journal Receiver exit program. The exit program is described in the Getting Started Guide.

   Note: You are not required to have the system delete receivers. You could delete the receivers manually or rely on another program (such as the Connect CDC Journal Manager) to delete the receivers.

   Installation may fail to activate the Delete Journal Receiver exit program if the user is not using a user profile that allows execution of this command on the IBM i host to which you are connecting. However, if activation fails due to privileges, the install will still continue and you can issue the ADDEXITPGM command later to activate the exit program:

   • After the exit program has been installed, check whether it was installed and activated properly. You can issue the WRKREGINF command:

   WRKREGINF EXITPNT(QIBM_QJO_DLT_JRNRCV)

   Alternately, you can inspect the install.log.

   • Then, if the exit was not enabled by the installer, issue the ADDEXITPGM. This command uses the optional program data parameter so that you run the exit as OMNIENT.

   By default, the exit runs with QUSER authority, but instead run the exit program under the privileges of the user name specified in the program data:

   ADDEXITPGM EXITPNT(QIBM_QJO_DLT_JRNRCV) FORMAT(DRCV0100)PGMNBR(*LOW) PGM(OMNIENT/ORDLTRCV) PGMDTA(65535 10 OMNIENT)TEXT('Omni Delete Receiver exit') 

   For reconfiguration, the command library fills in with whatever was set during the previous installation or reconfiguration.

8. Click Next.

   The Installation Components window displays.

   
9. Select the Connect CDC components to be installed, then click Next.

   The Database Selection window displays.

   

10. Select the database types that will participate in data movement on this recipient host.

    For reconfiguration, the database type selected is set according to what was chosen in the previous install.

    Normally, you would set the path for the JDBC driver. However, the JDBC driver for IBM i is automatically installed and does not require a driver path.

    For reconfiguration, the driver path contains the value provided in the previous install or reconfiguration.

11. Click Next.

    The Listener Port window displays.

    

12. Specify an available TCP/IP port number for use by Connect CDC Listener. The installer assumes the port is free if the port is not active.

    For reconfiguration, The port number contains the value specified in the previous installation or reconfiguration.

    When reconfiguring an installation, Connect CDC Listener must be shut down prior to installing or the Installer assumes the port is in use by another service

13. Click Next.

    The JVM Memory Specifications window displays.

    

14. Specify the amount of memory in megabytes to use for data movement. The minimum memory is the threshold at which the Java Virtual Machine begins collecting allocated memory no longer referenced and setting the memory as free and available. In the Max. Memory field, if you enter any other value than *NOMAX, it is interpreted as a maximum memory setting.

    For reconfigurations, the memory minimum and maximum parameters contain the values specified in fill in the previous installation or reconfiguration.

15. Click Next.

    The Secure Sockets Options window displays.

    

16. Select the Secure Socket Layer options to use in all network communications with the recipient host.

    For reconfigurations, the SSL option selected is the one chosen in the previous installation or reconfiguration.

17. Click Next.

    The summary window displays your selections.

    

18. Do one of the following:

    • If the selections are correct, click Install.

    • If the selections are incorrect, click Back and make changes.

    • For reconfigurations, click Reconfig to continue.

    If the install is successful, you will receive an installation successful message.

19. Click OK to close.

    The final window shows the installation results.

20. Click Finish to end the installation process.