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):
- Open the Integration Explorer view in
the IBM App Connect
Enterprise Toolkit.
- Right-click the Integration Nodes folder, and click Connect
to a Integration Node.
- 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:
- 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.
- 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.
- Click Finish to connect to the
integration node.
- Create a connection to an integration node by using settings
from a .broker file:
- Open the Integration Explorer view in
the IBM App Connect
Enterprise Toolkit.
- Right-click the Integration Nodes folder, and click Connect
to an Integration Node using *.broker file.
- 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:
- Right-click the integration node that has a saved password.
- Select Change Saved Connection Password.
- Enter a new password, or leave the field empty to delete the saved
password.