이 콘텐츠는 선택한 언어로 제공되지 않습니다.
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.
- Edit the
/etc/openshift/resource_limits.conffile.- Replace the contents of the file with the contents of the
/etc/openshift/resource_limits.conf.xpaas.m3.xlargefile. - To prevent memory overcommit, set the maximum number of gears in the
max_active_gearsproperty 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.
- Edit the
/etc/openshift/node.conffile.- Add the following property:
PORTS_PER_USER=15 - Add the following value to the
OPENSHIFT_FRONTEND_HTTP_PLUGINSproperty:openshift-origin-frontend-haproxy-sni-proxy
openshift-origin-frontend-haproxy-sni-proxyCopy to Clipboard Copied! Toggle word wrap Toggle overflow
- In the
/etc/openshift/node-plugins.d/openshift-origin-frontend-haproxy-sni-proxy.conffile, update the list of thePROXY_PORTSproperty to include ten ports. For example:PROXY_PORTS="2303,2304,2305,2306,2307,2308,2309,2310,2311,2312"
PROXY_PORTS="2303,2304,2305,2306,2307,2308,2309,2310,2311,2312"Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Configure your firewall to allow TCP/SSL traffic through the ports that you specified in the
PROXY_PORTSproperty.For example, if you use the/etc/sysconfig/iptablesto manage your firewall configuration, add the following line before the last instance of the-A INPUTrule:-A INPUT -m state --state NEW -m tcp -p tcp --dport <port_number>:<port_number> -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport <port_number>:<port_number> -j ACCEPTCopy to Clipboard Copied! Toggle word wrap Toggle overflow 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
-A INPUT -m state --state NEW -m tcp -p tcp --dport 2303:2312 -j ACCEPTCopy to Clipboard Copied! Toggle word wrap Toggle overflow After you edit this file, run the service iptables reload command to apply the change. - Restart the
openshift-sni-proxyservice.
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.
- 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.
- On each node, install the cartridge RPM package with yum in the same way you install other OpenShift Enterprise components.
- Restart each node with the following command:
service ruby193-mcollective restart
service ruby193-mcollective restartCopy to Clipboard Copied! Toggle word wrap Toggle overflow
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.
- On the OpenShift Enterprise broker, import the installed cartridges with the following command:
oo-admin-ctl-cartridge -c import-profile --activate
oo-admin-ctl-cartridge -c import-profile --activateCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Edit the
/etc/openshift/broker.conffile.- Add the value
xpaasto the VALID_GEAR_SIZES property. - Add the value
xpaasto the DEFAULT_GEAR_CAPABILITIES property.
You must restart theopenshift-brokerservice after you edit this file. - 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 xpaasoption in the command. For example:rhc create-app <app_name> fuse-6.1.1 -g xpaas
rhc create-app <app_name> fuse-6.1.1 -g xpaasCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 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.
- 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}mvn clean deploy -Dfuse-server=http://${user}:${password}@${fuse-server-host}Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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
mvn clean deploy -Dfuse-server=http://admin:bU-zZTWSHscl@fuse-demo.openshift.example.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 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
osgi:install -s mvn:org.jboss.quickstarts.fuse/cbr/6.1.1.redhat-412Copy to Clipboard Copied! Toggle word wrap Toggle overflow