Installation Prerequisites

Prior to installing Private PaaS, verify that you have met the prerequisites described in the following sections on this page:

Software requirements

Application	Purpose	Version	Minimum Requirements		Download Links
Application	Purpose	Version	Development/ Testing Environment	Production Environment	Download Links
Oracle Java SE Development Kit (JDK)	Required by all the products: To launch the product, as each product is a Java application. To build the product from the source distribution (both JDK and Apache Maven are required).	1.6.24 or later / 1.7.* If you are using JDK 1.6, you might need to replace the Java Cryptography Extension (JCE) policy files in your JDK with the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy files. This will avoid "illegal key size" errors when you try to invoke a secured web service. Oracle and IBM JRE 1.7 are also supported.	√	√	If you wish to get support for 32 bits in Private PaaS, download the Java 32 bits distribution.
MySQL Server	Required to manage database connections.	5.5.0 or later	X	√
MySQL Connector for Java	Required as a standardized database driver for Java platforms and development.	1.7.0 or later	X	√
Git Client	Required to check out the source from the Git repository.	2.2.1 or later	√	√
Apache Maven	Required to build the product from the source distribution.	3.1.1 or later	√	√
Ruby	Required as a prerequisite for cartridges.	2.1.0 or later	X	√
Zip Utility	Required to compress and unzip the packages. NOTE: This is not required when using the manual approach to configure and start Private PaaS.	Any	X	√	Choose a zip utility that is compatible with the OS.
Cartridge Base Image	Required as a prerequisite for cartridges.	2.6.0 or later	√	√	The cartridge base image will vary based on the setup that you are using. For example, If you are using OpenStack, you need to have an OpenStack base image. Whereas, if you are using Docker, you need to have a Docker base image.
Facter	Required as a prerequisite for cartridges.	2.0.0 or later	X	√
AMQP Message Broker	Required for Private PaaS runtime. The message broker is used to communicate with CEP.	ActiveMQ 5.10.0	√	√	Currently ActiveMQ 5.10.0 is used by default in the Private PaaS installation. However, Private PaaS also supports other AMQP message brokers such as, WSO2 Message Broker and RabbitMQ.
MQTT Message Broker	Required to communicate with the Cloud Controller and other Private PaaS profiles.	Any	√	√	Currently ActiveMQ is used by default in the Private PaaS installation.
WSO2 CEP	Required to analyze & process events of a cartridge.	3.0.0	√	√	You do not need to download CEP when installing Private PaaS using the Automated Private PaaS Configurations approach.
Oracle VM VirtualBox Manager	NOTE: Required only when working with Kubernetes.	4.3.20 or later	√	X	https://www.virtualbox.org/
Vagrant	NOTE: Required only when working with Kubernetes. As VirtualBox will be used as the provider for Vagrant, VirtualBox needs to be installed prior to installing Vagrant.	1.7.2 or later	√	X	http://www.vagrantup.com/downloads.html

System requirements

System Requirements	Memory - 2GB Disk - 40GB hard disk space Processor - 2.8GHz CPU
Environment Compatibility	Operating Systems - Linux (Ubuntu 12.04 64bit server or SUSE Linux Enterprise 11 SP2) If you wish to get support for 32 bits in Private PaaS, download the Java 32 bits distribution.

Basic configurations

Set the environment variable as follows to avoid Maven OutOfMemoryError.
export MAVEN_OPTS='-Xms2048m -Xmx4096m -XX:MaxPermSize=1024m'