Installation & update

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

• docker installed and running;
• Profitap IOTA CM docker image (provided).

Minimum:

• Processor: 4 CPU cores;
• RAM: 8 GB;
• Available disk space: 10 GB.

Suggested:

• Processor: 8 CPU cores;
• RAM: 16 GB;
• Available disk space: 10 GB.

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.

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.

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.

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

• Currently installed IOTA CM docker container;
• Data folder (we are using /home/user/iota-cm-data for this example).

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

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

• 443: HTTPS GUI and API access;
• 80: HTTP redirection to HTTPS GUI;
• 9090: HTTP API access (docker container only).

The first access is possible using the following default credentials:

• username: admin
• password: admin

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