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