Hyper Open Edge Cloud

How To Deploy SlapOS Master in Theia (COMP-Root) With Embedded Software URL

How To Deploy SlapOS Master in Theia (COMP-Root) With Embedded Software URL
  • Last Update:2021-09-07
  • Version:001
  • Language:en

Agenda

  • Supply And Request Slapos Master
  • Wait for Deployment
  • Request Frontend
  • Verification

This tutorial will guide you through the steps of installing a SlapOS Master on Theia to manage a network of computers. Once completed you will have a COMP-ROOT node similar to that of panel.rapid.space, Nexedi's cloud hosting provider, which can then be used as starting point for creating a network of nodes to provide software instances.

Before starting this tutorial, make sure you have read the SlapOS architecture and SlapOS system requirements in order to make yourself familiar with the terminology and overall concepts.

Prerequisites

  1. A Theia Runner: HowTo Request A Theia Runner Embedded With A Software
  2. Know: How to supply and request a software in Theia
  3. Know: How to Request a Rapid.Space CDN

Prepare Supply and Request for Slapos Master

Follow the steps in HowTo Request A Theia Runner Embedded With A Software to request a SlapOS Master software. 

The Embedded Software URL for SlapOS Master Software is

https://lab.nexedi.com/nexedi/slapos/raw/master/software/slapos-master/software.cfg

Wait for Installation

Check the logs to make sure it has been deployed and installed:

$ tail -f ~/srv/runner/var/log/slapos-node-software.log

$ tail -f ~/srv/runner/var/log/slapos-node-instance.log

This will download, build and install the required packages (ansible, slapos-node, slapos-proxy), configure the computer as a SlapOS standalone node, and deploy SlapOS Master (ERP5) and a Frontend (Apache) service inside. Note, that, as mentioned, in case the required files are not available from binary cache, compilation may take several hours.

Get Connection Parameters

Get some help from slapos service to have the connection parameters listed:

$ slapos service list
# OUTPUT
# List of services:
# Embedded Instance https://lab.nexedi.com/nexedi/slapos/raw/master/software/slapos-master/software.cfg
$ slapos service info 'Embedded Instance'

Read Connection Parameters

There are some important parameters:

"monitor-setup-url":"https://monitor.app.officejs.com/#page=settings_configurator&url=https://softinst154691.host.vifib.net/public/feeds&username=admin&password=lfhnagev",
"family-default-v6": "https://[2001:67c:1254:53:b362::3c9]:2152", 
"inituser-login": "zope", 
"inituser-password": "tzcrvsio"

You can monitor your Theia instance by monitor-setup-url. If you have '&' in the monitor-setup-url,please replace it to '&'.family-default-v6 is the Backend URL for the SlapOS Master. Copy the IPv6 URL family-default-v6 for the next step. inituser-login is the administrator username and Backend Type of SlapOS Master. inituser-password, apparently, is the password to zope.

Request a CDN in Rapid.Space for the IPv6

Follow the steps to get a free CDN: How to Request a Rapid.Space CDN

Please fill the following fields in the configuration page:

  • "Title": this is the title of your frontend, it is just to name the service inside the panel, which will be displayed in the list of Services. It is recommended that name it like your domain.
  • "Backend URL" : Set the IPv6(family-default-v6) provided by the request.
  • "Backend Type": Set it to "zope"

Validate

  • Get URL from connection parameter of the CDN
  • Access ERP5 using init-user and init-password from request
 

Validate

Get URL from connection parameter of the CDN. Access ERP5 using inituser-login and inituser-password from request

Next: Configure SlapOS Master

How To Configure SlapOS Master (COMP-Root)