Configuring InterChange Server during installation

After InterChange Server components are installed, the InterChange Server Configuration screen appears. It is at this point that you can configure your environment for your specific needs.

The InterChange Server Configuration has the "InterChange Server", "WebSphere MQ", "Database" and "Security" configuration tabs. Enter values in the fields, using either the defaults or values specific to your environment. The information below each figure provides descriptions of the fields in each screen.

See Appendix A, InterChange Server configuration parameters for specific configuration parameter information.

Configuring server properties using the wizard

The "InterChange Server" tab of the configuration wizard allows you to change some basic properties of the server itself. Do the following to configure the InterChange Server properties:

  1. Click the "InterChange Server" tab.
  2. Type the name of the InterChange Server instance in the Server Name field.
  3. Do one of the following to set the value of the Log File field:
  4. Select the desired locale from the Locale list.

Figure 13 shows the "InterChange Server" tab:

Figure 13. InterChange Server configuration tab

The figure shows the InterChange Server tab of the InterChange Server Configuration window. The tab has three entries: Server Name (the name of the ICS server machine), Log file (with a default path and a browse button) and Locale (a pull-down menu with a choice of languages, shown in the default of US English). At the bottom of the window are action buttons: Default, Discard (which is displayed inactive), Apply and Exit.

Configuring WebSphere MQ properties using the wizard

The "WebSphere MQ" tab of the configuration wizard allows you to change properties that specify how InterChange Server communicates with the WebSphere MQ persistent messaging server. Do the following to configure the WebSphere MQ properties:

  1. Click the WebSphere MQ tab.
  2. Type the name of the computer on which the WebSphere MQ server is installed in the Host Name field.
  3. Type in the Port Number field the port over which WebSphere MQ allows clients to communicate with the server.

    The default port is 1414.

  4. Type in the Queue Manager Name field the name of the queue manager that has been created to contain the queues on which InterChange Server will persistently store messages for the flows it processes.
  5. Type in the Channel field the name of the channel over which clients of WebSphere MQ communicate with the WebSphere MQ server. The default value is CHANNEL1. Consult with the WebSphere MQ administrator at the site to determine if CHANNEL1 can be used and if not, which channel can be used.

Figure 14 shows the "WebSphere MQ" tab:

Figure 14. WebSphere MQ configuration tab

The figure shows the WebSphere MQ tab of the InterChange Server Configuration window. The tab has four entries: Host Name (with the server name entered), Port Number (set to its default value of 1414), Queue Manager Name (with the name of the ICS queue manager entered) and Channel (set to its default value of CHANNEL 1). At the bottom of the window are action buttons: Default, Discard, Apply and Exit.

Configuring database properties using the wizard

The "Database" tab of the configuration wizard allows you to change properties that specify the databases InterChange Server uses to store repository, event management, transaction management, and flow monitoring data. Do the following to configure the database properties:

  1. Click the Database tab.
  2. Select the appropriate value in the Database Driver list--either DB2, MS SQL Server(Type 4), or Oracle(Type 4)--depending on the database vendor.
  3. Type the maximum number of connections you want InterChange Server to make with the database server in the Max Connections field, or enable the Unlimited checkbox to allow InterChange Server an unlimited number of connections.
  4. Type the maximum number of pools InterChange Server should establish to contain the database connections it caches in the Max Pools field.
  5. Type the number of minutes you want a connection object to remain idle before being returned to the database connection pool for reuse in the Idle Timeout field.
  6. Do the following in the "Event Management" pane to configure the database connectivity for the event management service:
    1. If you chose MS SQL Server(Type 4), or Oracle(Type 4) in the Database Driver list, then type the name of the computer on which the database server resides in the Host Name field.
    2. Type the name of the database in the Database field. Ensure that the database name you specify matches the database name that you established when you created your database for use with the WebSphere business integration system. For more information, see Installing and configuring the database server.
      Note:
      Names of DB2 databases must contain eight or fewer characters.
    3. Type the maximum number of connections you want InterChange Server to make with the specific database server in the Max Connections field, or enable the Unlimited checkbox to allow InterChange Server an unlimited number of connections.
    4. Type the user name that should be used by InterChange Server to log in to the specified database in the Login field. Ensure that the database user name specified matches the ICS database account name that you established when configuring your database for use with the WebSphere business integration system. For more information, see Installing and configuring the database server.
    5. Type the password for the user name specified in step 6d in the Password field. Ensure that the database user password specified matches the database password that you established when configuring your database for use with the WebSphere business integration system. For more information, see Installing and configuring the database server.
    6. If you chose MS SQL Server(Type 4), or Oracle(Type 4) in the Database Driver list, then you must type the port number through which clients communicate with the database server in the Port Number field. See the section Setting up ports for information on port numbers.
  7. Repeat step 6 in the "Transactions" pane to configure the database connectivity for the transaction management service.
  8. Repeat step 6 in the "Repository" pane to configure the database connectivity for the repository service.
  9. Repeat step 6 in the optional "Flow Monitoring" pane to configure the database connectivity for the flow monitoring service.
    Note:
    Flow monitoring is not supported with the MS SQL Server (Type 4) driver.

