Add Software Release to SlapOS Master

Add Software Release to SlapOS Master

How To Add Software Release To SlapOS Master

This document explains how to add a Software Product and Software Release to a SlapOS Master in order for it to be installed and instantiated on nodes of a network.

The document does not cover creating a software release.

To follow the steps in this document it is required to have:

Table of Content

  • Adding Software Product
  • Adding Software Release

Adding Software Product

To provide software on a SlapOS Master, you need to create a software product and a software release. At time of writing, this still has to be done in the ERP5 interface behind the SlapOS Dashboard.

Administrator Login to ERP5 Interface

ERP5 Interface - Login with Administrator Account

Go to the ERP5 interface behind your SlapOS Master. If your master has a user-friendly url (like https://master.slaptest.erp5.net/), you can find the backend url in the Frontend Slave connection parameters (access Services menu, locate your Frontend Slave). Remove the web_site_module/hostingjs/ part of the URL and don't forget to logout of the SlapOS Dashboard so you can login on the underlying ERP5 interface with superuser privileges.

Once you are on the login page, login with the account that has administrator privileges.

Access Software Product Module

ERP5 Interface - Administrator Homescreen

Once logged in click on Software Products or select Software Product Module from the Modules select field.

Add Software Product

ERP5 Interface - Administrator Add Software Product

On the software product page, select Action and Add Software Product.

Define Software Product

ERP5 Interface - Administrator Define Software Product

Set Title and Reference, then save by clicking the disk icon.

Publish Software Product

ERP5 Interface - Administrator Publish Software Product

The final step is to publish the Software Product. Select Action and Publish to change the workflow change.

Published Software Product

ERP5 Interface - Administrator Published Software Product

Confirm and once you are back on the Software Product page and the state is changed to Published, click on the ERP5 breadcrumb to get back to the main homescreen.

Access Software Release Module

ERP5 Interface - Administrator Homescreen

Next click on Software Releases or select Software Release Module from the Modules select field.

Add Software Release

ERP5 Interface - Administrator Add Software Release

Repeat the steps, so once on the software release page, select Action and Add Software Release.

Locate Software.Cfg Url

Gitlab - Software Release Software.cfg file

Head over to the repository you are using to host software releases and locate the software.cfg file which contains the instructions for building your your software (see understanding buildout for more info. Find the URL of this software release. In the example, it is:

https://lab.node.vifib.com/nexedi/amarisoft/raw/wip/slapos/software/lte/software.cfg

and save it for later.

Define Software Release

ERP5 Interface - Administrator Define Software Release

Fill the form as shown in the screenshot. Make sure you select HTTP and provide the url to your software.cfg. Also select the software product for which this release is made, define a version and once all fields have been filled out, click the disk icon to save.

Publish Software Release Alive

ERP5 Interface - Administrator Publish Software Release Alive

The final step is to publish the Software Release Alive (publishing alive, will allow to edit the provided data in case necessary). Select Action and Publish Alive to change the workflow change.

Published Software Release

ERP5 Interface - Administrator Published Software Release Alive

Confirm and once you are back on the Software Release page and the state is changed to Published Alive, click on the ERP5 breadcrumb to get back to the main homescreen.

Software Available in SlapOS Dashboard

SlapOS Interface - Published Software Release Available

Head over to the SlapOS Dashboard. If you pick a computer and click Supply, the newly defined software will now be on the list.

The process is the same for all software releases, so to summarize.

Summary: Create and Publish Software Product

ERP5 Interface - Summary Software Product

Create and Publish a new Software Product every time you want to add a new software to be provided on a SlapOS Master.

Summary: Locate Software.cfg Url

Gitlab - Software Release Software.cfg

Locate the URL of the software.cfg file.

Summary: Create and Publish Software Release

ERP5 Interface - Summary Software Release

Create and Publish a new Software Release (Alive!) using the software.cfg url retrieved and filling out the other metadata required for a Software Release.

Summary: Verify Software Release Availability

SlapOS Interface - Summary Verify Software Release Availability

Back in the SlapOS Dashboard, verify the software release is available by selecting a computer and trying to supply a software.

Thank You

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