IBM App Connect Enterprise, Version 11.0.0.2 Operating Systems: Windows, Linux


Creating an integration server

You can create integration servers by using the IBM® App Connect Enterprise Toolkit, the web user interface, or commands.

About this task

You must create an integration server before you can deploy integration solutions and related resources.

The mode in which IBM App Connect Enterprise is running can affect the number of integration servers that you can use; see Restrictions that apply in each operation mode.

Use one of the following methods to create an integration server:

For information about why you might want to create multiple integration servers, see Integration servers and integration nodes.

Creating an integration server work directory by using the mqsicreateworkdir command

Use the mqsicreateworkdir command to create a work directory to be used by an integration server.

Procedure

  1. Open a command window for your current installation.
  2. Create a work directory for your integration server, by running the mqsicreateworkdir command, specifying the full path to the directory that you want to create. For example:
    mqsicreateworkdir c:\myaceworkdir
    This command creates the specified work directory, which contains a default configuration file called server.conf.yaml. This YAML file contains the default settings for your new integration server. The command also creates subdirectories, which will be used by the integration server when it is running. These include a log directory and a run directory. The log directory contains files of log messages, which can be used to review the status of your integration server. The run directory is where you can place your BAR files prior to starting your integration server, or while it is running. The resources from the BAR file are extracted and started by the integration server.

    If you have a BAR file with resources that contain graphical data maps, XML schemas, or DFDL schemas, these resources can be compiled using the mqsibar command, prior to starting the integration server. This precompilation reduces the time that it takes for the deployed application to start processing messages.

    See the mqsicreateworkdir command for more information.

  3. Configure your integration server by setting properties in the server.conf.yaml file, as described in Configuring an integration server by using the server.conf.yaml file.

Results

The integration server is created and the updated server.conf.yaml configuration file is stored in integration server's subdirectory in the file system.

What to do next

You can now start the integration server by running the IntegrationServer command, as described in Starting an integration server.

You can deploy resources to your integration server, as described in Deploying integration solutions.

Creating an integration server by using the IBM App Connect Enterprise Toolkit

Procedure

To add an integration server:

  1. Optional: If you are working with a remote integration node, connect to the integration node; see Connect to a remote integration node.
  2. In the Integration Explorer view, right-click and select New Integration Server.
  3. In the New Integration Server dialog, enter the integration server name.
  4. Click OK to create the integration server.

Results

The integration server is added to the selected integration node.

Creating an integration server by using the web user interface

Procedure

To add an integration server:

  1. Start the web user interface, as described in Accessing the web user interface.
  2. Select Servers, and then click Create.
  3. In the New Integration Server dialog, enter the integration server name.
  4. Click OK to add the integration server.

Results

The integration server is created.

Creating an integration server by using the mqsicreateexecutiongroup command

Use the mqsicreateexecutiongroup command to create integration servers on your integration node.

Procedure

  1. If you are creating an integration server on Linux or Windows systems:
    1. Open a command window for your current installation.
    2. Enter the mqsicreateexecutiongroup command, and specify the parameters for the integration server that you want to create.
      • If the integration node is local, specify the integration node name. For example:
        mqsicreateexecutiongroup INODE -e IServer_2
      • If the integration node is remote, you can specify a configuration file. For example:
        mqsicreateexecutiongroup -n INODE.broker -e IServer_2
      • If the integration node is remote, you can alternatively specify the connection parameters -i and -p. For example:
        mqsicreateexecutiongroup -n INODE -e IServer_2 -p 4414 -i host
      See the mqsicreateexecutiongroup command description for more details about these options.
  2. If you are creating an integration server on z/OS®:
    1. Configure the BIPCREG job to specify the properties for the integration server that you want to create.
    2. Run the BIPCREG job.

Results

The integration server has been created on the specified integration node.

What to do next

Deploy resources to your integration server; see Deploying integration solutions

bn03995_.htm | Last updated 2018-11-02 14:46:28