InfoSphere CDC for IBM i Installation

example

Version 1.1

IBM Information
Management

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

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 2 OF 16

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

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 3 OF 16

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

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 4 OF 16

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

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 5 OF 16

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 file
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

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 6 OF 16

- Enter the save file names (V6R1M0 and V6R1M0TUT)

2. Hit F2 for the license agreement

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 7 OF 16

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.

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 8 OF 16

If youre 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 youre doing a standard installation on an iSeries server, you can add a default dmirror
service table entry.

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 9 OF 16

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:

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 10 OF 16

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:

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 11 OF 16

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:

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 12 OF 16

- 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)

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 13 OF 16

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)

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 14 OF 16

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

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 15 OF 16

- 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.

INFOSPHERE CDC FOR IBM I INSTALLATION INSTRUCTIONS

PAGE 16 OF 16