Ubiquity Manuale Utente (v1.3) - Asem

Ubiquity Manuale Utente
Ubiquity Manuale Utente
Introduzione
Ubiquity è la soluzione ASEM per l’accesso e l’assistenza remota di macchine
industriali automatiche che impiegano sistemi operativi Windows e Windows CE.
Questo documento copre i seguenti argomenti:
Architettura e concetti
Installazione e configurazione del software per PC
Installazione e configurazione dei componenti Runtime
I contenuti sono allineati con Ubiquity V1.3
Page 1 / 58

Ubiquity Manuale Utente
Sommario
1 Concetti ...................................................................................................................................................... 3
1.1 Architettura Software ......................................................................................................................... 3
1.1.1 Runtime .......................................................................................................................................... 3
1.1.2 Control Center................................................................................................................................ 3
1.1.3 Infrastruttura Server ....................................................................................................................... 3
1.1.4 Connettività .................................................................................................................................... 3
1.2 Licenze Ubiquity ................................................................................................................................ 5
1.3 Dominio Ubiquity ................................................................................................................................ 6
2 Control Center ............................................................................................................................................ 7
2.1 Requisiti e installazione ..................................................................................................................... 7
2.2 Usare il Dominio .............................................................................................................................. 10
2.2.1 Creazione del Dominio ................................................................................................................ 10
2.2.2 Creazione degli utenti .................................................................................................................. 12
2.2.3 Cambio della password ............................................................................................................... 13
2.2.4 Creazione dei gruppi .................................................................................................................... 14
2.2.5 Associazione degli utenti ai gruppi .............................................................................................. 15
2.2.6 Organizzazione del dominio ........................................................................................................ 16
2.2.7 Gestione dei permessi ................................................................................................................. 18
2.3 Gestione dei dispositivi remoti ......................................................................................................... 23
2.3.1 Prima connessione e registrazione della licenza ......................................................................... 23
2.3.2 Connessione Seriale Remota ...................................................................................................... 26
2.3.3 Remote Desktop .......................................................................................................................... 28
2.3.4 Trasferimento file ......................................................................................................................... 29
2.3.5 Remote Task Manager ................................................................................................................ 31
2.3.6 System Information ...................................................................................................................... 32
2.3.7 Chat ............................................................................................................................................. 33
2.3.8 Virtual Private Network (VPN) ..................................................................................................... 34
2.3.9 Scenari di connettività VPN ......................................................................................................... 36
3 Runtime .................................................................................................................................................... 40
3.1 Runtime per piattaforme Windows CE ........................................................................................... 40
3.2 Runtime per piattaforme Win32 ....................................................................................................... 40
3.3 Registrazione dispositivo e licenza .................................................................................................. 42
3.4 Configurazione della VPN ................................................................................................................ 43
3.4.1 Connessione VPN ristretta al solo dispositivo remoto ................................................................. 44
3.4.2 Connessione VPN estesa all’intera sottorete con due interfacce di rete..................................... 45
3.4.3 Connessione VPN estesa all’intera sottorete con una interfaccia di rete .................................... 47
3.4.4 Connessione VPN ristretta al dispositivo remoto con indirizzi IP fisici ........................................ 54
3.5 Controllo Runtime da riga di comando ............................................................................................ 55
3.6 Funzionamento Remote Desktop su sistemi Windows CE ............................................................. 55
3.7 Esecuzione senza shell Explorer ..................................................................................................... 56
4 FAQ .......................................................................................................................................................... 57
4.1 Come viene identificato il dispositivo in modo univoco? ................................................................. 57
4.2 Come viene stabilita la connessione tra Control Center e Runtime? .............................................. 57
4.3 Collegamento locale ........................................................................................................................ 58
Page 2 / 58

1 Concetti
Ubiquity Manuale Utente
Questo capitolo illustra i concetti di base della piattaforma software Ubiquity per la teleassistenza.
Ubiquity è una piattaforma software completamente sviluppata da ASEM per la teleassistenza; permette di
operare sui sistemi remoti esattamente come in locale con il vantaggio di avere a disposizione tutta la
competenza tecnica aziendale senza nessuno spostamento.
Ubiquity è composto da una suite di componenti software:
Ubiquity Control Center
Applicazione Windows da installare sul PC utilizzato per l’assistenza; permette la configurazione del sistema,
la registrazione sul dominio dei sistemi remoti, la configurazione delle opzioni di sicurezza per gruppi ed
utenti. Il tutto fruibile attraverso un’interfaccia semplice e intuitiva.
Ubiquity Runtime
Componente software da installare sul sistema remoto che si desidera controllare. Ubiquity Runtime è
fornibile per sistemi “PC based”, ma anche per classici dispositivi HMI. Ubiquity Runtime è disponibile per
Windows CE e per tutte le piattaforme Win32, da Windows XP a Windows 8.
1.1 Architettura Software
L’architettura Ubiquity prevede l’interoperabilità di tre componenti: Runtime, Control Center e l’infrastruttura
Server.
1.1.1 Runtime
Ubiquity Runtime è il componente software installato sul dispositivo remoto che permette l’accesso al
dispositivo stesso. Il servizio è attivo in background ed è parametrizzabile attraverso l’interfaccia utente di
Ubiquity Runtime (pannello di controllo) oppure attraverso direttive inoltrate da riga di comando. Agisce
come “client” nei confronti dell’infrastruttura server.
1.1.2 Control Center
Control Center è il componente “client” installato sul PC impiegato per l’assistenza. Permette la gestione
delle risorse di dominio e la registrazione dei dispositivi sul dominio stesso. Permette la connessione a uno
specifico dispositivo, istanzia la connessione VPN, gestisce la funzione seriale virtuale e fornisce gli
strumenti d’interazione come il desktop remoto e il trasferimento file.
1.1.3 Infrastruttura Server
L’infrastruttura server gestisce l’autenticazione e il controllo di accesso. Supporta inoltre il controllo di flusso
tra il Control Center e il Runtime.
L’infrastruttura è dotata di caratteristiche di ridondanza e “fault tolerance”.
1.1.4 Connettività
Il requisito fondamentale per il funzionamento di Ubiquity è la disponibilità di una connessione Internet
funzionante per Control Center e per il dispositivo su cui è installato Ubiquity Runtime.
Ubiquity Control Center e Ubiquity Runtime usano sempre connessioni di tipo uscente e pertanto
normalmente consentite dai sistemi di firewall.
Page 3 / 58

Ubiquity Manuale Utente
Da questo punto di vista Control Center e Runtime agiscono come “clienti” nei confronti dell’infrastruttura
server che è in grado invece di accettare connessioni di tipo entrante.
Almeno una delle seguenti porte TCP deve essere aperta:
80 (http),
443 (https)
oppure 8888 (custom).
Per stabilire la connessione con il server, Control Center e Runtime attuano una scansione delle porte
disponibili e una volta individuata quella aperta, la utilizzano per la connessione al server e successivamente
per la connessione end-to-end.
Control Center e Runtime sono inoltre in grado di utilizzare le porte UDP 80, 443 o 8888 con connessioni
uscenti per aumentare le prestazioni della connessione. Connessioni di tipo UDP offrono normalmente tempi
di latenza inferiori e migliore stabilità, soprattutto quando la rete è congestionata.
Nel caso in cui le porte UDP siano chiuse, Control Center segnala la condizione utilizzando il colore
arancione per indicare l’attivazione della VPN e un simbolo di avvertimento ( ) localizzato graficamente sul
componente dove le porte sono chiuse (Control Center, Runtime o entrambi).
1.1.4.1 Proxy
Ubiquity V1.3 supporta la connessione ad Internet attraverso PROXY.
Le impostazioni per l’utilizzo del PROXY si trovano nella scheda “Network” come mostrato nella figura
seguente.
Page 4 / 58

