Differenze tra le versioni di "AdminGuide:Service:HighAvailability/en"

Da Kalliope Wiki.
Jump to navigation Jump to search
(Creata pagina con "==Description==")
 
(Creata pagina con "Return to AdminGuide:Service")
 
(Una versione intermedia di uno stesso utente non è mostrata)
Riga 1: Riga 1:
<languages />
<languages />
<div lang="it" dir="ltr" class="mw-content-ltr">
Return to [[AdminGuide:Service/en|AdminGuide:Service]]
Torna a [[AdminGuide:Service]]
</div>


==Description==
==Description==


<div lang="it" dir="ltr" class="mw-content-ltr">
High availability aims to increase the performance of the VoIP system by bringing together two physical nodes or two virtual machines that work together in active/passive mode.
L’alta affidabilità ha l’obiettivo di incrementare la robustezza del sistema VoIP mettendo insieme due nodi fisici o due macchine virtuali che lavorano congiuntamente in modo attivo/passivo.
Only one of the two PBXs is active in a specific moment, while the other is on standby and is ready to take over call service when the passive node fails.
Solo uno dei due PBX in un certo istante è operativo e serve le chiamate, mentre l’altro è in standby ed è pronto ad acquisire il servizio delle chiamate nel momento in cui il nodo passivo fallisce.
There is no retention of calls in progress during transferring resources from one node to the other
Nell’operazione di trasferimento delle risorse da un nodo all’altro non c’è mantenimento delle chiamate in corso.
By design, the failure that a high-availability system intends to handle is a complete shutdown of the active node's functionality at that time:
Per design, il failure che un sistema ad alta affidabilità intende gestire, è un completo arresto delle funzionalità del nodo attivo in quel momento:
* natively there is no case of monitoring service if it is not actiive, as instead happens in other redundancy mechanisms where the node is considered degraded, even if one of the services is not active
* nativamente non esiste il caso di monitoraggio di un servizio se esso non è operativo, come invece accade in altri meccanismi di ridondanza in cui si considera degradato il nodo, anche se uno dei servizi non è operativo
* unpleasant episodes can happen if the two nodes that are part of the cluster, lose their sight of each other, because each of them is convinced to be the only one and therefore activates, causing a "split brain" situation
* possono accadere spiacevoli episodi se i 2 nodi che fanno parte del cluster perdono la loro vista reciproca, perché ognuno di loro è convinto di essere l’unico e quindi si attiva, causando una situazione di "split brain"
The High availability panel is accesible only to the admin or in case of Multitenant machine, to the PBX Admin.
Il pannello dell’Alta affidabilità è disponibile solo all’admin o nel caso di macchina Multitenant, al PBX Admin.
</div>




