Red Hat Training

A Red Hat training course is available for Red Hat Fuse

fabric:mq-create


Name

fabric:mq-create — create a new broker profile

Synopsis

fabric:mq-create [ --help ] [ --group groupName ] [ --networks brokerGroup, ... ] [ --networks-username user ] [ --networks-password password ] [ --create-container containerID, ... ] [ --assign-container containerID, ... ] [ --config configFile ] [ --data dataDir ] [ --jmx-user jmxUser ] [ --jmx-password jmxPassword ] [ --jvm-opts jvmOpts ] [ --version version ] { name }

Arguments

Table 10.31, “fabric:mq-create Arguments” describes the command's arguments.

Table 10.31. fabric:mq-create Arguments

ArgumentDescription
--helpDisplays the online help for this command.
--group groupNameSpecifies the name of the group to which brokers using this profile are assigned. By default brokers are assigned to the default group.
--networks brokerGroup,...Specifies a comma separated list of broker groups to which brokers using this profile will establish network connections to form a network of brokers.
--networks-usernameSpecifies the username part of the credentials that are used to connect to the broker networks specified by the --networks option.
--networks-passwordSpecifies the password part of the credentials that are used to connect to the broker networks specified by the --networks option.
--create-container containerID,...Specifies a comma separated list of child containers to create using the new profile. The new containers will be children of the container from which the command is executed.
--assign-container containerID,...Specifies a comma separated list of containers to which the new profile will be deployed.
--config configFileSpecifies the ensemble path of the XML configuration template used by the profile. The path will have the syntax /fabric/configs/versions/version/profiles/profile/config.xml.
--data dataDirSpecifies the path, relative to the container, for storing the persistence data for a broker using the profile.
--jmx-userThe JMX username for logging on to the parent's JMX port.
--jmx-passwordThe JMX password for logging on to the parent's JMX port.
--jvm-optsSpecify options to pass to the container's JVM.
--version versionSpecifies the version into which the profile is stored. Defaults to the current default version.
nameSpecifies the name of the new broker profile.

Examples

To create a new broker profile with the name myBrokerProfile that uses the XML template file myConfigTemplate.xml use the command:
fabric:mq-create --config /fabric/configs/versions/1.0/profiles/mq-base/myConfigTemplate.xml myBrokerProfile
To create a new broker profile and create a new container using the new profile use the command:
fabric:mq-create --config /fabric/configs/versions/1.0/profiles/mq-base/myConfigTemplate.xml --create-container broker1 myBrokerProfile
To create a new broker profile and associate it with an existing container use the command:
fabric:mq-create --config /fabric/configs/versions/1.0/profiles/mq-base/myConfigTemplate.xml --assign-container container1 myBrokerProfile