After an integration project has been developed and tested, it is necessary to deploy the run-time components to the machines on which they will ultimately run in a production environment. An adapter instance can be deployed, started and managed using one of the following methods:
Enterprise Edition must be used if your adapter is part of a TIBCO BusinessWorks process. Enterprise Edition allows you to deploy, monitor, start and stop adapters from the Administrator web browser.
Repository Edition provides the repository server and the ability to set access control to your projects. This method requires you to manually create the adapter properties file and start and stop the adapter on the command line.
During development, you save your design to a project. When you are ready to deploy your project to a machine, you generate an Enterprise archive file (EAR file) from TIBCO Designer. The EAR file contains information on what you wish to deploy.
An Enterprise Archive file contains adapter instance configuration information, which is used by a run-time adapter. An Enterprise Archive file is generated using TIBCO Designer and imported into TIBCO Administrator.
After importing an Enterprise Archive file, the adapter can be deployed. This involves:
Before starting the adapter you can optionally specify monitoring options, including:
The adapter is started and stopped using the TIBCO Administrator GUI.
If you are using Repository Edition, you must export your project to a repository server, then create an adapter properties file where the location of the project repository, adapter instance and other runtime options are defined.
In TIBCO Designer, after the project has been configured, verified and tested, you export the project to be managed by an administration server. The server provides
Before starting the run-time adapter you must create a properties file or edit the default properties file that is provided in the adapter package. Each adapter must have a unique properties file. The easiest way to deploy an adapter is to copy the default properties file to a unique name and edit the properties defined in the file. Values for the following parameters are typically changed:
tibco.repourl
pathname of the TIBCO Designer project that contains the configuration information used by the run-time adapter.tibco.configurl
name of the adapter instance to run. The name is defined at design-time. If you nest an adapter instance under one or more folders in TIBCO Designer, the folder structure must also be specified as part of the tibco.configurl
parameter. application.args
name of the properties file to pass to the run-time adapter.tibco.clientVar.
<varname>
value for a global variable in a properties file. This overrides the global varible setting defined in the project.tibco.username
account name defined in TIBCO Administrator to access a server-based project.tibco.password
password to the account.These options are explained further in each adapter’s user’s guide.
An adapter is started from the command line. When starting an adapter against a local project, any user with file system read privileges set on the project can start the adapter. When starting the adapter against a server-based project, and if the project has been configured (using TIBCO Administrator) with access control restrictions, the user name and password must be supplied.
TIBCO Adapter™ Concepts April 2005 Copyright © TIBCO Software Inc. All rights reserved www.tibco.com |