<div lang="it" dir="ltr" class="mw-content-ltr">
==Configuration==
==Configurazione del servizio==
We have to go to Settings > High Availability Status
Si procede andando su Impostazioni > Stato alta affidabilità
This takes us to the '''High Availability Configuration''' page.
Ci troviamo così nella pagina della '''Configurazione dell’alta affidabilità'''.
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
[[File:Conf AA.png|600px|centro]]
[[File:Conf AA.png|600px|centro]]
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
You can change system's status as "Enabled as Coordinator" or "Enabled".
È possibile cambiare lo stato del sistema come “Abilitato come coordinatore” o “Abilitato”.
For example, we can choose "Enabled as Coordinator" for a node to keep as coordinator and select (from another browser tab) another node as "Enabled", which will act as a secondary and receive the configuration from the other node.
Per esempio, possiamo scegliere “Abilitato come coordinatore” per un nodo da tenere come coordinatore e selezionare (tramite un’altra scheda browser) un altro nodo semplicemente come “Abilitato”, che farà da secondario e riceverà la configurazione dall’altro nodo.
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
===Network settings===
===Impostazioni di rete===
[[File:AA Impostazioni di rete.png|750px|centro]]
[[File:AA Impostazioni di rete.png|750px|centro]]
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
For a complete configuration, you need to go to Settings > Network settings and check that two network interfaces are configured for high availability, checking their own IP address.  
Per una configurazione completa, è necessario andare su impostazioni > impostazioni di rete e controllare che siano configurate due interfacce di rete per l’alta affidabilità con ognuna il proprio indirizzo IP.  
The two interfaces are connected to the same virtual switch that has no public interfacing. It has a single DNS configured and a route.
Le due interfacce sono connesse allo stesso virtual switch che non ha interfacciamento con il pubblico. Ha un unico DNS configurato e una rotta.
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
===High Availability Configuration===
===Configurazione dell’alta affidabilità===
Service Configuration (Abilitato come coordinatore)  
Configurazione del servizio (Abilitato come coordinatore)  
[[File:AA Configur dett.png|600px|centro]]
[[File:AA Configur dett.png|600px|centro]]
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
* '''S/N remote node''': it's the serial number, the first communication between the two exchanges (coordinator and secondary node) works with an interactive SSH session, in which you have to insert user and password for autentication. The password is calculated from the serial number of the machine. So the coordinator node needs to know the serial number of the other node to get the password to connect with and provide the necessary commands
* '''S/N nodo remoto''': è il serial number, serve perché la prima comunicazione tra le due centrali (nodo coordinatore e secondario) viene fatta con una sessione SSH interattiva, in cui viene chiesta l’autenticazione con user e password. La password è calcolata dal serial number della macchina. Quindi il nodo coordinatore ha bisogno di sapere il serial number dell’altro nodo per poter ottenere la password con cui connettersi e fornire i comandi necessari
* '''Enabled''': you can choose which service to configure on one or both of them
* '''Abilitato''': posso scegliere quale servizio configurare su una o entrambe
* '''Interface''': it is possible to see all the network interfaces present on the machine
* '''Interfaccia''': è possibile visualizzare tutte le interfacce di rete presenti sulla macchina
* '''Local IP Address''': you can see which is the local IP address
* '''Indirizzo IP locale''': è possibile visualizzare qual è l’indirizzo IP locale
* '''Remote IP Address''': you can view the remote IP address.
* '''Indirizzo IP remoto''': è possibile visualizzare qual è l’indirizzo IP remoto
* '''Resource IP Address''': it's the IP address that will be acquired and shared on a given interface
* '''Indirizzo IP risorsa''': è l’indirizzo IP che verrà acquisito e condiviso su una determinata interfaccia
* '''Ping group''': you can insert the IP addresses separated by spaces and they will be the nodes that each of the two will ping periodically to check which one sees more of them
* '''Gruppo di ping''': si possono inserire gli indirizzi IP separati da spazi e saranno quei nodi che ciascuno dei due pingerà periodicamente per verificare chi dei due ne vede di più
* '''Synchronization interface''': you can insert a chosen interface that will be used for synchronization of data and logs between the two nodes (e.g. eth1)
* '''Interfaccia di sincronizzazione''': definisco una interfaccia scelta che sarà utilizzata per la sincronizzazione dei dati e nei registri tra i due nodi (es. eth1)
* '''Default active node''': you can choose which of the two nodes should acquire the default resource in case of indecision.  
* '''Nodo attivo predefinito''': si sceglie quale dei due nodi deve acquisire la risorsa di default in caso di indecisione.
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
===Advanced settings===
===Impostazioni avanzate===
[[File:AA Impostazioni avanzate.png|600px|centro]]
[[File:AA Impostazioni avanzate.png|600px|centro]]
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
* '''Timeout keepalive - warning threshold (sec.)''': this is a threshold after which a warning is generated (at the moment only in the logs)
* '''Timeout keepalive – soglia warning (sec.)''': è una soglia dopo la quale viene generato un warning (al momento solo nei log)
* '''Timeout keepalive - out of service (sec.)''': this value defines after how long the node is not communicating with the other node, it must be assumed that it is inactive, and therefore if the other node may acquire resources
* '''Timeout keepalive – fuori servizio (sec.)''': questo valore definisce dopo quanto tempo di mancata comunicazione con il nodo si deve assumere che sia inattivo e quindi se è possibile che l’altro nodo faccia l’acquisizione delle risorse
* '''Initialization timeout (sec.)''': this value guarantees a specific number of seconds before deciding to acquire the resources (if there is already an active node). The higher the value, the more time the machine will take at startup to become operational because both nodes wait for this time
* '''Timeout inizializzazione (sec.)''': valore che garantisce un tot di secondi prima di decidere di acquisire le risorse (nel caso ci sia un nodo già attivo). Più alto è il valore, più tempo impiegherà la macchina all’avvio per diventare operativa perché entrambi i nodi aspettano questo tempo
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
By pressing "Save and start service" you can save the setting to the database and the high availability can start.
Premendo “Salva e avvia il servizio” viene scritto nel database il setting e viene avviata l’alta affidabilità.
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
==High Availability Status==
==Stato alta affidabilità==
[[File:Stato alta aff.png|600px|centro]]
[[File:Stato alta aff.png|600px|centro]]
Dopo il salvataggio della configurazione, ci troviamo nella pagina dello Stato alta affidabilità in cui possiamo visionare:
After saving the configuration, we are on the High Availability Status page where we can view:
* I nodi con i rispettivi serial number e IP di sincronizzazione
* The nodes with their respective serial numbers and synchronization IPs
* Lo stato del cluster con l’abilitazione del servizio, lo stato del pairing, lo stato del servizio, l’heartbeat
* The cluster status with the service enable, the pairing status, the service status, the heartbeat
* Lo stato delle risorse con il nodo attivo
* The status of the resources with the active node
* Lo Stato del cluster - opzione “pair”: si aggancia il nodo secondario e potremo vedere il pannello di stato in modalità passiva:  
* The cluster status - "pair" option: we will hook the secondary node and we will be able to see the status panel in passive mode:  
[[File:Stato AA 2.png|600px|centro]]
[[File:Stato AA 2.png|600px|centro]]
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
===High availability passive node status===
===Stato alta affidabilità nodo passivo===
* '''Unhook node''': disable high availability, thus leaving the cluster degraded and the resource running on the active node
* '''Sgancia nodo''': si disabilita l’alta affidabilità, si lascia quindi il cluster degradato e la risorsa in esercizio sul nodo attivo
* '''Switch active node''': force resource acquisition
* '''Commuta nodo attivo''': forzare l’acquisizione delle risorse
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
===High availability active node status===
===Stato alta affidabilità nodo attivo===
[[File:Stato AA 3.png|600px|centro]]
[[File:Stato AA 3.png|600px|centro]]
</div>


