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:
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.
Go to the ERP5 interface behind your SlapOS Master. If your master has a user-friendly url (like
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.
Once logged in click on Software Products or select Software Product Module from the Modules select field.
On the software product page, select Action and Add Software Product.
Set Title and Reference, then save by clicking the disk icon.
The final step is to publish the Software Product. Select Action and Publish to change the workflow change.
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.
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.
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:
and save it for later.
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.
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 on the ERP5 breadcrumb to get back to the main homescreen.
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.
Create and Publish a new Software Product every time you want to add a new software to be provided on a SlapOS Master.
Locate the URL of the
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.
Back in the SlapOS Dashboard, verify the software release is available by selecting a computer and trying to supply a software.