Setup your RAISE Certified Node

Table of contents

• Requirements
• Registration
• Node Creation in Portal
• Installation
• Argument CLI

Requirements

Before starting make sure the machine meets the following requirements:

• Windows
  • Docker
  • Git
• Linux
  • Docker
  • Git

Registration

In order to download RCN you need an account to RAISE Portal If you have already access, sign in with your username/email and password. If you don’t have an account yet please see User Registration

Node Creation in Portal

Navigate to Nodes from the left panel and proceed to Create Node

Enter a Name for your RCN.

For the Node Public URL field you can enter the same as for Name, as its not used anymore.

Then click Save

You should see the Registered icon loading.

Click Details, from this window we need the uuid from Node Id for the installation process.

Installation

You need to download the executable file in order to install RCN in your machine.

• Windows latest release
• Linux latest release

Then in the directory you download the file open a Terminal and run the executable as follows (keep the —install-service if you want the node to be automatically updated):

Windows

./raise-rcn-deployer-win.exe --initial-node-deployment --install-service

Linux

chmod +x raise-rcn-deployer-linux
./raise-rcn-deployer-linux --initial-node-deployment --install-service

It prompted you to enter below information:

• Username (Your username from the raise portal)
• Password (Your password from the raise portal)
• RAISE Certified Node ID (Here you need to paste the Node Id that mentioned earlier in the Node Creation)

At this point the RAISE Node Installer starts the installation process by getting the latest available version for the Node and starting the installation. At this time, the current status at the portal is “Deploying”. Once the installation has finished, the current status will be “Ready” along with the installed version.

Automatic updates

The RAISE Node Deployer is taking care of the Node automatic updaters as well. To do so, after the initial deployment, the RAISE Node Deployer must be installed as a service. It uses the credentials that have been created during the initial deployment phase and checks for any available new version periodically. Each time, the latest available version is compared against the installed one. If a newer version is detected, the Node enters the Updating status and the update starts. Once finished, the Node goes back to the Ready status with the updated version.

Argument CLI

--configure
deletes all locally saved credentials and asks the user to type them again

--initial-node-deployment
It will run the initial deployment of the RAISE RCN containers and will inform the portal about the node deployment status. The node must be first registered on the portal as the node ID required for the node initial deployment is provided during RCN node registration on the portal.

--install-service
After deploying, it will install raise-rcn-service as a linux/windows service, it will start the service and will exit the current executable.

--uninstall-service
It will uinstall the raise-rcn-service from linux/windows service, and then will continue with the rest deploying, etc.

--install-docker
It will install docker, if not installed already

--uninstall-service --install-service
It will uninstall the running service of deployer

--dev
It is applicable only with --initial-node-deployment or --configure or --install-all
When used, it allows the user to set the RAISE API domain (i.e. https://develop.api.portal.raise-science.eu) and to enable the port 8000 binding (node api at http://localhost:8000)