Red Hat Training

A Red Hat training course is available for Red Hat Fuse

1.3. Getting Started

This section describes how to configure your OpenShift Enterprise environment and install JBoss Fuse.

1.3.1. Install the xPaaS Gear Profile on OpenShift Enterprise Nodes

This section describes how to configure OpenShift Enterprise nodes to support JBoss Fuse 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 Fuse 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
  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. For example: 
    PROXY_PORTS="2303,2304,2305,2306,2307,2308,2309,2310,2311,2312"
  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
    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
    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 Fuse Cartridge on OpenShift Enterprise

This section describes how to install the JBoss Fuse 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 Fuse applications on that node.
The JBoss Fuse 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 Fuse 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

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
  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 Fuse Application

You create the JBoss Fuse 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.

Choosing the xPaaS gear profile

When you create the JBoss Fuse 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> fuse-6.1.1 -g xpaas
  • 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 Fuse 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 must run the command with additional options to ensure that the quickstart builds with the correct configuration.
For general information about each quickstart, see the readme file located in the directory of each quickstart.
  1. In the OpenShift Enterprise server, run the command to build the quickstart in the following format: 
    mvn clean deploy -Dfuse-server=http://${user}:${password}@${fuse-server-host}
    The following example shows the command with the user name, password, and host properties: 
    mvn clean deploy -Dfuse-server=http://admin:bU-zZTWSHscl@fuse-demo.openshift.example.com
  2. Start the JBoss Fuse application and run the following command in the JBoss Fuse console: 
    osgi:install -s mvn:org.jboss.quickstarts.fuse/cbr/6.1.1.redhat-412