Adding a new service and session type

Perform this task when you want to add a new service and session type to your application. For example, you want to restrict the use of a new service only to clients that have been notified about the new session type in your existing application. You want to add this new service and session type to the application without affecting existing clients or workload. New sessions that are created after this update can use the new service and session type.

Before you begin

A new service package must already be created.

Procedure

  1. Add a new service to the application:
    1. Select Workload > Symphony > Application Profiles.
    2. Select the relevant consumer (not applicable to IBM® Spectrum Symphony Developer Edition).
    3. Click the application name.

      The application profile displays.

    4. From the drop-down list, select Dynamic Configuration Update.
    5. Select Add Service/Docker Container/Session Type.
    6. In the Service Definition group, click Add.
    7. Enter the service name. Ensure that the service name does not include angle brackets (< >), single quotation marks ('), double quotation marks ("), parentheses (( )), forward slashes (/), and backward slashes (\).
    8. Click Add.
    9. Enter a description for the service.
    10. From the Service Package drop-down list, select the new service package.
      If the new service package is not in the list:
      1. Select Add Package to repository.
      2. Click Browse and navigate to the new service package.
      3. Select the package and click Open.
      4. Click Add.
      5. When an information dialog displays, click Close.
    11. Update the start command, for example: ${SOAM_DEPLOY_DIR}/SampleService.
  2. Add a new session type to the application:
    1. Select Workload > Symphony > Application Profiles.
    2. Select the relevant consumer (not applicable to IBM Spectrum Symphony Developer Edition).
    3. Click the application name.

      The application profile displays.

    4. From the drop-down list, select Dynamic Configuration Update.

      A submenu displays.

    5. Select Add Service/Docker Container/Session Type.
    6. In the Session Type Definition group, click Add.
    7. Enter the new session type. Click Add.
    8. From the Service Definition drop-down list, select the new service that you just added to the application.
    9. Click Apply.

      A confirmation dialog displays. Click OK.

      An information dialog displays. Click OK.

    10. Click Close.
  3. Verify that the workload is still running (applicable to long-running tasks):
    1. Select Workload.
    2. Click the application name.
    3. Select the Sessions tab.
    4. Click the session ID.
    5. Verify that the tasks are still running. (Existing clients and workload are not affected.)

      You can use the new service and session type when you create a new session.