Show Table of Contents
9.32. fabric:mq-create
Abstract
create a new broker profile
Synopsis
fabric:mq-create [
--help
] [
--group groupName
] [
--network brokerGroup
] [
--networks-username user
] [
--networks-password password
] [
--create-container
containerID,
...
] [
--assign-container
containerID,
...
] [
--config configFile
] [
--data dataDir
] [
--kind brokerKind
] [
--replicas num
] [
--port port
] [
--profile profile
] [
--parent-profile parentProfile
] [
--client-profile clientProfile
] [
--client-parent-profile clientParentProfile
] [
--minimum-instances num
] [[
--property
] | [
-D
]prop] [
--jmx-user jmxUser
] [
--jmx-password jmxPassword
] [
--jvm-opts jvmOpts
] [
--version version
] {
name
}
Arguments
Table 9.32, “fabric:mq-create Arguments” describes the command's arguments.
Table 9.32. fabric:mq-create Arguments
| Argument | Description |
|---|---|
--help | Displays the online help for this command. |
--group groupName | Specifies the name of the group to which brokers using this profile are assigned. By default brokers are assigned to the default group. |
--network brokerGroup | Specifies a broker group to which brokers using this profile will establish network connections to form a network of brokers. To specify multiple broker groups, specify this flag multiple times on the command line—for example, --network GroupA --network GroupB. |
--networks brokerGroup | Deprecated. |
--networks-username | Specifies the username part of the credentials that are used to connect to the broker networks specified by the --network option. |
--networks-password | Specifies the password part of the credentials that are used to connect to the broker networks specified by the --network 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 configFile | Specifies 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 dataDir | Specifies the path, relative to the container, for storing the persistence data for a broker using the profile. |
--kind brokerKind | The kind of broker to create. |
--replicas num | Number of replicas required for replicated brokers (which typically use a parent-profile of mq-replicated profile). |
--port port | Port number for a transport connector, specified using the syntax --port transportConnectorName=port, where transportConnectorName is the value of the name attribute from a transportConnector element in the configuration template. To specify multiple ports, specify this flag multiple times on the command line—for example, --port openwire=11111 --port mqtt-ssl=4321. |
--ports port | Deprecated. |
--no-ssl | Disables support for SSL/TLS protocol. |
--profile profile | The profile name to create or update, if defining N+1 broker groups. Defaults to mq-broker-$GROUP.$NAME. |
--parent-profile parentProfile | The parent profile to extend. |
--client-profile clientProfile | The profile name for clients to use to connect to the broker group. Defaults to mq-client-$GROUP. |
--client-parent-profile clientParentProfile | The parent profile used for the client-profile for clients connecting to the broker group. Defaults to default. |
--minimum-instances num | Minimum number of containers required of this broker's profile. |
--property, -D | Additional properties to define in the profile. To specify multiple properties, specify this flag multiple times on the command line—for example, --property keyA=valA --property keyB=valB. |
--jmx-user | The JMX username for logging on to the parent's JMX port. |
--jmx-password | The JMX password for logging on to the parent's JMX port. |
--jvm-opts | Specify options to pass to the container's JVM. |
--version version | Specifies the version into which the profile is stored. Defaults to the current default version. |
name | Specifies 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
SSL/TLS support
For SSL/TLS support, the Java command-line utility,
keytool, must be available on your PATH. To disable SSL/TLS support, specify the --no-ssl option.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.