Cliccare sull’icona per espandere la schermata e selezionare quindi il metodo richiesto.
Ubiquity Manuale Utente
“Type” supporta le seguenti scelte:
Auto: utilizza le impostazioni di Internet Explorer per l’indirizzo IP e la porta; nel caso in cui il
PROXY richieda autenticazione, la modalità Auto non può essere usata.
HTTP: Proxy di tipo HTTP, supporta autenticazione con nome utente e password.
SOCKS5: Proxy di tipo SOCKS5, supporta autenticazione con nome utente e password.
None: nessun Proxy configurato.
1.2 Licenze Ubiquity
Ubiquity è disponibile con due tipologie di licenze caratterizzate da funzioni diverse.
La tabella seguente illustra le differenze.
Funzione Licenza BASIC Licenza PRO
Strumenti interattivi (Remote Desktop, File Exchange, Remote Task
Manager, Chat, System Information)
Sì Sì
VPN ristretta al dispositivo su cui è in esecuzione Ubiquity Runtime Sì Sì
VPN estesa alla sottorete dei dispositivi collegati No Sì
Seriale Virtuale No Sì
Page 5 / 58

1.3 Dominio Ubiquity
Un dominio Ubiquity è un insieme di utenti e dispositivi remoti in un dato contesto applicativo.
Ubiquity Manuale Utente
Per esempio, l’azienda di nome Contoso S.p.A. può creare un dominio chiamato “Contoso” per raggruppare
tutti i suoi dispositivi remoti, suddividerli in cartelle organizzate ad albero ed assegnare agli operatori i diritti
per l’accesso.
Possono far parte del dominio i seguenti elementi:
Utenti
Un utente rappresenta delle credenziali di accesso con le quali accedere al dominio e ai sistemi remoti.
Idealmente è possibile la creazione di un utente per ciascun individuo, ognuno con la propria password.
L’accesso al dominio avviene attraverso Control Center fornendo il nome del dominio, il nome utente e la
password.
Gruppi
Un gruppo è un insieme di utenti. I gruppi permettono di organizzare in modo efficace gli utenti.
Un utente può appartenere a più gruppi.
Dispositivo remoto
In questo manuale “Dispositivo remoto” o più semplicemente “Dispositivo” è sinonimo di computer o
pannello operatore sul quale è installato e configurato il componente Runtime di Ubiquity e che può
quindi essere raggiunto attraverso Control Center.
Cartelle
Una cartella è un “contenitore” di dispositivi remoti; Control Center fornisce una vista ad albero dei
dispositivi organizzabile in modo gerarchico. Le cartelle possono anche essere innestate.
Un dispositivo remoto può appartenere a una sola cartella
Permessi
I permessi sono regole applicate a gruppi e utenti per discriminare l’accesso ai dispositivi remoti.
Ci sono due tipi di operazioni assoggettabili controllo:
“Administration”: un utente con questi permessi ha controllo completo sul dominio; può creare,
gestire o cancellare altri utenti, può modificare a piacimento la struttura dell’albero dei dispositivi,
compresa la registrazione di nuovi dispositivi.
“Remote Access”: questo livello permette all’utente di accedere al dispositivo remoto ed eseguire
l’assistenza attraverso gli strumenti interattivi e la connessione VPN.
Per esempio è possibile creare una cartella di nome “Italy” per il gruppo di utenti chiamato “External
technical” attribuendovi i diritti di “Remote Access”. In questo modo ogni utente parte del gruppo avrà
facoltà di accesso remoto a tutti i dispositivi contenuti all’interno della cartella “Italy”.
Per informazioni aggiuntive sulla gestione del dominio attraverso Contro Center si veda il capitolo
“Utilizzo del Dominio“.
Page 6 / 58

2 Control Center
Ubiquity Manuale Utente
Ubiquity Control Center è l’applicazione Windows da installarsi sul PC impiegato per l’assistenza; permette
la configurazione del sistema, la registrazione sul dominio dei sistemi remoti, la configurazione delle opzioni
di sicurezza per gruppi ed utenti. Il tutto fruibile attraverso un’interfaccia semplice e intuitiva.
2.1 Requisiti e installazione
Control Center supporta i seguenti Sistemi Operativi:
Windows XP
Windows Vista 32-bit and 64-bit
Windows 7 32-bit and 64-bit
Windows 8 32 bit and 64 bit
Windows Server 2008 and Server 2008 R2
La procedura di Setup di Control Center verificherà automaticamente la presenza del componente “.Net
Framework 4.0 Client Profile” e provvederà alla sua installazione se necessario.
La procedura di installazione installa i seguenti elementi:
software file
scheda di rete virtuale
porta seriale virtuale per l‘accesso ai dispositivi di automazione collegati alla porta seriale del
sistema remoto
La procedura di installazione prevede due modalità:
Complete
Custom
Page 7 / 58

Ubiquity Manuale Utente
Selezionando la modalità “Custom” si ha la possibilità di selezionare alcune opzioni per l’installazione della
porta seriale virtuale.
La versione V1.3 di Ubiquity Runtime introduce un supporto completamente rinnovato per la funzione di
porta seriale virtuale.
Page 8 / 58

Ubiquity Manuale Utente
Per mantenere la compatibilità con versioni precedenti del Runtime è possibile installare entrambi i supporti.
Nel caso in cui non sia necessario gestire sistemi con versioni Runtime precedenti la V1.3, è possibile
deselezionare il componente “Virtual Serial Port for Runtime 1.2 and older”.
Mantenere entrambi i componenti per garantire comunque sempre la compatibilità con le
precedenti versioni di Ubiquity Runtime.
Nel caso in cui sia installato il supporto per Runtime V1.2 e precedenti, la procedura di installazione chiederà
il numero della COM da assegnare alla porta virtuale.
Ubiquity Control Center V1.3 supporta la selezione del numero della porta virtuale momento
dell’attivazione del collegamento, rendendo quindi più semplice la configurazione e l’uso. Il
numero della porta potrà quindi essere cambiato in ogni momento.
Il numero della COM assegnato alla porta virtuale sarà quello da usarsi nell’applicazione che richiede
l’accesso da linea seriale. Il traffico generato verso la porta virtuale è automaticamente mappato da Ubiquity,
attraverso l’uso della VPN, sulla porta seriale fisica del dispositivo remoto.
Si veda nel seguito di questo manuale per altri dettagli sulla funzione.
L’adattatore di rete virtuale installato dalla procedura è chiamata “Ubiquity VPN” ed è visibile nella
configurazione delle schede di rete del Pannello di Controllo.
La gestione dell’indirizzo IP di questa scheda di rete è a carico di Ubiquity Control Center che in modo
automatico ne assegna il valore corretto per assicurare la compatibilità con la classe degli indirizzi dei
dispositivi remoti.
Page 9 / 58

2.2 Usare il Dominio
Ubiquity Manuale Utente
Questo capitolo descrive come creare un dominio, come aggiungere i dispositivi remoti e come organizzarlo
attraverso l’utilizzo di relazioni gerarchiche e l’applicazione di permessi a gruppi e utenti.
2.2.1 Creazione del Dominio
Il funzionamento di Ubiquity richiede la connessione a un dominio. Il primo passo nella messa in servizio è
proprio la creazione del dominio stesso.
Avviare l’applicazione Control Center, aprire la scheda “Network” e cliccare sul link “Create a new Domain”.
Cliccando sul link compare la maschera mostrata nella figura seguente dove è necessario introdurre i dati
anagrafici richiesti per la creazione e attivazione del dominio.
Page 10 / 58

Ubiquity Manuale Utente
Una volta compilata la scheda, cliccare sul tasto “Create Domain” ed attendere la risposta del server.
La creazione del dominio e il successivo utilizzo richiedono una connessione Internet
funzionante dal computer su cui è installato Control Center. Si veda il capitolo Connettività
per altre informazioni sui requisiti.
Page 11 / 58

Ubiquity Manuale Utente
Contestualmente alla creazione del dominio, viene automaticamente creato un utente “admin”; esso non può
essere rinominato ne cancellato ne possono essere rimossi i suoi diritti di accesso globale.
Questo previene condizioni anomale in cui per errore ci si possa trovare senza nessun utente con diritti di
amministrazione che sia in grado di gestire il dominio.
La password assegnata all’utente “admin” viene inviata all’indirizzo di posta elettronica specificato
nell’anagrafica.
E’ consigliato creare degli utenti aggiuntivi con permessi di amministrazione e lasciare l’utente l’uso
dell’utente “admin” ai casi eccezzionali.
2.2.2 Creazione degli utenti
Per creare un nuovo utente all’interno del dominio è necessario l’accesso da parte di un utente con diritti di
amministrazione.
E’ buona norma creare almeno un utente per l’utilizzo dei servizi di teleassistenza e lasciare
l’utente “admin” per le operazioni di gestione del dominio.
Cliccare sulla scheda “Users” per accedere alla lista degli utenti e dei gruppi.
Cliccare con il tasto destro del mouse sul nome del dominio e selezionare “Create user”.
Page 12 / 58

2.2.3 Cambio della password
Ciascun utente può cambiare la propria password in ogni momento.
Ubiquity Manuale Utente
Una volta connesso al dominio, l’utente che desidera cambiare la propria password dovrà cliccare sul link
“Change my password” che appare a fianco della casella “Password” nella schermata “Network”.
Gli utenti con diritti di amministratore possono creare e cambiare la password per tutti
gli altri utenti.
Page 13 / 58

Ubiquity Manuale Utente
Ogni nuovo utente creato ha una password a esso assegnata automaticamente dal sistema che corrisponde
al nome utente; si consiglia di cambiarla alla prima connessione.
L’utente con diritti di amministratore può cambiare la password degli altri utenti dalla schermata “Users”; per
cambiare la password, cliccare sul nome dell’utente e inserire la nuova password nella schermata che
compare a destra, come indicato nella figura seguente.
2.2.4 Creazione dei gruppi
I Gruppi sono collezioni di utenti; sono utili per organizzare e gestire l’assegnazione dei permessi agli utenti.
Per creare un gruppo è richiesto l’accesso al dominio da parte di un utente con diritti di amministrazione.
Dalla schermata “Users” cliccare quindi con il tasto destro del mouse sul nome del dominio e quindi scegliere
“Create Group” come indicato dalla figura seguente.
Page 14 / 58

2.2.5 Associazione degli utenti ai gruppi
Ciascun utente può essere associate ad uno o più gruppi.
L’associazione può avvenire in due modi.
Ubiquity Manuale Utente
1. Selezionare il gruppo nella lista di sinistra, premere il tasto "Add user", selezionare l’utente dalla lista
“Insert the new user” e confermare con OK come mostrato dalla figura seguente.
2. Trascinare l’icona dell’utente direttamente sul gruppo e rilasciare (drag&drop).
Page 15 / 58

2.2.6 Organizzazione del dominio
La vista ad albero del dominio può essere liberamente personalizzata.
In particolare si possono creare cartelle e sottocartelle secondo le più diverse necessità.
L’utilizzo delle cartelle facilita l’assegnazione dei diritti di accesso ai dispositivi remoti.
I permessi sono sempre assegnati alle cartelle e i dispositive in esse contenuti li
ereditano
Ubiquity Manuale Utente
Per creare una cartella è necessario l’accesso al dominio da parte di un utente con diritti di amministrazione.
Selezionare quindi la scheda “Devices” e cliccare con il tasto destro del mouse sul nome del dominio o sulla
cartella rispetto alla quale si desidera creare una sottocartella.
Page 16 / 58

Ubiquity Manuale Utente
Per rinominare una cartella selezionare la cartella, cliccare con il tasto destro del mouse e selezionare quindi
“Rename”; alternativamente è possibile usare il tasto preposto nell’area strumenti come indicato dalla figura
seguente.
E’ possibile creare un numero arbitrario di cartelle e sottocartelle.
Per inserire un dispositivo all’interno di una cartella, è sufficiente trascinare e rilasciare (drag&drop) l’icona in
corrispondenza della cartella.
Page 17 / 58

Ubiquity Manuale Utente
La lista viene automaticamente aggiornata dopo che il dispositivo è stato spostato all’interno della cartella di
destinazione.
2.2.7 Gestione dei permessi
Control Center permette di definire permessi per i gruppi; i gruppi sono assegnati alle cartelle e i dispositive
all’interno delle cartelle ereditano i permessi.
Le regole eventualmente assegnate alle sottocartelle hanno precedenza rispetto a quelle della cartella che le
contiene.
I permessi per un certo utente di un gruppo possono essere cambiati rispetto a quelli del gruppo a cui
appartiene (specifica di una eccezione per un certo utente).
I permessi sono sempre assegnati a livello di cartella. Nel caso in cui servisse creare
una regola per un singolo dispositivo, dovrà essere creata una cartella specifica per
esso.
Per assegnare un gruppo o un utente ad una cartella, aprire la scheda “Devices”, selezionare la cartella e
cliccare sul pulsante “Add” sul lato destro nell’area “Users and groups” come mostrato dalla figura seguente.
Page 18 / 58

Ubiquity Manuale Utente
Nell’esempio è stato assegnato il gruppo “Italy” alla cartella “Italy”. Questo implica che gli utenti appartenenti
al gruppo “Italy” avranno accesso ai dispositivi contenuti nella cartella “Italy” sulla base dei permessi
assegnati.
Vanno ora determinati quali permessi accordare al gruppo.
I permessi vengono assegnati selezionando prima la cartella e successivamente il gruppo o utente sul quale
si desidera operare, scegliendolo dalla lista sul lato destro, nell’area “Users and groups”.
Una volta scelto il gruppo o l’utente si opera nell’area “Permissions” utilizzando le check box.
Page 19 / 58

Ubiquity Manuale Utente
Nell’esempio sopra riportato il gruppo “Italy” ha il permesso di eseguire l’accesso remoto (gestione interattiva
e VPN).
Gli utenti del gruppo “Italy” ereditano i permessi e ottengono quindi la possibilità di eseguire assistenza sui
dispositivi contenuti nella cartella “Italy” (PC-0002) e sottocartelle (PC0001 in Reseller XYZ).
La colonna “Deny” permette di bloccare una certa azione per il gruppo o utente selezionato.
Selezionando ora la cartella “Reseller XYZ” è possibile verificare l’avvenuta propagazione dei permessi
assegnati, come mostrato dalla figura seguente.
Page 20 / 58

Ubiquity Manuale Utente
Nell’esempio, la cartella “Reseller XYZ” ha ereditato dalla cartella padre i permessi assegnati al gruppo
“Italy”.
Control Center supporta la specifica di eccezioni a livello utente. Questo è utile nel caso in cui si voglia
gestire in modo differente un utente rispetto allo standard del gruppo di appartenenza.
E’ possibile per esempio specificare una restrizione per l’utente “Peter” rispetto al suo gruppo di
appartenenza e relativa alla cartella “Reseller XYZ”.
Page 21 / 58

Ubiquity Manuale Utente
Come mostrato nella figura precedente questo permesso è negato in modo “esplicito”: non compare infatti a
fianco del nome utente la scritta “inherited”. La negazione è applicata marcando la checkbox “Deny” per
l’operazione di “Remote Access” una volta che l’utente Peter è selezionato nella lista “Users and Groups”.
Assumendo quindi che l’utente “Peter” appartenga al gruppo “Italy”, egli potrà accedere a tutti i dispositivi
all’interno della cartella “Italy”, ad eccezione di quelli all’interno della cartella “Reseller XYZ”.
Accedendo al sistema con l’utente “Peter” è possibile verificare che l’utente non ha neppure visibilità della
cartella alla quale egli non ha accesso.
Page 22 / 58

