eco-iot-pmed-workspace

eco-iot-pmed-workspace bundles all the necessary dependencies for building and running SSApps in a single package.

For more details about what a workspace is check out the template-workspace.

General architecture

Installation

In order to use the workspace, we need to follow a list of steps presented below.

If you have trouble installing the eco-iot-pmed-workspace, please try to follow the guide provided on PrivateSky.xyz

Step 1: Clone the workspace

$ git clone https://github.com/PharmaLedger-IMI/eco-iot-pmed-workspace.git

After the repository was cloned, you must install all the dependencies.

```sh
$ cd eco-iot-pmed-workspace
#Important: for the development mode we proceed with npm run dev-install
#For normal installation, the command is: npm install
$ npm run dev-install 

Note: this command might take quite some time depending on your internet connection and you machine processing power.

Step 2: Launch the api-hub

While in the eco-iot-pmed-workspace folder run:

$ npm run apihub

At the end of this command you get something similar to:

Step 3: Install the iot-adapter

See how to install the iot-adapter

Step 4: Build all things needed for the application to run.

Open a new console inside iot-workspace folder and run:

# Note: Run this in a new console inside "iot-workspace" folder
$ npm run build-all

To build individual applications open a new console inside eco-iot-pmed-workspace folder and run one of the following commands:

# Run this to build trial-participant-sapp
$ npm run build-tp

# Run this to build clinical-site-sapp
$ npm run build-cs

# Run this to build researcher-sapp
$ npm run build-rs

Also, refer package.json file for more commands.

Running

To run the application launch your browser (preferably Chrome ) in private or incognito mode depending on your browser and access the http://localhost:8080 link.

Prepare and release a new stable version of the workspace

Steps:

1. start from a fresh install of the workspace.

git clone https://github.com/PharmaLedger-IMI/eco-iot-pmed-workspace
cd eco-iot-pmed-workspace

2. run the installation process of the workspace

npm install

3. run the server and build the ssapps and wallets

npm run server
npm run build-all

4. verify that the builds are successfully and the ssapps are functioning properly
5. execute the freeze command

npm run freeze

6. verify the output of freeze command and check for errors. If any, correct them and run again the freeze command.
7. commit the new version of the octopus.json file obtained with the freeze command.