Connecting to an integration node by using the Toolkit

Before you can administer an integration node by using the IBM® App Connect Enterprise Toolkit, you must connect to the integration node.

Before you begin

Before you can connect to an integration node from the Toolkit, the integration node and its web user interface HTTP connection listener must be running. You can check that the listener was started by using the mqsilist command or by checking for the BIP3132 message in the integration node system log.

About this task

You can create a connection to an integration node by using the Integration Explorer view in the IBM App Connect Enterprise Toolkit. You can create the connection by using either the connection wizard or settings from a .broker file.

By default, when you create a connection to an integration node, the Toolkit connects to it automatically when the Toolkit is started. However, if you want to create the connection details without automatically connecting the Toolkit to the integration node, you can turn off the automatic connection setting by clicking Window > Preferences > Integration Development > Connection Settings, and then deselecting Automatic connection to remote Integration Nodes and Integration Servers. Then click Apply and Close.

Procedure

Create a connection to an integration node by using one of the following methods:

  • Create a connection to an integration node by specifying the hostname and port settings in the connection wizard:
    1. Open the Integration Explorer view in the IBM App Connect Enterprise Toolkit.
    2. Right-click the Integration Nodes folder, and click Connect to an Integration Node.

      A wizard guides you through the steps involved in connecting to your integration node. As a minimum, you must specify the hostname and port. If administration security has been enabled on the integration node, you must specify authentication details (username and password) or select the Use HTTPS option.

    3. In the Connect to an integration node wizard, enter the following values:
      • The Host name or IP address of the computer on which your integration node is running.
      • The Port used by the administration REST API. This property must be a valid positive number.
      • (Optional). The User name for a web administration account that you want to use to secure the connection. For more information, see mqsiwebuseradmin command.
      • (Optional). The Password that is associated with the web administration account for the User name. For more information, see mqsiwebuseradmin command and Managing web user accounts.
      • To save the Password value, select the Save password checkbox.

        The password is encrypted in Eclipse Secure Storage, which is a local file that is shared by all Eclipse-based products on the computer, including the IBM App Connect Enterprise Toolkit. If you select this option and Eclipse Secure Storage is not already set up, you must complete some additional steps to store the password securely:

        1. Set a main password for Eclipse Secure Storage.

          On Windows, the main password is generated automatically.

          On Linux® and UNIX, the Secure Storage window opens, and you must set a main password for Eclipse Secure Storage. Enter a value for Password, and use the same value for Confirm password.

        2. On all distributed systems, you are prompted to set main password recovery.

          If you select Yes, the Password Recovery pane opens. In the Password Recovery pane, enter your questions and answers for password recovery.

      • To connect to the integration node by using HTTP with the Secure Sockets Layer (SSL), select the Use HTTPS checkbox.
    4. Click Finish to connect to the integration node.
  • Create a connection to an integration node by using settings from a .broker file:
    1. Open the Integration Explorer view in the IBM App Connect Enterprise Toolkit.
    2. Right-click the Integration Nodes folder, and click Connect to an Integration Node using an integration connection file.
    3. Select the .broker file and then click Open to connect to the integration node.
    The connection to the remote integration node is created in your workspace.

Results

You can now view properties and manage your integration node, and its integration servers and resources, in the IBM App Connect Enterprise Toolkit.

You can export the remote connection details to a .broker file by right-clicking the integration node and selecting Export the Integration Node to an Integration Connection file.

What to do next

You can use the toolkit to create integration servers for the integration node, as described in Creating an integration server by using the IBM App Connect Enterprise Toolkit.

You can delete or change the value of a saved password for the connection. To change or delete the saved password:
  1. Right-click the integration node that has a saved password.
  2. Select Change Saved Connection Password.
  3. Enter a new password, or leave the field empty to delete the saved password.