Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

1.4. Port Configuration

This section describes how to configure, map, and assign ports when you want to connect to the JBoss A-MQ application.

1.4.1. Choosing SSL or Non-SSL Ports
Copy link

When you deploy your JBoss A-MQ application you can choose to use an SSL connection or non-SSL connection.
SSL connection
This connection uses static predefined ports to connect to the JBoss A-MQ application. SSL connections are slower than non-SSL connections due to processing overhead at run-time, but you can determine the port number to use at run-time when you first install the application.
Non-SSL connection
This connection uses a dynamic port number that OpenShift Enterprise allocates based on the available ports when you install the JBoss A-MQ application. After you install the application, you must determine which port numbers the clients need to use to connect to the application.

Configuring an SSL connection
Copy link

  1. In the ActiveMQ JMS client, specify the SSL port number in the ActiveMQConnectionFactory property. By default, the following port numbers are available for SSL connections:
    Openwire
    2303
    STOMP
    2304
    AMQP 1.0
    2305
    MQTT 3.1
    2306
  2. Copy the contents of the self-signed public server certificate to a file named server.crt and store the file in your local machine. You can access the certificate with the URL that appears when you first install the JBoss A-MQ application, or from the default profile directory in the Wiki tab of the Fuse Management Console.
  3. Run the following command to create a Java keystore that imports the certificate: 
    $ keytool -importcert -keystore my.jks -storepass password \
    -file server.crt -noprompt
    Copy to Clipboard Toggle word wrap
  4. Configure the JVM to use the keystore when the client connects to the application: 
    $ java -Djavax.net.ssl.trustStore=my.jks ...
    Copy to Clipboard Toggle word wrap

Configuring a non-SSL connection
Copy link

  1. After you install the JBoss A-MQ cartridge, run one of the following commands: 
    $echo    ${OPENSHIFT_AMQ_OPENWIRE_PROXY_PORT}
$echo    ${OPENSHIFT_AMQ_MQTT_PROXY_PORT}
$echo    ${OPENSHIFT_AMQ_AMQP_PROXY_PORT}
$echo    ${OPENSHIFT_AMQ_STOMP_PROXY_PORT}
    Copy to Clipboard Toggle word wrap
  2. Specify the port number that the broker returns in the connection URL. For example: 
    tcp://amq-demo.openshift.example.com:63373
    Copy to Clipboard Toggle word wrap

1.4.2. Port Binding
Copy link

Some Camel components and CXF endpoints must bind to specific ports to enable client connections. When you configure the JBoss A-MQ cartridge you must bind components such as camel-netty to these ports.
You can use the following system properties variables to bind components to private ports:
  • app1.port
  • app2.port
  • app3.port
Note
If you deploy an ActiveMQ container, the app1.port system property is reserved for the container.
You specify the port system property in the connection properties with the following format: 
${bind.address}:${system_property}
Copy to Clipboard Toggle word wrap
To bind a component to a public port, you use the following connection address format: 
${publichostname}:${app1.public.port}
Copy to Clipboard Toggle word wrap

1.4.3. Public Port Mapping
Copy link

The JBoss A-MQ cartridge includes the PublicPortMapper tool that translates private ports in CXF endpoint addresses to public ports. This tool ensures that users can connect to the JBoss A-MQ application from outside the OpenShift Enterprise domain without exposing the private ports that CXF requires to run.
The following CXF components use the PublicPortMapper tool:
io.fabric8.cxf.registry.FabricCxfRegistrationHandler
This handler uses the PublicPortMapper tool to translate CXF endpoint addresses. The tool maps the port for each endpoint based on the address property of the jaxws:server element: 
<jaxws:server id="service1" serviceClass="io.fabric8.demo.cxf.Hello"
          address="http://$[bind.address]:$[app1.port]/server/server1">
Copy to Clipboard Toggle word wrap
The following example shows the source address of a CXF endpoint: 
http://127.2.123.129:3001/server/server1
Copy to Clipboard Toggle word wrap
The following example shows the translated external URL: 
http://app-domain.openshift.com:47106/server/server1
Copy to Clipboard Toggle word wrap
The tool writes the translated address to one of the following ZooKeeper paths:
  • /fabric/registry/clusters/apis/rest/{name}/{version}/{container}
  • /fabric/registry/clusters/apis/ws/{name}/{version}/{container}
io.fabric8.cxf.FabricLoadBalancerFeature
This feature uses the PublicPortMapper tool to translate the addresses of all endpoints in the cluster. The tool maps the ports based on the list of addresses in the group array property of the feature.
Each time the jaxws:server component starts, the io.fabric8.cxf.FabricServerListener service retrieves the addresses from all active endpoints and stores the addresses in the group property. The feature then invokes the PublicPortMapper tool to translate the addresses to external connection URLs.
The tool writes the addresses to the following ZooKeeper path: 
/fabric/cxf/endpoints/<path-configured-for-FabricLoadBalancerFeature>
Copy to Clipboard Toggle word wrap
io.fabric8.camel.FabricPublisherEndpoint
This endpoint uses the PublicPortMapper tool to translate the address of the listener based on the from uri property of the io.fabric8.camel.FabricComponent route.
The following example shows the source address of a Jetty listener: 
<from uri="fabric-camel:cluster:jetty:http://0.0.0.0:[[port]]/fabric"/>
Copy to Clipboard Toggle word wrap
The tool writes the translated address to the following ZooKeeper path: 
/fabric/clusters/fabric/registry/camel/endpoints/cluster/<cluster_instance_number>
Copy to Clipboard Toggle word wrap
The following example shows the translated address: 
http://fuse0-test.openshift.example.com:40257/fabric
Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat