Next-generation platform

Starting servers on the next-generation platform

Users with the Developer role can start single or multiple instances of agent and integration servers from the Server configuration tab.

About this task

When you configure a server, it is added to the Server configuration dashboard. You can then start that server.

When you select multiple servers, all agent servers, or all integration servers, the default number of server instances that is configured for each server are started.

Note: The agent server might fail to start in the following conditions:
  • Bad queue name - Queue name is entered incorrectly or queue is not created in the IBM MQ server.
  • Bad InitialContextFactory definition - An incorrect InitialContextFactory is selected. By default, it is File.
  • Bad provider URL - An incorrect path for the bindings file is used.
  • Bad QueueConnectionFactory name - An incorrect QueueConnectionFactory name is entered or an incorrect value is used.

You can enter the correct server name in Self Service and start the server again. For the other conditions, you must correct the entries in Sterling™ Order Management System and then try to start the server.

Procedure

To start servers, complete the following steps:

  1. Access Self Service with your IBMid.
  2. From the Self Service menu, click Environments.
  3. From the list of environments, select an environment.
  4. In the Server configuration tab, click Server processes.
  5. Click Start servers.
  6. Select the servers that you want to start.
  7. You can select the Enable verboseGC output option for diagnosing issues, if any.

    After this option is enabled, you can trigger the Export application logs process in the Processes tab for the selected agent or integration server. You can then download the exported logs from the process report. For more information, see Self Service processes for the next-generation platform.

    Note: If you want to disable the option for generating the verbose GC logs for a server, you must stop the server.
  8. If you have selected a single server, the Number of instances to start option is displayed. Enter the number of instances of the server that you want to start. By default, one instance of the selected server is started.
  9. Click Submit.

Results

The number of instances that are specified for the server are started and the status is updated to Running. If the allocated CPU and memory are insufficient for the servers to start, an error message is displayed. You can reduce the number of running servers to free up some resources or you can schedule the servers to start later. You can also set the performance profile of the servers to Balanced for a more optimal allocation of resources.