Setting up InterChange Server Express

To efficiently manage InterChange Server Express, you must register it with and connect to it through System Manager. The following sections describe how to perform these tasks:

Starting System Manager on the remote Windows machine

System Manager is the GUI to InterChange Server Express and the repository. It runs only on Windows XP and Windows 2003 platforms.

To start System Manager, on the remote Windows machine, select Start > Programs > IBM WebSphere Business Integration Express > Toolset Express > Administrative > System Manager.

Note:
The System Manager perspective should appear by default. If it does not, select Window > Open Perspective > Other in the IBM Eclipse SDK menu bar, and then double-click System Manager to start System Manager.

Registering InterChange Server Express with System Manager

System Manager can manage instances of InterChange Server Express. You must register any instance you want to manage with System Manager. After you register the server, its name always appears in System Manager, unless you remove it.

To register an InterChange Server Express instance, follow these steps:

  1. Ensure that the Windows client hosting the System Manager can access the Name Server correctly by checking that the ORB_HOST property in the ProductDir\bin\CWSharedEnv.bat file is set to the IP address of the machine running the InterChange Server Express. If it is not, set this value by entering the following on a command line on the Windows client:
    set ORB_HOST=IP_address
    Note:
    Alternatively, you can set ORB_HOST=machine_name and then add the line IP_address machine_name to the %windir%\system32\drivers\etc\hosts file. In this example, IP_address is the IP address of the machine hosting the InterChange Server Express; machine_name is the name of the machine hosting the InterChange Server Express.
  2. Ensure that the Name Server can correctly retrieve by name the InterChange Server Express on the Linux machine by checking the /etc/hosts file on the Linux machine for entries similar to
    ip_address localhost.localdomain localhost
  3. In System Manager, right-click InterChange Server Instances in the left pane, then select Register Server.
  4. In the Register new server dialog box, browse for or enter the name of the InterChange Server Express.
    Note:
    Select the Test Server check box if you intend to use the server in an integrated test environment. An integrated test environment communicates only with servers that are registered as local test servers.
  5. Type the user name and password and select the Save User ID and Password check box. This has to be the same user name and password you entered at the RBAC screen during the Launchpad installation process.
  6. Select OK.

    The server name appears in the left pane of the System Manager window. If it does not, expand the InterChange Server Instances folder.

Connecting to InterChange Server Express

Verify that the registered InterChange Server Express is running by connecting to it. To connect to InterChange Server Express using System Manager, follow these steps:

  1. In the System Manager, right-click the name of the InterChange Server Express in the left pane and select Connect.
  2. Select OK on the Server User ID and Password confirmation screen.

Tip:
If the icon beside the name of the InterChange Server Express in the left pane of System Manager is green in color, the InterChange Server Express is already connected to System Manager.

Changing the InterChange Server Express password

InterChange Server Express is protected by a password that only the InterChange Server Express administrator knows. The password was created on the RBAC screen during installation. If you want to change the password for security reasons, you can do so after setting up the system.

To change an InterChange Server Express password, follow these steps:

  1. In System Manager, right-click the InterChange Server Express name in the left pane, then select Reset Password.
  2. In the dialog that opens, select the user name, type the old password, the new password, re-enter the new password to confirm it, and then select OK.

Restarting InterChange Server Express

For password changes to take effect, you must shut down InterChange Server Express, then restart it by doing the following:

  1. In System Manager, right-click the running InterChange Server Express name in the left pane and select Shut Down.
  2. On the Shut Down Server dialog box, either shut down the server gracefully, after allowing it to finish current work, or shut it down immediately, without performing cleanup.

    Select Gracefully, then select OK.

    Note:
    Select Immediately only when you must shut down the server without waiting.
  3. Restart InterChange Server Express by entering the following command:
    ProductDir/bin/ics_manager -start
  4. Connect to InterChange Server Express by right-clicking the InterChange Server Express name in System Manager. In the dialog that opens, enter the user name and password for the server and select OK.

Copyright IBM Corp. 2004, 2005