Visualizza wikitesto di AdminGuide:GettingStarted:V4R/V4R+

<languages />
<translate>
<!--T:1-->
Torna a [[AdminGuide:GettingStarted]]

== KalliopePBX v4 Rackmount (Hw rev. 3) ==

Gli apparati KalliopePBX v4 rackmount (nelle diverse varianti -R, -R+, -R-OPT-FO e -R-OPT-FO+) in hw rev. 3 sono basati su una piattaforma hardware headless che mette a disposizione:
* una interfaccia di rete Gigabit Ethernet equipaggiata con uno switch hardware 8 porte, tutte Gigabit Ethernet autosensing (ETH0)
* due interfacce di rete Gigabit Ethernet (ciascuna dual mode RJ45 e SFP 1GbE) a porta singola (ETH1 e ETH2). 
** '''NOTA''': in caso di utilizzo di GBIC nello slot SFP di una di queste interfacce, se viene lasciato inserito il cavo di rete nella porta RJ45, quest'ultima avrà la precedenza. 
** '''NOTA 2''': nel caso di utilizzo di GBIC 100 Mbps, il sistema non le riconosce in automatico ed è necessaria un'operazione di abilitazione da parte del nostro supporto tecnico.

Una volta collegato l'apparato tramite l'alimentatore in dotazione, il sistema si avvia in automatico ed entro pochi secondi sarà possibile accedere al KalliopePBX.

Il primo accesso a KalliopePBX avviene tramite una delle porte switch dell'interfaccia ETH0, puntando il browser all'indirizzo predefinito http://192.168.0.100:10080.

