Infosphere Change Data Capture Version 6.5.2
Total Page:16
File Type:pdf, Size:1020Kb
IBM InfoSphere Change Data Capture Version 6.5.2 InfoSphere Change Data Capture for DB2 for Linux, UNIX and Windows, Version 6.5.2 End-User Documentation IBM InfoSphere Change Data Capture Version 6.5.2 InfoSphere Change Data Capture for DB2 for Linux, UNIX and Windows, Version 6.5.2 End-User Documentation Note Before using this information and the product it supports, read the information in “Notices” on page 121. First edition, third revision This edition applies to version 6, release 5, modification 2 of IBM InfoSphere Change Data Capture (product number 5724-U70) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 2008, 2011. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About InfoSphere CDC and InfoSphere To delete an instance of InfoSphere CDC (UNIX CDC Management Console ......1 and Linux) .............31 Capturing change data with single scrape ....3 Configuring InfoSphere CDC for OS What’s new .............5 (operating system) clustering (UNIX and Linux) .............33 System requirements .........7 Performing a forced or manual failover of Supported operating systems and processors . 7 InfoSphere CDC .............33 Supported databases............8 Preparing for a failover of InfoSphere CDC....34 Disk space requirements ..........9 RAM requirements ............10 Configuring InfoSphere CDC for a DB2 Port requirements ............11 High Availability Disaster Recovery (HADR) environment .........35 Before you install ..........13 Starting replication to the new primary server after Required database, user accounts, and schemas . 13 a failover ...............35 Enabling database log retention........14 Changing the IP address or hostname of the target Creating a database backup .........14 datastore for a subscription .........36 Assessing disk space and memory requirements . 14 To create an alias for the IP address or hostname Sizing considerations for the staging store ....15 of the standby server ..........36 Calculating database connections required by To update the IP address or hostname of the InfoSphere CDC .............16 target datastore for a subscription after a failover. 37 Replicating XA transactions .........18 Configuring remote log reading Installing InfoSphere CDC ......19 (Windows, UNIX, and Linux) .....39 Installing InfoSphere CDC using an interactive To configure remote log reading (Windows, UNIX, installation ..............19 and Linux) ..............39 To install InfoSphere CDC (Windows) ....19 To install InfoSphere CDC (UNIX and Linux) . 20 Replicating data in a DB2 pureScale To override the locale for the installation (UNIX and Linux) .............20 environment ............41 Installing InfoSphere CDC using a silent installation 21 To perform a silent installation of InfoSphere Replicating data in a Database CDC (UNIX and Linux) .........21 Partitioning Feature (DPF) environment 43 Sourcing a DPF environment with InfoSphere CDC 43 Configuring InfoSphere CDC for DB2 InfoSphere CDC behavior in a DPF source for LUW (Windows) .........23 environment .............43 Configuring InfoSphere CDC for DB2 for LUW Best practices for InfoSphere CDC in a DPF instances (Windows) ...........23 source environment...........45 To add a new instance of InfoSphere CDC for Adding a partition in a DPF source environment 45 DB2 for LUW (Windows) .........23 Dropping a partition in a DPF source To edit an instance of InfoSphere CDC environment .............46 (Windows)..............26 Using the REDISTRIBUTE DATABASE To delete an instance of InfoSphere CDC PARTITION GROUP command in DB2 for LUW . 47 (Windows)..............26 Targeting a DPF environment with InfoSphere CDC 47 Replicating LOB or XML data to a target DPF Configuring InfoSphere CDC (UNIX and environment .............47 Linux) ...............29 After you install and configure ....49 Configuring InfoSphere CDC instances (UNIX and Starting InfoSphere CDC ..........49 Linux) ................29 To start InfoSphere CDC (Windows) .....49 To add a new instance of InfoSphere CDC (UNIX To start InfoSphere CDC (UNIX and Linux) . 49 and Linux) .............29 Replicating DB2 LUW identity columns ....49 To edit an instance of InfoSphere CDC (UNIX Stopping InfoSphere CDC .........50 and Linux) .............31 To stop InfoSphere CDC (Windows) .....50 © Copyright IBM Corp. 2008, 2011 iii To stop InfoSphere CDC (UNIX and Linux). 51 dmdescribe - Describe source tables .....81 Maintaining active TCP connections in a network dmflagforrefresh - Flag for Refresh .....82 environment ..............51 dmmarktablecapturepoint - Mark a table capture To maintain active TCP connections .....51 point on a source table .........82 Enabling SQL statements in Management Console 52 dmpark - Park table ..........83 To enable SQL statements in Management dmreaddtable - Update source table definition. 84 Console...............52 dmreassigntable - Update target table definition 85 dmsetreplicationmethod - Set replication method 86 Upgrading Transformation Server . 53 Monitoring replication commands .......87 Upgrading Transformation Server version 6.0 and dmclearevents - Clear events .......87 above ................53 dmgetsubscriptionstatus - Get subscription status 88 To upgrade multiple instances of Transformation dmshowevents - Display InfoSphere CDC events 89 Server for DB2 UDB version 6.0 and above Refresh performance commands .......90 (Windows)..............53 dmviewrepairsql - View SQL repair statements 91 To upgrade multiple instances of Transformation dmrunrepairsql - Run SQL repair statements . 92 Server for DB2 UDB version 6.0 and above Single scrape and staging store commands ....93 (UNIX and Linux) ...........54 dmclearstagingstore - Remove cached operations Upgrading InfoSphere CDC version 5.2 .....54 from the staging store ..........93 To upgrade Transformation Server for DB2 UDB dmgetstagingstorestatus - Retrieve Staging Store version 5.2 (Windows) ..........54 status ...............93 To upgrade Transformation Server for DB2 UDB Other commands ............94 version 5.2 (UNIX and Linux) .......54 dmbackupmd - Backup Metadata ......94 dmconfigurets - Configure InfoSphere CDC . 95 Updating the InfoSphere CDC dmmdcommander ...........95 dmmdconsole ............95 bookmark format for DB2 LUW version dmset - Set InfoSphere CDC system parameter 95 9.7................57 dmshowversion - Show InfoSphere CDC version 96 To update the InfoSphere CDC bookmark format for dmshutdown - Shut down InfoSphere CDC . 96 DB2 LUW version 9.7 ...........57 dmsupportinfo - Collect IBM Support information .............98 Metadata tables ...........59 dmterminate - Terminate InfoSphere CDC processes ..............99 Data types supported by InfoSphere dmts32 - Start InfoSphere CDC ......100 CDC................61 dmts64 - Start InfoSphere CDC ......100 User exits for InfoSphere CDC ....103 Commands for InfoSphere CDC ....63 Stored procedure user exits for table and row level Using the InfoSphere CDC commands .....63 operations ..............103 Setting the TSINSTANCE environment variable . 64 Defining a stored procedure user exit ....103 Continuous Capture commands .......64 Stored procedure user exit database connections 104 dmenablecontinuouscapture - Enable Continuous Retrieving data with a stored procedure user Capture ..............65 exit ................104 dmdisablecontinuouscapture - Disable Example of a stored procedure user exit . 110 Continuous Capture ..........65 Sample Java class user exits for InfoSphere CDC 111 Controlling replication commands .......66 To compile the Java class sample user exits dmendreplication - End replication .....66 (Windows) .............111 dmrefresh - Refresh subscription ......70 To compile the Java class sample user exits dmstartmirror - Start mirroring .......71 (UNIX and Linux) ...........112 Database transaction log commands ......73 InfoSphere CDC API reference – Javadocs ....113 dmdecodebookmark - Display verbose information bookmark..........73 Conflict resolution audit table ....115 dmsetbookmark - Set bookmark ......74 dmshowbookmark - Display bookmark Structure of the conflict resolution audit table . 115 information .............76 Row image format............117 dmshowlogdependency - Show Log Dependency 78 Truncated images ............117 Exporting and importing configuration commands 79 Unaudited data types...........117 dmexportconfiguration - Export InfoSphere CDC Configuration ............79 Troubleshooting and contacting IBM dmimportconfiguration - Import InfoSphere CDC Support ..............119 Configuration ............80 Managing tables for replication commands ....81 Notices ..............121 iv InfoSphere Change Data Capture: End-User Documentation Trademarks ..............123 Contents v vi InfoSphere Change Data Capture: End-User Documentation About InfoSphere CDC and InfoSphere CDC Management Console IBM® InfoSphere® Change Data Capture (InfoSphere CDC) is a replication solution that captures database changes as they happen and delivers them to target databases, message queues, or an ETL solution such as InfoSphere DataStage® based on table mappings configured in the InfoSphere CDC Management Console GUI application. InfoSphere CDC provides low impact capture and fast delivery of data changes for key information management initiatives including dynamic data warehousing, master data management, application consolidations or migrations, operational BI, and enabling SOA projects.