2.3 Gestione dei dispositivi remoti
Ubiquity Manuale Utente
Il capitolo descrive tutte le funzioni disponibili per la teleassistenza partendo dal modo con cui registrare un
dispositivo in un dominio.
Sono illustrati gli strumenti interattivi (desktop remoto, trasferimento file, chat, etc) e in seguito è spiegato
l’uso della connessione VPN.
2.3.1 Prima connessione e registrazione della licenza
Assumiamo in questo capitolo che il component Runtime di Ubiquity sia correttamente installato sul
dispositivo su cui si desidera fare assistenza remota.
Localizzare l’icona del servizio Ubiquity nell’area di notifica delle applicazioni, e fare doppio click.
Se nella finestra che compare viene mostrato un tasto “Connect”, premerlo ed attendere che lo stato cambi
in “Connected to the Ubiquity Network” come mostrato nella figura seguente.
Nel caso in cui il sistema non sia già stato registrato presso un dominio, la finestra mostrerà un ID ed una
password (si veda la figura precedente) che dovranno essere fornite a Control Center per eseguire la
registrazione del dispositivo su un dato dominio.
Eseguire ora il programma Control Center e accedere al dominio con un utente avente diritti di
amministrazione. A connessione avvenuta aprire la scheda “Devices” e cliccare su “Add new device to the
domain” visibile nella parte bassa della finestra come mostrato dalla figura seguente.
Page 23 / 58

Inserire quindi l’ID e la password e cliccare sul pulsante “Add”.
Il dispositivo verrà aggiunto al dominio.
Ubiquity Manuale Utente
Page 24 / 58

Ubiquity Manuale Utente
Control Center assegna automaticamente, a tutti i nuovi dispositivi, il nome ; per cambiare il
nome assegnato, selezionare il dispositivo, cliccare con il tasto destro del mouse e selezionare il comando
“Rename”. Alternativamente è possibile usare lo strumento “Rename” accessibile dalla barra degli strumenti.
Nel caso in cui Ubiquity Runtime non sia stato attivato è possibile eseguire l’operazione di registrazione della
licenza semplicemente cliccando sul link “Register” ed inserendo il codice di licenza come mostrato nella
figura seguente.
Il codice di licenza è stampato sull’etichetta “Ubiquity Runtime” normalmente apposta sul retro
dell’apparecchiatura o disponibile nel pacchetto di vendita del componente Runtime (installazione su sistemi
non ASEM o acquisto successivo).
Page 25 / 58

Ubiquity Manuale Utente
La registrazione del component Runtime può essere fatta anche direttamente dal
dispositivo utilizzando un commando dedicato; si veda per questo il capitolo
“Registrazione dispositivo e licenza”.
Una volta completata la registrazione e attivazione è possibile iniziare una sessione di assistenza remota
utilizzando I tasti “Remote Desktop” e “VPN” visibili sulla destra della finestra.
2.3.2 Connessione Seriale Remota
La procedura di installazione di Control Center installa sul computer una porta seriale virtuale necessaria per
la funzione di virtualizzazione del canale di comunicazione seriale (Serial Port Passthrough)
La porta seriale virtuale è mappata da Ubiquity, attraverso il canale VPN, sulla porta seriale fisica del
dispositivo remoto.
La connessione alla porta seriale del dispositivo remoto richiede l’attivazione della connessione VPN.
Una volta che la connessione VPN è attiva, cliccare sul pulsante “Serial Passthrough” sulla barra dei pulsanti
in alto per aprire la finestra di configurazione della porta seriale virtuale.
Sul lato sinistro è mostrata la porta seriale virtuale; il numero della porta va selezionato tra quelli disponibili
mostrati dal menù a discesa. Questo sarà il numero di porta seriale che dovrà essere configurato
sull’applicativo che utilizzerà il canale Passthrough.
Sul lato destro è mostrata la configurazione per la seriale fisica del dispositivo remoto; va selezionata qui la
porta seriale alla quale sono collegati i dispositivi che si desira raggiungere attraverso il canale di
passthrough.
Completata la scelta delle porte, cliccare su “Connect” ed attendere il messaggio di avvenuta connessione.
Da questo momento il tunnel tra le porte seriali è attivo e utilizzabile dagli applicativi.
Page 26 / 58

Le impostazioni standard sono normalmente corrette per la maggior parte dei casi.
Ubiquity Manuale Utente
La sezione “Advanced” dispone di controlli avanzati da utilizzarsi nel caso in cui si evidenziassero
problematiche di utilizzo del canale virtuale (per esempio timeout di connessione da parte dell’applicativo
che utilizza la seriale).
Ubiquity utilizza due tipologie di incapsulamento per il traffico seriale.
La prima modalità è studiata per gestire in modo automatico l’impostazione dei parametri di comunicazione
della porta seriale.
Utenti avanzati possono comunque utilizzare la modalità RAW che permette di impostare manualmente tutti i
parametri di comunicazione.
Ubiquity supporta il Passthrough seriale per connessioni sia di tipo half-duplex che ti
tipo full-duplex
Page 27 / 58

Ubiquity Manuale Utente
Alcuni protocolli di comunicazione che utilizzano interfacce di comunicazione seriali
sono molto sensibili ai tempi di latenza della connessione e potrebbero non funzionare
attraverso il canale virtuale anche con connessioni Internet di ottima qualità.
L’attivazione del canale virtuale per il passthrough è condizionata alla “disponibilità” della porta seriale fisica
sul dispositivo remoto; essa non deve pertanto essere in uso da parte di alcun applicativo.
Le applicazioni che ne fanno eventualmente uso dovranno essere chiuse prima di attivare la connessione da
Control Center.
2.3.3 Remote Desktop
Remote Desktop è una funzione di Ubiquity Control Centrer che permette di visualizzare lo schermo del
dispositivo remoto ed interagire con esso attraverso l’uso di mouse e tastiera.
Per attivare una sessione di Remote Desktop è sufficiente selezionare il dispositivo dall’albero e cliccare sul
tasto “Remote Desktop” nella parte destra della finestra.
Alternativamente è anche possibile fare un doppio click sull’icona del dispositivo direttamente dalla vista ad
albero.
Il tasto “Take screenshot” accessibile dalla barra in alto permette di eseguire la cattura dello schermo
visualizzato su una immagine salvata su file.
La qualità della rappresentazione grafica è configurabile attraverso il menù a tendina preposto. Le opzioni
disponibili sono le seguenti:
Page 28 / 58

Ubiquity Manuale Utente
Hi color lossless: 65K colori, alta qualità senza compressione, il rinfresco dello schermo potrebbe
risultare lento.
Hi color lossy: 65K color, alta qualità, compressione JPEG; ottima velocità anche in presenza di
immagini complesse con molti colori, ha qualità inferiore per I testi
Low color lossless: 256 colori, bassa qualità con compressione; è la modalità che garantisce
velocità più elevate ma anche qualità dell’immagine più bassa.
Il comando “Keyboard/mouse lock” permette di bloccare i dispositivi di input eventualmente disponibili sul
dispositivo remoto.
Il comando “Fit to window / Original size” modifica il modo di ridimensionamento della visualizzazione del
desktop remoto.
Il comando “Ctrl+Alt+Del” permette di inviare al dispositivo remoto la combinazione di tasti “Ctrl+Alt+Del”
2.3.4 Trasferimento file
La funzione di trasferimento file permette di copiare file da e per il dispositivo remoto attraverso una
interfaccia simile a Windows Explorer con una visualizzazione a pannelli.
Per attivare la funzione, connettere Control Center e cliccare sul tasto “Remote Explorer”.
Verrà aperta una finestra con due pannelli: a sinistra si trova il PC locale, alla destra la vista del dispositivo
remoto.
Page 29 / 58

Ubiquity Manuale Utente
Per eseguire un trasferimento, selezionare il file dal panello sorgente e cliccare sul tasto “Send” o “Receive”
a seconda della direzione richiesta.
Per rinominare un file, selezionare il file e cliccare con il tasto destro del mouse; selezionare il comando
“Rename” e digitare il nuovo nome.
Dal pannello di destra (dispositivo remoto) è possibile lanciare l’esecuzione di un applicativo che verrà quindi
eseguito sul dispositivo stesso. Per eseguire il programma, selezionare il file eseguibile, cliccare con il tasto
destro del mouse e selezionare il comando “Execute remotely”.
Page 30 / 58

