Creating an integration node by using the command line

On Linux®, UNIX and Windows, you can create integration nodes on the command line. On Linux and Windows systems, you can also create integration nodes in the IBM® Integration Toolkit.

Before you begin

If you want to configure the integration node as a WebSphere® MQ trusted application, see Using WebSphere MQ trusted applications.
Read Considering security for an integration node.
Check which operation mode you are licensed to use. If you do not set a mode, the automatic default is advanced mode; see Operation modes.

About this task

When you create an integration node, you can optionally specify a queue manager for the integration node. If you do not specify a queue manager, features that require access to WebSphere MQ will be unavailable. For more information about using WebSphere MQ with IBM Integration Bus, see Enhanced flexibility in interactions with WebSphere MQ and Installing WebSphere MQ.

To create an integration node by using the IBM Integration Toolkit, see Creating an integration node by using the IBM Integration Toolkit.

To create an integration node by using the command line, complete the following steps:

Procedure

Ensure that you have the authority to create an integration node by following the steps for your operating system:
- On Linux and UNIX, ensure that you are logged in using a user ID that has authority to run the mqsicreatebroker command.
  Run the mqsiprofile script to set up the command environment for the integration node:
```
install_dir/server/bin/mqsiprofile
```
  You must run this script before you can run the IBM Integration Bus commands.
  
  For more information, see Setting up a command environment.
- On Windows, open an IBM Integration Bus command prompt for the runtime installation in which you want to create the integration node. For more information about initializing the runtime environment, see Setting up a command environment.
  On Windows systems, you must open a command console with elevated privileges. To open a command console with elevated privileges, use the mqsicommandconsole command. For more information, see mqsicommandconsole command.
Use the mqsicreatebroker command to create the integration node.
For example, if you want to create an integration node that is called IBNODE with a queue manager that is called IBQMGR, enter the following command:
```
mqsicreatebroker IBNODE -i wbrkuid -a wbrkpw -q IBQMGR
```
Where wbrkuid and wbrkpw are the user name and password under which the integration node runs.
Note: You can specify a queue manager name that does not exist, but the specified queue manager must be running before you start your integration node.
When you create an integration node, the web user interface uses the default port 4414, and increments by one for each integration node after. You can disable the web user interface or change the port on which it runs by using the mqsichangeproperties command. If administration security is not enabled, web users can access the web user interface as a default user with unrestricted access to data and integration node resources. To enable function that becomes available in IBM Integration Bus fix packs, use the -f parameter on the mqsichangebroker command. For more information, see mqsichangebroker command.

For more information about the command options, see mqsicreatebroker command.

Results

You have created an integration node.

What to do next

Start the integration node by using the mqsistart command.
Connect to the integration node from the IBM Integration Toolkit or a custom integration application.

When you have completed these tasks, you can create the resources that you want to associate with the integration node; for example message flows. You can create and work with resources by using either the IBM Integration Toolkit or the IBM Integration API.