IS CDC IBM i - Installation€¦ · info sphere cdc for ibm i – installation instructions page 2 of 16 ... transfer save files to the i series server ... open a dos prompt on your

InfoSphere CDC for IBM i – Installation example

Version 1.1

IBM Information Management

INFOSPHERE CDC FOR IBM I – INSTALLATION INSTRUCTIONS PAGE 2 OF 16

TABLE OF CONTENTS

TABLE OF CONTENTS .......................................................................................................................2

INTRODUCTION .................................................................................................................................3

TRANSFER SAVE FILES TO THE ISERIES SERVER................................................................................4 Create save files on the iSeries server..................................................................................................................................................... 4 Transfer the save files from a desktop to the iSeries server.................................................................................................................... 4

INSTALL INFOSPHERE CDC FOR IBM I..............................................................................................6 Base product installation........................................................................................................................................................................... 6

Restore the installation programs from the save file .......................................................................................................................... 6 Start the installation............................................................................................................................................................................. 6

Post-installation steps............................................................................................................................................................................... 9 Add standard dmirror entry to service table........................................................................................................................................ 9

Add non-standard entry to service table ................................................................................................................................................ 12 Install latest Fix Pack .............................................................................................................................................................................. 13 Install latest InterimFix ............................................................................................................................................................................ 14 Post-installation steps for non-standard or parallel installation .............................................................................................................. 14

START CDC...................................................................................................................................15 Start DMIRROR subsystem................................................................................................................................................................... 15


INTRODUCTION

This document demonstrates the steps to install InfoSphere CDC on an iSeries (IBM i) server. It is not intended as the full installation guide and only installs from iSeries save files (the most common installation media nowadays).

There are 4 main steps required to install CDC on an iSeries server:

1. Transfer save files to the iSeries server

2. Install CDC base version + latest fix pack + latest InterimFix

3. Post-installation steps to create service (port) for CDC listener process

4. Start CDC


TRANSFER SAVE FILES TO THE ISERIES SERVER

InfoSphere CDC for IBM i is typically distributed in save files. There are 2 save files that make up the installation of the base version. Additionally, we recommend that you install the latest Fix Pack and InterimFix on top of the base installation.

For the example, we assume that CDC for IBM i version 6.1.0 is installed.

Create save files on the iSeries server To ensure that the distribution save files are in the correct format, you need to pre-create save files on the iSeries server. We recommend that you have the customer create a library to hold the save files and subsequently create the empty save files in them. Alternatively, they can use a library that already exists on the server.

5. Create library: CRTLIB LIB(DMTEMP) TEXT('InfoSphere CDC temporary library')

6. Create the save files: CRTSAVF FILE(DMTEMP/V6R1M0) CRTSAVF FILE(DMTEMP/V6R1M0TUT) CRTSAVF FILE(DMTEMP/V6R1M0UPD) CRTSAVF FILE(DMTEMP/INTERIMFIX)

Transfer the save files from a desktop to the iSeries server Now that the save files have been created, you can transfer the save files from a desktop to the server.

1. Open a DOS prompt on your desktop


2. Change to the directory that hold the save files that were part of the distribution

3. Start FTP to the iSeries server you have created the save files on and log on as the iSeries user: ftp <hostname>

4. Change to binary transfer mode: bin

5. Change the current directory (library) to the library that holds the save files: cd dmtemp

6. Send the individual save files: put v6r1m0 put v6r1m0tut put v6r1m0upd put interimfix


INSTALL INFOSPHERE CDC FOR IBM I

This section is a partly duplication of the InfoSphere CDC installation guide and just shows the screens you will pass through when installing CDC with some comments. Please refer to the installation guide for more details.

Base product installation

Restore the installation programs from the save fil e

Installation programs are restored from the save file that was transferred to the iSeries server in the previous step.

1. Restore the installation programs: RSTOBJ OBJ(DMCINSTALL) SAVLIB(V6R1M0) DEV(*SAVF) SAVF(DMTEMP/V6R1M0) RSTLIB(QTEMP)

You should get the following completion message:

Start the installation

You should prompt (F4) the DMCINSTALL command to specify the save files.

1. Type the installation command: - QTEMP/DMCINSTALL <F4> - For the device name type *SAVF and press enter


- Enter the save file names (V6R1M0 and V6R1M0TUT)

2. Hit F2 for the license agreement


3. Hit enter to start the installation

4. Enter X for the authorization code, CDC 6.1 FP1 or higher no longer requires codes.

5. Specify the product library and the library holding the tutorial files. Usually, you can accept the defaults.


If you’re doing a non-standard (or parallel) installation of CDC, specify a different DTS/400 product library to hold the programs and metadata. For example you could specify DMIRROR_P.

6. You will get several status messages.

7. After a few minutes, the installation is complete.

Post-installation steps The most important step after you install is to define a port that CDC will listen on.

Add standard dmirror entry to service table

If you’re doing a standard installation on an iSeries server, you can add a default “dmirror” service table entry.


1. Determine if the port you want to add is free. The standard listening port for CDC on iSeries is 2222. To determine if the port is free, use the NETSTAT *CNN command: - Type command NETSTAT *CNN

- Hit the F15 (shift-F3) key to subset the connections and enter 2222 for the local port

- If there are no processes listening on this port, you should see the following:


If you do see a listener on the specified port, you have to choose a different one.

2. Add the service table entry - Type the WRKSRVTBLE command

- Add a new service by selecting “1” for option and type the rest of the service information on the same line:


Please ensure that you type the service name and protocol in lowercase. - You will be prompted with the following:

Enter the text description and enter to add the service entry.

Add non-standard entry to service table If you cannot add the “dmirror” entry to the service table (for example when doing a parallel installation), you can follow the previous steps to add the non-standard entry to the service table. However, when finished there is an additional step you need to do to ensure that CDC will be listening to the correct service.

1. Change the TCP listener autostart job description. - Type the command CHGJOB JOBD(DMIRROR_P/DMTCPJOBD) and hit F4 to prompt:


- Press F10 for additional parameters and page down to find “Request data or command”, the default value for this parameter is 'STRDMTCP'. - Change the request data to reference the service you just created, as an example we have chosen service name dmirror_p .

Please note that the command must be enclosed in single quotes. Also, the service name must be enclosed in quotes and to let the command process correctly interpret the quotes, you have to add an additional for each quote around the service name. So, the '' are 2 single quotes.

Install latest Fix Pack Installation of fix packs must be done while CDC is not running. It is best to do this immediately after the installation of the base version.

All objects that were changed as part of the fix pack are kept in the V6R1M0UPD save file that was transferred in a previous step.

2. Restore the objects from the save file. It is best to prompt (F4) the RSTOBJ command and fill out the correct parameters. Alternatively you ran run the RSTOBJ command will all parameters specified on the command line.

3. RSTOBJ OBJ(*ALL) SAVLIB(V6R1M0UPD) DEV(*SAVF) SAVF(DMTEMP/V6R1M0UPD) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(DMIRROR)


4. Make sure you specify CDC 6.1 library for the RSTLIB parameter

5. You may see messages that security or data format changes have occurred; you can safely ignore these messages

Install latest InterimFix Installation of interim fixes (individual fixes or enhancements which have not been gathered in a fix pack yet) must be done while CDC is not running. It is best to do this immediately after the installation of the latest fix pack.

All objects that were changed as part of the fix pack are kept in the INTERIMFIX save file that was transferred in a previous step.

1. Restore the objects from the save file. It is best to prompt (F4) the RSTOBJ command and fill out the correct parameters. Alternatively you ran run the RSTOBJ command will all parameters specified on the command line.

2. RSTOBJ OBJ(*ALL) SAVLIB(INTERIMFIX) DEV(*SAVF) SAVF(DMTEMP/INTERIMFIX) MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(DMIRROR)

3. Make sure you specify CDC 6.1 library for the RSTLIB parameter

4. You may see messages that security or data format changes have occurred; you can safely ignore these messages

Post-installation steps for non-standard or parallel installation If you have done a non-standard installation or want to run multiple instances of CDC on the same server, additional steps are required to ensure the instances can run in parallel. In the example below, we have assumed CDC has been installed in DMIRROR_P.

1. Rename the DMIRROR subsystem to match the library name you have chosen for the install. Although not mandatory, it is good practice to have the subsystem name match the name of the CDC installation library for easier management. - RNMOBJ OBJ(DMIRROR_P/DMIRROR) OBJTYPE(*SBSD) NEWOBJ(DMIRROR_P)

2. Change the CDC registry to update the product library and subsystem name. - CHGCURLIB CURLIB(DMIRROR_P) - TSSETREG PRODLIB(DMIRROR_P) SUBSNAME(DMIRROR_P)

3. Check (and change) the CDC user profile for the current library. This is required to avoid the TCP listener job starting in the wrong subsystem. - CHGUSRPRF USRPRF(D_MIRROR) CURLIB(*CRTDFT)

4. Change the job description DMIRROR_P/DMTCPJOBD in the product library to have the request data as ‘STRDMTCP SERVICE(‘‘dmirror_p’’)’ instead of STRDMTCP

5. Start the DMIRROR_P subsystem. This then submits a second TCPLISTEN job under the D_MIRROR user profile. The end result is that multiple concurrent instances of CDC can be started with the associated listener automatically running and the correct current library, as this is inherited from the initial TCPLISTEN job.

If the listener needs to be started outside of the autostart job issue the STRDMTCP command manually. The user must have additional privileges to the D_MIRROR user profile

• Give the operational user profile a minimum of *USE authority to the D_MIRROR user profile and the DMIRROR_P library - GRTOBJAUT OBJ(QSYS/D_MIRROR) OBJTYPE(*USRPRF) USER(*PUBLIC) AUT(*USE)


START CDC

The CDC listener is started when the DMIRROR subsystem becomes active.

Start DMIRROR subsystem 1. Start the subsystem

- STRSBS DMIRROR/DMIRROR or, if this was a non-standard installation: - STRSBS DMIRROR_P/DMIRROR_P

2. Check if the TCP listener job has become active - WRKACTJOB SBS(DMIRROR) or, if this was a non-standard installation: - WRKACTJOB SBS(DMIRROR_P) - If the listener has become active, you will see the TCPLISTEN job under the DMIRROR or DMIRROR_P subsystem

- You can view which port the listener is listening to, by displaying the job log - Enter option “5” before the TCPLISTEN job

- Enter option 10 on the menu that is shown


- Hit F10 for detailed messages

Once the listener has been started, you can create the datastore in the Management Console and start creating subscriptions and mapping tables.

Documents

IS CDC IBM i - Installation€¦ · info sphere cdc for ibm i – installation instructions page 2 of 16 ... transfer save files to the i series server ... open a dos prompt on your