2.3.5 Remote Task Manager
Ubiquity Manuale Utente
Control Center dispone di una funzione che permette di mostrare l’elenco dei processi in esecuzione sul
dispositivo remoto.
Una volta anche Control Center è connesso al dispositivo, cliccare su “remote Task Manager” per
visualizzare la lista dei processi in esecuzione sul dispositivo remoto; la lista mostra il nome del processo, il
suo ID, l’impegno di CPU e di memoria.
Cliccando sul nome di un processo con il tasto destro del mouse è possibile selezionare il commando “Kill”
per terminare sua esecuzione.
Page 31 / 58

2.3.6 System Information
Ubiquity Manuale Utente
Il tasto “System information” mostra una visualizzazione di alcune caratteristiche del sistema remoto, come il
sistema operativo, la configurazione della rete, il processore, etc…
Page 32 / 58

2.3.7 Chat
Ubiquity Manuale Utente
La funzione “Chat” permette di scambiare messaggi scritti con un eventuale operatore posizionato di fronte
al dispositivo remoto.
La funzione è attivabile dal tasto “Chat” sulla barra in alto; compare sulla destra una colonna e una casella di
input in cui digitare i messaggi che, una volta inviati con pressione del tasto Enter, appaiono sullo schermo
del dispositivo remoto.
Page 33 / 58

2.3.8 Virtual Private Network (VPN)
Ubiquity Manuale Utente
La procedura di installazione di Ubiquity Control Center e Ubiquity Runtime installa sui dispositivi un
adattatore di rete virtuale che viene utilizzato per la connessione VPN.
Cliccare sul tasto “VPN” per aprire la schermata con lo schema della connessione di rete.
La figura seguente mostra un esempio di configurazione in cui ci sono dei dispositivi collegati alla sottorete
Ethernet del dispositivo remoto.
Il tasto “Connect/Disconnect” visibile in centro serve per attivare e disattivare la connessione VPN.
La schermata nella figura precedente mostra tre elementi:
Sul lato sinistro è rappresentato il computer dal quale si opera l’assistenza; su questo computer è
installato Control Center; viene mostrato il suo nome ed il suo indirizzo IP (la figura mostra un caso
in cui gli IP sono multipli)
Nella parte centrale è rappresentato il dispositivo remoto al quale si è collegati; è indicato il nome e
la lista dei suoi indirizzi IP privati
Sul lato destro è mostrata una rappresentazione grafica simbolica di quella che può essere la
sottorete dei dispositivi Ethernet ai quali si potrà accedere attraverso la connessione VPN;
nell’esempio la classe degli IP è la 10.20.x.x
Page 34 / 58

Gli indirizzi IP che coinvolgono la connessione VPN sono evidenziati in grassetto.
Ubiquity Manuale Utente
Nell’esempio l’indirizzo IP 10.20.0.179 è automaticamente assegnato da Control Center alla scheda di rete
Virtuale Ubiquity VPN. Questo IP è stato scelto da Control Center in modo da essere compatibile con la
sottorete remota 10.20.0.0. / 255.255.255.0.
L’indirizzo IP dell’adattatore Ubiquity VPN, sul computer dove è installato Control Center, è assegnato in
modo automatico in conformità a un’informazione proveniente dal Runtime; Ubiquity Runtime, sul dispositivo
remoto, ipotizza quale può essere un indirizzo IP libero nella sottorete di automazione, esegue un PING
sull’indirizzo ipotizzato e in caso non vi sia risposta esso viene considerate libero; l’informazione è quindi
passata a Control Center che lo usa per l’adattatore Ubiquity VPN.
Questo comportamento può essere cambiato cliccando su “IP Configuration” dalla schermata VPN come
mostrato nella figura seguente.
Le scelte disponibili sono l’assegnazione automatica oppure manuale.
Dal computer dove Control Center ha attivato la connessione VPN, qualsiasi applicazione è ora in grado di
raggiungere il dispositivo remoto e tutti i dispositivi collegati alla medesima sottorete.
Lo stato della connessione è verificabile attraverso l’uso del comando “ipconfig” da prompt di comandi.
Page 35 / 58

L’indirizzo 10.20.0.30 risponde correttamente al ping.
2.3.9 Scenari di connettività VPN
Ubiquity Manuale Utente
Ubiquity utilizza una connessione VPN posizionata al livello data-link 2, equivalente pertanto ad un cavo
Ethernet che virtualmente collega il computer con Control Center alla rete dei dispositivi remoti.
Il protocollo Ubiquity è un grado di assegnare in modo automatico un IP statico all’adattatore virtuale
“Ubiquity VPN” in modo che attraverso esso si possa raggiungere il dispositivo remoto e avere visibilità della
sottorete della medesima classe.
Importante notare che non è necessario definire alcuna regola statica di routing; le applicazioni in
esecuzione sul computer dove è installato Contro Center possono semplicemente connettersi all’IP fisico dei
dispositivi remoti con cui devono comunicare.
Sono supportate le seguenti tipologie di connessioni VPN:
Connessione VPN ristretta al solo dispositivo remoto che ospita Ubiquity Runtime
Connessione VPN all’intera sottorete remota con due adattatori di rete
Connessione VPN all’intera sottorete remota con un solo adattatore di rete
Page 36 / 58

Ubiquity Manuale Utente
Connessione VPN ristretta al dispositivo remoto che ospita Ubiquity Runtime attraverso, con uso di
indirizzi IP fisici e non virtuali.
Si veda il capitolo Configurazione della VPN per informazioni aggiuntive a proposito di come configurare la
VPN sul dispositivo remoto che ospita Ubiquity Runtime.
2.3.9.1 Connessione VPN ristretta al dispositivo remoto
In questo scenario il dispositivo remoto e il computer con Control Center acquisiscono un indirizzo IP di rete
virtuale (es 10.8.0.0/255.255.0.0) attraverso il quale possono poi comunicare tra di loro.
Nessuno dei dispositivi nella sottorete remota è raggiungibile dal computer dove è in esecuzione Control
Center.
Questo scenario è compatibile con i modelli di licenza BASIC e PRO.
2.3.9.2 Connessione VPN estesa all’intera sottorete remota con 2 interfacce Ethernet
Questo è lo scenario ideale raccomandato per tutte le situazioni in cui è richiesta la visibilità completa della
sottorete di dispositivi collegati al sistema remoto.
In questo caso il dispositivo remoto ha due interfacce Ethernet fisiche distinte.
Page 37 / 58

Ubiquity Manuale Utente
La prima viene convenzionalmente indicata come WAN ad intendere che è dedicata all’accesso alla rete
Internet; essa viene configurata dal personale di IT dell’azienda ospite in modo da garantire i requisiti minimi
di connettività per Ubiquity Runtime. Si veda il capitolo Connettività per informazioni aggiuntive sui requisiti.
La seconda interfaccia è denominata LAN ad intendere che essa è dedicata alla connessione alla rete locale
di automazione. Questa è normalmente configurata con un indirizzo IP statico e non prevede gateway.
Il computer con Control Center può quindi accedere ai dispositive remoti connessi alla sottorete LAN
(10.20.0.0 nell’esempio seguente).
Questo scenario è compatibile con il modello di licenza PRO.
2.3.9.3 Connessione VPN estesa all’intera sottorete con una interfaccia Ethernet
In questo scenario il dispositivo remoto ha una sola interfaccia di rete che viene utilizzata
contemporaneamente per l’accesso ad Internet e per la connessione alla sottorete di automazione.
Ubiquity può essere configurato per avere accesso completo a tutta la sottorete remota senza alcuna
separazione fisica tra LAN e WAN.
E’ inoltre possibile configurare Ubiquity Runtime in modo che possa utilizzare due classi di indirizzi diversi,
per l’accesso ad internet e per l’accesso alla reta LAN, pur con una sola interfaccia Ethernet.
Page 38 / 58

