Install on Your Own VM

Installing Cloudbreak on Your Own VM

This is an advanced deployment option. Select this option if you have custom VM requirements. Otherwise, you should use one of the pre-built images and follow these instructions:

System Requirements

To launch the Cloudbreak deployer and install the Cloudbreak application, your system must meet the following requirements:

Minimum VM requirements: 16GB RAM, 40GB disk, 4 cores
Supported operating systems: RHEL, CentOS, and Oracle Linux 7 (64-bit)
Docker 1.9.1 must be installed

You can install Cloudbreak on Mac OS X for evaluation purposes only. Mac OS X is not supported for a production deployment of Cloudbreak.

Prerequisites

To launch the Cloudbreak deployer and install the Cloudbreak application, you must first meet the following prerequisites:

Ports

Ports 22 (SSH), 80 (HTTPS), and 443 (HTTPS) must be open.

Root Access

Every command must be executed as root. In order to get root privileges execute:

sudo -i

System Updates

Ensure that your system is up-to-date by executing:

yum -y update

Reboot it if necessary.

Iptables

Install iptables-services:

yum -y install iptables-services net-tools

Without iptables-services installed the iptables save command will not be available.

Next, configure permissive iptables on your machine:

iptables --flush INPUT && \
iptables --flush FORWARD && \
service iptables save

Additionally, review the following prerequisites:

Install Cloudbreak on Your Own VM

Install Cloudbreak using the following steps.

Steps

Install the Cloudbreak deployer and unzip the platform-specific single binary to your PATH. For example:
```
yum -y install unzip tar
curl -Ls public-repo-1.hortonworks.com/HDP/cloudbreak/cloudbreak-deployer_2.4.2_$(uname)_x86_64.tgz | sudo tar -xz -C /bin cbd
cbd --version
```
Once the Cloudbreak deployer is installed, you can set up the Cloudbreak application.
Create a Cloudbreak deployment directory and navigate to it:
```
mkdir cloudbreak-deployment
cd cloudbreak-deployment
```
In the directory, create a file called Profile with the following content:
```
export UAA_DEFAULT_SECRET=MY-SECRET
export UAA_DEFAULT_USER_PW=MY-PASSWORD
export UAA_DEFAULT_USER_EMAIL=MY-EMAIL
```
For example:
```
export UAA_DEFAULT_SECRET=MySecret123
export UAA_DEFAULT_USER_PW=MySecurePassword123
export UAA_DEFAULT_USER_EMAIL=dbialek@hortonworks.com
```
You will need to provide the email and password when logging in to the Cloudbreak web UI and when using the Cloudbreak CLI. The secret will be used by Cloudbreak for authentication.
Generate configurations by executing:
```
rm *.yml
cbd generate
```
The cbd start command includes the cbd generate command which applies the following steps:
- Creates the docker-compose.yml file, which describes the configuration of all the Docker containers required for the Cloudbreak deployment.
- Creates the uaa.yml file, which holds the configuration of the identity server used to authenticate users with Cloudbreak.
Start the Cloudbreak application by using the following commands:
```
cbd pull
cbd start
```
This will start the Docker containers and initialize the application. The first time you start the Coudbreak app, the process will take longer than usual due to the download of all the necessary docker images.
Next, check Cloudbreak application logs:
```
cbd logs cloudbreak
```
You should see a message like this in the log: Started CloudbreakApplication in 36.823 seconds. Cloudbreak normally takes less than a minute to start.

Next Steps After Installing on Your Own VM

Log in to the Cloudbreak web UI and create a credential for Cloudbreak using the following platform-specific instructions: