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:
- 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.
- 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
- In System Manager, right-click InterChange Server Instances in
the left pane, then select Register Server.
- 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.
- 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.
- 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:
- In the System Manager, right-click the name of the InterChange
Server Express in the left pane and select Connect.
- 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:
- In System Manager, right-click the InterChange
Server Express name in the left pane, then select Reset Password.
- 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:
- In System Manager, right-click the running InterChange Server
Express name in the left pane and select Shut Down.
- 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.
- Restart InterChange Server Express by entering the following
command:
ProductDir/bin/ics_manager -start
- 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.