Ubiquity Manuale Utente
Il comportamento sarà quindi analogo a quello descritto nel punto precedente, ottenendo pertanto una
separazione logica degli indirizzi pur senza separazione fisica tra le reti.
Si veda il capitolo Configurazione della VPN per le istruzioni su come configurare la VPN sul dispositivo
remoto.
Questo scenario è compatibile con il modello di licenza PRO.
2.3.9.4 Connessione VPN ristretta al dispositivo remoto con uso di indirizzo IP fisico
Questo scenario corrisponde ad una variante della connessione VPN ristretta al dispositivo remoto, e
permette l’uso di indirizzi IP fisici invece che virtuali.
Questa configurazione è conveniente quando l’applicazione in esecuzione sul dispositivo remoto espone
servizi server associati unicamente a indirizzi IP fisici e non disponibili per indirizzi virtuali.
La configurazione è analoga a quella vista nel caso in cui sia richiesta visibilità dell’intera sottorete; Control
Center accede alla rete LAN attraverso l’uso dell’indirizzo IP fisico, mentre Ubiquity Runtime si preoccupa di
limitare il traffico al solo dispositivo remoto nel caso di licenza di tipo BASIC.
Questo scenario è compatibile con i modelli di licenza BASIC e PRO.
Page 39 / 58

3 Runtime
Ubiquity Manuale Utente
Ubiquity Runtime è il component software installato sul dispositivo remoto al quale si desidera connettersi.
Ubiquity Runtime è disponibile per dispositivi HMI classici basati su sistemi Windows CE, ma anche per le
piattaforme Windows (XP, Vista, Windows 7, Windows Server 2008 and Windows 8).
3.1 Runtime per piattaforme Windows CE
Ubiquity Runtime per Windows CE richiede il componente .NET Compact Framework 3.5 o maggiore.
L’installazione del compact framework è disponibile per il download dal sito Microsoft al seguente indirizzo:
http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=65
Scaricare quindi il file NETCFSetupv35.msi e procedere all’installazione su un computer dotato si sistema
operativo Windows.
La procedura di installazione mette a disposizione i seguenti file::
C:\Program Files (x86)\Microsoft.NET\SDK\CompactFramework\v3.5\WindowsCE\NETCFv35.wce.x86.cab
C:\Program Files
(x86)\Microsoft.NET\SDK\CompactFramework\v3.5\WindowsCE\NETCFv35.wce.armv4.cab
Il primo file è da usarsi con piattaforme x86, il secondo vale per i sistemi basati su ARM.
Una volta installato il framework .NET Compact è possibile procedure con l’installazione del Runtime di
Ubiquity.
I file per l’installazione del Runtime di Ubiquity sono disponibili per il download dal sito web ASEM al
seguente indirizzo:
http://www.asem.it/prodotti/industrial-automation/teleassistenza/ubiquity/downloads/
Per installare o aggiornare Ubiquity Runtime procedure come segue:
Copiare il file “.CAB” all’interno di una cartella sul dispositivo utilizzando per esempio una memory
stick USB.
Terminare l’esecuzione di Ubiquity Runtime sul dispositivo (nel caso in cui sia in esecuzione una
precedente versione).
Fare doppio click sul file “.CAB” appena copiato, confermare la posizione standard proposta per
l’installazione (sistemi di produzione ASEM), identificare altrimenti la posizione idonea e confermare.
Completata l’installazione, lanciare il file “UbuityRuntime.exe” che si trova nella cartella in cui il software è
stato installato.
3.2 Runtime per piattaforme Win32
Ubiquity Runtime per piattaforme Win32 richiede il componente .NET Framework 2.0 o maggiore.
Nel caso in cui esso non sia presente sul dispositivo, sarà automaticamente installato dalla procedura di
installazione.
L’installazione di Ubiquity Runtime è disponibile per il download dal sito web di ASEM al seguente indirizzo:
http://www.asem.it/prodotti/industrial-automation/teleassistenza/ubiquity/downloads/
Scaricare il componente Runtime per piattaforma x86 e lanciare quindi l’installazione.
Page 40 / 58

L’installazione non richiede decisioni particolari da parte dell’utente.
Al termine dell’installazione riavviare il computer.
Ubiquity Manuale Utente
Al prossimo avvio l’icona di Ubiquity Runtime apparirà nell’area notifiche delle applicazioni: .
Cliccare sull’icona per aprire il pannello di controllo di Ubiquity Runtime.
Premere il pulsante “Connect” per avviare la connessione con il server.
Si veda il capitolo Connettività per i requisitimi minimi di connettività richiesti.
Nel caso in cui il dispositivo non sia ancora registrato su un dominio, il pannello di controllo mostrerà
l’indicazione dell’ID e della password necessarie per la registrazione.
Page 41 / 58

Ubiquity Manuale Utente
Da questo punto in avanti è possibile seguire i passi per la registrazione sul domino già indicate nel capitolo
“Prima connessione e registrazione della licenza“.
3.3 Registrazione dispositivo e licenza
Per registrar un dispositivo remoto all’interno di un dominio UIbiquity ed associare la relative licenza
(attivazione del Runtime) seguire le istruzioni indicate nel capitolo “Prima connessione e registrazione della
licenza“.
Si ricorda che Ubiquity Runtime può essere attivato da Control Center, ma anche direttamente
dall’interfaccia di controllo del Runtime come mostrato dalla figura seguente.
Page 42 / 58

Ubiquity Manuale Utente
L’utilizzo dell’attivazione off-line è dedicato alle procedure interne di produzione ASEM
e non dovrebbe essere usata dall’utente finale.
3.4 Configurazione della VPN
Ubiquity Runtime incorpora il server VPN adibito all’accettazione delle connessioni da parte di Control
Center.
La tecnologia VPN di Ubiquity è stata sviluppata al livello 2 (data-link) e una volta istanziata non richiede la
definizione di regole di instradamento aggiuntive. Inoltre, i dispositivi remoti NON devono cambiare la
configurazione del loro parametro “gateway” per garantire l’accessibilità. Il tutto è gestito in modo
trasparente.
La connessione VPN provvede alla realizzazione di un link tra due adattatori di rete virtuali, uno installato sul
computer Control Center, il secondo installato sul dispositivo che ospita Runtime.
Nei sistemi Win32 l’interfaccia di rete virtuale è chiamata “Ubiquity VPN” come mostrato nella figura
seguente.
Nei sistemi operative Windows CE l’interfaccia di rete virtuale è chiamata “UEA1” (Ubiquity Ethernet
Adapter).
Nei sistemi Windows CE l’interfaccia di rete virtuale non è installata in modo automatico dalla procedura di
installazione del Runtime; sarà pertanto necessario eseguire l’installazione manuale.
Page 43 / 58

Ubiquity Manuale Utente
Per installare l’interfaccia aprire la schermata delle impostazioni di Ubiquity Runtime (icona con
l’ingranaggio. )
I sistemi ASEM HMI30 sono prodotti con Ubiquity Runtime già installato e configurato
(interfaccia di rete e bridge) e non richiedono nessuna operazione aggiuntiva.
Cliccare quindi sul tasto per l’installazione e attendere alcuni secondi; al termine il sistema ritorna un
messaggio di avvenuta installazione e richiesta di riavvio.
Ubiquity supporta due diverse topologie di connessione VPN:
Connessione VPN ristretta al solo dispositivo remoto
Connessione VPN estesa all’intera sottorete
Nel primo scenario le interfacce virtuali di Control Center e Runtime sono messe in comunicazione
attraverso la connessione VPN e la comunicazione resa possibile dall’impiego di IP compatibili con le
sottoreti da raggiungere.
La seconda topologia è implementata attraverso l’utilizzo di connessioni in bridge tra l’interfaccia virtuale
Ubiquity VPN e l’interfaccia fisica rispetto alla quale si desidera attivare la connessione VPN.
L’accesso alla sottorete Ethernet richiede che il sistema operativo su cui è installato
Ubiquity Runtime abbia la capacità di creare un bridge tra due interfacce di rete.
Il bridge tra le schede di rete è configurabile anche attraverso l’uso del pannello di controllo di Ubiquity
Runtime.
I capitoli seguenti mostrano come configurare la connessione VPN nei vari scenari possibili di utilizzo:
1. Connessione VPN ristretta al solo dispositivo remoto
2. Connessione VPN estesa all’intera sottorete con due interfacce di rete
3. Connessione VPN estesa all’intera sottorete con una interfaccia di rete
4. Connessione VPN ristretta al solo dispositivo remoto con utilizzo di indirizzi IP fisici
3.4.1 Connessione VPN ristretta al solo dispositivo remoto
In questo scenario si crea una VPN punto-punto tra Control Center e il Runtime remoto. La connessione
VPN utilizza le interfacce Ethernet virtuali di Ubiquity, ciascuna di esse configurata su indirizzi IP virtuali e
differenti dalle rispettive interfacce di rete fisiche.
Page 44 / 58