'''NOTA''': Alcuni browser hanno iniziato a bloccare per impostazione predefinita l'accesso a pagine su porte diverse da quelle standard. In caso di visualizzazione di un errore che indica '''"ERR_UNSAFE_PORT"''', è necessario effettuare lo sblocco della porta 10080, mediante la procedura indicata alla pagina '''[[AdminGuide:GettingStarted:Risoluzione ERR UNSAFE PORT per Chrome e Firefox|Gestione errore ERR_UNSAFE_PORT]]'''

Come per le VM e gli altri apparati fisici, è possibile modificare l'indirizzo IP di KalliopePBX collegando all'interfaccia ETH0 un PC configurato con un indirizzo IP sulla subnet 192.168.0.0/24 e accedendo al pannello "Impostazioni di rete" dal menu Strumenti, accessibile in alto a destra della GUI di Kalliope.

In alternativa, è possibile accedere alla console di KalliopePBX (operativa solo in modalità "recovery" o "console di ripristino", in cui il sistema è avviato quindi su bootloader e non su un firmware) e effettuare la configurazione utilizzando la CLI integrata (a cui si accede con le credenziali predefinite manager/manager). A differenza delle precedenti versioni hardware, l'accesso alla console di KalliopePBX non avviene direttamente tramite la porta seriale presente sull'apparato, ma tramite il servizio VNC.

In questa revision hardware, difatti, KalliopePBX gira come macchina virtuale all'interno di un ambiente di virtualizzazione basato su KVM. L'accesso a KalliopePBX è quindi mediato dal sistema operativo nativo che gira sull'apparato fisico, tramite il quale è possibile effettuare alcune semplici operazioni di configurazione, come dettagliato di seguito.

Nel caso sia possibile accedere all'interfaccia web di KalliopePBX con le impostazioni di rete predefinite (192.168.0.100/24), la procedura di prima attivazione segue quella standard comune alle altre versioni, ed è composta dai seguenti passi:

# Configurazione dell'indirizzo IP, default gateway e DNS tramite web GUI e nuovo accesso al nuovo indirizzo IP assegnato. Verifica della corretta impostazione data/ora e eventuale sincronizzazione forzata usando i server NTP di sistema (o quelli personali eventualmente configurati).
# Attivazione della licenza della VM KalliopePBX. In questo caso, a differenza delle VM tradizionali, non è necessario inserire una chiave di attivazione perché questa sarà disponibile a bordo dell'apparato, pertanto l'attivazione consiste solamente nel premere il corrispondente pulsante dall'interfaccia web
# Registrazione del prodotto. Analogamente agli altri sistemi Kalliope, questa operazione sblocca la possibilità di procedere con l'installazione dei firmware, e determina l'inizio del periodo previsto per la garanzia sull'apparato e per l'accesso agli aggiornamenti
# Aggiornamento bootloader, se necessario, ed installazione firmware. Al termine dell'installazione firmware sarà necessario effettuare il riavvio da GUI di KalliopePBX e, terminato il boot, verrà automaticamente effettuata la redirezione verso la pagina di login (su porta standard 80)

Nel caso in cui non sia possibile effettuare l'accesso all'IP predefinito 192.168.0.100 e si debba o voglia procedere con la sua modifica utilizzando la CLI di KalliopePBX, è necessario comunque avere accesso al sistema operativo nativo dell'apparato, per poter configurare l'accesso VNC alla console di KalliopePBX. Nello specifico, una volta effettuata la configurazione di un IP al sistema operativo nativo, in base alle indicazioni presenti nella sezione successiva, è sufficiente avviare un client VNC (es. TightVNC Viewer) configurando la connessione verso l'host <IP_OS_nativo:5900>, per ottenere accesso alla CLI di KalliopePBX su cui poter effettuare login (utilizzando l'utente cablato manager/manager)


===Accesso al sistema operativo nativo ATOS dell'apparato===

L'accesso al sistema operativo nativo dell'apparato (ATOS) può essere necessario per configurarne le impostazioni di rete al fine di poter accedere tramite VNC alla console di KalliopePBX, oltre che per poter effettuare, laddove necessario, l'arresto forzato e il riavvio di KalliopePBX.

L'accesso ad ATOS può avvenire tramite la porta seriale ("Console") presente sul fronte del dispositivo (con impostazioni 115200/8/N/1), oppure mediante accesso ssh.
In modo simile a quanto avviene con i sistemi di gestione fuori banda di molti server (iLO per HP, DRAC per Dell, ecc.) ATOS ha un proprio stack di rete, che per impostazione predefinita è configurato come DHCP client sull'interfaccia ETH0 (con un MAC della famiglia 00:D0:D6:xx:xx:xx, come riportato sull'etichetta presente sull'apparato).

Le credenziali di accesso sono riportate sull'etichetta presente sull'apparato. L'utente è "manager" e la password è univocamente assegnata a ciascun apparato (in seguito modificabile previo accesso ad ATOS).

'''NOTA''': questo utente manager non ha alcun legame con l'utente manager che si utilizza per accedere alla CLI di Kalliope in modalità bootloader.

Una volta effettuata la connessione tramite console seriale, o tramite ssh (qualora si conosca l'IP acquisito da ATOS, ad esempio grazie ai log del server DCP eventualmente presente nella rete), si procede con il login usando l'utente "manager" e la password riportata sull'etichetta presente sull'apparato:

  login as: manager
  manager@192.168.23.60's password: *******
  ATOSNT Remote CLI
  
  CTRL+d to exit
  
  Init Command Line Interface...
  ATOS Version: 7.2.7 (mcccfvitbkovsc)
  ATOS Date: 06/10/2022 13:34
  ATOS License: NFVSBC
  Hardware: XV8800 - 4C8R120D - 2518D
  Product Code: 708190501
  Serial Number: xxxxxx
  MAC Address: 00:D0:D6:xx:xx:xx
  BARCODE: AE70819050110204xxxxxx
  
  User name :manager
  Password :*******
  <manager> logged at MANAGER level
  KPBXv4_kvm>  

Digitando "?" seguito dal tasto invio, il sistema presenta le voci di configurazione ed i comandi disponibili:

  KPBXv4_kvm>?
  
  Available nodes:
                          system
                          interfaces
                          dns
                          nfv
  Available commands:
  up                      Move one step up from the current node
  top                     Back to the root of the tree
  quit                    Exit from CLI session
  set                     Set node options
  add                     Add a new option
  del                     Remove an added option
  show                    Show 'KPBXv4_kvm' settings
  help                    Help of item
  info                    Show the system informations
  date                    Show or setting system date and time
  save                    Save configuration data
  restart                 Restart device
  ping                    Send an ICMP ECHO request
  tracert                 Display a trace of packet
  show-logging-level      Show logged level
  
  password                Set user/others password on node KPBXv4_kvm\system>>

Di seguito si riportano i comandi di visualizzazione delle impostazioni correnti, seguite poi dai comandi dispositivi, con cui effettuare le modifiche alla configurazione di ATOS. 

'''Nota''': tutti i comandi dispongono di un aiuto in linea, è sufficiente completare il comando in corso con il carattere "?" per avere dal sistema l'informazione di tutte le possibili opzioni disponibili per quel comando. Ad esempio:

  KPBXv4_kvm>set interfaces vswitch-0 ip ?
  
  Set command parameters:
    ip address          [address]             Current value: 0.0.0.0
    default router      [defaultrouter]       Current value: 0.0.0.0
    dhcp client         [dhcp-client]         Current value: on


Inoltre, il tasto "Tab" effettua il completamento del comando inserito:

  KPBXv4_kvm>set interfaces vswitch-0 ip dh<tab>

produce l'autocompletamento 

  KPBXv4_kvm>set interfaces vswitch-0 ip dhcp-client

In caso di più possibilità di autocompletamento, la pressione ripetuta del tasto "Tab" causa il ciclare attraverso tutte le possibili opzioni.

=== Comandi di visualizzazione informazioni di stato ATOS ===

==== Visualizzazione indirizzo IP assegnato e stato interfacce ====

  KPBXv4_kvm>show interfaces status
  
  Show status of KPBXv4_kvm interfaces
  INTERFACES      IPV4-ADDRESS    MAC-ADDRESS        STATUS     PROTOCOL  STATUS-DETAILS                            VRF
  eth0            unassigned      00:D0:D6:xx:xx:xx  up         up        operational/running/bundled               global
  eth1            unassigned      00:D0:D6:xx:xx:xx  down       down      operational/not running                   global
  eth2            unassigned      00:D0:D6:xx:xx:xx  down       down      operational/not running                   global
  tap-vdev0       unassigned      02:09:C0:17:8C:24  up         up        operational/running/bundled               global
  tap-vdev1       unassigned      02:09:C0:CE:2D:08  up         up        operational/running/bundled               global
  tap-vdev2       unassigned      02:09:C0:FA:F0:9E  up         up        operational/running/bundled               global
  vswitch-0       192.168.23.60   00:D0:D6:xx:xx:xx  up         up        operational/running/ip4 address assigned  global

In questo output, le interfacce eth0-1-2 sono le porte fisiche dell'apparato (eth1 e eth2 sono "not running" in quanto non ci sono cavi di rete connessi), le tap-vdev0-1-2 sono porte logiche usate internamente per interconnettere le interfacce di rete della VM Kalliope con le porte fisiche. La vswitch-0 è l'interfaccia di rete di accesso ad ATOS, che in questo esempio ha ricevuto l'indirizzo 192.168.23.60 tramite DHCP.

==== Visualizzazione server DNS impostato su ATOS ====

  KPBXv4_kvm>show dns work
  Show of KPBXv4_kvm dns
  Enable                : on
  Level of log          : 1
  Max retries           : 3
  Timeout retries (sec) : 20
  Local resolution      : preferred-v4
  
  LIST OF DOMAIN NAME SERVERS
  VRF                : global
  Domain Name        : anydomain
  Interface          : vswitch-0
  Primary address    : 8.8.8.8
  Secondary address  : 4.4.4.4
  Priority           : 1

I DNS preimpostati in ATOS sono 8.8.8.8 e 4.4.4.4

==== Visualizzazione server NTP per sincronizzazione orario ATOS ====

  KPBXv4_kvm>show system timesync work
  Show of KPBXv4_kvm system timesync
  Level of log                 : 1
  Enable                       : on
  Sync frequency (sec)         : 300
  GMT offset (min)             : 60
  Daylight saving time period  : last Sun Mar 02:00 last Sun Oct 03:00
  Local IP Address             : 0.0.0.0
  Local IPv6 Address           : ::
  VRF                          : global
  
  LIST OF SERVERS
  Server                                   Type
  it.pool.ntp.org                          sntp

==== Visualizzazione stato di esercizio della VM KalliopePBX ====

  KPBXv4_kvm>show nfv kpbxv4 status
  
  Show status of KPBXv4_kvm nfv kpbxv4
  Status     : on
  UUID       : 614c20db-8219-4804-b27b-ca9afe91398c
  Huge pages : 4096
  Nic model  : virtio-net-pci

=== Comandi dispositivi e di modifica configurazione ===

{|style="width: 100%; color: red; border: 1px solid" cellpadding="5"
| NOTA: per rendere persistenti al riavvio i comandi seguenti è necessario eseguire, al termine delle modifiche, il comando "save"
|}

==== Arresto/avvio della VM KalliopePBX ====

  KPBXv4_kvm> set nfv kpbxv4 off
  KPBXv4_kvm> set nfv kpbxv4 on


==== Gestione indirizzo IP interfaccia vswitch-0 di ATOS ====

Disabilitazione/abilitazione DHCP client ('''attenzione''', se si è connessi via ssh e non via seriale, la disattivazione del client DHCP causa il rilascio dell'indirizzo e quindi la disconnessione!)

  KPBXv4_kvm>set interfaces vswitch-0 ip dhcp-client off 
  KPBXv4_kvm>set interfaces vswitch-0 ip dhcp-client on

Impostazione indirizzo IP statico 

  KPBXv4_kvm>set interfaces vswitch-0 ip address ?
  
    ip address  [aa.bb.cc.dd[/0-32]]
  
    Current value:    0.0.0.0
    Default fw value: 0.0.0.0

es:

  KPBXv4_kvm>set interfaces vswitch-0 ip address 192.168.55.200/24

Impostazione default gateway (per eventuale accesso da remoto):

  KPBXv4_kvm>set interfaces vswitch-0 ip defaultrouter ?
  
    default router  [aa.bb.cc.dd]
  
    Current value:    0.0.0.0
    Default fw value: 0.0.0.0

es:

  KPBXv4_kvm>set interfaces vswitch-0 ip defaultrouter 192.168.55.1

==== Modifica server DNS utilizzati da ATOS  (utilizzati per risoluzione dei server NTP configurati) ====
  
In questo caso si utilizza il comando "del" per rimuovere il set di DNS configurati, ed il comando "add" per aggiungere un nuovo set di server: 

  KPBXv4_kvm>del dns SERVER anydomain 1

Questo comando rimuove il set a priorità 1 (l'unico presente di default) a cui sono associati i DNS con IP 8.8.8.8 e 4.4.4.4. L'informazione delle priorità definite e dei relativi server associati sono ottenibili con il comando "show dns work"

Per aggiungere un nuovo set di server DNS, si utilizza invece il comando 

  KPBXv4_kvm>add dns SERVER anydomain 8.8.8.8 4.4.4.4 1

==== Modifica server NTP utilizzati da ATOS ====

Anche in questo caso si utilizza il comando "add" per aggiungere un nuovo server e il comando "del" per rimuovere quello da cancellare:

  KPBXv4_kvm>del system timesync it.pool.ntp.org

  KPBXv4_kvm>add system timesync ntp1.inrim.it

Qualora desiderato, è possibile aggiungere più server NTP, senza necessariamente cancellare l'esistente.


== KalliopePBX v4 Rackmount (Hw rev. 1 e 2) ==

===Descrizione porte=== <!--T:2-->

<!--T:3-->
[[File:Retro V4R.png|sinistra]] <br />

<!--T:4-->
<br />
<br />


<!--T:5-->
#Power (12v, 5A)
#VGA (unused)
#USB 2.0/USB 3.0
#Gigabit Ethernet (eth0)
#Gigabit Ethernet (eth1)
#HDMI (unused)
#Audio jack (unused)
#COM1 (Console 115200 8/n/1)



===Prima installazione=== <!--T:6-->

<!--T:7-->
* Collegate KalliopePBX alla vostra rete utilizzando l’interfaccia eth0
* Opzionale: collegate la porta seriale COM1 di KalliopePBX al vostro PC usando un cavo seriale (non incluso - impostazioni: 115200 8/n/1)
* Collegate l’alimentatore incluso a KalliopePBX e successivamente collegate l’alimentatore ad una presa di corrente (100-240V AC, 50-60 Hz)
* Avviare KalliopePBX premendo il tasto di accensione posto sul frontale; in caso di interruzione imprevista dell’alimentazione, al ripristino dell’alimentazione il sistema si avvia automaticamente
* Puntate il vostro browser all’indirizzo http://192.168.0.100:10080 per effettuare la prima registrazione. È richiesto l’accesso da parte di KalliopePBX all’indirizzo<br> https://license.kalliopepbx.it; la configurazione di rete può essere modificata attraverso il menu “Impostazioni”. Nel caso compaia l'errore UNSAFE_PORT seguire questa procedura ([[Risoluzione_ERR_UNSAFE_PORT|Clicca qui]])<br>
* Dopo la registrazione, installare il firmware desiderato tra quelli disponibili. È richiesto l’accesso da parte di KalliopePBX all’indirizzo https://updates.kalliopepbx.it. Il processo può richiedere alcuni minuti, in base alla dimensione del firmware e della velocità di download della vostra rete
* Seguite il progresso dell’installazione firmware; al termine, riavviate KalliopePBX ed accedete all’interfaccia di configurazione puntando il vostro browser all’indirizzo http://<Configured_ip> (porta standard http 80). Le credenziali di default per l'accesso sono: admin/admin.
</translate>