Hyper Open Edge Cloud

How To Request an ERP5 Instance on a SlapOS Webrunner

Instructions on installing an ERP5 instance via SlapOS webrunner for learning or working with ERP5.
  • Last Update:2020-09-10
  • Version:005
  • Language:

How to Request an ERP5 Instance on a SlapOS Webrunner

These instructions will help you get your first ERP5 instance using a SlapOS webrunner. The document is for Nexedi developer (it requires a SlapOS network ) or users wanting to use Nexedi's commercial hosting service Vifib (how to register on Vifib). For getting your own instance on your machine, please use the standalone installer.

What is SlapOS?

SlapOS is an open source grid operating system for cloud orchestration and edge computing. Almost all ERP5 implementations are hosted through SlapOS as both tools share many similarities in they way they are built. If you are interested, have a look at the SlapOS software page and especially the general introduction and presentation on SlapOS architecture.

There are two ways to getting an ERP5 instance using SlapOS:

  • Requesting an "empty" Webrunner and deploying ERP5 as a software release (Production-Instance - recommended)
  • Requesting a Webrunner with ERP5 preinstalled

Getting A Webrunner and deploying ERP5 (recommended)

The following steps will help you get an empty webrunner to deploy ERP5:

Create an account on slapos.vifib.com

SlapOS Interface - Dashboard Login

Go to slapos.vifib.com and create an account (recommended). You may also create an account using Facebook or Google.

Request a new Service

SlapOS Dashboard

Once you have your account, click on Services in the left-hand panel.

We will be creating a new hosting-subscription (the service) for a Webrunner. This will create a Webrunner instance for us to use.

Add a new Service

SlapOS Dashboard - Services - Add a service

Click "Add" in the subheader to add a new serice

Select Webrunner

SlapOS Dashboard - Select Service Webrunner

Select SlapOS WebRunner

Select Latest Version

SlapOS Dashboard - Select Version Webrunner

Select the latest version

Configure Resilient Instance

SlapOS Dashboard - Configure Service Webrunner Version

Enter a name for your Webrunner and make sure to select the Resilient Software-Type, in order to create multiple geographically separated instances of your software. Click Proceed to request your service. The remaining parameters are not required.

Instantiate Webrunner

SlapOS Dashboard - Instantiate Service Webrunner

You will be redirected back to the service list. Note: Refresh the page if your service doesn't show up immediately. Your Webrunner will be ready in 10-15 minutes. Refresh the page from time to time to see when the status light turns green. When it does click on the Service (Not on the status-light!) to access the webrunner connection parameters

Access your Webrunner

SlapOS Dashboard - Connection Parameters Service Webrunner

Locate the table with Connection Parameters. Your init-login will be admin

Note down your init-password and click on the url parameter at the bottom of the table. This is the IPv4 url of your webrunner. Enter login and password in the prompt to continue to your Webrunner interface

Installing ERP5 on the Webrunner

Webrunner Interface

To request the ERP5 software release, click on Open a Software Release.

Select ERP5 Software

Webrunner Interface - Open Software Release

