Quick installation of the Clarify CRM adapter

The following subsections describe how to install the adapter on a Windows or UNIX system.

After your WebSphere Business Integration Adapter system is installed, you can install additional connectors from the WebSphere Business Integration Adapter CD at any time. To do this, insert the product CD, run the installation program, and choose the connectors that you want to install.

Note:
Unless otherwise indicated, the remaining sections in this chapter apply to both Windows and UNIX installations of the connector.

Installing on a UNIX system

To install the adapter on a UNIX system, run the Installer for IBM WebSphere Business Integration Adapter and select the IBM WebSphere Business Integration Adapter for Clarify CRM.

Note:
Only versions 8 and 10 of the adapter for Clarify CRM are supported on the UNIX system.

For more information on installing the connector component, refer to one of the following guides, depending on the integration broker you are using:

For the connector, the Installer installs the file structure shown in Table 1.

Table 1. Installed UNIX file structure for the connector

Subdirectory of $ProductDir Description
connectors/Clarify
Subdirectories containing various versions of the Clarify CRM shared library
connectors/Clarify/dependencies
Files containing the triggers for event notification and the scripts for event and archive tables
connectors/messages
Contains the ClarifyConnector.txt file.
connectors/Clarify/start_Clarify.sh
The start_Clarify.sh file is a system startup script for the connector. It is called from the generic connector manager script. When you click Install from Connector Configurator (WebSphere MQ Integrator Broker as the integration broker) or the Connector Configuration screen of System Manager (ICS as the integration broker), the installer creates a customized wrapper for this connector manager script. When the connector works with ICS, use this customized wrapper to start and stop the connector. When the connector works with WebSphere MQ Integrator Broker, use this customized wrapper only to start the connector. Use the mqsiremotestopadapter command to stop the connector.

Before you can use the connector, you must:

  1. Use the Connector Configuration Tool to generate the customized Clarify CRM wrapper (connector_manager_Clarify) required to start the connector. Refer to the System Installation Guide for UNIX or the WebSphere Business Integration Adapters Implementation Guide for MQ Integrator Broker for more information.
  2. In the start_Clarify.sh file, modify the ORACLE_HOME environment variable.

    For the connector to run, the ORACLE_HOME environment variable must be set to the location of the Oracle Server software on your system.

  3. Copy one Clarify CRM shared library from the version-specific subdirectory into the $ProductDir/connectors/Clarify directory.

    For example, if you are using the Clarify 8.5 connector with Oracle Server, copy the libclarify.so from the Clarify8.5-oracle subdirectory into the $ProductDir/connectors/Clarify directory.

Installing on a Windows system

To install the connector on a Windows system, run the Installer for IBM WebSphere Business Integration Adapter and select the IBM WebSphere Business Integration Adapter for Clarify CRM. All standard files associated with the connector are installed. Table 2 describes the file structure used by the connector.

Table 2. Installed Windows file structure for the connector

Subdirectory of %ProductDir% Description
connectors\Clarify Subdirectories containing various versions of the Clarify CRM DLL.

Note:
For the connector to start, all Clarify dependent dlls (Ex: mny*.dll, tls *.dll and libdb_d.dll) must be copied into this directory.
connectors\Clarify\dependencies Files containing the triggers for event notification and the scripts for event and archive tables.
connectors\messages Contains the ClarifyConnector.txt file.

Installer adds an icon for the connector file to the IBM WebSphere Business Integration Adapter menu. For a fast way to start the connector, create a shortcut to this file on the desktop.

For more information on installing the connector component, refer to one of the following guides, depending on the integration broker you are using:

or the instructions in the sectionComprehensive install and uninstall instructions for adapters

Copyright IBM Corp. 1997, 2003