Installing A Connector Locally

Once you have compiled your Connector, install it in TIBCO Scribe® as part of your testing. See Testing A Connector for more information about testing.

After you have thoroughly tested your Connector, you can, if desired, make your Connector available for public distribution. To do so, the Connector must be certified by TIBCO. Notify us via email at scribeconnectordeploy@tibco.com that you will be submitting a Connector for Certification.

• For information about the Connector certification process see Connector Certification & Release in the Developer Forum of the TIBCO Community.

Once your Connector has been certified, you can:

• Make your Connector available through the TIBCO Cloud™ Integration Marketplace. For more information about the TIBCO Cloud™ Integration Marketplace, see the TIBCO Cloud™ Integration Marketplace Program Guide.
• Make your Connector available by request from other customers.

Installing A Connector For Testing

For testing purposes, you can install your Connector in your local TIBCO Scribe® Agent directory. This makes your Connector available for your site.

1. Stop the TIBCO Scribe® Agent Windows service.
2. Navigate to the TIBCO Connectors directory:

   ..\Scribe Software\TIBCO Scribe® Online Agent\Connectors\

3. In this directory, create a new sub-directory for the Connector you want to test.

   Connector sub-directory names must not contain the word connectors. Using connectors in the sub-directory name prevents TIBCO Scribe® from finding the Connector and displaying it in the drop-down on the Connection dialog. Errors are generated in the Agent logs indicating that the Connector cannot be found.

4. Copy the compiled .dll file for your Connector, as well as any required supporting files into the new directory. For example, if your Connector is called ScribeSampleConnector, you need to copy the following files:
   • ScribeSampleConnector.dll
   • ScribeSampleConnector.pdb
   • ScribeChangeHistory_Create.sql
   • ScribeDelete_Trigger.sql
5. Restart the TIBCO Scribe® Agent Windows service.
6. After a few minutes, the Connector appears in the list of available Connectors in the Connection dialog in the TIBCO Scribe® user interface.
7. Set up a Connection with the newly installed Connector.
8. Set up a TIBCO Scribe® Solution that uses the new Connection.

Troubleshooting

If you have installed your Connector as described in the instructions above, but you do not see the Connector in the drop-down list on the Connection dialog, the files may be blocked by your operating system. To unblock the files:

1. Stop the TIBCO Scribe® Agent Windows service.
2. Navigate to the TIBCO Connectors directory:

   ..\Scribe Software\TIBCO Scribe® Online Agent\Connectors\

3. Locate the sub-directory for the Connector you want to test.
4. Right-click each file in the sub-directory and select Properties.
5. On the Properties dialog, select the Unblock option on the General tab and click OK. For example, if your Connector is called ScribeSampleConnector, you need to unblock the following files:
   • ScribeSampleConnector.dll
   • ScribeSampleConnector.pdb
   • ScribeChangeHistory_Create.sql
   • ScribeDelete_Trigger.sql
6. Restart the TIBCO Scribe® Agent Windows service.
7. After a few minutes, the Connector appears in the list of available Connectors in the Connection dialog in the TIBCO Scribe® user interface.

See the TIBCO Scribe® Help Center for more information about working with TIBCO Scribe® Agents, which describes installing an Agent, creating Connections, and creating a Solution.