Installing Connectors or Components Using the Deployment Utility
When new or updated connectors or components are available separately and not with a platform release, you can use the deployment utility (extensionkit.exe) to install the connectors or components in your environment. This utility supports native connectors, DMS connectors, and MCF components. The extensionkit.exe file is available at the following DataConnect installation location:
C:\Program Files\Actian\actian-dc-studio-64-bit-XX.X.X\di-standalone-engine-XX.X.X-xx\runtime\di9\
The utility has the following capabilities:
• Lists the currently installed connectors and components
• Installs a new connector or component
• Installs a newer version of the connector or component
• Provides details about a connector (.zip) or component (.jar) file
• Provides a list of connectors and components.
• Views the connector or component name(s) and version numbers
When installing a connector:
• If the connector already exists, it is updated and the earlier connector is moved to deprecated.
• If a connector of the same version exists, then it will be overwritten.
When installing a component:
• If a component exists, the new version is added.
• If a component of the same version exists, then no action is taken.
When installing a connector or component, it does not:
• Delete any existing connectors or components
• Update any existing maps or processes to use the new connector or component
Connector Pack Structure
The connector pack provides the native and Java connectors and message components in a single zip file.
After you unzip the file, the structure is:
• connectors: Contains all DMS (Java) connectors. Each DMS connector has a configuration file and associated folder that contains the connector resources.
• connectors/native: Contains all native connectors. Native connectors are packaged as a .cdc file.
• plugins: Contains the message component packages.These can be packaged as a .jar file (java message components) or a .zip file (native message components).
Prerequisites
Before using the deployment utility:
• Make sure that the following location is added to the PATH system environment variable:
C:\Program Files\Actian\actian-dc-studio-64-bit-XX.X.X\di-standalone-engine-XX.X.X-xx\runtime\di9
• Location of the cosmos.ini file is added to the DJLIB environment variable.
Use the Deployment Utility for Installation
To install a connector or component using the deployment utility
1. Download the connector or component package file from
Actian ESD.
2. Extract the package file to a folder on your system.
3. Open the command prompt and go to the location of the extracted package folder.
For example:
• For a connector, run cd <connector_package_extracted_folder>/connectors.
• For a component, run cd <component_package_extracted_folder>/Plug-Ins.
4. Run any of the following commands based on your requirements.
Note: You must run these commands as an administrator (or root in Linux/AIX) so that you have the correct permissions to update, replace, or delete configuration and dll/so files.