Changing database passwords

Do the following to change the password for the user name that InterChange Server uses to access one of the databases:

  1. Click Change next to the Password field in the "Event Management", "Transactions", "Repository", or "Flow Monitoring" panes.
  2. Type the new password in the New Password field.
  3. Type the new password again in the Confirm New Password field.
  4. Click OK.

Figure 15 shows the "Database" tab:

Figure 15. Database connectivity configuration tab

The figure shows the Database tab of the InterChange Server Configuration window. The tab has five major areas: Database connectivity, Event Management, Transactions, Repository, Flow Monitoring. At the bottom of the window are action buttons: Default, Discard, Apply and Exit.

Notes:

  1. Flow Monitoring is not supported for MS SQL Server. If you are using MS SQL Server as your repository database, the Flow Monitoring portion at the bottom of this tab is disabled.

  2. The field called "Schema Name" in the Flow Monitoring portion of this tab was new in release 4.2.2. If a specific value for this field is not entered, it will default to the same value used for the "Login" field. Valid values for this field can contain up to 30 characters from the US-ASCII character set. The name must begin with a letter from A through Z and the first three characters cannot be SYS. Other characters in the name can include the letters A through Z and numbers 0 through 9. For information on the prerequisite software needed to utilize flow monitoring, as well as detailed explanations of flow-monitoring concepts, see the System Administration Guide.

Configuring security settings using the wizard

The Security tab of the InterChange Server Configuration Wizard gives access to the security options. Choose between the local WBI repository (the default) or an LDAP directory as the location for a user registry (a secure list of user names and passwords for authorized users). Do the following to configure the security options:

  1. Click the Security tab.
  2. In the User Registry list, select either Repository (to use the local WBI repository) or LDAP (to use an LDAP directory) for the location of the user registry.
    Note:
    If you are using an LDAP directory as your user registry, then none of the remaining options are active. The advanced options for the LDAP option are available through the System Manager.
  3. In the Host Name field, type the name of the computer on which the database server resides.
    Note:
    This field is inactive if DB2 is selected as the database driver.
  4. Type the name of the database in the Database field. Ensure that the database name you specify matches the database name that you established when creating your database for use with the WebSphere business integration system. For more information, see Installing and configuring the database server.
  5. Type the user name that should be used by InterChange Server to log in to the specified database in the Login field. Ensure that the database user name you specify matches the ICS database account name that you established when configuring your database for use with the WebSphere business integration system. For more information, see Installing and configuring the database server.
  6. Type the password for the user name specified in step 5 in the Password field. Ensure that the database user password you specify matches the database password that you established when configuring your database for use with the WebSphere business integration system. For more information, see Installing and configuring the database server.
  7. Type the maximum number of connections you want InterChange Server to make with the database server in the Max Connections field, or enable the Unlimited check box to allow InterChange Server an unlimited number of connections.
  8. Type the port number through which clients communicate with the database server in the Port Number field. See the section Setting up ports for information on port numbers.
    Note:
    This field is inactive if DB2 is selected as the database driver.

Changing database passwords

Do the following to change the password for the user name that InterChange Server uses to access the database:

  1. Click Change next to the Password field.
  2. Type the old password in the Old Password field.
  3. Type the new password in the New Password field.
  4. Type the new password again in the Confirm New Password field.
  5. Click OK.

Figure 16. Security configuration tab

The figure shows the Security configuration tab of the InterChange Server Configuration wizard. The tab has two sections: in the upper is a pull-down list labelled User Registry which currently says Repository. The lower half of the window contains options for the Repository. There are six entry fields: Host Name which is inactive, Database which is empty, Login which is empty, Password which is empty, Max Connections which is shown inactive, with an associated check box labelled Unlimited, which is displayed checked, and Port Number which is shown inactive. There is a Change button by the Password field. Across the bottom are Default, Discard, Apply and Exit buttons.

Completing InterChange Server configuration

  1. After all required values are entered in the InterChange Server Configuration screen, select one of the following options before exiting:
  2. Click Exit.

Copyright IBM Corp. 1997, 2004