Working with InterChange Server Express instances

This section describes the tasks you perform in System Manager to work with InterChange Server Express.

Registering an InterChange Server Express instance

To work with an InterChange Server Express instance you must register it in System Manager. Do the following:

Important:
To connect to an InterChange Server Express instance, it must be running. For information on starting InterChange Server Express see the WebSphere InterChange Server: System Administration Guide. You can still register a server that is not running, but System Manager will not be connected to it after doing so.

  1. Do one of the following to display the "Register Server" dialog:
  2. Do one of the following to enter the name of the server in the Server name field:
  3. Type the user name to interact with the InterChange Server Express instance in the User name field.

    The default user name is admin.

  4. Type the password for the user name specified in step 3 in the Password field.

    The default password for the default user name admin is null.

  5. If you do not want to have to supply the user name and password each time you have to connect to the InterChange Server Express instance in System Manager then enable the Save User ID and Password checkbox.
    Important:
    Be sure to consider the security implications of caching the user name and password in this way. Some component definitions require sensitive information such as valid user names and passwords to log in to the applications being integrated. With such information, an individual could gain access to records stored in those applications and the critical information stored in those records, such as credit and payroll information. It is recommended that you only cache the user name and password in this way when the only information that could be accessed through System Manager is not production information.
  6. To register the InterChange Server Express instance as a local test server, enable the Test Server checkbox and then either type the full path to the InterChange Server Express product directory in the Test Server Installation Path field, or use the Browse button to navigate to the product directory.

    You should only enable this checkbox when you need to test an interface, and should leave it disabled when developing components or when working with a production server.

    For more information on testing interfaces, see Using Integrated Test Environment and Using Collaboration Debugger.

  7. Click OK.

    System Manager registers the InterChange Server Express instance, connects to it (if the name of the InterChange Server Express instance, the user name, and the password supplied are all accurate and the server and the IBM Java Object Request Broker (ORB) are running), and displays an entry for it in the InterChange Server Express Component Management view.

    You can subsequently work with the InterChange Server Express instance by right-clicking it in the InterChange Server Express Component Management view.

Connecting to InterChange Server Express

When you register an InterChange Server Express instance in System Manager, System Manager automatically connects to the instance if the instance name, the user name, and the password are all accurate and the server and the IBM ORB are running.

If you have to shut down the instance, or exit from System Manager, then you need to reconnect System Manager to the instance. The task is slightly different depending on whether or not you chose to cache the user name and password, so follow the steps in the appropriate following section.

Connecting with a cached user name and password

Do the following if you chose to cache the user name and password when registering the server initially:

  1. Right-click the entry for the InterChange Server Express instance in the InterChange Server Express Component Management view and choose Connect from the context menu.

    The "Login" dialog is displayed with the login information cached.

  2. Click OK.

Note:
If System Manager was unable to connect to the server, see Troubleshooting problems connecting to InterChange Server Express in System Manager.

Connecting when the user name and password have not been cached

If you did not choose to cache the user name and password when initially registering an InterChange Server Express instance, then you must do the following:

  1. Right-click the entry for the InterChange Server Express instance in the InterChange Server Express Component Management view and choose Connect from the context menu.
  2. Type the user name to interact with the InterChange Server Express instance in the User name field.

    The default user name is admin.

  3. Type the password for the user name supplied in step 2 in the Password field.

    The default password for the default user name admin is null.

  4. If you do not want to have to supply the user name and password each time you have to connect to the InterChange Server Express instance in System Manager then enable the Save userid/password checkbox.
    Important:
    Be sure to consider the security implications of caching the user name and password in this way. Some component definitions require sensitive information such as valid user names and passwords to log in to the applications being integrated. With such information, an individual could gain access to records stored in those applications and the critical information stored in those records, such as credit and payroll information. It is recommended that you only cache the user name and password in this way when the only information that could be accessed through System Manager is not production information.
  5. Click OK.

InterChange Server Express modes

InterChange Server Express can run in different modes that best suit different stages of the implementation cycle.

Production mode

By default, InterChange Server Express starts in production mode.

In production mode, InterChange Server Express is designed to guarantee the integrity of the repository. It will not allow you to deploy a package with unresolved dependencies to the repository, and it automatically compiles all maps and collaboration templates in the deployment package. These restrictions guarantee that the server environment is in a state in which its components can execute properly. If there were components with unresolved dependencies or uncompiled components in the server environment at runtime then any transactions that involved those components would fail. Although that is an acceptable situation in a development environment, where it is presumed that you are still creating the required components, it is not considered acceptable in a production environment, so these restrictions enforce safe deployment procedures.

Production mode is the default mode for InterChange Server Express, so you do not have to take any configuration steps to start it in production mode. If you want to start it in production mode, however, be sure that you have not taken steps to start it in design mode and confirm its mode in the InterChange Server Express Component Management view of System Manager.

Test mode

Once you have registered InterChange Server Express, you will be able to start the server in test mode. To start InterChange Server Express in test mode, use the -test parameter when starting the server.

Note:
In order for the server to run in test mode, you want to make sure that the test role has the operation permission to perform such tasks as start, shut down, deploy and so on.

Local and remote servers are supported in Integrated Test Environment (ITE). A local server is an InterChange Server Express started from the task manager of the Integrated Test Environment. To launch a server from task manager, InterChange Server Express should be registered as a local server in the registration panel. A remote server is an InterChange Server Express launched outside the ITE. Therefore, even a server started on the same machine as ITE can be a remote server if it is launched outside ITE.

The local server script can be modified automatically to ensure that the server starts up as a test server. A remote server does not have the capability to start this way; therefore, the server launch option will be disabled if the registered server is a remote server.

Design mode

In design mode, InterChange Server Express permits the repository to be in an inconsistent state--you can import components into the repository without components they depend upon already existing. For instance, if you customize and try to import a new business object definition that requires a child object, but the child object does not exist in the repository, then an InterChange Server Express instance in production mode would cause the import to fail to protect the integrity of the repository. An InterChange Server Express instance in design mode, however, would allow you to proceed so that you can assemble your integration components in a way that best suits your development approach.

Furthermore, compiling maps and collaboration templates when deploying a package to a design-mode server is optional. In production mode, the server automatically compiles all maps and collaboration templates.

Design mode is particularly useful when you are importing components from another environment. You may not be aware of all the dependencies yourself, so being able to incrementally import components without the import operations failing due to unresolved dependencies is very helpful.

To start InterChange Server Express in design mode, use the -design parameter when starting the server:

Changing the InterChange Server Express password

You can change the password for the user account that is used to connect to InterChange Server Express. Do the following to change the password:

  1. Right-click the entry for the InterChange Server Express instance in the InterChange Server Express view and choose Change Password from the context menu.

    The "Change InterChange Server Express Password" dialog displays.

  2. Type the current 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 Password field.
  5. Click OK.

Refreshing InterChange Server Express

After you have deployed components to an InterChange Server Express instance you must refresh the instance in System Manager for it to accurately display the components in the server. For instance, if you deploy components to a server and then try to create a new integration library and add components to the library from the server, System Manager does not list the recently deployed components unless you refresh the server.

To refresh a server instance, right-click it in the InterChange Server Express Component Management view and choose Refresh from the context menu.

Disconnecting from InterChange Server Express

To disconnect System Manager from an InterChange Server Express instance, right-click the InterChange Server Express instance from which you want to disconnect in the InterChange Server Express Component Management view, then select Disconnect from the context menu.

Shutting down InterChange Server Express

To shut down an InterChange Server Express instance, right-click the InterChange Server Express instance you want to shut down in the InterChange Server Express Component Management view, then select Disconnect from the context menu and then either select Gracefully or Immediately from the submenu depending on how you want the instance to shut down.

If you select Immediately as the type of shutdown, then InterChange Server Express shuts down immediately and any flows that it might be processing at the time fail. You can subsequently resolve any failed flows by using Flow Manager. Use this type of shutdown in development and test environments where you do not care about the flows in the system or in production environments where there are no complications presented by submitting failed flows.

If your InterChange Server Express is running on OS/400, an immediate shutdown can also be done by either of the following:

If you select Gracefully as the type of shut down, then the InterChange Server Express integration components will finish processing their current flows before the server shuts down. Use this type of shutdown in production environments where there may be complications resulting from flow failures.

If your InterChange Server Express is running on OS/400, in addition to using the InterChange Server Express Component Management view, you can also shutdown the server gracefully from the OS/400 system. To do so, use the OS/400 CL command QSH to enter the QShell environment, and run the following script:

/QIBM/ProdData/WBIServer44/bin/stop_server_gracefully.sh 

serverName -uAdmin -pPassword

where serverName is the name of the InterChange Server Express instance (the installed default server is named QWBIDFT44), and Password is the password for the admin Server Express user ID.

Note:
If InterChange Server Express is running on Windows, you can also shut down InterChange Server Express by closing the console window in which it is running. This results in an immediate shutdown, and any flows currently being processed will fail. This may be acceptable in a development environment, if the integrity of the data does not matter, but should not be done in a production environment. A benefit of using System Manager to shut down InterChange Server Express even in a development environment is that the InterChange Server Express Component Management view displays the status of the server, but it cannot detect and report changes in the state of the server if it is shut down by some other means than the use of System Manager.

Deleting an InterChange Server Express instance from the view

You may want to remove an InterChange Server Express instance from the InterChange Server Express Component Management view in System Manager. Do the following to remove an InterChange Server Express instance:

  1. Ensure that System Manager is not connected to the InterChange Server Express instance you want to remove. You can do this by either disconnecting System Manager from the InterChange Server Express instance or by shutting down the InterChange Server Express instance.

    For more information on disconnecting System Manager from an InterChange Server Express instance, see Disconnecting from InterChange Server Express.

    For more information on shutting down an InterChange Server Express instance, see Shutting down InterChange Server Express.

  2. In the InterChange Server Express Component Management view, right-click the InterChange Server Express instance you want to remove, then select Delete from the context menu.
  3. At the "Delete server confirmation" prompt click OK.

    The server instance is removed from the view.

Other System Manager commands for InterChange Server Express

The context menu displayed when you right-click an InterChange Server Express instance has several additional menu items.

Table 3. Other System Manager commands for InterChange Server Express
InterChange Server Express menu item
Edit Configuration For more information on this menu item, see Configuring InterChange Server Express.
Statistics For more information on this menu item, see the WebSphere InterChange Server: System Administration Guide.
System View For more information on this menu item, see the WebSphere InterChange Server: System Administration Guide.
Server object delete For more information on this menu item, see Deleting components using the Server Object Delete Wizard.
Delete Repository Deleting the entire repository.
Monitor definition wizard For more information on this menu item, see the WebSphere InterChange Server: System Administration Guide.

Copyright IBM Corp. 2004, 2005