Locate the Software folder, which contains all software releases you can currently install on this Webrunner. Locate ERP5 and select the folder (don't open it). Then click the Open Software button on the bottom left to open the software release.

Save ERP5 Software Release

Webrunner Interface - Save Software Release

You can see which buildout profile and which revisions will be used to build your ERP5 instance from scratch. Just confirm the values by clicking Save at the bottom left. Then hit the green play button to start the software build.

Compilation - have a coffee

Requesting a Webrunner with ERP5 - SlapOS Webrunner Install Software Release

Compilation from scratch and installation will take a few hours. Once everything is done, both indicators should be showing a green state. Note: Should the indicators not show a green light, it may be, that installation did not complete successfully due to some errors like missing templates. Please hit the green button again - it will only take a few minutes to re-instantiate and see if installation finishes successful.

Compilation - Debugging

Requesting a Webrunner with ERP5 - SlapOS Webrunner Installed Software Release

Should you still have errors, please check the log on the left for ERROR entries to start investigating why your build and install did not succeed. A more detailed version of the logs can be found in the logs tab.

Requesting a Frontend Url

Requesting a Webrunner with ERP5 - SlapOS Webrunner Services Partition Parameters

Head to the Services tab and locate parameters on the Slappart0 partition or in case of a resilient runner, just click the "Connection Parameters" tab. Copy the family-default-v6 parameter (make sure you don't copy the family-default). We will use this to require a custom-front-end url for the erp5 instance. Head back to the SlapOS Interface.

Note: Please can also copy the inituser-password for later. It will be the password to access your ERP5 instance.

Updating Hosting Subscription Parameters

SlapOS Dashboard - Request ERP5 Frontend

Copy the value, head to your SlapOS Service page and add it as value for the Custom Frontend Backend URL to request an IPv4 frontend url for your instance. Also set the Custom Frontend Backend Type to "Zope". Click Save in the header. Requesting the Frontend should not take longer than 15 minutes. When refreshing the page it should be visible in the Connection Parameters table as custom-frontend-url.

Locate the Frontend Url Service

SlapOS Dashboard - Locate ERP5 Frontend Service

There may (still) be a bug that causes the custom-frontend-url to not show up when ready. Scroll down to the table called Instances and locate the Custom Web Frontend entry. Click on the row (not the green status button).

Locate the Frontend Url

SlapOS Dashboard - Locate ERP5 Frontend Url

Locate the Connection Parameters table. The Url parameter contains the domain name under which the ERP5 instance can be reached.

Click on this URL, you should reach your ERP5 instance (you should see zope quickstart guide). To access ERP5 itself add /erp5 to the URL (you should see the login page).

Login to ERP5

Your inituser is zope. You can now use the inituser-password you copied earlier in the Connection parameters when noting down the family-v6-url. Enter both to login to ERP5.

Getting A webrunner with ERP5 preinstalled

The following steps will help you getting your instance.

Request Webrunner with ERP5 Preinstalled

SlapOS Interface - Service XML Parameters

You can follow the steps above:

  • Go to https://slapos.vifib.com/
  • Add a new service called "SlapOS Web Runner (latest version)"
  • Enter the following Parameters for ERP5 (found here).

Partition Amount: 15
Pre-selected Software Release: software/erp5
Automatically Deploy Software: true
Automatically Deploy Instances: true
Automatically Run Sofware/Instance: true
Custom Frontend Backend URL: <Leave empty, fill after instance creation, see below>
Custom Frontend Backend Type: zope
  • Once done you should have a number of URLs available describe here.
  • Use the url (12) and Init User (7) and Init Password (6) to login to your Webrunner (initial setup described here). When accessing your Webrunner, your software release should be compiling already. This will take some hours. After the software release is compiled, the erp5 instance will be created. In the Log tab you can see the progress. Request the service by clicking on the green triangle (it will take a few hours). Note that when your account needs to be validated, your Webrunner instance may be generated, but ERP5 may not be built automatically. In this case, once you log into your Webrunner and access the Services tab, the connection information may be empty. Press the green play button to trigger compilation and instantiation manually.
  • Make sure to check "Services" > "Parameters" tab. The value of the field "Software Type of main instance" should be "default". If it is not, change it and then redploy service by clicking the green triangle again.
  • After your instance has been created, check the tab "Services" > "Connection Information". Here you will find a json dictionary parameter with the key family-default-v6 or just family-default. The URL will look something like https://[2001:67c:1254:e:b7::8680]:2151. Copy this url and paste into the Custom Frontend Backend URL Slapos Parameters which you left empty before.
  • When you refresh the web page of you slapos service after some time a new Connection Parameter should appear: custom-frontend-url(if it is empty, wait a bit more). Append "/erp5" to this link to access you new erp5 instance. You will find the initial user name ("zope") and the initial password of your instance in the "Services" > "Connection Information" tab of your webrunner.
  • Note: Should your instance not setup correctly or start, check the parameter tab in your WebRunner and try adding this parameter (key must be "_"), then re-instantiate by clicking the green triangle.
"_" : {
  "timezone": "UTC",
  "site-id": "erp5",
  "zope-partition-dict": {
    "admin": {
      "family": "admin",
      "thread-amount": 10,
      "port-base": 2210,
      "instance-count": 1
    }
  }
}

Thank You

Image Nexedi Office
  • Nexedi SA
  • 147 Rue du Ballon
  • 59110 La Madeleine
  • France