Deploying components to a server

You create integration components in a library in your local file system and deploy them to an InterChange Server Express instance to make them executable.

You can deploy a package of integration components using either the System Manager graphical interface or the repos_copy command-line interface. For information on using System Manager, see Deploying components using the deployment wizard. For information on using repos_copy, see Using repos_copy. For information on the advantages and disadvantages of each interface, see Deciding to use System Manager or repos_copy for deployment.

Deciding to use System Manager or repos_copy for deployment

Table 6 describes the advantages and disadvantages of using System Manager or repos_copy for deployment. Evaluate the two interfaces and use whichever one is best suited to your needs.

Table 6. Advantages and disadvantages of System Manager and repos_copy in deployment

Interface Advantages Disadvantages
System Manager
  • System Manager uses a graphical interface.
  • You can selectively choose the components in the user project that you want to deploy.
  • You can choose to create relationship schemas in the server repository during the deployment, or can choose for them to not be created.
  • You can deploy multiple user projects at the same time.
  • With drag-and-drop deployment, you can deploy user projects, integration component libraries, or even individual components easily.

  • System Manager runs only on Windows.

repos_copy
  • There is no requirement to have components grouped together, as they must be in a user project when deploying through System Manager.
  • Repos_copy is platform-independent.

  • Repos_copy uses a command line interface.
  • You must export the components you want to deploy to a package file first, using either System Manager or repos_copy.
  • You cannot selectively deploy components in the package file.
  • You can only deploy a single package file at a time.

Setting deployment configuration properties

When you deploy a user project from System Manager to different servers, the configuration properties for some of the integration components may need to change for the new server environment. For example, an adapter in your solution may have properties that specify a database URL, a user name, and a password that are all valid for your development and testing server. But the production environment in which the solution will be deployed may require different values for these properties. Rather than manually reconfiguring the adapter (by manually using the connector configurator to change the connector configuration properties) --and other integration components that might require modification for the new environment--you can use the deployment configuration feature of System Manager.

The deployment configuration feature of System Manager enables you to define a set of values for certain integration component properties and make them applicable to a specific server (or servers) that you name. The values are stored in a deployment file (with the extension .dfg) associated with an Integration Component Library. When you deploy an existing user project to one of the servers that you listed in deployment configurator, System Manager uses the property values from the deployment file to modify the existing configuration files for the relevant components of the user project.

This feature can be used to modify the properties of connectors, maps, collaborations, and relationships.

To create and deploy properties using the deployment configuration feature, follow these steps:

Note:
If you plan to deploy encrypted property values, before you begin, open the shortcut properties for your InterChange Server Express instance, and add the path to the JRE you are using.

Opening the deployment configuration dialog

To open the deployment configuration dialog, do this:

Adding a server name

To add a server to the deployment file, in the Select the server section you must designate a name for a server that will use the deployment time properties that you are creating.

Adding integration components

After you have selected or named a server, you must add the integration components, properties, and values that you want to apply for use with that server.

If you have previously added elements for one server, when you later add a new server in the Deployment Configuration dialog, it will automatically be populated with the elements previously created. You can then delete or modify the elements.

If you have not previously added configuration elements in the dialog for any server, you will need to add elements to the dialog for the first time. You can do so either by importing an existing deployment file (described later in this section) or by manually adding elements in the dialog. To manually add elements, position the cursor in the Property Name column, and right-click. The Components Selection dialog appears, displaying all the available integration components in the ICL that you right-clicked to open the Deployment Configuration dialog. Expand the categories as necessary. Then, for each individual component for which you want to configure properties, click the checkbox for the component, and choose OK. Do this in turn for each individual component. When you choose OK each time, the Components Selection dialog closes, and the Deployment Configuration dialog displays, showing the new component that you have added.

Adding properties

For each component that you add, you will need to also add the properties whose values you want to set for that component. To do so:

  1. Right-click in the value field next to the component for which you want to add properties. Choose Add Property.
  2. The Properties Selection dialog appears, prefilled with all the properties that are available within the selected component definition.
  3. Put checks in the boxes for one or more properties, and choose OK.
  4. The Add Property dialog closes, and the Deployment Configuration dialog displays, showing the properties that you have added for the specific component.

Assigning values

Now you need to specify the values that you want to use for these properties. To do so:

  1. Double-click in the Value field for any property.
  2. Enter the value you want to use for that property.
    Note:
    Consult the documentation for your component to determine the available values. The tool does not validate the values as you enter them.

When you are done, click OK. The Deployment Configurator dialog closes. When you open the Deployment Configurator dialog again, the last configuration that you created will be displayed by default. If you have created more than one configuration (that is, if you have named more than one server in the Deployment Configuration dialog) you can display any of the other configurations by using the Please select destination server drop-down box.

Deploying the property values

