See information about the latest product version
mqsiaddbrokerinstance command
Use the mqsiaddbrokerinstance command to create a multi-instance broker on a server where WebSphere® Message Broker has been installed.
Supported platforms
- Windows
- Linux and UNIX systems
Purpose
Use the mqsiaddbrokerinstance command to add a broker instance to any additional server on which you require multi-instance support. You must first create a multi-instance enabled broker on one server by using the mqsicreatebroker command.
If you add a broker instance with the mqsiaddbrokerinstance command, you cannot use this command to start and stop a multi-instance broker as a WebSphere MQ service; you must use the mqsichangebroker command instead.
Authorization
On Linux and UNIX systems, the user ID used to run this command must be a member of both the mqbrkrs group and the mqm group. Additionally, you need to make the uid and gid for this user ID the same on all the systems, and the user ID needs to be the same one that created the first instance of the multi-instance broker, using the mqsicreatebroker command.
You might need to edit the /etc/passwd file on each system to set a common uid and gid for the user ID being used to create and add broker instances; then reboot your systems.
You should change the uid and gid in the Linux and UNIX environments with caution, as it affects the permission levels of files on the system.
Changing a uid or gid causes the ownership of all the files previously owned by that user or group to change to the actual integer of the previous owner of the file. Therefore, you must ensure that your system administrator manually restores the ownerships of the affected files and directories.