Configuring plugin properties

For the integration plugin to work, you need to configure various property files in TADDM and on the integration plugin.

1. Open the <IntegrationPlugin path>/resources/config/plugin.properties file.
2. Configure the following properties:
   For the integration plugin:

   • enableChangeEventManagement = <Enables and disables processing for change event updates >
   • enableMigration = <Enables and disables the migration of CI data>
   • runMigrationAgain = <Run migration process again for all CIs>
   • migrationThreadPoolSize = <Number of threads for processing migration data >
   • changeEventThreadPoolSize = <Number of threads for processing change event updates >
   • sourceConnector = <Source endpoint>
   • targetConnector = <Target endpoint>
   • javaHome = <IBM Java home path>
   • useMagicMethod = <Set true to run the magic methods>
   • sessionRetryTime = <Set time for session retry for source and target connector>

   For log settings:

   • fileSize = <Log file size in MB>
   • backupIndex = <Count of backup log files before they are lost or rotated with latest logs >
   • logLevel = <Log level>

   For graceful shutdown:

   • gracefulEventProcessingCount = <Total count of number of events to be processed during shutdown time>
   • gracefulEventProcessingTime = <Time for graceful shutdown processing in milliseconds>

   Note: Not all properties are mandatory. For details, see Appendix A: Properties used in the integration.
3. Open the <IntegrationPlugin path>/resources/taddm_snow/taddm.properties file.
4. Configure the following properties:
   For TADDM Configurations (Source):

   • taddmHost = <IP address of the TADDM machine>
   • taddmPort = <TADDM server port>
   • taddmUserName = <User name>
   • taddmPassword = <TADDM user password or password stored in encrypted form>
   • taddmUseSSl = <To establish secure connection>
   • taddmTrustStorePath = <Specify SSL certificate path>
   • taddmHome = <Path of collation home>
   • tlsVersion = <Same TLS version as set in TADDM collation.properties file>

   To configure Change event:

   • listenIp = <IP address of machine on which the plugin is running and listening for change event processing>
   • listenPort = <Port on which the plugin listens for change event processing>

   Note: Not all properties are mandatory. For details, see Appendix A: Properties used in the integration.
5. Open the <IntegrationPlugin path>/resources/taddm_snow/serviceNow.properties file.
6. Configure the following properties:
   For ServiceNow configuration (Target):

   • serviceNowInstanceUrl = <ServiceNow instance URL>
   • serviceNowOAuthUrl = <oAuth URL for generating access token>
   • discoverySource = <Discovery source type>
   • relationTable = <Table that contains relations type>
   • refreshTokenLifespan = <Refresh token life time span in seconds>
   • serviceNow.attribute.softdelete.status = <Status to be used for indicating soft delete of record>
   • serviceNow.attribute.softdelete.name = <ServiceNow attribute to maintain the soft delete status>
   • serviceNow.attribute.guid.name = justification <ServiceNow attribute to store TADDM GUID, a per-record unique identifier>
   • securityProtocol= <Enter TLS protocol>

   For Proxy settings:

   • enableProxy = <Enable proxy while connecting to ServiceNow>
   • proxyHost = <Proxy IP>
   • proxtPort = <Proxy host>
   • proxyUserName = <User name for proxy>
   • proxyPassword = <Proxy password>

   Note: Not all properties are mandatory. For details, see Appendix A: Properties used in the integration.
7. Restart the integration plugin.
8. On the TADDM server, open the $COLLATION_HOME/etc/collation.properties file.
9. Configure the following properties:
   To enable ChangeEvent:

   • com.ibm.cdb.omp.changeevent.enabled= <Enable ChangeEvent module to send events from TADDM>
   • com.ibm.cdb.omp.changeevent.optimized.update = <Property to allow consolidation of update events for multiple attributes of the same Model Object>
   • com.ibm.cdb.omp.changeevent.classnames.nonfriendly = <This property returns the CI class name instead of non-user-friendly class name>
   • com.ibm.cdb.omp.changeevent.deletefromportal = <Property to enable sending of delete events when the CI is deleted from portal>
   • com.ibm.cdb.omp.changeevent.GenerationType = later <This property should be set to later is to process the change events separately otherwise discovery can hang>

   To encrypt the password:

   • com.collation.integrationplugin.taddm.password= <Encrypted TADDM password>
   • com.collation.integrationplugin.target.proxy.password= <Encrypted target proxy password>

   Note: Not all properties are mandatory. For details, see Appendix A: Properties used in the integration.
10. Restart TADDM.