Administering InterChange Server Express

Administering InterChange Server Express may involve starting and shutting down the system and managing the startup parameters and database passwords. This section includes the following topics:

"Steps for starting InterChange Server Express"

Steps for customizing InterChange Server Express startup parameters

Steps for setting the InterChange Server Express mode for OS/400

"Shutting down InterChange Server Express"

"Changing the InterChange Server Express and database passwords"

Steps for starting InterChange Server Express

Perform the following steps to start InterChange Server Express:

At startup, InterChange Server Express reads the InterchangeSystem.cfg file and sets its properties according to the parameter values listed there. See the WebSphere Business Integration Server Express installation guide for Windows, for Linux, or for OS/400 for a list and description of the configuration parameters.

Steps for customizing InterChange Server Express startup parameters

Perform the following steps to customize the InterChange Server Express startup parameters:

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

Table 4. InterChange Server Express startup parameters

Parameter Function
-c configFile Name of the configuration file to be used during startup. The default is InterchangeSystem.cfg (not supported in Linux).
-design Specifies that the server is started in the design mode.
-i Allows InterChange Server Express to start up and ignore all error messages.
-p password Specifies the password to access InterChange Server Express. 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 Express instance. The name is case-sensitive.
For Linux and Windows, this parameter is hard coded as WebSphereICS, and you must modify the start_server.bat or ics_manager script to change the server name.
For OS/400, the default name is QWBIDFT, and you can create other instances. The serverName parameter is passed to start_server.sh from submit_ics_server.sh. Do not invoke start_server.sh directly, instead invoke submit_ics_server.sh, which requires serverName as a parameter.
-u loginName Specifies the user login name for InterChange Server Express. 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 Express, then exits (not supported in Linux).

Steps for setting the InterChange Server Express mode for OS/400

Setting the server mode allows the server to be started in the set mode each time it is started, except when the mode parameter (-design or -kproduction) is passed on the submit_ics_server.sh script.

Setting the server mode starts the server in the set mode each time it is started except when the mode parameter

Perform the following steps to set the server mode for OS/400:

  1. From the command line, type the QSH command and from the QSHELL environment, cd to /QIBM/Proddata/WBIServer43/bin.
  2. Run the script: set_ics_server_mode.sh WebSphereICSName design|production
    where WebSphereICSName is the name of the InterChange Server Express instance, QWBIDFT by default.

Note:
If the set mode for a server is design mode, but you want to start it in production mode, you can run the following script: submit_ics_server.sh WebSphereICSName -kproduction.

Shutting down InterChange Server Express

Shutting down InterChange Server Express stops all running collaborations and connectors and InterChange Server Express itself. All connections to the database are closed and the machine's system resources used by InterChange Server Express are returned.

Attention:
Refrain from using Ctrl-C (or the ENDSBS CL command on the QWBISVR43 subsystem for OS/400) to shut down InterChange Server Express. Doing so prevents the server from shutting down in an orderly manner.

Steps for shutting down InterChange Server Express gracefully

Perform the following steps to shut down the server gracefully:

  1. In System Manager, go to the InterChange Server Component Management view.
  2. Right-click the InterChange Server Express instance and click Shut Down > Gracefully.
Linux

On Linux you can also use the $./ics_manager -stopgraceful script to shut down InterChange Server Express gracefully.

OS/400

On OS/400, you can also use the stop_server_gracefully.sh script to shut down InterChange Server Express gracefully. From the command line, type the QSH command and from the QSHELL environment, cd to /QIBM/Proddata/WBIServer43/bin and run stop_server_gracefully.sh serverName.
Optional parameters are -uUserName and -pPassword. If these are not specified, the default values are used.
If you want to specify values other than the defaults, run the following:
stop_server_gracefully.sh serverName -uUserName -pPassword

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 want to gracefully shut down the system, the following occurs:

Steps for shutting down InterChange Server Express immediately

Perform the following steps to shut down the server immediately:

  1. In System Manager, go to the InterChange Server Component Management view.
  2. Right-click the InterChange Server Express instance and click Shut Down > Immediately.
Linux

On Linux you can also use the $./ics_manager -stop script to shut down InterChange Server Express immediately.

OS/400

On OS/400, you can also use the stop_server.sh script. From the command line, type the QSH command, and from the QSHELL environment, cd to /QIBM/Proddata/WBIServer43/bin and run stop_server.sh serverName with -uUserName and -pPassword. The -uUserName and -pPassword parameters are optional. If these are not specified, the default values are used.

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. See Flow failures for more information on submitting a flow that fails to process.

Note:
Immediately stopping the system does not compromise the integrity of the data or the integrity of the InterChange Server Express 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 IBM WebSphere InterChange Server Express 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. See Using repos_copy.

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

Steps for changing the InterChange Server Express password

Steps for changing the database passwords

Steps for changing the InterChange Server Express password

Perform the following steps to change the password for InterChange Server Express:

  1. Open System Manager.
  2. Right-click the InterChange Server Express instance in the InterChange Server Component Management view, then click Change Password. The Change InterChange Server Password dialog box appears.
  3. Type the current password in the Old Password field.
  4. Type a new password in the New Password field.
  5. Type the new password again 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 does not start.

Steps for changing the database passwords

Note:
On OS/400, it is recommended that you avoid changing the database user ID and password. When you install InterChange Server Express on OS/400, a user profile, QWBISVR43, is created, which is of *USER class with no password. All necessary items are installed, and the database is created, under this profile. This makes it unnecessary to provide a password in any form in the configuration file. If you want to use a different profile, you must include a password.

The repository database passwords can be changed through System Manager after the InterChange Server Express system is running.

Perform the following steps to change the database passwords:

  1. In the InterChange Server Component Management view, right-click the InterChange Server Express instance whose database password you want to change, then click 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 22).

    Figure 22. Database tab of Edit Configuration window


  3. Change any of the database passwords by doing the following:
  4. Click OK.

Copyright IBM Corp. 2004