Ubiquity Manuale Utente
Nell'esempio, il PC remoto è connesso sia alla rete aziendale (172.17.16.0) sia alla rete di automazione
(10.20.0.0), tuttavia, tramite teleassistenza, si vuole concedere l'accesso al solo PC remoto e non al resto
della sottorete del.
Quando Control Center si collegherà da remoto, esso potrà comunicare con il device remoto utilizzando l'IP
virtuale 10.8.0.1. Le altre classi di IP (es. 10.20.0.0) non saranno raggiungibili.
All’installazione di Ubiquity Runtime, la scheda di rete virtuale ("Ubiquity VPN", oppure "UEA1" sotto
Windows CE) viene automaticamente configurata per operare con indirizzo IP 10.8.0.1 e assegnare ai
computer con Control Center IP 10.8.0.2 o superiori.
Se si desidera utilizzare un IP differente, basta configurare l'IP nelle proprietà TCP/IP del pannello di
controllo dei dispositivi di rete di Windows.
Notare che la connessione VPN è installata utilizzando degli indirizzi IP virtuali; la classe 10.8.0.0 non
corrisponde infatti a nessun indirizzo IP reale di nessuna interfaccia di rete fisica.
Esistono alcuni rari casi in cui questa configurazione non è supportata dall’applicazione che richiede di
connettersi al servizio di tipo “server” esposto dal dispositivo remoto. Il caso è risolto dal quarto tipo di
connessione e per questo si veda il capitolo “Connessione VPN ristretta al solo dispositivo remoto con uso di
indirizzi IP fisici”
3.4.2 Connessione VPN estesa all’intera sottorete con due interfacce di rete
In questo scenario si configura Ubiquity Runtime per funzionare come "switch virtuale" e dare accesso a
Control Center all'intera sottorete collegata.
In questo scenario il dispositivo con Ubiquity Runtime è dotato di 2 interfacce di rete:
L'interfaccia denominata "WAN" (rossa), configurata ad esempio per ricevere l'IP dal server DHCP,
serve a fornire connettività Internet.
L'interfaccia denominata "LAN" (blu) è utilizzata per collegare il dispositivo ai dispositivi Ethernet di
automazione.
Nel momento della connessione VPN, all’interfaccia "Ubiquity VPN" di Control Center viene assegnato un IP
compatibile con la rete 10.20.0.0. In tal modo è possibile per il computer con Control Center accedere all'IP
del Runtime (10.20.0.10) e a tutti gli IP della stessa classe.
Per configurare l'accesso a tutta la sottorete "LAN" occorre creare un bridge di rete (cerchio giallo) tra
l'interfaccia "LAN" e l'interfaccia "Ubiquity VPN"
Per creare il bridge di rete, aprire il pannello di configurazione di Ubiquity Runtime, cliccare sul pulsante delle
opzioni (icona con l'ingranaggio ) e quindi su "VPN".
Page 45 / 58

Apparirà la lista delle interfacce di rete disponibili.
Ubiquity Manuale Utente
Occorre selezionare l'interfaccia che si vuole rendere disponibile da remoto (nell'esempio l'interfaccia "LAN")
e cliccare "Create bridge".
Questa è la situazione dopo la creazione del bridge:
Page 46 / 58

Il Bridge appare come una nuova interfaccia che include le altre due.
Ubiquity Manuale Utente
La configurazione dell'IP va fatta sul Bridge stesso, mentre le altre interfacce non saranno più singolarmente
configurabili.
Ubiquity configura automaticamente IP, gateway e DNS del bridge esattamente come era configurata
l'interfaccia selezionata per creare il bridge.
Le figure di cui sopra sono valide per il sistema operativo Windows XP; simili
condizioni sono valide anche per I sistemi Windows CE dove è possibile usare
direttamente il pannello di controllo di Ubiquity per l’installazione dell’interfaccia e
creazione del bridge.
Se è necessario modificare l'indirizzo IP (es. da 10.20.0.10 a 10.20.0.11), occorre aprire le proprietà TCP/IP
della connessione "Network bridge", non dell'interfaccia selezionata per creare il bridge.
3.4.3 Connessione VPN estesa all’intera sottorete con una interfaccia di rete
Questo scenario di collegamento prevede di utilizzare un device con Ubiquity Runtime dotato di una sola
Ethernet. Tramite Ubiquity si vuole accedere in VPN non solo al PC, ma anche a tutta la sottorete in cui
risiedono PLC e altri componenti di automazione.
Sono possibili due scenari:
a. Gestione di due sotto-reti di IP (la sotto-rete dotata di accesso Internet (WAN) e la sotto-rete di
automazione (LAN)
Page 47 / 58

. Gestione di una unica sottorete
A. VPN con due sottoreti (separazione spazio IP)
Ubiquity Manuale Utente
Nell'esempio l'unica interfaccia Ethernet fisica è quella evidenziata in blu. Viene creato quindi un bridge di
rete (giallo) che collega la scheda virtuale con quella fisica in un'unica interfaccia.
Al bridge risultante si assegnano 2 indirizzi IP:
uno compatibile con la rete finale e con accesso internet (172.17.60.50)
l'altro appartenente alla sottorete di IP di automazione (10.20.0.10).
Quando Control Center si collegherà da remoto, Runtime gli assegnerà un IP compatibile con la rete di
automazione (10.20.0.x), in questo esempio 10.20.0.180.
Control Center potrà ora comunicare in modo totalmente trasparente (con applicazioni TCP, UDP, ecc.) non
solo con il device remoto (10.20.0.10) ma anche con i dispositivi collegati, ad esempio il PLC (10.20.0.1).
Per creare il bridge di rete, aprire il pannello di configurazione di Ubiquity Runtime, cliccare sul pulsante delle
opzioni (icona con l'ingranaggio ) e quindi su "VPN".
Page 48 / 58

Ubiquity Manuale Utente
Dovrebbe essere elencata l'unica interfaccia fisica sul device; con quella interfaccia selezionata, cliccare
"Create bridge".
Questa è la situazione dopo la creazione del bridge:
Page 49 / 58

Ubiquity Manuale Utente
A questo punto occorre configurare gli IP del Network Bridge in modo che includa sia l'IP WAN 172.17.16.50
che IP LAN 10.20.0.10.
Configurazione IP del bridge sotto Windows XP e Windows 7
Aprire le proprietà TCP/IP del Network Bridge e assegnare il primo IP, comprese le informazioni sul
gateway e DNS, come in figura:
Page 50 / 58

Ubiquity Manuale Utente
Premere quindi il pulsante "Advanced"/"Avanzate", e quindi il pulsante "Add..."/"Aggiungi..." in alto a
sinistra per inserire l'IP compatibile con la rete di automazione.
Page 51 / 58

Configurazione IP del bridge sotto Windows CE
Ubiquity Manuale Utente
WindowsCE non supporta di default la gestione di IP multipli. Nella schermata di configurazione delle
interfacce di rete è infatti possibile configurare un solo IP.
Per sopperire a questa mancanza Ubiquity Runtime mette a disposizione un pannello di configurazione degli
indirizzi IP.
Aprire il pannello di configurazione di Ubiquity Runtime, cliccare sul pulsante delle opzioni (icona con
l'ingranaggio) e quindi su "IP".
Page 52 / 58

Ubiquity Manuale Utente
Selezionare in alto l'interfaccia "MBRIDGE1".
Inserire quindi i campi "IP" e "Mask" e poi cliccare "Add". Ripetere per il secondo IP.
Inserire gateway e DNS e premere quindi "Apply". Riavviare affinché le modifiche abbiano effetto.
Assegnando IP multipli come descritto, non è possibile utilizzare la modalità di assegnamento automatica
con DHCP.
E' necessario quindi richiedere un IP, gateway e DNS dall'amministratore di sistema. In alternativa è
possibile assegnare un unico IP tramite DHCP, registrare l'IP, il gateway e il DNS forniti e poi reinserirli
manualmente nella configurazione IP.
B. Configurazione VPN con una sottorete IP
Questo caso è una semplificazione precedente. Viene creato un bridge di rete tra la scheda Ethernet virtuale
e quella fisica.
Il bridge risultante è configurato per ricevere un indirizzo dinamico via DHCP oppure in modo statico con
tutte le informazioni che servono a dare al PC connettività Internet (indirizzo IP, gateway e DNS server).
Poiché il PC remoto è dotato di un unico indirizzo IP, esso può comunicare solamente con indirizzi IP della
sua classe (nell'esempio 172.17.16.x).
Page 53 / 58

Ubiquity Manuale Utente
3.4.4 Connessione VPN ristretta al dispositivo remoto con indirizzi IP fisici
Questo scenario corrisponde ad una variante della connessione VPN ristretta al dispositivo remoto, e
permette l’uso di indirizzi IP fisici invece che virtuali.
Questa configurazione è conveniente quando l’applicazione in esecuzione sul dispositivo remoto espone
servizi server associati unicamente a indirizzi IP fisici e non disponibili per indirizzi virtuali.
La configurazione è analoga a quella vista nel caso in cui sia richiesta visibilità dell’intera sottorete; Control
Center accede alla rete LAN attraverso l’uso dell’indirizzo IP fisico, mentre Ubiquity Runtime si preoccupa di
limitare il traffico al solo dispositivo remoto nel caso di licenza di tipo BASIC.
Questo scenario è compatibile con i modelli di licenza BASIC e PRO.
Page 54 / 58

3.5 Controllo Runtime da riga di comando
Ubiquity Manuale Utente
Sono disponibili alcuni parametri con cui eseguire Runtime.exe per controllare le operazioni di
teleassistenza. Ad esempio, è possibile assegnare tali comandi ad azioni provenienti da un applicativo HMI,
in modo da rendere la presenza del Runtime completamente trasparente.
-connect
-disconnect
-noui
-quit
Esempi:
Connette Runtime al servizio di teleassistenza, rendendolo visibile al
Control Center. Si usa questa opzione quando Runtime è già in
esecuzione ma è scollegato, poiché di default Runtime si collega
automaticamente, a meno che non venga specificata l'opzione -
disconnect.
Se Runtime è già in esecuzione, disconnette Runtime dal servizio di
teleassistenza, rendendolo inaccessibile al Control Center. Runtime
rimane in esecuzione.
Se Runtime non è in esecuzione, lo avvia ma non lo connette al servizio di
teleassistenza.
Utilizzato solo durante il primo avvio di Runtime. Non crea l'icona nell'area
di notifica della barra delle applicazioni e non rende accessibile la finestra
del Runtime in alcun modo.
Utilizzato solo con Runtime già in esecuzione. Disconnette e chiude
Runtime
Runtime -disconnect -noui
Esegue Runtime, che inizialmente rimarrà disconnesso dal server. Runtime sarà inoltre eseguito in modalità
invisibile, senza icona e pannelli di configurazione.
Runtime -connect
Connette Runtime al servizio di teleassistenza.
Runtime -disconnect
Disconnette runtime dal servizio di teleassistenza.
Runtime –quit
Chiude definitivamente Runtime.
3.6 Funzionamento Remote Desktop su sistemi Windows CE
La funzione di desktop remoto di Ubiquity Runtime per Windows CE è configurata per utilizzare al massimo il
40% delle risorse di CPU con un thread a priorità normale.
In condizioni particolari in cui il sistema Windows CE ha poche risorse di CPU da condividere con altri
processi, è possibile configurare diversamente la funzione di desktop remoto utilizzando due parametri che
impostano la percentuale massima di CPU da utilizzare e la priorità da assegnare al thread.
I parametri sono contenuti nel file “config.xml” presente nella cartella di Ubiquity Runtime.
Per modificarli, occorre prima chiudere il processo di Ubiquity Runtime ed editare quindi il file “config.xml”
aggiungendo o modificando le seguenti righe:
Page 55 / 58

dove occorre inserire i seguenti valori al posto di x:
0 – Priorità critica
1 – Priorità alta
2 – Priorità sopra il normale
3 – Priorità normale (default)
4 – Priorità sotto il normale
5 – Priorità bassa
6 – Priorità sopra il livello “idle”
7 – Priorità “idle”
Ubiquity Manuale Utente
e un numero da 1 a 100 al posto di y (il default è 40), per indicare la percentuale massima di CPU da
utilizzare per il thread che gestisce la funzione desktop remoto.
3.7 Esecuzione senza shell Explorer
Nel caso in cui Ubiquity Runtime sia eseguito senza la shell Explorer, l’icona di Ubiquity Runtime nell’area di
notifica delle applicazioni non verrà mostrata.
Per accedere all’interfaccia di programmazione di Ubiquity Runtime (o pannello di controllo) è sufficiente
lanciare nuovamente l’eseguibile “UbiquityRuntime.exe”
Dal momento che Runtime è già in esecuzione, non verrà lanciata una seconda istanza ma semplicemente
attivata l’interfaccia di programmazione.
Page 56 / 58

4 FAQ
Ubiquity Manuale Utente
Questo capitolo raccoglie alcune delle domande più frequenti relative al funzionamento di Ubiquity.
Siamo comunque a Vostra disposizione per qualsiasi dubbio all’indirizzo di posta elettronica del supporto
tecnico: supportsw@asem.it
4.1 Come viene identificato il dispositivo in modo univoco?
Dopo la prima connessione al server, Ubiquity Runtime crea e memorizza l’identità del dispositivo su un file
chiamato “auth.bin”.
Nei sistemi WindowsCE il file si trova nella medesiam cartella del Runtime.
Nei sistemi Windows XP il file si trova in:
"C:\Documents and Settings\All Users\ Application Data\ASEM\Ubiquity\Runtime\"
Nei sistemi Windows 7il file si trova in:
“C:\ProgramData\ASEM\Ubiquity\Runtime”
Non è possibile trasferire il file identità da un PC ad un altro copiando il file auth.bin, ma è possibile fare un
backup del file e ricopiarlo in seguito a disinstallazione e reinstallazione del Runtime o del sistema operativo.
L'unico caso in cui non è possibile effettuare un restore del file di identità è quando viene sostituito il disco,
poiché il PC verrà riconosciuto come una macchina diversa.
4.2 Come viene stabilita la connessione tra Control Center e Runtime?
La logica di collegamento tra Control Center e Runtime avviene con queste regole:
Control Center si connette all’infrastruttura di rete Ubiquity e ottiene l'elenco dei dispositivi registrati
al proprio dominio, per i quali dispone dei permessi di accesso.
Runtime si connette al all’infrastruttura di rete Ubiquity. Questo accade quando si clicca il pulsante
"Connect" sul pannello del Runtime.
Control Center viene notificato all’infrastruttura di rete che quel particolare Runtime è disponibile alla
connessione. L'icona del Runtime è evidenziata in verde.
Control Center può quindi decidere di collegarsi in qualsiasi momento, con desktop remoto oppure
con VPN.
Quando Control Center chiude la connessione al device, esso rimane comunque disponibile ad altre
connessioni finché qualcuno clicca "Disconnect" sul pannello di Ubiquity Runtime.
Se un Runtime è disponibile al collegamento ed esso viene riavviato, la disponibilità dopo riavvio è
regolata dall'opzione mostrata in figura:
Page 57 / 58

4.3 Collegamento locale
Ubiquity Manuale Utente
Ubiquity riconosce automaticamente la topologia di collegamento in cui Control Center si trova sulla stessa
LAN del Runtime.
Anche in questo caso Ubiquity si pone in modalità Internet, evitando la connessione diretta tra Control
Center e Runtime e simulando quindi le prestazioni ottenibili da un collegamento reale.
Page 58 / 58