This page is a work in progress!
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
CPU Cores Minimum | CPU Cores Recommended | Memory Minimum | Memory Recommended | Disk Size | OS | Version | Public IP | Type | Description |
---|---|---|---|---|---|---|---|---|---|
8 | 16 | 32 GB | 64 | 100 GB | Ubuntu | 16.04 | Yes | Core-VM | Application Server |
8 | 16 | 32 GB | 64 | 100 GB | Ubuntu | 16.04 | No | DB-VM | Database Server |
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
Username | Type | Access | Description | Repository |
---|---|---|---|---|
companyA_model_ro | Docker | Read Only | ML Model Docker Images | companyA _repo_model_docker |
companyA_model_rw | Docker | Read Write | ML Model Docker Images | companyA _repo _model_docker |
companyA _model_ro | Maven | Read Only | ML TOSCA/Raw/code | companyA _repo _model_maven |
companyA _model_rw | Maven | Read Write | ML TOSCA/Raw/code | companyA _repo _model_maven |
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**
5 Comments
Cedric Gegout
Dear, I can see that the installation of Acumos requires Ubuntu 16.04. (see https://logs.acumos.org/production/vex-yul-acumos-jenkins-1/documentation-rtd-verify-master/195/html/AcumosDeveloper/InstallRun.html). It is possible to install Acumos on Redhat OS? Thanks in advance. Best Regards.
Michael O'Brien
Nice page, going through the installation
The AIO VM size is 16, but here we are recommending 64 - When I finish the install on an AWS spot VM I'll compare notes.
Issues: as I progress through the install
ACUMOS-851 - Getting issue details... STATUS
The oneclick_deploy.sh script brings up a grub-pc dialog (that would pause automated installs) - the VM is a clean Ubuntu 16.04.2 on us-east-1 on AWS using an R4.large spot instance
Script is not re-runnable
Acumos Installation
Installing the package maintainer's version breaks the install as well
Moving to Azure just to check
Michael O'Brien
it looks like the uname part of the docker install, installing this manually and commenting out this line in the install gets past docker setup
sudo apt-get install -y \ linux-image-extra-$(uname -r) \ linux-image-extra-virtual
Digest: sha256:72523224fa2cef618a9e8954bac21cd55fe320b6e68ba611f27c41e0d2640447 Status: Downloaded newer image for nexus3.acumos.org:10004/acumos-cms-docker:1.3.2
xiongbo zou
Dear,there is failed of docker_login when i'm installed acumos by oneclick_deploy.sh script.
my docker-version:Docker version 18.03.1-ce, build 9ee9f40
the failed info:
and also failed when i'm visited the repo by browser :
Could you give me any suggest ?
Looking forward to your guidance! Thank you very much!
Aditya Singh
I am getting this failure after running the setup_prereqs.sh script. Any solution?