9.8. Installing Cartridges

At this point, install any web or add-on cartridge packages for your OpenShift Enterprise deployment.
Web cartridges provide support for specific types of applications to run on OpenShift Enterprise. For example, there is a web cartridge that supports PHP development, and another for Ruby development.
Add-on cartridges include database and management cartridges, and exist to support additional functions on which an application may rely. For example, cartridges exist for the MySQL and PostgreSQL database servers.
If a particular cartridge is not installed at this point, it can be installed later. However, a cartridge must be installed before developers can create applications for the supported framework or service.

Important

Administrators choose the set of installed cartridges. However, node hosts require installation of this same set on each node host. Gear placement does not currently take into account differences in the installed cartridges per node host. All node hosts are assumed to have the same cartridge set, and gear creation fails on a node host that is missing cartridges required for the gear.

9.8.1. Installing Web Cartridges

The following table lists the web cartridges available for installation.

Table 9.2. Available Web Cartridges

Package Name Description
openshift-origin-cartridge-amq JBoss A-MQ support [a]
openshift-origin-cartridge-diy DIY ("do it yourself") application type
openshift-origin-cartridge-fuse JBoss Fuse support [a]
openshift-origin-cartridge-fuse-builder JBoss Fuse Builder support [a]
openshift-origin-cartridge-haproxy HAProxy support
openshift-origin-cartridge-jbossews JBoss EWS support
openshift-origin-cartridge-jbosseap JBoss EAP support [a]
openshift-origin-cartridge-jenkins Jenkins server for continuous integration
openshift-origin-cartridge-nodejs Node.js support
openshift-origin-cartridge-ruby Ruby Rack support running on Phusion Passenger
openshift-origin-cartridge-perl mod_perl support
openshift-origin-cartridge-php PHP support
openshift-origin-cartridge-python Python support
[a] Premium cartridge. If installing, see Section 9.1, “Configuring Node Host Entitlements” to ensure the correct premium add-on subscriptions are configured.
Install any web cartridges using the following command: 
# yum install package_name

Note

If you use the kickstart or bash script, the install_cartridges function performs this step. This function currently installs all cartridges listed. Edit this function to install a different set of cartridges.

Important

If needed, administrators can choose to configure the JBoss EWS cartridge tomcat7 binary provided by the EWS 3 product to work around known security issues with the JBoss EWS-2 tomcat7 binary. See Known Issues to learn more.