+
Search Tips
|
Advanced Search
Tivoli Directory Integrator
Introduction
Users Guide
Administrator Guide
Reference Guide
Message Guide
Problem Determination Guide
Plugins Guide
Introduction
Introduction
Install the tutorial files
Publications
Accessibility
Overview
Kernel/Component Architecture
Entry-Attribute-value data model
Data flows = AssemblyLines
Tutorial
Create our first AssemblyLine
Run the Assemblyline
Null Behavior: Dealing with missing Attributes/values
Debug the AssemblyLine
Looking up data from a sequential source
Using Lookup Mode
Inheritance
Lookup search rules = Link Criteria
Deciphering Run errors
Event-driven integration
Scheduling AssemblyLines
Service request AssemblyLines
Hardening your Integration Solutions
Legibility, re-use and configurability
Logging and auditing
Connectivity problems
AssemblyLine availability
Scaling and performance
Monitoring
The AssemblyLine Debugger
EasyETL Guide
Creating a Project
Detecting Changes
Notices
Users Guide
General Concepts
The AssemblyLine
Connectors
Connector modes
Iterator mode
Multiple Iterators in an AssemblyLine
Using the Iterator mode
Providing an Initial Work Entry (IWE)
Lookup mode
Using the Lookup mode
AddOnly mode
Using the AddOnly mode
Update mode
Using the Update mode
Delete mode
Using the Delete mode
CallReply mode
Using the CallReply mode
Server mode
Server Mode and the ALPool
Using the Server Mode
Delta mode
Delta Detection
Delta Application (Connector Delta Mode)
Link Criteria
Simple Link Criteria
Advanced Link Criteria
Functions
Script Components
AttributeMaps
Null Behavior
Branch Components
Exiting a Branch (or Loop or the AssemblyLine Flow)
Parsers
Character Encoding conversion
Access our own Java classes
Instantiating the classes using the Config Editor
Runtime instantiation of the classes
AssemblyLine flow and Hooks
Handle termination and cleanup for critical errors
Control the flow of an AssemblyLine
Expressions
Expressions in component parameters
Expressions in LinkCriteria
Expressions in Branches, Loops and Switch/Case
Scripting with Expressions
The Entry object
Scripting in TDI
Internal data model: Entries, Attributes and Values
Working with hierarchical Entry objects
Integrating scripting into our solution
Control execution with scripting
Using variables
Using properties
Control points for scripting
Scripting in an AssemblyLine
Script Component
AssemblyLine Hooks
Server Hooks
Calling Server Hooks from script
Accessing AssemblyLine components inside the AssemblyLine
AssemblyLine parameter passing
Task Call Block (TCB)
Basic Use
Starting an AssemblyLine with operations
Using an accumulator
Disabling AssemblyLine components
Providing an Initial Work Entry (IWE)
Scripting in a Connector
Setting internal parameters by scripting
Scripting in a Parser
Java + Script ≠ JavaScript
Data Representation
Ambiguous Function Calls
Char/String data in Java versus JavaScript Strings
Variable scope and naming
Instantiating a Java class
Using binary values in scripting
Using date values in scripting
Using floating point values in scripting
The Configuration Editor
The Project Model
The TDI Servers view
The TDI Project
Configuration Files
The Project Builder
Properties and substitution
The User Interface Model
The User Interface
The Application Window
Servers view
The Expression editor
The AssemblyLine Editor
AssemblyLine Options
Component panels
User Documentation View
Run AssemblyLine window
Attribute Mapping and Schema
Input Attribute mapping
Output Attribute mapping
The Connector Editor
Creating a Connector
Input and Output Attribute Maps
Hooks
Connection
Parser
Link Criteria
Connection Errors
Delta
Pool
Connector Inheritance
Server Editor
Schema Editor
Data Browser
Generic Data Browser
Stream Data Browser
JDBC Data Browser
LDAP Data Browser
Forms Editor
Wizards
Import Configuration Wizard
New Component Wizard
Connector Configuration form characteristics
Run and debug AssemblyLines
AssemblyLine Reports
Run the AssemblyLine
The stepper and debugger
Server Debugging
Run Options
Choosing the Server
Team Support
Sharing a project
Using a shared project
The Problems View
JavaScript Enhancements
Code Completion
Syntax Coloring
Syntax Checking
Local Evaluation
External Editors
Solution Logging and Settings
System Store settings
Logging
Tombstones
Java Libraries
AutoStart
Solution Interface settings
Server Properties
Inheritance
Actions and Key Bindings
Debugging features in TDI
Sandbox
Recording AssemblyLine input
Sandbox playback of AssemblyLine recordings
AssemblyLine Simulation Mode
Proxy AssemblyLine workflow
Simulation script workflow
Easy ETL
System Store
User Property Store
Delta Store
Store Factory methods
Property Store methods
UserFunctions (system object) methods
Deltas
Delta Features
Delta Entry
Producing Delta Entries
Delta feature for Iterator mode
Change Detection Connectors
Consuming Delta Entries
Delta Mode Connectors
Update Mode and Delta Entries
Examples
What's new for IBM TDI version 7.1
Overview of IBM TDI version 7.1
Deprecated or removed functionality and components
The Configuration Editor
The Administration and Monitoring Console and Action Manager
Server, server API, and server components enhancements
AssemblyLine components enhancements
Documentation enhancements
Installation enhancements
Parsers, connectors and function components
Javadocs, tooling and scripting
Password plug-in enhancements
IBM TDI terms
Notices
Administrator Guide
PDF version
TDI Library
Accessibility
IBM Software support
IBM TDI 7.1 Editions
Before you install
Disk space requirements
Memory requirements
Platform requirements
Components in IBM TDI
Other requirements
Root or Administrator Privileges
Security Enhanced (SELinux)
Authentication of AMC on Unix/Linux
Installing IBM TDI
Launching the appropriate installer
Using the platform-specific TDI installer
Before you install
Installing IBM TDI on i5/OS
Java virtual machine version
PTF versions
Installation
Installing using the graphical installer
Install Panel flow
Uninstall Panel flow
Add Feature Panel flow
Migration Panel flow
Installing using the command line
Temporary file space usage during installation
Performing a silent install
Post-installation steps
CE Update Site
Plugins
Administration and Monitoring Console (AMC)
General information
Bundled embedded web platform deployment
Customer or deferred deployment
Documentation
Migration
Installing local Help files
Deploying AMC to a custom ISC SE or Tivoli Integrated Portal (ISC embedded)
Installing or Updating using the Eclipse Update Manager
Post-installation steps
Uninstalling
Launching the uninstaller
Performing a silent uninstallation
Default installation locations
Update Installer
The .registry file
Installing fixes
Rollback
Troubleshooting
Supported platforms
Virtualization support
Migrating
Migrate files to a different location
Which files do not need to be modified to be used in another location?
Which files need to be modified before they can be used in another location?
Which files should not be used in another location under normal circumstances?
Migrating files that contain encrypted data
Migrate files to a newer version
Installer-assisted migration
Tool-assisted migration
Manual migration
Backing up important data
Files backed up by the Installer
Upgrade from version 6.0 to 7.1
Upgrade from version 6.1.x to 7.1
Upgrade from version 7.0 to 7.1
Backup tools
Manual backup
Migrating AMC 7.x configuration settings to another AMC deployment
Converting from EventHandlers to corresponding AssemblyLines
TCP Server Connector
Mailbox Connector
JMX Connector
SNMP Server Connector
IBM Directory Server Changelog Connector
HTTP Server Connector
LDAP Server Connector
Netscape/iPlanet/Sun Directory Changelog Connector
Active Directory Change Detection Connector
z/OS LDAP Changelog Connector
DSMLv2SOAPServerConnector
Migrating BTree tables and BTree Connector to System Store
Migrating Cloudscape database to Derby
Migrating global and solution properties files using migration tool
Migrating Password plug-ins properties files using migration tool
Security and TDI
Introduction
Manage keys, certificates and keystores
Background
Public/private keys and certificates
Secret keys
Keystores
Keys for SSL
Keys for encryption
Tools
List the contents of a keystore
Create keys
Secure Sockets Layer (SSL) Support
Server SSL configuration of TDI components
Client SSL configuration of TDI components
SSL client authentication
IBM TDI and Microsoft Active Directory SSL configuration
Summary of properties for enabling SSL and PKCS#11 support
SSL example
TDI component as a server
TDI component as a client
Remote Server API
Introduction
Configuring the Server API
Remote Server API access on a Virtual Private Network
Server API access options
Server API SSL remote access
Using Server API specific SSL properties
Using the standard SSL Java System properties
Server API authentication
Local client session
Remote client session
JAAS authentication
SSL-based authentication
Username/password based authentication
Authentication hook
An example authentication hook
LDAP Authentication support
LDAP Authentication Configuration
LDAP Authentication Logic
LDAP Group Support
Host based authentication
Summary of Server API Authentication options
Server API JMX layer does not support username and password authentication
Server API authentication setup examples
Server API Authorization
Authorization roles
Server API User Registry
Server Audit Capabilities
Auditing scope
Suppression of notifications
Sending notifications
TDI Server Instance Security
Stash File
Server Security Modes
Working with encrypted TDI configuration files
Introduction
Separation of certificates for PKI Encryption and SSL
Creating an encrypted TDI configuration file from scratch
Using the cryptoutils command line tool
Editing an encrypted TDI configuration file
Standard TDI encryption of global.properties or solution.properties
Encryption of properties in external property files
The TDI Encryption utility
TDI System Store Security
Miscellaneous Config File features
The "password" configuration parameter type
Component Password Protection
Saving passwords to configured Properties
Protecting attributes from being printed in clear text during tracing
Encryption of TDI Server Hooks
Remote Configuration Editor and SSL
Using the Remote Configuration Editor
Summary of configuration files and properties dealing with security
Web Admin Console Security
Miscellaneous security aspects
HTTP Basic Authentication
Lotus Domino SSL specifics
Certificates for the TDI Web service Suite
Example Server certificate creation
MQe authentication with mini-certificates
Reconnect Rule Engine
Introduction
Reconnect Rules
User-defined rules configuration
Examples
Exception considerations
General reconnect configuration
System Queue
System Queue Configuration
WebSphere MQe parameters
WebSphere MQ parameters
Microbroker parameters
JMSScript Driver parameters
The env JavaScript object
The ret JavaScript object
JavaScript example for Fiorano MQ
System Queue Configuration Example
Security and Authentication
Encryption
Authentication
MQe Configuration Utility
Authentication of MQe messages to provide MQe Queue Security
Support for DNS names in the configuration of the MQe Queue
Configuration of High Availability for MQe transport of password changes
Providing remote configuration capabilities in the MQe Configuration Utility
Encryption and FIPS mode
Configuring TDI to run FIPS mode
Symmetric cipher support
FIPS encryption
Connectors, Function Components, Parsers
The TDI server and FIPS
Enabling FIPS mode
Running auxiliary tools in FIPS mode
Configuring FIPS properties for TDI
Configuring SSL and PKI certificates
Encrypting and decrypting using CryptoUtils
Working with certificates
Comparing CA-signed and Self-signed certificates
Configuring certificates using PKI and SSL
Using cryptographic keys located on hardware devices
Using IBMPCKS11 to access devices and to store SSL keys and certificates
Enabling or disabling padding
Maintaining encryption artifacts - keys, certificates, keystores, encrypted files
Changed encryption key
Changed password for encryption key or keystore
Expired encryption certificate
Configuring the TDI Server API
Server ID
Exception for password protected Configs
Server RMI
Config load time-out interval
Properties
Working with properties
Migrating using properties and the tdimiggbl tool
Global properties
Solution properties
Java properties
System properties
System Store
Property stores
Password Store
User property stores
Third-party RDBMS as System Store
Oracle
MS SQL Server
IBM DB2 for z/OS
DB2 for other OS
IBM SolidDB
Using Derby to hold your System Store
Configuring Derby Instances
Starting Derby in networked mode
Enabling user authentication in System Store
Create statements for System Store tables
Backing up Derby databases
Troubleshooting Derby issues
Pre-6.0 (properties file) configuration of Cloudscape
See also
Command-line options
Configuration Editor
Server
Command Line Interface - tdisrvctl utility
Command Line Reference
Operations
Other points to note
Logging and debugging
Script-based logging
Logging using the default Log4J class
Log Levels and Log Level control
Log4J default parameters
Creating our own log strategies
Tracing and FFDC
Tracing Enhancements
Understanding Tracing
Configuring Tracing
Setting trace levels dynamically
Useful JLOG parameters
Administration and Monitoring
Installation and Configuration
Deploying AMC into the Integrated Solutions Console (ISC)
Deploying AMC as a Windows service or UNIX process using the TDI installer
Starting the Administration and Monitoring Console and Action Manager and logging in
Enabling AMC
Running Action Manager remotely
AMC and Action Manager startup
AMC and Derby shutdown
Action Manager remote startup
Action Manager shutdown
AMC Logs
Backward Compatibility with previous versions of TDI
AMC in the Integrated Solutions Console
Console user authority
Administrator and the iscadmins group
Action Manager
Enabling Action Manager
Action Manager status in real time
AMC force trigger for a given rule
AMC and Action Manager security
Introduction
AMC and SSL
AMC and remote TDI server
AMC and role management
AMC and passwords
AMC and encrypted configs
Administation and Monitoring Console User Interface
Log in and logout of the console
AMC Console Layout
Logging off the console
Using AMC tables
Select action drop-down menu
Paging
Sorting
Finding
Filtering
Servers
Add a server
Modify a server
Console Properties
General
SSL
JDBC Properties
Solution Views
Configure ACLs
Local variables
Add a Solution View
Config files (allows loading/reloading of configurations)
Custom load
Monitor Status and Action Manager
Monitor Status
Solution View Details
Solution View Details Table
Columns
Actions
Start AssemblyLine
Start AssemblyLine synchronously
Start AssemblyLine in simulate mode
View Tombstones
Delete Tombstones
View Logs
Action Manager results table
Columns
Actions
Server Information
View Components
Show Preferred Solution Views
Action Manager
Add/Edit configuration rules
Configuration rules settings
Configure trigger
Configured actions
Add/Modify Action
Substitute variable for event data
Triggers that can produce event data
Actions that can access event data
View Rules Summary
Property Stores
Select Solution View
Solution Properties
Global Properties
Java Properties
System Properties
Password Store
User Property Store
Log Management
Preferred Solution Views
AMC and AM Command line utilities
Example walkthrough of creating a Solution View and Rules
Touchpoint Server
Touchpoint concepts
Touchpoint Server
Touchpoint Provider
Touchpoint Type
Touchpoint Instance
Touchpoint Template
Resource Persistence
Touchpoint Schema
Touchpoint Server communication protocol
Touchpoint Configuration
Instance Configuration
Destination Configuration
Touchpoint Instance communication protocol
Provider Touchpoint
Initiator Touchpoint
Intermediary Touchpoint
Representation of Entry objects as HTTP content
Touchpoint Status Entry schema
Property sheet definitions
XML Schema locations
Error flows
Configuration
Authentication
Examples
Shipped example
Example steps for creating a Touchpoint Instance using a JDBC Connector
Provider Touchpoint Instance
Initiator Touchpoint Instance
Intermediary Touchpoint Instance
Tombstone Manager
Introduction
Configuring Tombstones
Configuration Editor Configuration screen
AssemblyLine Configuration screen
The Tombstone Manager
Tombstone Manager
Multiple TDI services
IBM TDI as Windows Service
Introduction
Installing and uninstalling the service
Installing the service
Uninstalling the service
Starting and stopping the service
Manual start and stop
Changing service startup type
Logging
Configuring the service
IBM TDI as Linux/UNIX Service
Deployment methods
Tailoring /etc/inittab
IBM TDI as z/OS Service
USS process
Normal z/OS started task
IBM TDI as i5/OS Service
Command line support
z/OS environment Support
Post install configuration
Using MQe for system queue
Default encoding different than IBM-1047
JDK 5.0 not located at /usr/lpp/java/J5.0
Running TDI
Reading License Files
Using the Remote Configuration Editor on z/OS
Handling configuration and properties files
Using ASCII mode
Configuring the TDI task to log to its SYSOUT
Appendix A. Dictionary of terms
IBM TDI terms
Appendix B. Example Property files
Log4J.properties
jlog.properties
derby.properties
global.properties
Appendix C. Monitoring with external tools
Monitoring TDI with ITM
Short presentation of the ITM architecture
Importing an existing Agent configuration in ITM Agent Builder 6.2
Creating a TDI agent for ITM using ITM Agent Builder 6.2
Generating the ITM Agent
Configuring the ITM Agent
Monitoring TDI data
Defining thresholds
Creating links between tables
Purpose of links
Construction of links
Send custom notifications to ITM
Limitations
Monitoring TDI using OMNIbus
Introduction
Configuring the EIF probe props file
Determine the severity for the events
Working with the EventPropertyFile.properties file
Send custom notifications to OMNIbus
Appendix D. Notices
Third-Party Statements
ICU License - ICU 1.8.1 and later
Trademarks
Reference Guide
PDF version
TDI 7.1 FlowDiagrams
Reference Guide
Preface
Who should read this book
Publications
IBM TDI library
Related publications
Accessing publications online
Accessibility
Accessibility features
Keyboard navigation
Interface Information
Vendor software
Related accessibility information
Contacting IBM Software support
Introduction
Connectors
Connector availability and reference
Connector Interfaces
Legend for the Supported Mode columns
Script-based Connectors
Configurations
Connector re-use
Active Directory Change Detection Connector
Tracking changes in Active Directory
Deleted objects in Active Directory
Moved objects in Active Directory
Use objectGUID as the object identifier
Change detection
Change detection mechanism
Offline and Paged results cases
Using the Active Directory Change Detection Connector
Authentication of the Connector to the directory
Error flows
Configuration
See also
AssemblyLine Connector
Configuration
Using the Connector
Attribute Mapping (Schema) and modes
AssemblyLine Parameters
See also
Axis Easy Web Service Server Connector
Hosting a WSDL file
Schema
Input Schema
Output Schema
Configuration
Parameters
Connector Operation
See also
Axis2 Web Service Server Connector
Comparison between Axis1 and Axis2 components
SOAP encoding support
Popularity of the RPC/encoded model
Using the Connector
Supported Message Exchange Patterns
SOAP Faults
SOAP Headers
The HTTP Transport Layer
WSDL Generation
Schema
Input Schema
Output Schema
Configuration
Security and Authentication
Encryption
Authentication
Authorization
See also
Command line Connector
Native-encoded output on some operating systems
Some words on quoting
Configuration
Examples
See also
Database Connector
Configuration
Direct TCP /URL scripting
TCP
URL
Domino/Lotus Notes Connectors
Session types
Post Install Configuration
If we create Local Client Session, perform the following:
If we create Local Server Session, perform the following:
If we create IIOP Session, perform the following:
Native API call threading
The ncso.jar file
Server aspects
The "-v" command-line option
The Server API getServerInfo method
Running an AssemblyLine, IIOP Session
Reported component availability
Component version table
Component combo box
"Input Map" connection to the data source
"Classes" folder
Domino Change Detection Connector
Using the Connector
Document identification
Deleted documents
Minimal synchronization interval
Switching to a database replica
Structure of the Entries returned by the Connector
The $$UNID and $$NoteID Attributes
The $$ChangeType Attribute
Synchronization state values
Accessing the Connector synchronization state
Filtering entries
Sorting
Domino Server system time is used
Processing very large Domino databases (.nsf files)
API
Required Setup of the IBM TDI
Required Domino Setup
Required Domino Server tasks
Required privileges
Configuration
Troubleshooting the Domino Change Detection Connector
Compatibilty
See also
Domino Users Connector
Deployment and connection to Domino server
Configuration
Parameter migration from earlier versions
Security
Configuring encryption between the Domino Server and a client
Authentication
Authorization
Using the Domino Users Connector
Iterator mode
Lookup mode
AddOnly mode
Update mode
Delete mode
List of Domino user attributes (or Person document items)
Domino Server for Unix/Linux
Examples
See also
Domino AdminP Connector
Overview
Admin requests signing
Schema
Configuration
See also
Lotus Notes Connector
Known limitations
Session types
Connecting with IIOP
Configuration
UNID Support
Support of RichText attributes
Example scripts
RichText limitations
Setting quota and file ownership
Security
See also
ITIM DSMLv2 Connector
Skip Lookup in Update and Delete mode
Using the Connector with ITIM Server
HTTPS (SSL) Support
Configuration
See also
DSMLv2 SOAP Connector
Supported Connector Modes
Extended Operations
SOAPAction Header
Configuration
DSMLv2 SOAP Server Connector
Extended operations
Configuration
EIF Connector
Introduction to IBM Tivoli Netcool/OMNIbus
Introduction to Tivoli Enterprise Console
Introduction to the Event Integration Facility
Schema
Iterator mode
AddOnly mode
Configuration
File system Connector
Configuration
See also
Form Entry Connector
Using the Connector
Configuration
FTP Client Connector
SSL support
Character Encoding
Configuration
See also
GLA Connector
Introduction
Adapter configuration file
Using more than one outputter in the configuration file
Configuration
Configuring the TDIOutputter
Using the Connector
Schema
See also
HTTP Client Connector
Modes
Lookup Mode
Special attributes
Character Encoding
Configuration
Examples
See also
Old HTTP Client Connector
Modes
Lookup Mode
Special attributes
Configuration
Examples
See also
HTTP Server Connector
Connector structure and workflow
Connector Client Authentication
Chunked Transfer Encoding
Configuration
Connector Schema
Input Attributes
Output Attributes
See also
Old HTTP Server Connector
Configuration
See also
IBM Tivoli Directory Server Changelog Connector
Attribute merge behavior
Differences between changelog on distributed TDS and z/OS TDS
Configuration
See also
ITIM Agent Connector
Setting up SSL for the ITIM Agent Connector
Configuration
Known Issues
See also
IBM MQ Connector
JDBC Connector
Connector structure and workflow
Understanding JDBC Drivers
Connecting to DB2
Connecting to Informix Dynamic Server
Connecting to Oracle
Connecting to SQL Server
Connecting to Sybase Adaptive Server
Connecting to Derby
Connecting to IBM SolidDB
Specifying ODBC database paths
Schema
Configuration
Link Criteria configuration
Skip Lookup in Update or Delete mode
Customizing select, insert, update and delete statements
Overview
Metadata Object
Link Object (Link Criteria)
Convenience Objects
Option to turn off Prepared Statements in the JDBC connector
Custom Prepared Statements
Additional JDBC Connector functions
API to disable or enable parameter substitution
APIs to allow specification of Prepared Statements
Timestamps
Padding
Calling Stored Procedures
SQL Databases: column names with special characters
Using prepared statements
On Multiple Entries
Additional built-in reconnect rules
See also
JMS Connector
Introduction
JMS message flow
WebSphere MQ and JMS/non-JMS consumers of messages
JMS message types
Text message
Object message
Bytes message
Iterator mode
Lookup mode
AddOnly mode
Call/Reply mode
JMS headers and properties
JMS headers
JMS properties
Configuration
Examples
External System Configuration
Troubleshooting
JMS Password Store Connector
Connector Workflow
Force transfer of accumulated messages from the JMS Password Store with MQe
PKCS7 Encryption support
Signing of messages
Encryption of messages
Certificate management
Certificate structure
Creating certificates
Example usage
Schema
Configuration
JMS drivers
IBM WebSphere MQe driver
IBM WebSphere MQ driver
See also
JMX Connector
Connector Schema
Configuration
See also
JNDI Connector
Configuration
Setting the Modify operation
Calling the Modify Interface
Adding a value to an attribute
Replacing the attribute value
Removing attribute
Removing a certain attribute value from an attribute
modify operation
Skip Lookup in Update and Delete mode
See also
LDAP Connector
Detect and handle modrdn operation
Configuration
Virtual List View Control
Handling memory problems in the LDAP Connector
Built-in rules for reconnect functionality
Searching against an SDBM backend on z/OS
LDAP Connector methods (API)
LDAP compare
Adding a value to an attribute
Replacing an attribute value
Removing an attribute value
Removing all attribute values
Flag in Config Editor for default action for attribute add or replace
Rebind
Skip Lookup in Update and Delete mode
See also
LDAP Server Connector
Scripting
Returning the LDAP message returned values
Error handling
Configuration
See also
Log Connector
Introduction
Schema
Configuration
Logger configuration screen
Apache Log4J Loggers
Category based configuration
ConsoleAppender
CustomAppender
DailyRollingFileAppender
FileAppender
NTEventLog
FileRollerAppender
SystemLogAppender
SyslogAppender
Java Util Loggers
Category based configuration
FileHandler
JLOG Loggers
Category based configuration
FileHandler
Lotus Notes Connector
Mailbox Connector
Configuration
Schema
Input Map
Output Map
Using the Connector
Iterator Mode
Lookup Mode
Delete Mode
AddOnly Mode
Update Mode
Memory Queue Connector
Memory queue components
High level workflow
Configuration
Accessing the Memory Queue programmatically
Memory Stream Connector
Configuration
Sun Directory Change Detection Connector
Attribute merge behavior
Configuration
See also
Properties Connector
Configuration
Using the Connector
Properties File Format
See also
Server Notifications Connector
Encryption
Trust store
Authentication
SSL Authentication
Username and Password Authentication
Configuration
Schema
Iterator mode
AddOnly mode
System Queue Connector
Introduction
Configuration
Security, Authentication and Authorization
Encryption
Authentication
Username and password authentication
SSL certificate-based authentication
Authorization
See also
Windows Users and Groups Connector
Preconditions
Configuration
Constructing Link Criteria
Other
User and Group account names
Creating a new user
Setting user password
Setting user Primary Group/global groups membership
Operating with groups
Character sets
Examples
Windows Users and Groups Connector functional specifications and software requirements
Functionality
Extract user and group data
Add user and group data
Modify group membership
Modify user and group data
Delete user and group data
System Store Connector
Configuration
Using the Connector
See also
RAC Connector
Introduction
Configuration
Using the Connector
AddOnly Mode
Post-install Configuration for AddOnly Mode
Iterator Mode
Schema
See also
RDBMS Change Detection Connector
Configuration
Change table format
Creating change tables in DB2
Creating change tables in Oracle
Creating change table and triggers in MS SQL
Creating change table and triggers in Informix
Creating change table and triggers for SYBASE
Example
Script Connector
Predefined script objects
main
task
system
The result object
The config object
The entry object
The search object
The connector object
Functions
Configuration
Examples
See also
SNMP Connector
Configuration
Examples
See also
SNMP Server Connector
Connector Schema
Configuration
Tivoli Access Manager (TAM) Connector
Introduction
Connector Modes
Skip Lookup in Update and Delete mode
Configuration
Configuring the Tivoli Access Manager Java Run Time
Configuring secure communication to the Tivoli Access Manager policy server
Configuring SSL
Configuring the Connector
Using the Connector
AddOnly Mode
Update Mode
Delete Mode
Lookup Mode
Iterator Mode
Troubleshooting
Connector Input Attribute Details
User
Group
Policy
Domain
SSO Credentials
SSO Resource
SSO Resource Group
See also
TCP Connector
Iterator Mode
AddOnly Mode
Configuration
See also
TCP Server Connector
Configuration
Connector Schema
See also
Timer Connector
Configuration
URL Connector
Configuration
Supported URL protocol
See also
Web Service Receiver Server Connector
Hosting a WSDL file
Schema
Input Schema
Output Schema
Configuration
Parameters
Connector Operation
See also
z/OS LDAP Changelog Connector
Attribute merge behavior
Configuration
See also
Parsers
Base Parsers
Character Encoding conversion
Availability
CBE Parser
Using the Parser
CBE Input and Output Map Attributes
Configuration
See also
CSV Parser
Configuration
Schema
DSML Parser
Configuration
Examples
See also
DSMLv2 Parser
Modes
Operations
Modify Request
Modify Response
Search Request
Search Response
Add Request
Add Response
Delete Request
Delete Response
ModifyDN Request
ModifyDN Response
Compare Request
Compare Response
Auth Request
Auth Response
Extended Request
Extended Response
Error Response
Binary and non-String Attributes
Optional Attributes
DSMLv2 controls must be Base64 encoded
Setting result code and result description
Multiple Attribute modifications
Configuration
Examples
Parsing a DSMLv2 AddRequest in Server mode
Creating a DSMLv2 SearchRequest in Client mode
Fixed Parser
Configuration
HTTP Parser
Configuration
Schema
General Header fields
Entity Header Fields
Request Header Fields
Response Header Fields
Character sets/Encoding
Character set when reading
Character set when sending
How to use HTTP cookies
See also
LDIF Parser
Reading LDIF input
Writing LDIF output
Configuration
See also
Line Reader Parser
Configuration
Script Parser
Objects
The result object
The entry object
The inp object
The out object
The parser object
The connector object
Functions (methods)
Configuration
Schema
Example
See also
Simple Parser
Configuration
SOAP Parser
Example Entry
Example SOAP document
Configuration
Parser-specific calls
Examples
SPMLv2 Parser
Introduction
Operations
Add request
Add response
Modify request
Modify response
Delete request
Delete response
Lookup request
Lookup response
Search request
Search response
Binary and non-String Attributes
Attribute operation tagging
Search Filter capabilities
Reading
Writing
Configuration
Example
See also
Simple XML Parser
Configuration
Character Encoding in the Simple XML Parser
Examples
Additional Examples
See also
XML Parser
Introduction
Configuration
Using the Parser
Navigation through the XML structure
Navigation when reading
Simple XML
Advanced XML
Navigation when writing
Reading XML
Writing XML
Character Encoding in the XML Parser
Example
Using XSD Schemas
Predefined XSD schema URI
No XSD provided
Configuring the Schema
Example XSD Schema
XML SAX Parser
Configuration
Character encoding
See also
XSL based XML Parser
Introduction
Configuration
Using the Parser
TDI Internal Format
Example
See also
User-defined parsers
Function Components
Castor Java to XML Function Component
Castor Overview
Configuration
Parameters
Using the FC
Entry mode
Non-Entry mode
Castor XML to Java Function Component
Configuration
Parameters
Using the FC
Entry mode
Non-Entry mode
XMLToSDO Function Component
Example
Configuration
Migration
SDOToXML Function Component
Configuration
Using the FC
Migration
AssemblyLine Function Component
Configuration
Using the FC
See also
Java Class Function Component
Schema
Parameter Conversion
Configuration
Parser Function Component
Configuration
Using the FC
Scripted Function Component
Configuration
Using the FC
Objects
See also
CBE Function Component
Common Base Event (CBE)
The Common Event Infrastructure (CEI)
Input and Output attributes
Configuration
Generating a CBE Log XML
Emitting events to a CEI Server
Function Component API
See also
SendEMail Function Component
Schema
Output Schema
Input Schema
Configuration
Memory Queue Function Component
Configuration
Using the FC
See also
Axis Java To Soap Function Component
Configuration
Parameters
Function Component Input
Function Component Output
Using the FC
Custom serializers/deserializers
Serialization/deserialization problems
See also
WrapSoap Function Component
Configuration
Parameters
Function Component Input
Function Component Output
Using the FC
InvokeSoap WS Function Component
Introduction
Authentication
Configuration
Parameters
Function Component Input
Function Component Output
Using the FC
One-way web service operation support
See also
Axis Soap To Java Function Component
Configuration
Parameters
Function Component Input
Function Component Output
Using the FC
See also
Axis2 WS Client Function Component
Using the FC
Supported Message Exchange Patterns
SOAP Headers
Schema
Configuration
See also
Axis EasyInvoke Soap WS Function Component
Configuration
Parameters
Security and Authentication
Function Component Input
Function Component Output
Using the FC
See also
Complex Types Generator Function Component
Configuration
Parameters
Function Component Input and Output
Troubleshooting
Delta Function Component
Introduction
Configuration
Using the Function Component
Example
Remote Command Line Function Component
Configuration
Function Component Input
Function Component Output
Using the FC
Configuring the Target System
See also
z/OS TSO/E Command Line Function Component
Configuration
Parameters
Using the FC
Error Flows
Function Component Input
Function Component Output
Authentication
Authorization
Required pseudonym file
Setting up the native part of the FC
See also
SAP ABAP Application Server Component Suite
Who should read this chapter
Component Suite Installation
Software Requirements
Configuring the SAP Java Connector
Verifying the Component Suite for SAP ABAP Application Server
Checking the Version Numbers
Uninstallation
Function Component For SAP ABAP Application Server
Function Component Introduction
Configuration
Parameters
Function Component Input
Function Component Output
Using the Function Component
Using the Command Line RFC Invoker
User Registry Connector for SAP ABAP Application Server
Introduction
Skip Lookup in Update and Delete mode
Configuration
Parameters
Using the User Registry Connector for SAP ABAP Application Server
IBM TDI Entry Schema
Add Only Mode
Update Mode
Delete Mode
Lookup Mode
Iterator Mode
Transactional Operations Not Supported
Handling ABAP Errors
Human Resources/Business Object Repository Connector for SAP ABAP Application Server
Introduction
Key Fields and XML Representation
Skip Lookup in Update and Delete mode
Configuration
Parameters
Using the Human Resources Connector for SAP ABAP Application Server
IBM TDI Entry Schema
Add Only Mode
Update Mode
Delete Mode
Lookup Mode
Iterator Mode
Transactional Operations Not Supported
Handling ABAP Errors
ALE Intermediate Document (IDOC) Connector for SAP ABAP Application Server and SAP ERP
Introduction
Installation
Configuration
IDOC Server Parameters
IDOC Client Configuration Parameters
General Configuration Parameters
Using the SAP ALE IDOC Connector
IBM TDI schema
XML Attribute Parsing
Configuration in SAP ALE Distribution Models
Troubleshooting the SAP ABAP Application Server Component Suite
Supplemental information for the SAP ABAP Application Server Component Suite
Example User Registry Connector XML Instance Document
XSchema for User Registry Connector XML
Asset Integration Suite
Overview
CDM components
Attributes
Classes
Interfaces
Relationships
Naming and identification
IT registry
Components of the suite
Open IdML Function Component
Introduction
Schema
Configuration
See also
Close IdML Function Component
Introduction
Schema
Configuration
Rolling IdML Function Component
Introduction
Schema
Configuration
IdML CI and Relationship Connector
Introduction
Schema
Configuration
IdML Parser
Introduction
Schema
Configuration
Data Cleanser Function Component
Introduction
Schema
Configuration
Init IT Registry Function Component
Introduction
Schema
Configuration
IT Registry CI and Relationship Connector
Introduction
Schema
Configuration
The it_registry.properties file
Examples
IT Registry database setup
Troubleshooting
Script languages
JavaScript
Java and JavaScript
Objects
The AssemblyLine Connector object
The attribute object
Examples
Creating a new attribute object
Adding values to an attribute
Scanning attribute's values
See also
The Connector Interface object
Methods
The Entry object
Global Entry instances available in scripting
See also
The FTP object
Example
Main object
The Search (criteria) object
Operands
Example
The shellCommand object
The status object
The system object
The task object
The COMProxy object
Example code
See also
Appendix A. Password Synchronization plug-ins
Appendix B. AssemblyLine Flow Diagrams
AssemblyLine Flow Diagrams
Appendix C. Server API
Overview
Sample use case
Local and Remote Server API interfaces
Server API structure
Security
Configuring the Server API
Configuring the Server API properties
Setting up the User Registry
Remote client configuration
SSL configuration of the remote client
Using the Server API
Creating a local Session
Access to the Server API in a scripting context
Creating a remote Session
Working with Config Instances
Getting access to running Config Instances
Starting a Config Instance
Stopping a Config Instance
Synchronizing Server API and Config Initialization
Optional Config instance ID in a Config file
Solution Name and Run Name - the Configuration Instance ID
Using Solution Name instead of Config file path
Scanning the configs folder for Solution Names
Working with AssemblyLines
Getting access to the AssemblyLines available in a configuration
Getting access to running AssemblyLines
Starting an AssemblyLine
Starting an AssemblyLine in manual mode
Starting an AssemblyLine with a listener
Starting an AssemblyLine with component simulation
Stopping an AssemblyLine
Editing configurations
TDI Configurations folder
Load for editing
Configuration Locking
Load for editing with temporary Config Instance
Using the Solution Name instead of the config file path
Server API event for configuration update
Working with the System Queue
Access the System Queue through the Server API
Put a message in the System Queue
Retrieve a message from the System Queue
Working with the Tombstone Manager
Globally Unique Identifiers
Server API support for the Tombstone Manager
What is a tombstone
Retrieving tombstones
Deleting tombstones
Adding a custom message to AssemblyLine tombstones
Working with TDI Properties
JMX layer API
Registering for Server API event notifications
Server shutdown event
Custom Server API event notifications
Getting access to log files
Server Info
Using the Security Registry
Custom Method Invocation
A Full Example
The JMX layer
Local access to the JMX layer
Remote access to the JMX layer
MBeans and Server API objects
JMX notifications
JMX Example - TDI 7.1 and MC4J configuration
TDI side
Set up Remote Server API and JMX
Start the TDI server from the command line
MC4J side
Backward compatibility
Scenarios overview
Guidelines for porting a TDI 6.0 Server API client to use a TDI 7.1 server
When is porting required
When is porting optional
Guidelines for implementing a Server API client capable of working with both TDI 6.0 and TDI 7.1 servers
Using RMI remote objects
Using serializable classes
Config Editing
Authentication mechanisms
Checking the TDI server version
Server API changes in TDI 7.1
Known issues
com.ibm.di.config.interfaces.ExternalPropertiesDelegator
com.ibm.di.config.base.BaseConfigurationImpl
Appendix D. Creating new components using Adapters
Introduction
Features that enable implementation of a TDI Adapter
AL Operations
Switch/case component
Flexible connector initialization
Using an Iterator in Flow
Packing an Adapter for consumption
Using an Adapter in your AssemblyLine
The use of operations in a TDI Adapter
Mapping Adapter operations to Connector modes
Implementing code in the Adapter for each operation
Adapter configuration through the $initialization operation
Understanding the link criteria
Attribute mapping
From the calling AssemblyLine into the Adapter
Return data from the Adapter to the calling AL
Status indication
Implementing Query Schema
Delta mode
Error handling
Appendix E. Implementing our own Components in Java
Support materials for Component development
Developing a Connector
Implementing the Connector's Java source code
Using a Parser in your Connector
Logging from a Connector
Building the Connector's source code
Implementing the Connector's GUI configuration form
Introduction
tdi.xml file format
Basic Component Definitions
Install Location
Form description
Component/Form Association
Form/Configuration Binding
Form Definition
Forms definition elements
XML Translation considerations
Parameter Definitions
Dynamic Values
Syntax
Form Scripts
Examples
Connector Reconnect Rules definition
Packaging and deploying the Connector
Developing a Function Component
Implementing Function Component Java source code
Building the Function Component source code
Implementing the Function Component GUI configuration form
Packaging and deploying the Function Component
Developing a Parser
Implementing the Parser Java source code
Building the Parser source code
Implementing the Parser GUI configuration form
Packaging and deploying the Parser
Creating additional Loggers
Understanding the logging interface
Log Interface Configuration
Logger External Configuration
Logger Internal Configuration
Logger API
See also
Appendix F. Notices
Third-Party Statements
ICU License - ICU 1.8.1 and later
Trademarks
Message Guide
PDF version
Messages Guide
Preface
Who should read this book
Publications
IBM TDI library
Related publications
Accessing publications online
Accessibility
Accessibility features
Keyboard navigation
Interface Information
Vendor software
Related accessibility information
Contacting IBM Software support
Overview
Message format
Message ID format
Component identifiers
Severity
Presentation of messages in this book
CTGDI
CTGDIA001 - CTGDIA100
CTGDIA101 - CTGDIA200
CTGDIB
CTGDIB101 - CTGDIB300
CTGDIC
CTGDID
CTGDIE
CTGDIF
CTGDIH
CTGDIH001 - CTGDIH100
CTGDIH101 - CTGDIH200
CTGDII
CTGDIK
CTGDIK001 - CTGDIK100
CTGDIK101 - CTGDIK200
CTGDIK201 - CTGDIK300
CTGDIK301 - CTGDIK400
CTGDIK401 - CTGDIK500
CTGDIJ
CTGDIL
CTGDIM
CTGDIM001 - CTGDIM100
CTGDIM101 - CTGDIM200
CTGDIN
CTGDIO
CTGDIP
CTGDIQ
CTGDIQ001 - CTGDIQ100
CTGDIQ101 - CTGDIQ200
CTGDIQ201 - CTGDIQ300
CTGDIR
CTGDIR001 - CTGDIR100
CTGDIR101 - CTGDIR200
CTGDIR201 - CTGDIR300
CTGDIR301 - CTGDIR400
CTGDIS
CTGDIT
CTGDIU
CTGDIV
CTGDIW
CTGDIX
CTGDIY
CTGDIY001 - CTGDIY100
CTGDIY101 - CTGDIY200
CTGDIZ
CTGDIZ001 - CTGDIZ100
CTGDIZ101 - CTGDIZ200
CTGDIZ201 - CTGDIZ300
CTGDIZ301 - CTGDIZ400
CTGDIZ401 - CTGDIZ500
CTGDIZ501 - CTGDIZ600
CTGDIZ601 - CTGDIZ700
CTGDIZ701 - CTGDIZ800
CTGDIZ801 - CTGDIZ900
CTGDIZ901 - CTGDIZ999
CTGDJ
CTGDJA
CTGDJB
CTGDJB001 - CTGDJB500
CTGDJB501 - CTGDJB999
CTGDJC
CTGDJE
CTGDJF
CTGDJG
CTGDJH
CTGDJH001 - CTGDJH100
CTGDJH101 - CTGDJH200
CTGDJI
CTGDJI001 - CTGDJI100
CTGDJI101 - CTGDJI200
CTGDJJ
CTGDJK001 - CTGDJK101
CTGDJK101 - CTGDJK201
CTGDJL
CTGDJM
CTGDJN
CTGDJO
CTGDJP
CTGDJP001 - CTGDJP100
CTGDJP101 - CTGDJP200
CTGDJP201 - CTGDJP300
CTGDJP301 - CTGDJP400
CTGDJP401 - CTGDJP500
CTGDJQ
CTGDJQ001 - CTGDJQ200
CTGDJQ201 - CTGDJQ300
CTGDJR
CTGDJT
CTGDJT001 - CTGDJT100
CTGDJT101 - CTGDJT200
CTGDJU
CTGDJU001 - CTGDJU100
CTGDJU101 - CTGDJU200
CTGDJV
CTGDJW
CTGDJX
CTGDJY
CTGDJY001 - CTGDJY100
CTGDJY101 - CTGDJY200
CTGDJZ
CTGDJZ001 - CTGDJZ100
CTGDJZ101 - CTGDJZ200
CTGDJZ201 - CTGDJZ300
CTGDJZ401 - CTGDJZ450
CTGDJZ451 - CTGDJZ500
CTGDJZ601 - CTGDJZ650
CTGDJZ551 - CTGDJZ600
CTGDJZ651 - CTGDJZ700
CTGDJZ501 - CTGDJZ550
CTGDJZ701 - CTGDJZ750
CTGDJZ751 - CTGDJZ800
CTGDK
CTGDKB
CTGDKB001 - CTGDKB100
CTGDKC
CTGDKD
CTGDKE
CTGDKE001 - CTGDKE100
CTGDKE101 - CTGDKE300
CTGDKG
CTGDKH
CTGDKI
CTGDKJ
CTGDKJ001 - CTGDKJ100
CTGDKJ101 - CTGDKJ200
CTGDKK
CTGDKK001 - CTGDKK100
CTGDKK101 - CTGDKK200
CTGDKK301 - CTGDKK400
CTGDKL101 - CTGDKL200
CTGDKL001 - CTGDKL100
CTGDKM
CTGDKM101 - CTGDKM200
CTGDKM001 - CTGDKM100
CTGDKM201 - CTGDKM300
CTGDKM301 - CTGDKM400
CTGDKM401 - CTGDKM501
CTGDKN
CTGDKN001 - CTGDKN100
CTGDKN101 - CTGDKN200
CTGDKN101 - CTGDKN200
CTGDKN301 - CTGDKN400
CTGDKN401 - CTGDKN500
CTGDKN601 - CTGDKN700
CTGDKO
CTGDKO001 - CTGDKO100
Appendix. Notices
Third-Party Statements
ICU License - ICU 1.8.1 and later
Trademarks
Index
Problem Determination Guide
PDF version
Problem Determination Guide
Preface
Who should read this publication
Publications
IBM TDI library
Related publications
Accessing publications online
Accessibility
Accessibility features
Keyboard navigation
Interface Information
Vendor software
Related accessibility information
Contacting IBM Software support
Introduction to problem determination
IBM TDI 7.1 overview
Troubleshooting topics
Built-in troubleshooting features
Using the Messages Guide to resolve errors
Performance Test Utilities and Debugging
Performance Test Utilities
Run the Performance Test Utilities scripts
Run the ibmdisrvtp.sh utility
Run the ibmdibenchmark.sh utility
Performance debugging
Data collected by the Performance Debugging tool
Run the Performance Debugging tool
Installation and uninstallation
Troubleshooting Installation
Gathering installation information
Performing a manual uninstallation
Troubleshooting installation problems
TDI v7.1 installer does not appear to honor -D$INSTALLER_TEMP_DIR$ option
TDI v7.1 installer does not support -D$TDI_NOSHORTCUTS$ and -D$TDI_SKIP_VERSION_CHECK$ options
TDI 7.0 installer fails to detect previously installed v6.1 or v6.1.1 instances
install_tdiv70_linux_x86.bin fails to launch with error ./install_tdiv70_linux_x86.bin: line 1957: warning: here-document at line 1957 delimited by end-of-file (wanted '/dev/null')
On RHEL 5.0 (or any other system with SELinux enabled), TDI 7.0 installer fails to launch with error "No Java Runtime Environment (JRE) was found on this system"
"No Java Runtime Environment (JRE) was found on this system": JVM verification fails while installing TDI on some slower platforms
AIX: problem during uninstall
AIX 5.3: No Java Runtime Environment (JRE) was found on this system.
Attempting to install TDI version 7.0 to a location where TDI is already installed
Ikeyman file needs executable permissions on HP-UX and Solaris operating systems
Unable to migrate Cloudscape System Store of TDI 6.0 to TDI 7.0 or 7.1.
Known limitations
Multiple installations not registered correctly in Windows Add/Remove Programs
Glibc package 2.3 or higher required for installation on Linux operating systems
Maintenance Level 3 required for installation on an AIX 5.3 operating system
Incorrect text emphasis when installing TDI on a Windows operating system in Simplified Chinese
Some messages display when uninstalling TDI 6.1.1 using the -console option
Debug statements created when installing and uninstalling TDI V7.0 using the -console option on Windows and UNIX operating systems
Migration from TDI 6.0 to TDI 7.0 on the HP-UX 11iv2 operating system is not supported
Avoid JAVA errors by having executable and JAR files in the installation directory
Monitor the installation or uninstallation log during silent installation execution
Configuration Editor
Troubleshooting the Configuration Editor
Verify that the server associated with your project has been started
Consult the Error View when using the Configuration Editor
Unwanted perspective changes
Problems during installation of the CE into Eclipse
Known Limitations
Solution directory does not always resolve to expected path
Upper part of characters truncated in Javascript panel
Tooltips are not shown on Dropdown combos on Solaris.
CE hangs after seeing the splash screen or choosing the workspace on AIX.
IBM JavaScript limitations
java.lang.OutOfMemoryError: Failed to fork OS thread
String representations of numbers not represented in exponential format
Package and class references do not return string values
Date constructors cannot take values higher than the maximum integer value
All comparisons of prototypes return false
Arrays with high numeric values truncate
Sandbox not supported with connectors that return nonserializable data
Variable override of standard types allowed
Declaring two or more functions on same line allowed
Redeclared variable does not retain the previous value
Troubleshooting the Administration and Monitoring Console
Administration and Monitoring Console Problem Determination
Problems with localized messages in the console
Action Manager and Administration and Monitoring Console on different machines
Unable to delete TDI Server and Solution Views
Deleting a Server
Deleting a Solution View
String is truncated on the Start AssemblyLine window
The background of the text in Filter field overlaps the field
Unable to start Administration and Monitoring Console using the start_tdiamc script
SSL communications problems with AMC in ISC AE
Authentication failure on UNIX when LWI runs as non-root user
Components
Components overview
Connectors
Remote Agent Controller (RAC) Connector
Agent controller on a non-Windows platform
Slow network connection to the agent controller
No agent is registered by the RAC Connector in AddOnly mode
Agent Controller is accessible using the LTA Eclipse tool but not by the RAC Connector in Iterator mode
Assorted Connectors
Backlog parameter and server mode connectors
Cause
Solution
Some platforms do not throw exceptions when accepting post-dated SSL server certificates
Cause
Solution
Connectors whose libraries do not ship with TDI
For Domino or Lotus Notes connectors running on Linux operating systems, set PATH and LD_LIBRARY_PATH variables
TDI process privileges and Domino on Linux
CommandLine Connector
AssemblyLine AssemblyLines/CommandLine failed with error: CreateProcess: dir error=2
DOS-encoded output on Windows operating systems
JDBC Connector
Nullpointer exception while using Custom Prepared Statements
COM.ibm.db2.jdbc.DB2Exception: CLI0616E Error opening socket. SQLSTATE=08S01
CLI0616E Error opening socket
java.sql.SQLException: ORA-01830: date format picture ends before converting entire input string
Suggestions
Handling of CLOB/BLOB (Character/Binary large object)
Disabling Prepared Statement can result in an exception for queries that exceed the maximum length value
Use ojdbc14.jar to transfer BLOB data from table to another in an Oracle database
InitConnectors: com.ibm.db2.jcc.a.SqlException: The version of the IBM Universal JDBC driver in use is not licensed for connectivity to QDB2/<OS> databases.
Cause
Solution
JNDI Connector
Problem
Symptom
Solution
Insufficient memory issue with Domino
Domino User's Connector
java.lang.Exception: Connector Notes Thread not alive. Cannot perform.
Cause
Solution
Windows Users and Groups Connector
java.lang.UnsatisfiedLinkError: can't find library NTMetaData (libNTMetaData.so)
SAP Connection Suite
JCO.classInitialize(): Could not load middleware layer 'com.sap.mw.jco.rfc.MiddlewareRFC'JCO.nativeInit()
Cause
Solution
Function Components
Parsers
LDIF Parser
Performance degradation
Password Synchronization plug-ins
Problem with ICU4J on Windows when automatic daylight saving changes are disabled
Known limitations and general troubleshooting
Known limitations
Troubleshoot problems with Delta Features and solidDB
Cannot start another queue manager for JMS
Regular Expression support in the IBM Java Script engine shipped with TDI 6.1 and newer
Problem
Solution
Launchpad exit confirmation window title bar displays incorrectly in Firefox browser
SSL connects with expired self signed certificates
Programmatically disabling components
Specifying multiple Configs to the ibmdisrv command
Cause
Solution
RHEL 5.0 (or any other system with SELinux enabled), TDI 7.0 commands fail with "Failed to find VM - aborting" message
Cause
Solution
General troubleshooting
Certain scripted utilities must be invoked in specific way
System Store database might get corrupted when shutting down an AssemblyLine that uses Derby in embedded mode
Cannot connect to TDI server from a remote machine even though the TDI server says the server API has started
OutOfMemoryError thrown when an AssemblyLine in manual mode makes huge number of attempts to initialize
Remote Command Line Function Component can execute shell scripts remotely only if there are no carriage returns in the shell script
java.io.IOException: The pipe has been ended
Cause
Solution
Error occurs when an encrypted password exceeds the size of the table column in which the password is stored
AssemblyLine Flow
Connector in Lookup mode with no match in a loop component causes error
Advanced link criteria for a Lookup Connector in a Loop deleted when saving config
ibmdisrv -c switch does not allow you to work with multiple file names
tdisrvctl not listing created tombstones when -c option specifies file name
Memory Leaks
Reinitialization of connectors
Platform specific problems
IBM Message Queue (MQ) Connector (JMS) on z/OS
Domino User's Connector running on AIX 5.3 with Domino Server 7.0
Troubleshooting scenarios
Log files not showing up or showing up after only the second run of the server
Appendix A. Support information
IBM Support Assistant plug-in
IBM Support Assistant for TDI (TDI)
Searching knowledge bases
Search the information center on your local system or network
Search the Internet
Obtaining fixes
Contacting IBM Software Support
Determine the business impact of the problem
Describe your problem and gather background information
Submit your problem to IBM Software Support
Appendix B. Notices
Third-Party Statements
ICU License - ICU 1.8.1 and later
Trademarks
Index
Plugins Guide
PDF version
Password Synchronization Plug-ins Guide
Preface
Who should read this book
Publications
IBM TDI library
Related publications
Accessing publications online
Accessibility
Accessibility features
Keyboard navigation
Interface Information
Vendor software
Related accessibility information
Contacting IBM Software Support
Tivoli technical training
Conventions Used in this Book
Introducing Password Synchronization Plug-ins
Overview
Building blocks
Building the solution
Available specialized components
Password Synchronizers
Password Stores
Specialized Connectors
Tivoli Identity Manager Integration
Password Synchronization Architecture and Workflow
The Java Proxy process
Proxy process Authentication
Restricting file access on Windows
Restricting file access on Linux/UNIX
The Password Store interface
Architecture options
Security
Reliability
Installing the Password Synchronization Plug-ins
Before You Install
Platform Requirements
Root or Administrator Privileges
Installing the Password Synchronization Plug-ins
Upgrading the Password Synchronization Plug-ins
Password plug-ins common configuration and utilities
Configuration file parameters
Command line utilities
Manage the Java proxy with IBM Tivoli Monitoring
Windows Password Synchronizer
Overview
Synchronizing from a single machine
Synchronizing from a Windows XP, Windows 2003 or Windows 2008 domain
Sample scenario
Windows Password Synchronizer Workflow
Windows Password Synchronizer Filtering
Supported Platforms
Deployment and Configuration
Post-install configuration
Configuration parameters in the Windows registry
Configuration parameters in the configuration file
Enabling Local Security
Password Stores setup information
Plug-in administration tool
Usage
Operational Windows registry settings
Logging
Considerations when using the administration tool
Example for changing the configuration without rebooting the Windows machine
Migration from previous installations
Reliability and availability
Sun Directory Server Password Synchronizer
Overview
Supported platforms
Deployment and configuration
Registering the Sun Directory Server Password Synchronization Plug-ins with Sun Directory Server
Sun ONE Directory Server 5.2
Sun Java System Directory Server Enterprise Edition 6.0
Enable Sun Directory Server logging for plug-ins
Sun ONE Directory Server 5.2
Sun Java System Directory Server Enterprise Edition 6.0
Configuring the Sun Directory Server Password Synchronization Plug-in
IBM Directory Server Password Synchronizer
Overview
Supported platforms
Deployment and configuration
Register the plug-in with the IBM Directory Server
Configuring the IBM Directory Server Password Synchronization Plug-in
Domino HTTP Password Synchronizer
Overview
Supported platforms
Installation
Configuration file options
Post install configuration
Creating a signer for the Password Synchronizer agents
Deployment on Domino servers
Deployment on a single Domino Server
Setup of the Domino plug-in
Deployment on a Domino Domain with multiple Domino Servers
Partial Deployment of the Password Synchronizer
Deployment alternative that does not involve a dedicated agent signer (default pre-v7.1)
Using the Password Synchronizer
Overview
Only certain password change mechanisms are intercepted
Solution workflow
Editing the Person document through the Lotus Domino Administrator
Editing the Person document through the Domino web browser interface
Password change through the Password Change web form from domcfg.nsf or through iNotes
Secure password transfer
Migration
Migrate from v7.0 to v7.1
Password Synchronizer for UNIX and Linux
Overview
Supported Platforms
Deployment
Registering the Password Synchronizer for UNIX and Linux plug-in within PAM
Configuration
Reference Material
LDAP Password Store
Supported Directories
Installing LDAP Password Store
Overview
Prerequisites
Installing LDAP Password Store
Set up the LDAP server
Modifying the schema of zLDAP
Modifying the schema of Sun Directory Server and Active Directory
Configuring the LDAP Password Store
About encrypting passwords
Using the Password Store
JMS Password Store
Overview
IBM WebSphere MQe driver
IBM WebSphere MQ driver
Microbroker Driver
JMS Script Driver
Configuring the JMS Password Store
MQe Queue Manager setup
Websphere MQ setup
Log Password Store
Troubleshooting problems with the Password Synchronizers
Troubleshooting problems with the plug-in
Troubleshooting problems with the Java Proxy
Tivoli Identity Manager Integration
Overview
Supported Synchronizers
ITIM Password Strength Validation Communication
Configuring Password Synchronizers for Tivoli Identity Manager Integration
Known Issues
Appendix A. AIX 5.3 PAM Configuration
Appendix B. IBM Software Support
Determine the business impact of the problem
Describe your problem and gather background information
Submit your problem to IBM Software Support
Searching knowledge bases
Search the information center on your local system or network
Search the Internet
Obtaining fixes
Appendix C. Notices
Trademarks