Most Powerful Open Source ERP

SlapOS How To Deploy Software on Webrunner

FINAL - Document showing how to deploy a software on the SlapOS Webrunner
  • Last Update:2020-05-26
  • Version:001
  • Language:en

How To Deploy Software on a Webrunner

This document will show how to deploy a software release on a SlapOS Webrunner. The process can be used for any software available on the SlapOS repository. Note, that the Webrunner is behaves like a SlapProxy (see SlapOS architecture) in that it contains a "mini SlapOS Master" that can provide a single software. Instantiating a Webrunner thus means, creating a smaller encapsulated system for then deploying another software inside. This is a useful approach for developing or hosting simple software releases.

Table of Content

  • Deploy Software

Deploy Software

This section will show how to access a webrunner and deploy a software. The screenshots show deployment of the helloworld software release, also used to explain how to extend a software release.

Access Webrunner

SlapOS Interface - Webrunner Connection Parameters

Locate the connection parameter on your webrunner service. You can access the webrunner using the url and logging in with init-user and init-password.

Webrunner Landing Page

Webrunner Interface - Landing Page

On the Webrunner landing page, select Open Software Release

Locate Software Directory

Webrunner Interface - Locate Software Directory

Locate the Software directory which contains a list of all software releases available on the webrunner. The list is based on the official SlapOS software repository.

Select Helloworld Software

Webrunner Interface - Select Software

Select the Helloworld Software Release, then click Open Software.

Confirm Helloworld Software

Webrunner Interface - Confirm Software

Click Save unless modification of the software release is required before deploying the default version. Then click the green arrow to start build and instantiation.

Build Status

Webrunner Interface - Deployment Status

Once saved the deployment of the software will begin. Deployment can take anywhere from a few minutes (simple software, already compiled) to several hours. The log panel will inform of any errors or warnings encountered during deployment.

Build Finished

Webrunner Interface - Deployment Finished

The top indicator Building State will show the result of (re-)building the software release. If it fails, errors are likley in software.cfg. The bottom indicator shows the Running State which indicates whether an instance could successfully be deployed from the software release. Errors in this part are likley to be found in instance.cfg.in.

Once both indicators switch to green, the software is deployed and ready to use.

Inspect Services

Webrunner Interface - Inspect Services

Click on Services in the subheader to open the list of running services. The services defined in the software.cfg file should be running.

Inspect Connection Parameters

Webrunner Interface - Inspect Connection Parameters

The connection parameters tab displays the parameters defined in the instance.cfg.in.

Thank You

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