After you have created a deployment configuration, the integration component properties and their values can be deployed to another server. After deployment , the property values you specified during deployment configuration will be applied to the component that went into the server. You can deploy to a server in either of the following ways:

When you export an ICL or User Project from System Manager , the deployment descriptor.dfg file with the relevant entries will be included with the repository jar file. You can then use the repos_copy utility to repos copy the .jar file into the server. The values for the configuration file inside the .jar file will be automatically applied to the components before being deployed to the server.

If you do not want the transformations to happen, you can suppress them using the following option:

repos_copy -sserverName -uusername -ppassword -ireposcopyfile  -xdn

The -xdn option ignores the .dfg file inside the repository .jar file and sends the deployment package to the server without changing the property values.

Export and import of deployment configuration properties

After deployment configuration properties have been created in Deployment Configurator for one server, you can export those properties to a file, and then import that file as the starting point for the deployment configuration properties of another server. To do so, right-click in a field in the Property Name column, and choose Import. The Import Properties dialog appears, providing the following choices:

Copying and pasting deployment configuration properties

Deployment configuration properties created for one server can be copied and pasted into the configuration for another server. When you copy and paste properties, any values assigned to those properties are copied and pasted as well. When you paste properties, if the properties already exist in the configuration, they are overwritten by the paste operation.

Setting deployment properties without System Manager

A standalone utility, contained in the deploymentconfigutil.zip file in the product \bin directory, can allow a *.dfg file to be edited without the use of System Manager. This can be useful, for example, in a situation where a database administrator needs to have a connector password property set to a specific value for interacting with the database, but does not want to reveal that value to the implementer who is using System Manager. The implementer can use the Deployment Configurator feature of System Manager to create a *.dfg file with default values and then send that file to the database administrator. The database administrator then runs the standalone utility, which allows modification of the property values (not the addition or deletion of integration components or properties). The database administrator uses the utility to modify the password value, and then sends the file back to the implementer, who uses System Manager to import the *.dfg file into Deployment Configurator.

This utility is controlled by a pre-defined password and you must contact the product support center to get one. The password is intended to prevent users without appropriate privileges from changinge the passwords or encrypted data specified in the deployment descriptor files.

This standalone utility is contained in the deploymentconfigutil.zip file, which resides in the IBM\WebSphere\bin directory. The file can be extracted and used on a system that does not have either System Manager or InterChange Server Express installed.

Setting the initial states of components for deployment

For components with states (such as connectors, collaboration objects, maps, relationships, and database connection pools), you can set the state in which the component initializes when rebooting the server after deployment. Do the following to set the initial post-deployment state of components:

  1. Select the shortcuts for the components whose initial states you want to set in a user project.

    You can use standard Windows selection techniques to choose multiple components, such as the following:

  2. Right-click the selection made in step and do one of the following:

Validating a package using System Manager

You can validate a package comprised of the components you want to deploy before performing the deployment to ensure that the deployment will succeed. Do the following to validate a package of components:

  1. Add shortcuts for the components you want to validate to user projects.

    For information on creating a user project see Creating user projects, and for information on adding shortcuts to a user project see Adding shortcuts to a user project.

    Note:
    You can validate multiple user projects at once, so add shortcuts for all of the desired components to the appropriate user projects.
  2. In the WebSphere Business Integration System Manager view, select the user projects you want to validate, right-click one of the selected user projects, and choose Validate user project from the context menu.

    System Manager displays the "Validate Project(s)" wizard, as shown in Figure 19.

    Figure 19. Selecting components for validation


  3. Select the server against which you want to validate the components from the Please select the server to validate with drop-down menu.
  4. Use the following techniques to select the components you want to validate:

    Note:
    If you select components with the same name from multiple user projects you will be required to select a single one from among the duplicates at the next screen of the wizard.

    If you have not selected any duplicate components, proceed to step 6.

    If you have selected duplicate components, proceed to step 5.

  5. Click Next.

    System Manager displays the "Local Duplicates" screen, as shown in Figure 20.

    Figure 20. Selecting distinct components from user projects to validate


    Select distinct components among the duplicates.

  6. Click Finish.

    System Manager creates a package containing the selected components and validates it against the server repository. A message is displayed to indicate whether validation was successful or not.

Deploying components using System Manager

You can deploy components to an InterChange Server Express instance in one of two ways described in the following sections:

Deploying components using the deployment wizard

