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 IBM App Connect Enterprise 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 an 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

  • Create a connection to an integration node by using its administration URI (hostname and port):
    1. Open the Integration Explorer view in the IBM App Connect Enterprise Toolkit.
    2. Right-click the Integration Nodes folder, and click Connect to a Integration Node.
    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.
      • The User name for a web administration account that you want to use to secure the connection. For more information, see mqsiwebuseradmin command.
      • 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 *.broker file.
    3. Select the .broker file and then click Open to connect to the integration node.

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 connection details to a .broker file by right-clicking the integration node and selecting Export the Integration Node to a .broker 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.