Installation & update

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

• docker installed and running;
• Profitap IOTA CM docker image: https://iota.profitap.com/release-cm/

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.

Log in to the IOTA CM GUI.

Navigate to the Settings > License page and click the Edit button.

Paste the license key into the License Key field.

If IOTA CM can access the Internet, click the Activate Online button to activate the license.

If IOTA CM cannot access the Internet, use the following procedure to manually activate the license.

Click the Activate Offline button. An Offline Challenge text will be generated. Click the Copy to Clipboard button to copy this text, and paste it in a new plain text file (e.g. offline-challenge.txt).

Navigate to https://profitap.customer.eu.cryptlex.com/ ​​and log in with your credentials.

Navigate to the Activations page and click the Create Offline button.

The following window will open. Fill in the license key (this is the same key we pasted into the IOTA CM's License Key field previously). In the Offline Request File box, upload the Offline Challenge text file that we created previously (offline-challenge.txt). Press the Activate button.

A license file will be generated. The file will have a .dat extension. Click the Download button to download it.

Back on the IOTA CM's License page, click the Upload License File button and select the .dat file that we received in the previous step.

IOTA CM should now show that the license activation was successful.