Licence

In order to use the full functionality of ACEMD3, one has to purchase a licence. Contact Acellera (info@acellera.com) for details.

Alternatively, ACMED3 can be used for free, but following limitations apply:

  • Runs on one GPU (device 0) only

  • Do not work in a virtualized environment

  • Only limited technical support is be provided

One can check the status of the licence with the following command:

$ acemd3 --licence

Licence types

Three types of licence are available:

  • Node-locked licence is locked to a specific machine. It is recommended for invidual workstations and small HPC clusters.

  • Floating licence is aquired by connecting a licensing server hosted internally. It is recommended for large HPC clusters.

  • Cloud licence is aquired by connecting a licensing server hosted by Acellera. It is recommend for cloud and virtualized environments.

Node-locked licence

A node-locked licence is locked to a specific machine by its MAC address. One will have to provide it when purchasing the licence.

The licence is issued in a form of a licence file (licence.dat), which needs to place at one of the following locations:

  • ~/.acellera/licence.dat

  • /opt/acellera/licence.dat

Alternatively, the path of the licence file can be set with the environment variable ACELLERA_LICENCE_FILE:

$ export ACELLERA_LICENCE_FILE=/tmp/licence.dat

Floating licence

A floating licence is aquired by connecting to a licensing server. Any machine having access to a licence server can use it. The maximum number of concurrent licences is agreed then purchasing the licence. Additionally, one will have to provide an MAC address of a machine where the licence server will be deployed.

The licence is issued in a form of a licence file (licence.dat), which is needed to deploy the licence server. After deploying the license server, its IP address (or hostname) and port number is provided to a user.

The user has to set the IP address (e.g. 192.168.0.1) and port number (e.g. 27000) with the environment variable ACELLERA_LICENCE_SERVER:

$ export ACELLERA_LICENCE_SERVER=27000@192.168.0.1

Cloud licence

A cloud licence is aquired by connecting to a licensing server hosted by Acellera. Any machine having access to the licence server can use it. The maximum number of concurrent licences is agreed then purchasing the licence.

The licence is issued in a form of a public IP address (e.g. 35.237.46.128) and port number (e.g. 27000), which have to be set with the environment variable ACELLERA_LICENCE_SERVER:

$ export ACELLERA_LICENCE_SERVER=27000@35.237.46.128

Licence server

The floating licence requires a license server. It should be deployed on a machine that is accessible via the network.

Requiments for the hosting machine:

  • CentOS 7 or other compatible OS

  • Fixed MAC address

  • root access

Download the server:

$ curl -s https://software.acellera.com/floating-licence-server.tar.gz | tar xzvf -

Install the server. Note that install.sh has to be executed as root user. By default, the server is installed to /opt/acellera and executed as sglmd user. This can be changed by setting the environment variables ROOT and USER, respecively:

$ cd floating-licence-server && sudo ./install.sh

Copy the licence file (license.dat) to /opt/acellera. Note, /opt/acellera/license.dat has to be readable by sglmd user.

Start the licence server:

$ service acellera.sglmd start

Validate that the server has started:

$ tail /var/log/acellera.sglmd.log
2020/01/01 00:00:00 Server starting on localhost, port 27000, max components 64, max connections 256
Enabling acemd 3.0 512 01-jan-2025
Ready...

This means that the server is accepting license requests on part 27000. It can issue up to 512 concurrent licences of ACEMD until the 1st of January, 2025.

Finally, validate the server from a remote machine. This assumes that the server is running on licence.internal.acellera.com and a firewall is configured to allow TCP connections to port 27000:

$ export ACELLERA_LICENCE_SERVER=27000@licence.internal.acellera.com
$ acemd3 --licence
# Licence:
#   Check floating licence:
#     ACELLERA_LICENCE_SERVER (27000@licence.internal.acellera.com) -- GRANTED
#     ACELLERA_LICENSE_SERVER -- not defined
#   Check node-locked licence:
#     ACELLERA_LICENCE_FILE -- not defined
#     ACELLERA_LICENSE_FILE -- not defined
#     /opt/acellera/licence.dat -- DENIED (Unable to locate target file)
#     /opt/acellera/license.dat -- DENIED (Unable to locate target file)
#     /home/raimis/.acellera/licence.dat -- DENIED (Unable to locate target file)
#     /home/raimis/.acellera/license.dat -- DENIED (Unable to locate target file)