# Installazione

Prima di iniziare, è necessario eseguire tutti gli step di installazione della piattaforma sulla tua macchina, la quale deve basarsi su un sistema operativo Unix (preferibilmente Ubuntu) per assicurarsi di operare con totale compatibilità.

TIP

Ubuntu è gratis e open-source: è possibile scaricare la versione desktop qui (opens new window).

Non è consigliato, ma per i più esperti è possibile anche configurare la propria macchina con un dual-boot mantenendo il sistema operativo originale.

Una volta pronta la macchina, seguire gli step di installazione elencati sotto.

Al termine la piattaforma PlexusLAB sarà disponibile alla URL http://localhost/plexus/ oppure http://TUO_HOST_O_IP/plexus/ nel caso in cui la macchina sia collegata ad Internet.

# Installazione standard

PlexusLAB è un software scritto in linguaggio PHP. Ad oggi sono due le versioni di PHP supportate, 7.4 e 8.2.

ATTENZIONE

L'installazione default forza l'installazione di PHP 7.4 o 8.2 sulla macchina Ubuntu. Se avete altro software basato su PHP controllate che funzioni al termine dell'installazione. Bioforcetech Corporation non si assume responsabilità per il malfunzionamento di altro software PHP-based sulla macchina sul quale viene installato PlexusLAB.

# PHP 7.4

Aprire un terminale e lanciare i comandi:

