Readme.md

PeerOS repository

This repository contains source code of Subutai PeerOS project. This is a multi-module Maven Java project.

Building the project

###Prerequisites

To build the project, you need to have the following tools:

• Oracle JDK 7 or later

  Download Page (JDK 8)

  Installation (manual way)

  • Download the 32-bit or 64-bit Linux "compressed binary file" - it has a ".tar.gz" file extension.

  • Uncompress it

  tar -xvf jdk-8-linux-i586.tar.gz (32-bit)

  tar -xvf jdk-8-linux-x64.tar.gz (64-bit)

  The JDK 8 package is extracted into ./jdk1.8.0 directory. N.B.: Check carefully this folder name since Oracle seem to change this occasionally with each update.

  • Now move the JDK 8 directory to /usr/lib

  sudo mkdir -p /usr/lib/jvm
  sudo mv ./jdk1.8.0 /usr/lib/jvm/

  • Now run

  sudo update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/jdk1.8.0/bin/java" 1
  sudo update-alternatives --install "/usr/bin/javac" "javac" "/usr/lib/jvm/jdk1.8.0/bin/javac" 1
  sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/lib/jvm/jdk1.8.0/bin/javaws" 1

  This will assign Oracle JDK a priority of 1, which means that installing other JDKs will replace it as the default. Be sure to use a higher priority if you want Oracle JDK to remain the default.

  • Correct the file ownership and the permissions of the executables:

  sudo chmod a+x /usr/bin/java
  sudo chmod a+x /usr/bin/javac
  sudo chmod a+x /usr/bin/javaws
  sudo chown -R root:root /usr/lib/jvm/jdk1.8.0

  N.B.: Remember - Java JDK has many more executables that you can similarly install as above. java, javac, javaws are probably the most frequently required. This answer lists the other executables available.

  • Run

  sudo update-alternatives --config java

  You will see output similar to the one below - choose the number of jdk1.8.0 - for example 3 in this list (unless you have have never installed Java installed in your computer in which case a sentence saying "There is nothing to configure" will appear):

  $ sudo update-alternatives --config java
  There are 3 choices for the alternative java (providing /usr/bin/java).
  
     Selection    Path                                            Priority   Status
     ------------------------------------------------------------
     0            /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java   1071      auto mode
     1            /usr/lib/jvm/java-7-openjdk-amd64/jre/bin/java   1071      manual mode
   * 2            /usr/lib/jvm/jdk1.7.0/bin/java                   1         manual mode
     3            /usr/lib/jvm/jdk1.8.0/bin/java                   1         manual mode
  
  Press enter to keep the current choice[*], or type selection number: 3
  update-alternatives: using /usr/lib/jvm/jdk1.8.0/bin/java to provide /usr/bin/java (java) in manual mode

  Repeat the above for:

  sudo update-alternatives --config javac
  sudo update-alternatives --config javaws

  Note for NetBeans users!

  You need to set the new JDK as default editing the configuration file.

  Ubuntu: Installing Java 8

  sudo add-apt-repository ppa:webupd8team/java
  sudo apt-get update
  sudo apt-get install oracle-java8-installer
  sudo apt-get install oracle-java8-unlimited-jce-policy

  Setting JAVA_HOME

  To check if JAVA_HOME is set or not, execute

  echo $JAVA_HOME

  If the result is empty or points to the version of Java that is not suitable, you need to set it.

  update-java-alternatives -l
  sudo nano /etc/profile
  
  Add following lines at the end:
  export JAVA_HOME="path that you found in update-java-alternatives for your JDK without quotes"
  export PATH=$JAVA_HOME/bin:$PATH
  
  Save file
  
  reset

  Check again.

• Unlimited strength files (specific for Java version)

  Download Page (JDK 8)

  unzip jce_policy-8.zip
  cd UnlimitedJCEPolicyJDK8
  sudo cp local_policy.jar US_export_policy.jar $JAVA_HOME/jre/lib/security

  OR

  sudo apt-get install oracle-java8-unlimited-jce-policy

• Maven version 3.2.2 or later

  Download Page

  Before installing, remove older versions:

  sudo apt-get purge maven maven2 maven3

  Installation (manual way - works only on Ubuntu 15.04)

  • Unzip the binary with tar

  tar -zxf apache-maven-3.3.3-bin.tar.gz

  • Move the application directory to /usr/local

  sudo cp -R apache-maven-3.3.3 /usr/local

  • Make a soft link in /usr/bin for universal access of mvn

  sudo ln -s /usr/local/apache-maven-3.3.3/bin/mvn /usr/bin/mvn

  Installation (apt repo - older versions)

  sudo apt-add-repository ppa:andrei-pozolotin/maven3
  sudo apt-get update
  sudo apt-get install maven3

  Verify mvn installation

  mvn --version
  
  Apache Maven 3.3.3 (12a6b3acb947671f09b81f49094c53f426d8cea1; 2014-12-14T17:29:23+00:00)
  Maven home: /usr/local/apache-maven-3.2.5
  Java version: 1.7.0_80, vendor: Oracle Corporation
  Java home: /usr/lib/jvm/java-7-oracle/jre
  Default locale: en_US, platform encoding: UTF-8
  OS name: "linux", version: "3.13.0-48-generic", arch: "amd64", family: "unix"

###Build steps

• Clone the project by using:

  git clone https://github.com/subutai-io/base.git

• Start maven build:

  cd base/management
  mvn clean install

  If you want to create a Debian package, add additional flag

  mvn clean install -P deb

After this you will have management/server/server-karaf/target directory with subutai-{version}.tar.gz archive which contains custom Karaf distribution of SS application.

Untar it to some directory and execute {distr}/bin/karaf.

After that go to https://your_host_ip:8443 in your browser.

###Development

For development purposes, access to management container can be opened by executing the following commands on RH-with-MH:

sudo iptables -t nat -A PREROUTING -p tcp -m tcp --dport 2222 -j DNAT --to-destination 10.10.10.1:22
sudo iptables -t nat -A PREROUTING -p tcp -m tcp --dport 5005 -j DNAT --to-destination 10.10.10.1:5005

This would open ports 2222 for ssh access and 5005 for debugger.

CAUTION: this must be used for development only. Highly dangerous to do this in production!