이 콘텐츠는 선택한 언어로 제공되지 않습니다.

1.3. Getting Started


This section describes how to configure your OpenShift Enterprise environment and install JBoss A-MQ.

1.3.1. Install the xPaaS Gear Profile on OpenShift Enterprise Nodes

This section describes how to configure OpenShift Enterprise nodes to support JBoss A-MQ gear profiles after you install each node.
Alternatively, you can specify the xPaaS profile when you install each new node to configure the new node with the required gear properties.
Note
You must install the xPaaS gear profile on each node where you intend to deploy the JBoss A-MQ cartridge. The nodes cannot be associated with districts or contain other gears.
  1. Edit the /etc/openshift/resource_limits.conf file.
    • Replace the contents of the file with the contents of the /etc/openshift/resource_limits.conf.xpaas.m3.xlarge file.
    • To prevent memory overcommit, set the maximum number of gears in the max_active_gears property to the number of gears that the node can support. The number of active gears needs to reflect the available RAM and disk space of the node.
  2. Edit the /etc/openshift/node.conf file.
    • Add the following property: PORTS_PER_USER=15
    • Add the following value to the OPENSHIFT_FRONTEND_HTTP_PLUGINS property:
      openshift-origin-frontend-haproxy-sni-proxy
      Copy to Clipboard Toggle word wrap
  3. In the /etc/openshift/node-plugins.d/openshift-origin-frontend-haproxy-sni-proxy.conf file, update the list of the PROXY_PORTS property to include ten ports as follows:
    PROXY_PORTS="2303,2304,2305,2306,2307,2308,2309,2310,2311,2312"
    Copy to Clipboard Toggle word wrap
  4. Configure your firewall to allow TCP/SSL traffic through the ports that you specified in the PROXY_PORTS property.
    For example, if you use the /etc/sysconfig/iptables to manage your firewall configuration, add the following line before the last instance of the -A INPUT rule:
    -A INPUT -m state --state NEW -m tcp -p tcp --dport <port_number>:<port_number> -j ACCEPT
    Copy to Clipboard Toggle word wrap
    The following example shows the port configuration for the ports numbered 2303 to 2313:
    -A INPUT -m state --state NEW -m tcp -p tcp --dport 2303:2312 -j ACCEPT
    Copy to Clipboard Toggle word wrap
    After you edit this file, run the service iptables reload command to apply the change.
  5. Restart the openshift-sni-proxy service.

1.3.2. Install the JBoss A-MQ Cartridge on OpenShift Enterprise

This section describes how to install the JBoss A-MQ cartridge on OpenShift Enterprise. You must install the cartridge on each node in your OpenShift Enterprise domain, regardless of whether you intend to deploy JBoss A-MQ applications on that node.
The JBoss A-MQ cartridges is shipped as an RPM package in an erratum that you apply in the same way that you apply asynchronous errata updates to OpenShift Enterprise.
For general information about OpenShift errata updates, see the Asynchronous Errata Updates section of the OpenShift Enterprise documentation.
  1. Download the advisory that contains the JBoss A-MQ cartridge. See the OpenShift Enterprise 2 General Advisories page on the Red Hat Customer Portal for a list of all OpenShift Enterprise 2 errata.
  2. On each node, install the cartridge RPM package with yum in the same way you install other OpenShift Enterprise components.
  3. Restart each node with the following command:
    service ruby193-mcollective restart
    Copy to Clipboard Toggle word wrap

1.3.3. Configure the OpenShift Enterprise Broker to Support xPaaS Gears

This section describes how to add the xPaaS gear profiles to the OpenShift Enterprise broker and how to create a district for the gear size.
For general information on districts in the OpenShift Enterprise broker, see the Managing Districts section in the OpenShift Enterprise Deployment Guide and Capacity Planning and Districts section in the OpenShift Enterprise Administration Guide.
  1. On the OpenShift Enterprise broker, import the installed cartridges with the following command:
    oo-admin-ctl-cartridge -c import-profile --activate
    Copy to Clipboard Toggle word wrap
  2. Edit the /etc/openshift/broker.conf file.
    • Add the value xpaas to the VALID_GEAR_SIZES property.
    • Add the value xpaas to the DEFAULT_GEAR_CAPABILITIES property.
    You must restart the openshift-broker service after you edit this file.
  3. Run the following commands:
    oo-admin-ctl-user -c -l <user_name> --addgearsize xpaas
    Grants existing OpenShift Enterprise users permissions to create xPaaS gears.
    oo-admin-ctl-district -c create -n <district_name> -p xpaas
    Creates a district for the xPaaS nodes.
    oo-admin-ctl-district -c remove-capacity -n <district_name> -s 4000
    Sets the district capacity to a maximum of 2,000 gears.
    oo-admin-ctl-district -c add-node -n <district_name> -i <node_hostname>
    Adds the xPaaS nodes to the district.

1.3.4. Create the JBoss A-MQ Application

You create the JBoss A-MQ application from the OpenShift Enterprise management console or from the command line, in the same way that you create other applications on the node.
For general information on how to create applications in OpenShift Enterprise, see the Creating an Application section in the OpenShift Enterprise documentation.
After succussful creation of A-MQ Application, the terminal displays information for the newly created application. You can use the provided URL to access A-MQ web-based admin console. Enter the login credentials that are provided to you after the application creation.

Choosing the xPaaS gear profile

When you create the JBoss A-MQ application, make sure to specify the xPaaS gear profile:
  • If you create the application from the command line, include the -g xpaas option in the command. For example:
    rhc create-app <app_name> amq-6.2.0 -g xpaas
    Copy to Clipboard Toggle word wrap
  • If you create the application from the OpenShift Enterprise management console, choose xPaaS from the Gear Size drop-down list.

1.3.5. Deploy Quickstarts

This section describes how to deploy a JBoss A-MQ quickstart to run in the OpenShift Enterprise domain. Normally, you run the mvn clean install command to build the quickstart. However, in the OpenShift Enterprise domain, you can deploy the quickstart by assigning the quickstart profile to the container. For example, the profile for cbr quickstart is located at:
/hawtio/index.html#/wiki/branch/1.0/view/fabric/profiles/example/quickstarts/cbr.profile
After you assign the cbr profile, the Camel tab will be activated. You can view the quickstart attributes by clicking Camel tab. The Logs tab will show the messages related to cbr quickstart.
For more information regarding Profiles, see Management Console User Guide.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat