Skip to end of metadata
Go to start of metadata

Install the Operating System 

NOTE: At this time we only support openSuSE. We are looking for help porting this process to other platforms.

  1. Download the image from openSuSE:

  2. Install the image on bare metal or a VM and configure the network.
    1. Recommended at least 60GB in root filesystem, 6GB of RAM
  3. Here is an example on how to install the ISO in a vCenter instance
    1. VCenter Deployment

It is recommended for the time being you do NOT accept OpenSUSE software updates to your system until we've had a chance to determine how those updates impacts the software we're installing below.  Allowing software updates to occur before performing the steps in this wiki may result in your CoprHD services failing to deploy.

NOTE: To install the minimun set of packages to get started, install git and make:

zypper --non-interactive install --no-recommends git make

Get the Source

The CoprHD source code is mirrored to GitHub (see Repository Structure & Code Flow), but those wishing to contribute to the project should get the source from the primary repository as follows:

git clone

Be sure Git knows who you are!

Anywhere you clone the source, it's important to configure Git with your name and email address before making any commits. Per CoprHD's DCO requirement, the name should be your real name and the email address should match the one associated with your Stash username.

Configure Your Development Environment

You can setup/update your developer environment in a single line (as the root user) that configures the OS with all requirements needed to start building CoprHD:

make -f coprhd-controller/packaging/appliance-images/openSUSE/13.2/CoprHDDevKit/Makefile devkit

If you would like to perform a step by step configuration you can also run scripts to setup the operating system. Note that if you have a development environment ready, you can also run one of the substeps from below to configure specific items (additional repositories, RPM dependencies, java versions, etc.), but there is no need to run them after running the command from above.

 Click here to view an alternative setup with detailed sub-steps.

Configure Additional RPM Repositories

In order to install all of the packages CoprHD requires, additional package repositories must be added. You can do this using the commands below:

bash coprhd-controller/packaging/appliance-images/openSUSE/13.2/CoprHDDevKit/ installRepositories

Install Additional RPMs

Now that you have the extra package repositories configured, install additional RPMs needed by CoprHD:

bash coprhd-controller/packaging/appliance-images/openSUSE/13.2/CoprHDDevKit/ installPackages

Install Patched Nginx Server

CoprHD uses Nginx as a reverse proxy/load balancer and it needs extra patches beyond those found in the standard openSUSE RPM. Follow these steps to install or replace the existing nginx with the required version:

bash coprhd-controller/packaging/appliance-images/openSUSE/13.2/CoprHDDevKit/ installNginx

Configure Java 8

Make Java 8 the default Java environment on the host:

# NOTE: Though the name may imply java installation, the line below does not install the packages for java.
# It just switches the java/javac paths, so a specific version is set on the system (7 or 8). To install the packages, run:
# zypper --non-interactive --no-gpg-checks install --details --no-recommends --force-resolution java-1_8_0-openjdk java-1_8_0-openjdk-devel
bash coprhd-controller/packaging/appliance-images/openSUSE/13.2/CoprHDDevKit/ installJava 8

Create the storageos user and group

To add the user and group, run the following:

bash coprhd-controller/packaging/appliance-images/openSUSE/13.2/CoprHDDevKit/ installStorageOS
  • No labels