sudo apt install curl -y
bash <(curl https://setup.plexus-automation.com/lab/ubuntu/install-php7.4.sh)

# PHP 8.2

Aprire un terminale e lanciare i comandi:

sudo apt install curl -y
bash <(curl https://setup.plexus-automation.com/lab/ubuntu/install.sh)

WarnA questo punto l'installazione richiede di inserire la password di sistema.

ATTENZIONE

Sul terminale, finita l'installazione, la password verrà stampata a video. Copiare la password per effettuare il login in PlexusLAB per la prima volta. Ricordarsi di cambiarla entrando nella pagina "Users" dopo il primo login.

# Installazione Offline

# Prerequisiti

PlexusLAB è installabile anche nel caso in cui non si abbia accesso diretto ad Internet sulla macchina Ubuntu.

Bisogna verificare che i seguenti requisiti siano soddisfatti dal sistema, seguendo questo elenco di checks:

Requisito Come verificare Note
Ubuntu OS 18.04 o successivo [Ubuntu 22.04 raccomandato] lsb_release -a
Apache 2.4 apache2 -v Qualsiasi sotto-versione 2.4.x
Apache status abilitato e attivo sudo systemctl status apache2
unzip unzip -v Qualsiasi versione
jq jq --version Qualsiasi versione
SQLite 3 [versioni PlexusLAB precedenti alla 0.40] sqlite3 --version Qualsiasi sotto-versione 3.x
MySQL Server [versioni PlexusLAB dalla 0.40] mysql --version
PHP 7.4 [PHP 8.2] php -v
libapache2-mod-php7.4 [libapache2-mod-php8.2] sudo apachectl -M php7_module [php8_module]
PHP Modules php -m bcmath, bz2, intl, gd, mbstring, mysql, zip, curl, sqlite3

ATTENZIONE

L'installazione offline non installerà il servizio di tunnelling sulla macchina.

Non sarà possibile esporre PlexusLAB pubblicamente e garantire accesso remoto alla piattaforma.

# MySQL Server

Dalla versione 0.40.0 di PlexusLAB è necessaria l'installazione di MySQL Server.
In particolare, oltre all'installazione, è richiesto di:

  • aver abilitato mysql.service allo startup
sudo systemctl enable mysql.service
  • avere creato un database chiamato “plexus_db” e un utenza mysql “plexus@localhost” con password “plexus4mysql”. Di seguito sono elencati i comandi necessari a tal scopo:
sudo mysql -e "CREATE DATABASE IF NOT EXISTS plexus_db;"
sudo mysql -e "CREATE USER plexus@localhost IDENTIFIED BY 'plexus4mysql';"
sudo mysql -e "GRANT ALL PRIVILEGES ON plexus_db.* TO 'plexus'@'localhost';"
sudo mysql -e "FLUSH PRIVILEGES;"

# Installazione manuale

Se tutti i requisiti sono soddisfatti è possibile procedere seguendo gli step di installazione manuale.

Scaricare lo script (opens new window) di installazione offline su un dispositivo, e spostare i file sulla macchina Ubuntu.

Scaricare l'ultima versione Plexus (opens new window) su un dispositivo, e spostare i file sulla macchina Ubuntu.

Se non si ha accesso diretto alla macchina è sempre possibile eseguire un push da remoto via ssh con il comando scp (opens new window):

scp /local/path/to/offline_install.sh <ubuntu_remote_user>@<ubuntu_ip_address_or_host>:/var/tmp
scp /local/path/to/latest.zip <ubuntu_remote_user>@<ubuntu_ip_address_or_host>:/var/tmp

Ora è necessario operare sulla macchina Ubuntu, aprendo direttamente il terminale o connettendosi da remoto via ssh.

# Spostarsi dove verrà installato PlexusLAB
cd /var/tmp
# Check che i 2 files latest.zip e offline_install.sh esistano
ls -la
# Garantire permessi di esecuzione allo script di installazione
sudo chmod +x offline_install.sh
# Esecuzione dello script
./offline_install.sh

# Aggiornamento di un PlexusLAB pre-esistente

# PHP 7.4

Aprire un terminale e lanciare i comandi:

bash <(curl https://setup.plexus-automation.com/lab/ubuntu/install-php7.4.sh) update

# PHP 8.2

Aprire un terminale e lanciare i comandi:

bash <(curl https://setup.plexus-automation.com/lab/ubuntu/install.sh) update

TIP

Il comando update non esegue l'aggiornamento delle librerie/package di OS e mantiene il meccanismo di autenticazione base di Expose e Apache2 (se precedentemente abilitato).

WarnQuando richiesto, inserire la password di sistema.

# Rimozione di PlexusLAB

bash <(curl https://setup.plexus-automation.com/lab/ubuntu/remove.sh)

AlertTutti i file di progetto vengono eliminati. Questa è una rimozione permanente di PlexusLAB e dei tuoi dati

# Layer di sicurezza Apache2

Scripts disponibili a partire da PlexusLAB 0.15.0 e successivi

I seguenti passi sono opzionali ma raccomandati, in modo da configurare un'autenticazione base alla piattaforma.

TIP

È consigliato in tutti i casi in cui la macchina è esposta alla rete internet esterna (IP pubblico) o quando è attivo il servizio di tunnelling.

ATTENZIONE

Se si abilita questo tipo di autenticazione e si desidera abilitare il servizio di tunnelling, ricordarsi di lasciare vuoto il campo "tunnel password" nei settaggi di System; altrimenti, i due sistemi di autenticazione andranno in conflitto e il browser continuerà a richiedere una password più e più volte quando si naviga attraverso il tunnel.

# Abilitazione e/o aggiunta di nuove credenziali

Abilitando il layer, agli utenti verrà chiesto di inserire delle credenziali nel browser prima ancora di vedere qualsiasi schermata di PlexusLAB o dei pannelli HMI.

Infatti è un livello di sicurezza aggiuntivo che lavora sopra le credenziali di PlexusLAB / HMI Panel e non le rimpiazza, né sostituisce.

Aprire il terminale, lanciare i seguenti comandi e seguire le indicazioni:

cd /var/www/html/plexus/
./apache_basic_auth_enable.sh

# Rimozione di credenziali esistenti

Aprire il terminale, lanciare i seguenti comandi e seguire le indicazioni:

cd /var/www/html/plexus/
./apache_basic_auth_disable_user.sh

# Rimozione del layer di sicurezza

Aprire il terminale, lanciare i seguenti comandi e seguire le indicazioni:

cd /var/www/html/plexus/
./apache_basic_auth_disable.sh

# Performance

Le seguenti istruzioni non sono obbligatorie.

Modificando il file di configurazione di PHP è possibile migliorare le performance del loop di sistema abilitando il meccanismo di caching dei files, chiamato OPcache. Nella maggior parte dei casi il sistema riuscirà ad ottenere un miglioramento del ~20% del tempo di esecuzione.

Il file php.ini si trova in uno dei seguenti percorsi, a seconda del tipo di installazione (PHP7 o PHP8).

Per prima cosa, creare un backup della configurazione attuale:

# PHP 7
sudo cp /etc/php/7.4/cli/php.ini /etc/php/7.4/cli/_php.ini.bkp
# OPPURE, PHP 8
sudo cp /etc/php/8.2/cli/php.ini /etc/php/8.2/cli/_php.ini.bkp

Aprire quindi il file config in un nano editor:

# PHP 7
sudo nano /etc/php/7.4/cli/php.ini
# OPPURE, PHP 8
sudo nano /etc/php/8.2/cli/php.ini

Quando il nano editor è aperto, cercare le seguenti "config keys" e impostarle come segue:

opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=512
opcache.max_accelerated_files=10000
opcache.validate_timestamps=1
opcache.revalidate_freq=0
opcache.revalidate_path=1

Chiudere l'editor e salvare premendo (CTRL + S), poi (CTRL + X).

ATTENZIONE

Per abilitare la nuova configurazione, un riavvio di sistema di PlexusLAB è necessario. Lo si può effettuare tramite la pagina System di PlexusLAB.

Last Updated: 2/2/2024, 16:28:31