Operating InterChange Server Express

Operating InterChange Server Express may involve the following tasks:

"Starting InterChange Server Express"

"Shutting down InterChange Server Express"

"Changing the InterChange Server Express and database passwords"

Starting InterChange Server Express

To start InterChange Server:

At startup, InterChange Server Express reads the InterchangeSystem.cfg file and sets its properties according to the parameter values listed there.

Customizing InterChange Server Express startup parameters

The parameters in table Table 5 customize the startup of InterChange Server.

Table 5. InterChange Server Express startup parameters
Parameter Function
-c configFile Name of the configuration file to be used during startup. The default is InterchangeSystem.cfg.
-i Allows InterChange Server Express to start up and ignore all error messages.
-p password Specifies the password to access InterChange Server. If you do not use this parameter, the start_server command uses the password in the InterchangeSystem.cfg file. Use with the -u parameter.
-s serverName Specifies the name of the InterChange Server. The name is case-sensitive.
-u loginName Specifies the user login name for InterChange Server. If you do not use this parameter, the start_server command uses the user login name in the InterchangeSystem.cfg file. Use with the -p parameter.
-v Displays the version of InterChange Server, then exits.

Shutting down InterChange Server Express

Shutting down InterChange Server Express stops all running collaborations and connectors, as well as InterChange Server Express itself. All connections to the database are closed and the machine's system resources used by InterChange Server Express are returned. To shut down the server, in System Manager, right-click the server name under Server Instances in the InterChange Servers section, then select Shut Down > Gracefully.

Attention:
Refrain from using Ctrl+C to shut down InterChange Server. Doing so prevents the server from shutting down in an orderly manner.

Graceful shutdown

Gracefully shutting down the system allows all currently processing and queued flows to complete before shutting down. This may take a long time because all flows waiting to be processed by a running collaboration must complete. Existing flows are processed by the collaborations, but no new flows are accepted.

If you choose to gracefully shut down the system, the following occurs:

Note:
This procedure cannot be used to shut down an HA system.

Immediate shutdown

Immediately stopping the system forces the system to shut down without processing any more flows. Running connectors and collaborations are stopped immediately. When the system is restarted, flows that were interrupted by the immediate shutdown are redelivered in the same processing order. If one of these flows wrote data to an application, when the flow is redelivered, it tries to duplicate the data and fails because the data already exists. If the collaboration processing the flow is transactional, a rollback occurs. If the flow is not transactional, it is moved to the resubmission queue.

Note:
Immediately stopping the system does not compromise the integrity of the data or the integrity of the Business Integration Express for Item Sync system.

Use this option when you need to quickly shut down the system. For example, you may want to reboot the system, but a collaboration has multiple events waiting to be processed. Shutting down gracefully may take too much time because the collaborations need to complete all existing work before stopping.

Changing the InterChange Server Express and database passwords

Password encryption provides a measure of security for protecting the Business Integration Express for Item Sync system and underlying databases from unauthorized user entry. The encrypted string for each of the passwords is stored in InterChange Server Express and is accessed by the server when the password must be decrypted. In the InterchangeSystem.cfg file, the encrypted password is placed in the PASSWORD*= parameter.

The InterChange Server Express administrator and database passwords are requested during system installation by Installer and are encrypted and stored when the system is rebooted at the completion of the installation. Thereafter, you can change the InterChange Server Express password or the database password in System Manager.

The InterChange Server Express user name and password are required during repository copy and restoration when the repos_copy command is used. See Using Repos_Copy.

For instructions on changing the password for InterChange Server Express or for the database(s), refer to the following sections:

Changing the InterChange Server Express password

Changing the database passwords

Changing the InterChange Server Express password

To change the password for InterChange Server:

  1. Open System Manager.
  2. Right-click the server under Server Instances in the InterChange Servers section of System Manager, then select Change Password. The Change InterChange Server Express Password dialog box appears.
  3. Enter the current password in the Old Password field.
  4. Enter a new password in the New Password field.
  5. Reenter the new password in the Confirm Password field.
  6. Click OK.

The encrypted password is stored in the InterchangeSystem.cfg file.

Attention:
The InterChange Server Express password can be changed only by using this procedure. If you try to change the password by editing the password in the InterchangeSystem.cfg file, InterChange Server Express will not start.

Changing the database passwords

The repository database passwords can be changed through System Manager once the Business Integration Express for Item Sync system is operating.

To change the database passwords:

  1. Under Server Instances, right-click the server under whose database password you want to change, then select Edit Configuration. The upper-right section of the window changes to an editing tool in which many system properties can be changed.
  2. Click the Database tab to access the database configuration properties. The Server Property and Configuration window for database properties appears (see Figure 8).

    Figure 8. Database tab of Edit Configuration window


  3. Change any of the database passwords:
    1. In the section for the appropriate database (Event Management, Transactions, or Repository), click the Change button.

      A dialog box for changing the password appears.

    2. Type the old password in the Old Password field.
    3. Type a new password in the New Password field.

      A maximum of 30 characters is allowed.

    4. Retype the new password in the Confirm Password field.
  4. Click OK.

Copyright IBM Corp. 1997, 2003