Aggiornamento da NethServer Enterprise 6¶
L'aggiornamento da NethServer Enterprise 6 a NethServer Enterprise 7 può essere eseguito utilizzando uno dei tre seguenti metodi:
backup (vedere anche Disaster recovery)
Avvertimento
Prima di procedere con l'aggiornamento, leggere attentamente tutte le sezioni di questo documento. Si prega di fare riferimento anche alla sezione Pacchetti rimossi.
Nota
Per l'intera durata del processo di upgrade tutti i servizi di rete saranno inaccessibili.
Account provider¶
Esistono differenti scenari di aggiornamento, a seconda di come è configurata la macchina di origine.
In caso di sistema di origine Primary Domain Controller NT (ruolo del server Samba Primary Domain Controller -- PDC) o di file server standalone (ruolo Workstation -- WS), fare riferimento alla sezione Aggiornamento Primary Domain Controller e Workstation.
In caso di sistema origine attestato ad un dominio Active Directory (ruolo server Samba Active Directory member -- ADS), fare riferimento alla sezione Aggiornamento membro Active Directory.
In tutti gli altri casi il server LDAP viene automaticamente aggiornato a "Account provider LDAP locale", preservando utenti, password e gruppi preesistenti.
Aggiornamento Primary Domain Controller e Workstation¶
Successivamente alla procedura di ripristino, spostarsi nella pagina Accounts provider e selezionare la procedura Upgrade to Active Directory. Il bottone sarà disponibile unicamente se la configurazione di rete sarà stata adattata al nuovo hardware.
I seguenti account vengono ignorati dalla procedura di aggiornamento perché sono già forniti da Samba Active Directory:
administrator
guest
krbtgt
E' necessario fornire un indirizzo IP, aggiuntivo e libero, della rete green al container Linux per attivare l'account provider Active Directory locale.
Ad esempio:
IP server (green):
192.168.98.252
IP aggiuntivo e libero della rete green: 192.168.98.7`
Assicurarsi che sia attiva una connessione internet:
# curl -I http://packages.nethserver.org/nethserver/
HTTP/1.1 200 OK
Per maggiori informazioni relative all'account provider Active Directory locale, fare riferimento alla sezione Installazione del provider locale Samba Active Directory.
Le connessioni alle cartelle condivise potrebbero richiedere delle modifiche.
Avvertimento
Leggere attentamente la sezione Cartelle condivise, le credenziali per la connessione potrebbero variare a seguito dell'upgrade a NethServer Enterprise 7.
La procedura di upgrade preserva utenti, gruppi e account dei computer.
Avvertimento
Gli utenti non abilitati per Samba in NethServer Enterprise 6 saranno migrati come utenti bloccati. Per abilitare questi utenti bloccati, l'amministratore dovrà semplicemente impostargli una nuova password.
Aggiornamento membro Active Directory¶
Successivamente al ripristino della configurazione, attestare il server ad un dominio Active Directory esistente tramite l'interfaccia web. Per ulteriori informazioni consultare la sezione Join ad un dominio Active Directory esistente.
Al termine, procedere con il ripristino dei dati.
Avvertimento
Gli alias e-mail non vengono importati automaticamente da AD!
Server mail¶
Tutte le opzioni delle cassette postali come la SPAM retention e la quota, così come le ACL, le cassette postali condivise dall'utente e le sottoscrizioni vengono conservate.
Le mailbox associate a gruppi con l'opzione Consegna il messaggio in una cartella condivisa abilitata, verranno convertite in cassette postali pubbliche condivise. La cartella pubblica condivisa verrà automaticamente sottoscritta da tutti i membri del gruppo, ma tutti i messaggi verranno contrassegnati come non letti.
TLS policy¶
La configurazione dei servizi di NethServer Enterprise 7 può aderire a diverse TLS policy. Prima dell'aggiornamento, è necessario verificare la compatibilità dei client di rete con le caratteristiche delle policy disponibili.
Avvertimento
Un client di rete datato potrebbe fallire la connessione se i cifrari TLS da esso supportati sono considerati non validi
La versione della policy selezionata dalla procedura di aggiornamento dipende dal versione di NethServer Enterprise come documentato in Note di rilascio 7.
Let's Encrypt¶
I certificati Let's Encrypt vengono ripristinati durante il processo, ma non verranno automaticamente rinnovati.
Dopo aver completato il processo di aggiornamento, accedere all'interfaccia web e riconfigurare Let's Encrypt dalla pagina Certificato del server.
Owncloud e Nextcloud¶
In NethServer Enterprise 7, Owncloud è stato ufficialmente sostituito da Nextcloud.
Tuttavia Owncloud 7 è ancora disponibile per evitare interruzioni del servizio dopo l'aggiornamento.
Nota
In caso di upgrade da LDAP locale ad Samba AD, i dati utente all'interno di Owncloud non saranno accessibili né dall'interfaccia web né dai client desktop/mobile. In tal caso, installare e migrare a Nextcloud dopo che è stato completato l'aggiornamento a Samba Active Directory.
Da Nextcloud 13, la migrazione da Owncloud a Nextcloud non è più supportata.
Gli utenti dovranno sostituire i client per Owncloud con quelli per Nextcloud 2, assicurandosi di impostare il nuovo URL dell'applicazione: https://<your_server_address>/nextcloud
.
- 2
download client Nextcloud https://nextcloud.com/install/#install-clients
Librerie Perl¶
In NethServer Enterprise 7, la libreria perl NethServer::Directory
è stata sostituita da NethServer::Password
. Gli script personalizzati andranno adattati di conseguenza.
Esempio del vecchio codice:
use NethServer::Directory;
NethServer::Directory::getUserPassword('myservice', 0);
Nuovo codice:
use NethServer::Password;
my $password = NethServer::Password::store('myservice');
La documentazione è disponibile attraverso il comando perldoc:
perldoc NethServer::Password
Upgrade da backup¶
Assicurarsi di avere un backup recente del sistema di origine.
Installare NethServer Enterprise 7 utilizzando la ISO più recente disponibile e completare gli step iniziali utilizzando il wizard di prima configurazione. La nuova macchina deve avere lo stesso hostname della vecchia per poter accedere correttamente al set di backup. Installare e configurare il modulo del backup.
Ripristinare il backup della configurazione utilizzando l'interfaccia web. Anche la configurazione della rete verrà ripristinata! Se dovesse verificarsi qualche problema, controllare il file di log
/var/log/messages
per informazioni più approfondite:grep -E '(FAIL|ERROR)' /var/log/messages
Se necessario, spostarsi nel menu Network e correggere la configurazione di rete conformemente al nuovo hardware. Se la macchina era attestata ad un dominio Active Directory esistente, leggere Aggiornamento membro Active Directory.
Completare la procedura di ripristino con i seguenti comandi:
restore-data -b <name>
in cui name è il nome del backup configurato.
Nota
Di default il nome del backup-data configurato su NethServer Enterprise 6 è
backup-data
Verificare i log del ripristino:
/var/log/restore-data.log /var/log/messages
La compatibilità con la versione 7 di ciascun file contenuto nel percorso
/etc/e-smith/templates-custom/
dovrà essere verificata manualmente.
Avvertimento
La macchina non va riavviata prima di aver eseguito la procedura di restore-data.
Upgrade tramite rsync¶
Il processo tramite rsync è più rapido rispetto ad un tradizionale backup e ripristino e consenti di minimizzare il fermo servizi per gli utenti.
Prima di iniziare assicurarsi di avere:
una installazione di NethServer Enterprise 6 in produzione, che chiameremo server origine o server sorgente
una installazione di NethServer Enterprise 7 con almeno lo stesso spazio su disco del server di origine e gli ultimi aggiornamenti installati, che chiameremo server di destinazione
una connessione di rete attiva tra i due server
Assicurarsi che il server sorgente consenta il login all'utente root tramite password ed attraverso una chiave SSH.
Sincronizzazione dei file¶
Lo script di sincronizzazione copia tutti i dati utilizzando rsync su SSH. Se il server di destinazione non dispone di chiavi SSH, lo script genererà una coppia di chiavi RSA per il server destinazione e copierà la chiave pubblica nel server di origine. Tutte le directory escluse dai dati di backup non verranno sincronizzate.
Nella macchina di destinazione, eseguire il seguente comando:
screen rsync-upgrade <source_server_name> [ssh_port]
In cui
source_server_name
è il nome host o l'IP del server originessh_port
è la porta SSH del server origine (la porta di default è la 22)
Esempio:
screen rsync-upgrade mail.nethserver.org 2222
Quando richiesto, inserire la password di root del server origine quindi prepararsi un caffè e aspettare con pazienza.
Lo script non eseguirà alcuna azione sulla macchina di origine e può essere rilanciato più volte.
Sincronizzazione e migrazione¶
Se impartito con l'opzione -u
, rsync-upgrade
eseguirà una sincronizzazione finale e l'upgrade della macchina destinazione.
Esempio:
screen rsync-upgrade -u mail.nethserver.org 2222
Lo script si incaricherà di:
chiudere l'accesso ad ogni servizio di rete della macchina sorgente (ad eccezione di SSH ed httpd-admin)
eseguire gli eventi
pre-backup-config
epre-backup-data
nella macchina sorgentesincronizzare tutti i dati rimanenti
eseguire il comando
restore-config
sulla macchina destinazione
Se l'rsync-upgrade
termina senza perdita della connessione di rete,
Disconnettere il ns6 origine dalla rete, per evitare conflitti IP con il server di destinazione
Accedere all'interfaccia Server Manager e correggere la configurazione di rete dalla pagina Rete
Altrimenti, se durante l'rsync-upgrade
la connessione di rete viene persa, è probabile che i server di origine e di destinazione abbiano un conflitto IP:
Disconnettere il ns6 origine dalla rete,
Da una console di root del ns7 lanciare il comando:
systemctl restart network
Quindi accedere nuovamente alla screen:
screen -r -D
Al termine dell'rsync-upgrade
seguire i seguenti passi:
In caso di sistema di origine Primary Domain Controller NT (ruolo del server Samba Primary Domain Controller -- PDC) o di file server standalone (ruolo Workstation -- WS), fare riferimento alla sezione Aggiornamento Primary Domain Controller e Workstation.
In caso di sistema origine attestato ad un dominio Active Directory (ruolo server Samba Active Directory member -- ADS), fare riferimento alla sezione Aggiornamento membro Active Directory.
Tornare alla CLI e scatenare l'evento
post-restore-data
sulla macchina di destinazione:signal-event post-restore-data
Controllare nei log di ripristino eventuali occorrenze di messaggi di
ERROR
o diFAIL
:/var/log/restore-data.log /var/log/messages
La compatibilità con la versione 7 di ciascun file contenuto nel percorso
/etc/e-smith/templates-custom/
dovrà essere verificata manualmente.
Avvertimento
La macchina non va riavviata prima di aver scatenato la evento post-restore-data.
Upgrade tramite Upgrade tool¶
Il modulo Upgrade tool consente di eseguire un aggiornamento in-place di NethServer Enterprise dalla versione 6 alla versione 7 tramite una procedura automatica.
Fare riferimento alla pagina Upgrade tool del Manuale Amministratore di NethServer Enterprise 6.