Ripristino

Parent page: Altium On-Prem Enterprise Server con backend Oracle

Questo documento è destinato a un amministratore IT che sta ripristinando i dati del proprio Altium On-Prem Enterprise Server quando l’Enterprise Server utilizza un backend di database Oracle. Contiene dettagli sull’Enterprise Server, sulla relativa procedura di ripristino nel contesto dell’uso di Oracle, informazioni importanti sui requisiti di sistema, nonché un esempio che illustra il ripristino dei dati sulla piattaforma Microsoft Windows.

Panoramica del processo di ripristino

Il ripristino dell’Enterprise Server quando si utilizza un backend Oracle dipende da come la tua azienda gestisce i propri database Oracle. Alcune aziende eseguono database Oracle su sistemi operativi Windows Server, mentre altre dispongono di interi datacenter Oracle. Il processo di ripristino in genere prevede tre passaggi, come illustrato nell’immagine seguente.

Panoramica di alto livello della procedura di ripristino dell’Enterprise Server e del database Oracle.

Ipotesi adottate nel presente documento

Sebbene le configurazioni Oracle possano variare da sito a sito, nel presente documento si assumono le seguenti condizioni:

1. È stato eseguito un backup completo dei dati dell’Enterprise Server e del relativo dump dei dati Oracle, come descritto nel documento Backup di Altium On-Prem Enterprise Server con backend Oracle.
2. Il ripristino viene eseguito da un amministratore IT. Come minimo, l’utente che esegue il ripristino dell’Enterprise Server deve disporre di diritti amministrativi sulla macchina host.
3. Per eseguire l’importazione dei dati Oracle dovrebbe essere presente un amministratore di database (DBA). Come minimo, l’utente che segue questa guida dovrebbe avere accesso completo in lettura/scrittura per importare e modificare il database Oracle aziendale.
4. Questa guida presuppone l’esistenza di un’installazione dell’Enterprise Server già configurata e funzionante con un backend Oracle. (Consulta la sezione di esempio per maggiori dettagli su come gestire un ambiente in cui un nuovo Enterprise Server viene distribuito su una macchina e i dati vengono importati in tale istanza di Enterprise Server).
5. Lo schema Oracle e le credenziali dell’applicazione Oracle utilizzati sui server Oracle di origine e di destinazione devono essere gli stessi.

Panoramica di alto livello dell’architettura dell’Enterprise Server

Analogamente ad altri software progettati per essere eseguiti su Microsoft Windows, l’Enterprise Server è un’applicazione server multi-thread e multi-servizio. Poiché questo documento si concentra esclusivamente sulle parti dell’Enterprise Server che possono interagire con un database Oracle, l’immagine seguente è semplificata per rappresentare l’architettura complessiva del backend dell’Enterprise Server.

Panoramica di alto livello dell’architettura dell’Enterprise Server. I Backend Storages dell’Enterprise Server contengono la maggior parte dei dati binari del cliente, mentre i Windows Services sono una raccolta di servizi di supporto.

Questo documento si concentra sui Backend Storages, poiché i dati all’interno di questo blocco sono quelli di cui viene eseguito il backup, che possono essere migrati su un’altra macchina e quindi ripristinati sulla stessa o su una macchina diversa. All’interno dei Backend Storages si trovano i seguenti elementi:

• Databases – contiene metadati quali l’associazione tra footprint del componente e simbolo schematico, parametri, percorsi dei file, collegamenti alle fonti di dati della supply chain dei componenti e altro ancora. Queste informazioni possono risiedere all’interno di un database Firebird o Oracle.
• File Storage – quest’area di File Storage contiene dati binari all’interno del repository VCS dell’Enterprise Server. Questi dati binari includono informazioni quali documenti di progetto PCB e schematici, footprint, simboli, Draftsman e altri documenti nativi o non nativi dell’Enterprise Server.

Panoramica di alto livello dello strumento di ripristino Altium

Lo strumento di ripristino Altium si chiama avbackup.exe. È la stessa utility utilizzata per le operazioni di backup e ripristino con l’Enterprise Server. Si tratta di un’utility da riga di comando che gli amministratori IT possono eseguire per ripristinare i dati del proprio Enterprise Server. avbackup.exe è la stessa utility utilizzata per il ripristino quando l’Enterprise Server è configurato con il backend di database Firebird predefinito oppure quando si utilizza il database Oracle come backend.

Quando si utilizza avbackup.exe in un’implementazione di Enterprise Server che usa un database Oracle, gli amministratori devono tenere presente quanto segue:

1. avbackup.exe NOT supporta il ripristino dei metadati dell’Enterprise Server in un database Oracle. Questa funzionalità funziona solo nelle implementazioni di Enterprise Server che utilizzano un backend di database Firebird originariamente configurato automaticamente dal programma di installazione dell’Enterprise Server.
2. avbackup.exe accetta il file Zip che genera quando viene utilizzato come strumento di backup. Questo file Zip contiene tutti i dati binari dell’Enterprise Server.
3. L’Enterprise Server deve essere in esecuzione. avbackup.exe arresterà automaticamente tutti i servizi dell’Enterprise Server (inclusi i servizi IIS) durante il ripristino dei dati, quindi riavvierà tutti i servizi arrestati dopo un ripristino riuscito.

Esempio di ripristino dei dati dell’Enterprise Server con backend Oracle sulla piattaforma Windows

In questo esempio, le istruzioni sono pensate anche per le aziende più piccole che potrebbero non disporre di un amministratore di database Oracle (DBA) dedicato, ma che hanno comunque la necessità di ripristinare il proprio Enterprise Server e i relativi dati Oracle sulla propria rete. I passaggi seguenti mostrano come un backup di base dell’Enterprise Server e del relativo database Oracle possa essere ripristinato su una nuova macchina e in un nuovo database Oracle.

Elementi richiesti

• Istanza funzionante preesistente dell’Enterprise Server con backend Oracle.
• Cartelle e origini dati preesistenti:
  • Le cartelle in cui saranno collocati i dati dell’Enterprise Server e di Oracle devono già esistere e contenere una copia del file zip di backup dell’Enterprise Server e del file Oracle .DMP.
• Accesso amministrativo alla macchina host dell’Enterprise Server. Questo è necessario per eseguire correttamente l’utility da riga di comando di backup dell’Enterprise Server (avbackup.exe).
• Accesso DBA appropriato al server Oracle (ad esempio, aggiungere l’account Windows dell’utente al ruolo sysDBA in ambiente Windows).

Procedura di ripristino

1. Se non è stata configurata alcuna istanza preesistente dell’Enterprise Server con backend Oracle, leggere il documento Installazione di Altium On-Prem Enterprise Server con backend Oracle per un esempio di come configurare l’Enterprise Server utilizzando un backend Oracle su una nuova macchina.
2. A questo punto, dovresti già disporre di un’istanza esistente dell’Enterprise Server con Oracle, a seguito di una nuova installazione o di una precedente installazione.
3. Sulla macchina host dell’Enterprise Server:
   1. Crea una cartella di ripristino (è utile avere percorsi di file comuni, ad esempio: C:\Backups). Inserisci il file Zip di backup dell’Enterprise Server in questa cartella.
   2. Ripristina i dati dell’Enterprise Server eseguendo lo strumento avbackup.exe come amministratore. Lo strumento si trova nella cartella C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool.
   3. Arresta i servizi IIS dell’Enterprise Server oppure spegni la macchina host dell’Enterprise Server. Questo impedirà eventuali operazioni di scrittura non intenzionali nel database Oracle da parte dei servizi dell’Enterprise Server.

4. Sulla macchina host del database Oracle:
   1. Crea una cartella di ripristino e inserisci in questa cartella il file Oracle .dmp (è utile avere percorsi di file comuni, ad esempio: C:\Backups).
   2. Elimina/rimuovi lo schema esistente e l’account utente dal database Oracle.

L’eliminazione di un account utente Oracle e del relativo schema può essere eseguita come segue. In questo esempio, elimineremo l’account utente esistente AESUSER313 e il relativo schema da un database Oracle su Microsoft Windows:

1. Avvia un prompt dei comandi con privilegi di amministratore.
2. Arresta i servizi IIS, se presenti sulla macchina Oracle, utilizzando il comando: net stop WAS, quindi premi Y e invio.
3. Connettiti al DB Oracle avviando una sessione SqlPlus:

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Elimina lo schema associato all’Enterprise Server (in questo esempio AESUSER313 è il nome dello schema che vogliamo eliminare):

drop user AESUSER313 cascade;

5. riattiva normalmente il DB riavviando la macchina oppure utilizzando i seguenti comandi:

shutdown immediate;

startup;

3. Crea uno schema identico sul server Oracle e assegna diritti elevati:
   1. Apri la riga di comando come amministratore e digita:

sqlplus / as sysdba;

CREATE user AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

2. In alternativa, puoi concedere temporaneamente a questo utente il ruolo DBA, importare i file e quindi revocare questo privilegio come mostrato di seguito:

GRANT DBA TO AESUSER313;

3. Dopo aver importato correttamente il DB, revoca i privilegi DBA:

revoke DBA from AESUSER313;

4. Ripristina i dati Oracle (questa sezione presuppone che l’account utente e gli schemi si chiamino entrambi AESUSER313 e abbiano password Altium):
   1. Avvia il prompt dei comandi con privilegi di amministratore
   2. Arresta i server IIS utilizzando il comando:

net stop WAS

3. Importa i dati Oracle. Un esempio di comando di importazione è:

imp AESUSER313/Altium@xe file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_import.log fromuser=AESUSER313 touser=AESUSER313

dove,

AESUSER313 – utente che dispone di privilegi completi sullo schema e dei diritti di accesso al DB.

Altium – password dell’account utente Oracle associato all’Enterprise Server.

xe – nome del servizio di rete del DB di destinazione contenuto in tnsnames.ora.

file = c:\Backups\AESUSER313.dmp – posizione del backup.

log = c:\Backups\AESUSER313_import.log – log di ripristino (facoltativo).

fromuser=AESUSER313 – proprietario dello schema di backup.

touser=AESUSER313 – il nuovo proprietario dello schema (se i proprietari sono diversi, è necessario creare un nuovo utente con privilegi e ruoli appropriati).

5. Verifica l’integrità dei dati.
   1. Controlla il file tnsname.ora. Dovresti aggiornare il nome del servizio di rete (se hai cambiato il server DB).
   2. Convalida le impostazioni del server IIS. Controlla che la colonna “Host name” nelle associazioni in IIS Manager sia aggiornata. Deve contenere l’attuale Fully Qualified Domain Name (FQDN) del tuo Enterprise Server.
   3. Controlla i valori dei seguenti parametri nel file C:\Program Files (x86)\Altium\Altium365\LocalVault.ini.
      1. Domain – il nome del tuo dominio.
      2. WebsiteDomain – FQDN del tuo Enterprise Server.
      3. DataSourceType=Oracle – se utilizzi Oracle DB.
      4. User=AESUSER313 – proprietario dello schema.
      5. Password=Altium – password dell’utente definita dal DBA.
      6. DBLocation=FQDN o ip_address:1521 – indirizzo del tuo server DB.
      7. DatabaseName=xe – nome attuale del servizio di rete del DB, contenuto in tnsnames.ora.

Conclusione

Sebbene l’esempio sopra riportato includa ulteriori dettagli relativi all’interfacciamento e alla manipolazione di un database Oracle, esistono solo tre passaggi chiave per ripristinare i dati del tuo Enterprise Server:

1. Il passaggio 1 consiste nell’arrestare i servizi IIS e gli Application Pool IIS di Enterprise Server.
2. Il passaggio 2 consiste nel ripristinare i dati di Enterprise Server .
3. Il passaggio 3 consiste nel ripristinare i dati Oracle associati a Enterprise Server.

Eseguire questa procedura nell’ordine descritto riduce notevolmente la probabilità di corruzione dei dati dovuta a una mancata corrispondenza tra il database Oracle e i dati binari di Enterprise Server.