Do the following to use the deployment wizard to deploy a package of components to an InterChange Server Express instance:

  1. Except for maps, if any of the components you want to deploy already exist in the server repository, you must stop them prior to deploying them. (Because maps execute quickly and are normally idle, the system allows active map definitions to be redeployed).

    Use the InterChange Server Express Component Management view or System Monitor to stop the duplicate components in the server before deploying a package. For more information, see Managing component states in the repository.

  2. It is recommended that you set the initial state for the components you deploy. For more information, see Setting the initial states of components for deployment.
  3. Add shortcuts for the components you want to deploy to a user project.

    For information on creating a user project see Creating user projects, and for information on adding shortcuts to a user project see Adding shortcuts to a user project.

    Note:
    You can deploy multiple user projects at once, so add shortcuts for all of the desired components to the appropriate user projects.
  4. In the "WebSphere Business Integration System Manager" view, select each user project you want to deploy to the server instance. You can use standard Windows selection techniques to select multiple user projects for deployment at the same time, such as the following:
  5. Right-click a selected user project and choose Deploy user project from the context menu.

    System Manager displays the "Deploy wizard page 1 screen", as shown in Figure 21.

    Figure 21. Selecting deployable components and deployment options


  6. At the "Deployable Components" screen, do the following:
    1. Select the server instance to which you want to deploy the components from the Please select the destination server drop-down menu.
    2. Use the following techniques to select the components to deploy:
      • Enable the checkbox next to a user project to deploy all of the components in the project.
      • Expand the user project node and enable the checkbox next to entire component groups to deploy all of the components of that type.
      • Expand the user project node and a component group node and enable the checkbox next to individual components to deploy just those components.

      Note:
      If you select components with the same name in different user projects you will be prompted in the next screen of the wizard to choose which component among the duplicates should be deployed.
    3. Enable the Create schema checkbox if you want to create the database connection pool and relationship schemas during the deployment process.

      The schemas for relationships and database connection pools must be created for interfaces that reference them to work. If you are deploying an interface for the purpose of running it then you must enable this option for any components the interface uses.

      Note:
      You should only enable this option if the settings for the database connection pools and relationships reference the appropriate connection information for the server into which you are deploying the components. If you are migrating components from one environment where the database settings were correct to another environment where they will no longer be valid, you may not want to create the schemas for these components during deployment.
    4. Enable the Ignore compile warnings checkbox if you do not want to receive a prompt about warnings generated during compiling, such as about deprecated methods.
    5. Enable the Compile checkbox if you want to compile the map and collaboration templates you selected for deployment.

      Maps and collaboration templates be compiled for interfaces that reference them to work.

      Note:
      Compiling can take a long time depending on the number of components and you may want to deploy them to the server first and compile them afterwards.
    6. Do one of the following depending on your selections:
      • If you have not selected any components that are duplicates across the selected user projects and have not selected any components that already exist in the server repository then you may start the deployment at this time; proceed to step 9.
      • If you have not selected any components that are duplicates across the selected user projects, but have selected components that already exist in the server repository, then the "Server Duplicate Objects" screen appears; proceed to step 8.
      • If you have selected duplicate components within the user projects then proceed to step 7.
  7. Click Next.

    If you have selected duplicate components within the user projects then the "Deploy wizard page 2" screen appears, as shown in Figure 22:

    Figure 22. Selecting among local duplicates when deploying


    Expand the folders of the displayed user projects and enable checkboxes for the particular components you want deployed between the local duplicates.

    Do one of the following depending on your selections:

  8. Click Next.

    If you have chosen to deploy components that already exist on the server then the "Server Duplicate Objects" screen appears, as shown in Figure 23:

    Figure 23. Selecting duplicate objects to overwrite in the server


    Expand the folders of the displayed user projects and enable checkboxes for the duplicate components you want to overwrite in the server repository.

  9. Click Finish.

    System Manager attempts to deploy the selected components into the server repository. If you view the server logging output you will see messages logged as the deployment session is started and components are added to the repository.

    When the deployment session finishes System Manager either presents an informational prompt that the deployment succeeded or an error prompt that the deployment failed.

  10. Take note of any significant information displayed in the prompt. For instance, the prompt might tell you to reboot the server to activate some deployed components, or might tell you that the deployment failed because active components cannot be overwritten. Click OK and take whatever actions were specified by the prompt.

Deploying components using drag-and-drop

Do the following to deploy components by using drag-and-drop techniques among the System Manager views:

  1. If any of the components you want to deploy already exist in the server repository you must stop them prior to deploying them.

    Use the InterChange Server Express Component Management view or System Monitor to stop the duplicate components in the server before deploying a package. For more information, see Managing component states in the repository.

  2. Do the following in the WebSphere Business Integration System Manager view to select the components you want to deploy:
  3. Drag-and-drop the selected resources onto the InterChange Server Express instance to which you want to deploy the components in the InterChange Server Express Component Management view.

    System Manager attempts to deploy the components to the specified InterChange Server Express instance. Messages and errors are displayed in the Console view.

    Note:
    If you selected duplicate components in the WebSphere Business Integration System Manager view then System Manager generates an error when you try to deploy the components. Refine your selection to include only unique components and then attempt the deployment again.

Copyright IBM Corp. 2004