This document explains how to add a software release attached to a software product in order for it to be installed and instantiated on nodes of a network. The process is the same for any software release that should be provided over a SlapOS network. The Theia is only used as example. For software product not published, it is required to add a new software product, described in How To Add A Software Product.

The Theia is a development IDE for SlapOS and part of the SlapOS toolbox. It is a platform-as-a-service (PAAS), browser-based development IDE providing a sandbox for a SlapOS application, that can be used to develop this application itself.

This howTo requires having administrator (superuser) access to a SlapOS Master (done in install a SlapOS Master) and another network node on which to install the Software Release.

Login with the  your administrator account to SlapOS Master ERP5 Modern Interface. 

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

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

Note, that whenever you want to upgrade a software release, you have to create a new software release entry with the difference being the version and software.cfg being pointed to, which can both be set in the next steps.

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 software. Find the URL of this software release. Note, that you should always used tagged version in production environment for example:

https://lab.nexedi.com/nexedi/slapos/raw/[TAG]/software/theia/software.cfg

[TAG] can be any value listed on the published releases, found on https://lab.nexedi.com/nexedi/slapos/tags. Continue using the latest tagged version which is 1.0.299. Note down the following url:

https://lab.nexedi.com/nexedi/slapos/raw/1.0.299/software/theia/software.cfg

Have your client-vifib-test-agent.crt, client-vifib-test-agent.key and slapos-client-vifib-test-agent.cfg configured on one of your SlapOS node, then supply the SR to the vifib-test-agent machines by: 

$ for c in COMP-3487 COMP-3997 COMP-4571; do slapos supply --cfg ~/slapos-vifib-test-agent/slapos-client-vifib-test-agent.cfg https://lab.nexedi.com/nexedi/slapos/raw/1.0.299/software/theia/software.cfg $c ; done # DEBIAN 11 / 12 /13

$ for c in COMP-3702 COMP-3823 COMP-4584; do slapos supply --cfg ~/slapos-vifib-test-agent/slapos-client-vifib-test-agent.cfg https://lab.nexedi.com/nexedi/slapos/-/raw/1.0.458/software/simpleran/software-ors.cfg $c ; done # UBUNTU 20 / 22 / 24

Fill the form as shown in the screenshot. Make sure to add the Software Product pointing to the Theia product you just created (add the title of the software product). Title and reference can be the same as on the software product. Make sure define a version and select HTTP, then provide the URL of raw code to your software.cfg. Once all fields have been filled out, click the save.

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.

Confirm and once you are back on the Software Release page and the state is changed to Published Alive.

Click Add in Services module.

Select the Theia software product.

Select the latest version.

Click Proceed in the header to start installation.

After clicking Proceed you will be forwarded to the service list page.

Installation will take some time depending on the software you are installing, so either refresh the current page or check installation status directly by entering the instance tree page.

You can see the installed service is now available on the instance tree page. Once the Monitor status bar changes to green on a refresh of the page, the installation has finished.

You can follow the compilation by looking at the slapos-node-software.log using:

# tail /opt/slapos/log/slapos-node-software.log -f