This page will provide developer/user guidance on setting up an Acumos instance, as a supplement to Acumos documents. Currently there is a "One Click" installation guide with accompanying scripts but no guide for manual installation. The goal of this page in the interim is to fill those gaps, as we solidify the related info in the docs.

Info/efforts to be addressed here include:

• Automated scripts that execute parts, and ultimately all of the installation process - One Click Installation Guide
• Different types of install environments to be supported, e.g.
  
  • Multi-node in a private baremetal lab
  • Multi-node in a private OpenStack lab
  • Public cloud based
    
    

The install process will enable selection of the Acumos version to deploy. The default version to deploy is the latest stable version, currently 1.13. Go to <url> to determine if there is a later version you can deploy. How you select the version will be described when the installer script is available.

Scripted All-in-One Installation

The One Click Deploy User Guide can be found on the front page of docs.acumos.org. Be sure to select the release you are interest in, or "latest" to get the latest docs, using the selector at the bottom right of the page.

Manual Installation

Prerequisites

Minimum required machines for running an instance of Acumos is 2 for docker-compose method on Ubuntu 16.04:

• Application Server with Docker Engine.
• DB Server with Marida DB 10.2

DB-VM Setup

**setup accounts**

Login to the Database Server eg: db-vm which Ubuntu 16.04 pre-installed and become root

Create a user (eg acumosopr)

**install mariadb**

Download the install-mariadb-10.2.sh scripts on to the Database Server (eg: DB-vm)

**configure acumos database**

Following are the steps to install and setup acumos-application after the required servers (dbVM) are setup.

Example:

• DATABASENAME = acumos_1_7_0
• USERNAME = acumos_opr

create database:

mysql -u root -p

drop database if exists DATABASENAME;
create database DATABASENAME;
create user 'USERNAME'@'localhost' identified by 'USERPASSWORD';
grant all on DATABASENAME.* to 'USERNAME'@'localhost';
create user 'USERNAME'@'%' identified by 'USERPASSWORD';
grant all on DATABASENAME.* to 'USERNAME'@'%';
flush privileges;
quit

or control-C out

as the working user:

create tables and data ( DDLs and DMLs)

Access the database installation scripts here

click on cmn-data-svc-ddl-dml-mysql-\*.sql where \* is DB version, click RAW control-A Control-C to copy

create DDL.sql file and paste to it, add line to begining:

use DATABASENAME;

save DDL.sql

run: mysql -u USERNAME -p < DDL.sql

Nexus Server Setup

Create Private Repositories to hold Models and Artifacts

Nexus Repositories.

              Create Private Repositories to hold Models and Artifacts

               Example Nexus Repo Details

Create Blob Stores

type file one per model DB

Create Repositories

Docker Model Repository

type docker(hosted)  

set http port

blob store - one created above

deployment policy: allow redeploy

Maven Model Repository

type maven2r(hosted)  

blob store - one created above

deployment policy: allow redeploy

Docker Platform Repository

type docker(hosted)  

set http port

blob store - one created above

deployment policy: allow redeploy

Create Roles

create a general role,

add privileges nx-blobstores-read

create two readonly roles for model DB

use filter to select all privileges

nx-repository-admin-mavin2-yourmodelprivilagename-read

nx-repository-admin-mavin2-yourmodelprivilagename-browse

nx-repository-view-mavin2-yourmodelprivilagename-read

nx-repository-view-mavin2-yourmodelprivilagename-browse

nx-repository-admin-docker-yourmodelprivilagename-read

nx-repository-admin-docker-yourmodelprivilagename-browse

nx-repository-view-docker-yourmodelprivilagename-read

nx-repository-view-docker-yourmodelprivilagename-browse

create two readonly roles for platform DB

select privileges 

nx-repository-admin-docker-yourplatformprivilagename-read

nx-repository-admin-docker-yourplatformprivilagename-browse

nx-repository-view-docker-yourplatformprivilagename-read

nx-repository-view-docker-yourplatformprivilagename-browse

create two readwrite roles for model DB

use filter to select all privileges

nx-repository-*-yourmodelprivilagename-*

create two readonly roles for platform DB

select privileges 

nx-repository-*-docker-yourplatformprivilagesname-*

Create Users

model readonly user

model read write user

platform read write user

platform readonly password

Core-VM Setup

**setup accounts**

Login to the Application server eg: core-vm with ubuntu 16.04 pre-installed and become root

Create working user id (eg. acumosopr)

**install docker**

Download the install-docker-software.sh scripts on to the Application server (eg: core-vm)

Execute the install-docker-software.sh script as root to install and configure Docker software - ". /tmp/install-docker-software.sh"

**Note** If you are using insecure docker registries, update /etc/docker/daemon.json file accordingly

**install java, and mavin (Do not need as Hippo CMS service is now dockerized)**

add-apt-repository ppa:webupd8team/java

apt-get update

apt-get install oracle-java8-installer

apt-get install maven

**install acumos**

**configure acumos**

**install hippo cms**

**startup docker processes**