connect

Connect to an Apache Pulsar instance.

Use the connect command to associate your MSGMX session with an instance containing one or more Apache Pulsar Clusters. The target service must be running. An accessible IP address/port for the Apache Pulsar Broker's administrative interface must be supplied.

Synopsis

Copy
connect <InstanceName> <host:port>
    [allow-insecure-connection]
    [tls-certificate-file <filename>]
    [tls-key-file <filename>]
    [token <string>]
    [token-file <filename>]
    [trusted-certificate-file <filename>]

Required Arguments

InstanceName
The name you assigned when using the connect command is valid only while the connect session is active and provides a quick named way to access a specific cluster. InstanceName is shown as an instance at the root, or '/', level of the configuration hierarchy.
You can connect to multiple Apache Pulsar deployments and have multiple InstanceName active within a single MSGMX session by using multiple connect commands.

Optional Arguments

host:port
If needed, specify a host address of the Pulsar-Broker. This argument is needed only to connect to a new instance, not to instances that are already connected. It can be a URL specified with either http:// or https://.
Example:
> connect Instance1 localhost:8080
> connect existing_instance
allow-insecure-connection
This argument indicates that Messaging Manager must accept untrusted TLS certificates from the broker. The default setting is to not accept untrusted certificates.
tls-certificate-file
This argument specifies the client TLS certificate file that must be used to authenticate MTLS to the broker.
tls-key-file
This argument specifies the client TLS key file that is used to authenticate to the broker.
token
This argument is the token used to authenticate to the broker for token-based authentication schemes (OAuth2, JWT token, and so on).
token-file
This argument contains the file name that contains the authentication token. If both token and token-file arguments are specified, token takes precedence.
trusted-certificate-file
This argument specifies the file name of the trusted certificate that is used in the TLS communication.

See Also

disconnect