Connecting to a remote integration node

To administer a remote integration node by using the IBM® Integration Toolkit, you must connect to the integration node.

Before you begin

Before you can connect to a remote integration node, the integration node and its web user interface HTTP connection listener must be running. You can check that the listener was started by checking for the BIP3132 message in the integration node system log.

About this task

You can create a connection to a remote integration node by using the IBM Integration Toolkit, or you can create the connection by using settings from a .broker file, by right-clicking the Integration Nodes folder and then clicking Connect to a Remote Integration Node Using *.broker File. Select the .broker file and click Open. The connection to the remote integration node is created in your workspace.

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

You can also connect to remote integration nodes by using the IBM Integration API; see Connecting to an integration node from a custom integration application.

Procedure

To create a connection to a remote integration node by using the IBM Integration Toolkit:

  1. Open the Integration Nodes view in the IBM Integration Toolkit.
  2. Right-click the Integration Nodes folder, and click Connect to a Remote Integration Node.
  3. In the Connect to an integration node wizard, enter the following values:
    1. The Host name or IP address of the computer on which your integration node is running.
    2. The Port on which the web user interface HTTP connection listener is listening (the default is 4414). This property must be a valid positive number.
    3. The Integration node name that you want to connect to.
    4. Optional: The User name for a web administration account that you want to use to secure the connection.
    5. Optional: The Password that is associated with the web administration account for the User name.
  4. Optional: You can save the password by selecting Save Password.
    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 Integration 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.
  5. Optional: Select Use SSL to connect to the remote integration node by using HTTP with the Secure Sockets Layer (SSL).
  6. Click Finish to connect to the remote integration node.

Results

You can now view properties and configure your integration node in the IBM Integration Toolkit. You can export the remote connection details to a .broker file by right-clicking the integration node and selecting Export the Remote Integration Node to a .broker File.

What to do next

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 password.