Installation Instructions

This page is dedicated to DWIS installation instructions.

Prerequisites

You need to have docker installed on your machine before you can install the DWIS infrastructure.

Install the Blackboard

If you have internet access from your host, to install the Blackboard you can run the following command:

docker run --name ddhubserver -p 48030:48030/tcp --hostname localhost  digiwells/ddhubserver:latest

If you do not have internet access from your host, you need to download the docker image on a machine that have internet access, then dump an image, next transfer the image to the host, and finally install the image in your docker environment.

To download the docker image on a machine having internet access, run the following command:

docker pull digiwells/ddhubserver:latest

To save the image as a tar file:

docker save -o ddhubserver.tar digiwells/ddhubserver:latest

After, you have transferred the tar file on the destination host that does not have internet access, run the following command:

docker load ddhubserver.tar

Finally, you can run the image by using the following command:

docker run --name ddhubserver -p 48030:48030/tcp --hostname localhost  digiwells/ddhubserver:latest

how to test that the Blackboard runs correctly?

There is a small program that can be used to test that the Blackboard runs properly. It is called DWIS.Blackboard.Client.Test.

Prerequisites

You need to have git and DotNet 8.0 installed on a machine that has internet access.

Clone the source code

First you need to clone the DDHub-DSID-WP2-Common repository to a machine that have internet access.

Run the program DWIS.Blackboard.Client.Test

If you will test on a machine that has internet access, you can simply navigate to the folder DWIS.Blackboard.Client.Test and run the following command:

cd .\DDHub-DSID-WP2-Common\src\DWIS.Vocabulary.OPCUA\DWIS.Blackboard.Client.Test
dotnet run

If everything is alright you shall see

Connection established
Succeeded to define example semantics
Succeeded to push data

If you do not have internet access on the machine where you run the Blackboard, you need to create a self-contained application of the test program.

For a windows environment, run the following command:

dotnet publish -c Release -r win-x64 --self-contained

You will find the whole set of libraries and the executable in a directory called bin\Release\net8.0\win-x64. You can then zip the win-x64 folder and transfer it to the target machine. After unpacking the archive, you can run the command DWIS.Blackboard.Client.Test.

For a linux environment, run the following command:

dotnet publish -c Release -r linux-x64 --self-contained

You will find the whole set of libraries and the executable in a directory called bin\Release\net8.0\linux-x64. You can then zip the linux-x64 directory and transfer it to the target machine. After unpacking the archive, you need to mark the executable as runnable:

chmod +x DWIS.Blackboard.Client.Test

Afterward you can run the command DWIS.Blackboard.Client.Test.