Table of Contents

Installation & update

Installation

Prerequisites

In order to perform the application deployment, the following elements are necessary:

System requirements

Minimum:

Suggested:

Installation

The installation can be performed using the following commands in order:

1. Create a directory to be used to store the IOTA CM configuration:

mkdir -p /home/user/iota-cm-data/

This is only a reference path used for this documentation. If a different path is used, edit the following commands accordingly.

2. Load the provided docker container (replace 'X.Y.Z' with the appropriate version number):

docker load -i profitap-iota-cm-vX.Y.Z.tar

3. Run the docker container, specifying the correct data directory (replace 'X.Y.Z' with the appropriate version number):

docker run -v /home/user/iota-cm-data:/data:Z --network host --rm --name iota-cm -d profitap-iota-cm:vX.Y.Z

At this point, the IOTA CM application should be running. If you wish to verify that deployment has proceeded correctly, you can check the running containers using the following command:

docker ps

The Profitap IOTA CM container should appear.

Installing a custom SSL certificate

1. Stop the docker container:

docker stop iota-cm

2. Replace the certificate (cert.pem) and key (key.pem) files in the data folder with the one you want to use.

3. Restart the docker container:

docker run -v /home/user/iota-cm-data:/data:Z --network host --rm --name iota-cm -d profitap-iota-cm:vX.Y.Z

If you wish to recreate a new self-signed certificate, in step 2, remove the cert.pem and key.pem files.

Update

When using the IOTA CM docker container, the update process simply consists of shutting down the currently-running docker container, and starting the new updated docker container using the same data folder. The new instance will perform all of the necessary data migration.

Prerequisites

In order to perform the update, the following elements are necessary:

Update

The steps for updating IOTA CM are as follows:

1. Load the new docker container in your local registry (replace 'X.Y.Z' with the appropriate version number):

docker load -i profitap-iota-cm-vX.Y.Z.tar

2. Stop previous instance using the following command:

docker stop iota-cm

3. Start a new docker container instance (replace 'X.Y.Z' with the appropriate version number):

docker run -v /home/user/iota-cm-data:/data:Z --network host --rm --name iota-cm -d profitap-iota-cm:vX.Y.Z

Access

When deployed, IOTA CM is accessible through the following ports:

The first access is possible using the following default credentials:

It is strongly advised to change these credentials on first access.