Configuring a default application for an integration server

You can configure a default application for an integration server by setting the application name in the integration server's server.conf.yaml configuration file.

Before you begin

About this task

All resources that are run by the IBM App Connect Enterprise run time must be located in an application. Any independent resources (located in an independent resource project), are automatically placed in the integration server's default application. You can specify the default application when you create the integration server, by specifying the --default-application-name parameter on the IntegrationServer command. Alternatively, you can specify a default application for an existing integration server, by setting the defaultApplication property in the integration server's server.conf.yaml configuration file. When an integration server has been configured to use a default application, independent resources are placed under the specified default application so that they can be accessed.

Procedure

To configure a default application for an integration server, complete the following steps:

  1. Use a YAML editor to open the server.conf.yaml file.

    You can edit the file by using the built-in YAML editor that is provided in the IBM App Connect Enterprise Toolkit, either by double-clicking the file in the Application Development view or by right-clicking the file and selecting Open with > YAML editor. If you choose to edit the file by using a plain text editor, ensure that you do not include any tab characters (which are not valid in YAML) and use a YAML validation tool to validate the contents of your file.

    For more information about working with YAML, see http://www.yaml.org/start.html.

  2. Set the defaultApplication property in the Defaults section of the server.conf.yaml file, by removing the comment (#) from the start of the defaultApplication line and specifying a name for the default application that will be used by the integration server:
    
    Defaults:
      defaultApplication: 'myDefaultApp'   # Name a default application under which independent resources will be placed
      
  3. Restart the integration server. The properties that you set in the server.conf.yaml file take effect when the integration server is started. If you modify these properties again, you must also start the integration server again for the subsequent changes to take effect. For more information, see Starting an integration server.