<div lang="it" dir="ltr" class="mw-content-ltr">
* '''Disable High Reliability''': turns it off on both nodes
* '''Disabilita alta affidabilità''': la spegne su entrambi i nodi
* '''Unhook passive node'''
* '''Sgancia nodo passivo'''
* '''Switch active node''': force resource switching on the other node
* '''Commuta nodo attivo''': forzare la commutazione delle risorse sull’altro nodo
</div>

Versione attuale delle 14:23, 20 set 2022

Altre lingue:

Return to AdminGuide:Service

Description

High availability aims to increase the performance of the VoIP system by bringing together two physical nodes or two virtual machines that work together in active/passive mode. Only one of the two PBXs is active in a specific moment, while the other is on standby and is ready to take over call service when the passive node fails. There is no retention of calls in progress during transferring resources from one node to the other By design, the failure that a high-availability system intends to handle is a complete shutdown of the active node's functionality at that time:

  • natively there is no case of monitoring service if it is not actiive, as instead happens in other redundancy mechanisms where the node is considered degraded, even if one of the services is not active
  • unpleasant episodes can happen if the two nodes that are part of the cluster, lose their sight of each other, because each of them is convinced to be the only one and therefore activates, causing a "split brain" situation

The High availability panel is accesible only to the admin or in case of Multitenant machine, to the PBX Admin.


Configuration

We have to go to Settings > High Availability Status This takes us to the High Availability Configuration page.

Conf AA.png

You can change system's status as "Enabled as Coordinator" or "Enabled". For example, we can choose "Enabled as Coordinator" for a node to keep as coordinator and select (from another browser tab) another node as "Enabled", which will act as a secondary and receive the configuration from the other node.

Network settings

AA Impostazioni di rete.png

For a complete configuration, you need to go to Settings > Network settings and check that two network interfaces are configured for high availability, checking their own IP address. The two interfaces are connected to the same virtual switch that has no public interfacing. It has a single DNS configured and a route.

High Availability Configuration

Service Configuration (Abilitato come coordinatore)

AA Configur dett.png
  • S/N remote node: it's the serial number, the first communication between the two exchanges (coordinator and secondary node) works with an interactive SSH session, in which you have to insert user and password for autentication. The password is calculated from the serial number of the machine. So the coordinator node needs to know the serial number of the other node to get the password to connect with and provide the necessary commands
  • Enabled: you can choose which service to configure on one or both of them
  • Interface: it is possible to see all the network interfaces present on the machine
  • Local IP Address: you can see which is the local IP address
  • Remote IP Address: you can view the remote IP address.
  • Resource IP Address: it's the IP address that will be acquired and shared on a given interface
  • Ping group: you can insert the IP addresses separated by spaces and they will be the nodes that each of the two will ping periodically to check which one sees more of them
  • Synchronization interface: you can insert a chosen interface that will be used for synchronization of data and logs between the two nodes (e.g. eth1)
  • Default active node: you can choose which of the two nodes should acquire the default resource in case of indecision.

Advanced settings

AA Impostazioni avanzate.png
  • Timeout keepalive - warning threshold (sec.): this is a threshold after which a warning is generated (at the moment only in the logs)
  • Timeout keepalive - out of service (sec.): this value defines after how long the node is not communicating with the other node, it must be assumed that it is inactive, and therefore if the other node may acquire resources
  • Initialization timeout (sec.): this value guarantees a specific number of seconds before deciding to acquire the resources (if there is already an active node). The higher the value, the more time the machine will take at startup to become operational because both nodes wait for this time

By pressing "Save and start service" you can save the setting to the database and the high availability can start.

High Availability Status

Stato alta aff.png

After saving the configuration, we are on the High Availability Status page where we can view:

  • The nodes with their respective serial numbers and synchronization IPs
  • The cluster status with the service enable, the pairing status, the service status, the heartbeat
  • The status of the resources with the active node
  • The cluster status - "pair" option: we will hook the secondary node and we will be able to see the status panel in passive mode:
Stato AA 2.png

High availability passive node status

  • Unhook node: disable high availability, thus leaving the cluster degraded and the resource running on the active node
  • Switch active node: force resource acquisition

High availability active node status

Stato AA 3.png
  • Disable High Reliability: turns it off on both nodes
  • Unhook passive node
  • Switch active node: force resource switching on the other node