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"
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.
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 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.
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:
If the collaboration object is a member of a collaboration group, all collaboration objects in the group stop.
If messages from the connectors are in transit to the collaboration object when it stops, they remain in the messaging queues until the collaboration object starts.
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.
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.
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
To change the password for InterChange Server:
The encrypted password is stored in the InterchangeSystem.cfg file.
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:
A dialog box for changing the password appears.
A maximum of 30 characters is allowed.