====== 1.3 Setting up the IOL Connect Manager ======

===== Install the software on the target system =====

The IOL Connect Manager is delivered comes as a tar archive. First, you need to unpack the software package on the target system.

  * Transfer the tar file provided (contains the application, the folder structure and any additional files required) to the Raspberry Pi using scp
  * Unpack:<code ->
tar xfvz iol-connect-manager_x.y.z.tgz
</code>where x,y,z stand for the minor, major and build version
  * Set up the IOL master application (iol-master-appl) as described in the github: [[https://github.com/Pinetek-Networks/iol-hat]] (SPI access, GPIO access)

===== Software dependencies (iol-master-appl) =====

The iol-connect-manager depends on the following libraries:

  * linux-vdso.so.1
  * libstdc++.so.6
  * libgcc_s.so.1
  * libc.so.6
  * /lib/ld-linux-aarch64.so.1

===== Raspberry Pi Users =====

If a new user is created, it must be assigned to the user groups for SPI and GPIO access in order to be able to execute the iol-master-appl:

<code ->
sudo usermod -aG gpio newuser
sudo usermod -aG spi newuser
</code>

===== Installing Node-RED on Raspberry Pi =====

If you want to use Node-RED in combination with IO-Link, you need to install Node-RED manually as described here: [[https://nodered.org/docs/getting-started/raspberrypi]]\\ Node-RED can either be installed as a service or called via terminal:

<code ->
  node-red-pi –max-old-space-size=256
</code>

Node-RED can be accessed via port [Raspberry-Pi IP]:1880. Node-RED can also be installed as a service.

===== Executing the software =====

To run the iol-hat-appl, the IO-Link master application (the communication stack) iol-master-app must first be started. The master application is available from the GitHub repository: __ (the file may need to be renamed).Please note that for high demand application (e.g., COM3 sensors), the master application must run on its own core as described in the GitHub instructions.The master application can be started with the following command (in this example running in sudo mode on core 4):

<code ->
sudo ./iol-master-appl -r 3
</code>

The IOL Connect Manager can then be started (e.g. in another terminal). This is usually done in user space (without sudo).

<code ->
./iol-connect manager
</code>

The IOL Connect Manager web interface can be reached at [[http://[Raspberry-Pi-IP]:18080]]

<WRAP info>

Please note that //**https**// (SSL) access to the webpage is usually not possible due to the operation of the Raspberry in private networks.

</WRAP>