Restaurar

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

Este documento está dirigido a un administrador de TI que esté restaurando los datos de su Altium On-Prem Enterprise Server cuando Enterprise Server utiliza un backend de base de datos Oracle. Contiene detalles sobre Enterprise Server, su procedimiento de restauración en el contexto del uso de Oracle, información importante sobre los requisitos del sistema, así como un ejemplo que describe la restauración de datos en la plataforma Microsoft Windows.

Descripción general del proceso de restauración

La restauración de Enterprise Server cuando se utiliza un backend de Oracle depende de cómo su empresa administre sus bases de datos Oracle. Algunas empresas ejecutan bases de datos Oracle sobre sistemas operativos Windows Server, mientras que otras cuentan con centros de datos Oracle completos. El proceso de restauración normalmente implica tres pasos, como se ilustra en la siguiente imagen.

Descripción general de alto nivel del procedimiento de restauración de Enterprise Server y la base de datos Oracle.

Suposiciones realizadas en todo este documento

Aunque las configuraciones de Oracle pueden variar de un sitio a otro, en este documento se asumen los siguientes puntos:

1. Se ha realizado una copia de seguridad completa de los datos de Enterprise Server y de su volcado de datos de Oracle asociado, tal como se describe en el documento Copia de seguridad de Altium On-Prem Enterprise Server con un backend de Oracle.
2. La restauración la realiza un administrador de TI. Como mínimo, el usuario que realice la restauración de Enterprise Server debe tener derechos administrativos en la máquina host.
3. Debe estar presente un administrador de bases de datos (DBA) para realizar la importación de datos de Oracle. Como mínimo, el usuario que siga esta guía debe tener acceso completo de lectura/escritura para importar y modificar la base de datos Oracle de la empresa.
4. Esta guía supone que existe una instalación de Enterprise Server ya existente, configurada y funcionando con un backend de Oracle. (Consulte la sección de ejemplo para obtener más detalles sobre cómo manejar un entorno en el que se implementa un nuevo Enterprise Server en una máquina y se importan datos a esa instancia de Enterprise Server).
5. El esquema de Oracle y las credenciales de la aplicación Oracle utilizadas en los servidores Oracle de origen y destino deben ser las mismas.

Descripción general de alto nivel de la arquitectura de Enterprise Server

Al igual que otro software diseñado para ejecutarse en Microsoft Windows, Enterprise Server es una aplicación de servidor multihilo y multiservicio. Dado que este documento se centra únicamente en las partes de Enterprise Server que pueden interactuar con una base de datos Oracle, la siguiente imagen está simplificada para representar la arquitectura general del backend de Enterprise Server.

Descripción general de alto nivel de la arquitectura de Enterprise Server. Los almacenamientos de backend de Enterprise Server contienen la mayor parte de los datos binarios del cliente, mientras que los servicios de Windows son una colección de servicios de soporte.

Este documento se centra en los almacenamientos de backend, ya que los datos dentro de este bloque son los que se respaldan, potencialmente se migran a otra máquina y luego se restauran en la misma o en una diferente. Dentro de los almacenamientos de backend, se pueden encontrar los siguientes elementos:

• Databases – contiene metadatos como la asociación de huellas de componentes y símbolos esquemáticos, parámetros, rutas de archivos, enlaces a fuentes de datos de la cadena de suministro de componentes y más. Esta información puede residir dentro de una base de datos Firebird u Oracle.
• File Storage – esta área de almacenamiento de archivos contiene datos binarios dentro del repositorio VCS de Enterprise Server. Estos datos binarios incluyen información como documentos de proyectos PCB y esquemáticos, huellas, símbolos, Draftsman y otros documentos nativos o no nativos de Enterprise Server.

Descripción general de alto nivel de la herramienta de restauración de Altium

La herramienta de restauración de Altium se llama avbackup.exe. Es la misma utilidad utilizada para fines de copia de seguridad y restauración con Enterprise Server. Esta es una utilidad de línea de comandos que los administradores de TI pueden ejecutar para restaurar los datos de su Enterprise Server. avbackup.exe es la misma utilidad utilizada para fines de restauración cuando Enterprise Server está configurado con un backend de base de datos Firebird predeterminado, o cuando se utiliza la base de datos Oracle como backend.

Al usar avbackup.exe en una implementación de Enterprise Server que utiliza una base de datos Oracle, los administradores deben tener en cuenta lo siguiente:

1. avbackup.exeNOT no admite restaurar los metadatos de su Enterprise Server en una base de datos Oracle. Esta función solo funciona en implementaciones de Enterprise Server que utilizan un backend de base de datos Firebird que fue configurado automáticamente originalmente por el instalador de Enterprise Server.
2. avbackup.exe acepta el archivo Zip que genera cuando se utiliza como herramienta de copia de seguridad. Este archivo Zip contiene todos los datos binarios de Enterprise Server.
3. Enterprise Server debe estar en ejecución. avbackup.exe apagará automáticamente todos los servicios de Enterprise Server (incluidos los servicios de IIS) durante la restauración de datos y luego reiniciará todos los servicios que haya apagado tras una restauración exitosa.

Ejemplo de restauración de datos de Enterprise Server con backend de Oracle en la plataforma Windows

En este ejemplo, las instrucciones también están orientadas a empresas más pequeñas que pueden no tener un administrador de bases de datos Oracle (DBA) dedicado, pero que aun así necesitan restaurar su Enterprise Server y los datos de Oracle asociados en su red. Los siguientes pasos muestran cómo se puede restaurar una copia de seguridad básica de Enterprise Server y su base de datos Oracle asociada en una nueva máquina y base de datos Oracle.

Elementos necesarios

• Instancia funcional preexistente de Enterprise Server con backend de Oracle.
• Carpetas y fuentes de datos preexistentes:
  • Las carpetas donde se ubicarán sus datos de Enterprise Server y Oracle ya deben existir y contener una copia de su archivo zip de copia de seguridad de Enterprise Server y el archivo Oracle .DMP.
• Acceso de administrador a la máquina host de Enterprise Server. Esto es necesario para ejecutar correctamente la utilidad de línea de comandos de copia de seguridad de Enterprise Server (avbackup.exe).
• Acceso DBA adecuado al servidor Oracle (es decir, agregar la cuenta de Windows del usuario al rol sysDBA en el entorno Windows).

Procedimiento de restauración

1. Si no se ha configurado ninguna instancia preexistente de Enterprise Server con backend de Oracle, lea el documento Instalación de Altium On-Prem Enterprise Server con un backend de Oracle para ver un ejemplo de cómo configurar Enterprise Server usando un backend de Oracle en una máquina nueva.
2. En este punto, ya debería tener una instancia existente de Enterprise Server con Oracle, ya sea debido a una instalación nueva o anterior.
3. En la máquina host de Enterprise Server:
   1. Cree una carpeta de restauración (es útil tener rutas de archivo comunes, por ejemplo: C:\Backups). Coloque el archivo Zip de copia de seguridad de Enterprise Server en esta carpeta.
   2. Restaure los datos de su Enterprise Server ejecutando la herramienta avbackup.exe como administrador. La herramienta se encuentra en la carpeta C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool.
   3. Apague los servicios IIS de Enterprise Server o apague la máquina host de Enterprise Server. Esto evitará cualquier operación de escritura no deseada en su base de datos Oracle por parte de los servicios de Enterprise Server.

4. En la máquina host de la base de datos Oracle:
   1. Cree una carpeta de restauración y coloque el archivo Oracle .dmp en esta carpeta (es útil tener rutas de archivo comunes, por ejemplo: C:\Backups).
   2. Elimine el esquema y la cuenta de usuario existentes de la base de datos Oracle.

La eliminación de una cuenta de usuario de Oracle y su esquema asociado se puede lograr de la siguiente manera. Para este ejemplo, eliminaremos la cuenta de usuario existente AESUSER313 y su esquema asociado de una base de datos Oracle en Microsoft Windows:

1. Abra un símbolo del sistema con privilegios de administrador.
2. Detenga los servicios IIS si están presentes en la máquina Oracle usando el comando: net stop WAS, luego presione Y y Enter.
3. Conéctese a la base de datos Oracle iniciando una sesión de SqlPlus:

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Elimine el esquema asociado con Enterprise Server (en este ejemplo, AESUSER313 es el nombre del esquema que queremos eliminar):

drop user AESUSER313 cascade;

5. reactive la base de datos normalmente, ya sea reiniciando la máquina o usando los siguientes comandos:

shutdown immediate;

startup;

3. Cree un esquema idéntico en el servidor Oracle y asigne derechos elevados:
   1. Abra la línea de comandos como administrador y escriba:

sqlplus / as sysdba;

CREATE user AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

2. Como alternativa, puede conceder temporalmente el rol DBA a este usuario, importar los archivos y luego revocar este privilegio como se muestra a continuación:

GRANT DBA TO AESUSER313;

3. Después de importar correctamente la base de datos, revoque los privilegios de DBA:

revoke DBA from AESUSER313;

4. Restaure los datos de Oracle (esta sección asume que la cuenta de usuario y los esquemas se llaman AESUSER313 y tienen la contraseña Altium):
   1. Abra un símbolo del sistema con privilegios de administrador
   2. Detenga los servidores IIS usando el comando:

net stop WAS

3. Importe los datos de Oracle. Un ejemplo de un comando de importación es:

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

donde,

AESUSER313 – usuario que tiene privilegios completos sobre el esquema y derechos para acceder a la base de datos.

Altium – contraseña de la cuenta de usuario de Oracle asociada con Enterprise Server.

xe – nombre del servicio de red de la base de datos de destino contenido en tnsnames.ora.

file = c:\Backups\AESUSER313.dmp – ubicación de la copia de seguridad.

log = c:\Backups\AESUSER313_import.log – registro de restauración (opcional).

fromuser=AESUSER313 – propietario del esquema de la copia de seguridad.

touser=AESUSER313 – el nuevo propietario del esquema (si los propietarios son diferentes, debe crear un nuevo usuario con los privilegios y roles adecuados).

5. Verifique la integridad de los datos.
   1. Revise el archivo tnsname.ora. Debe actualizar el nombre del servicio de red (si cambió el servidor de base de datos).
   2. Valide la configuración del servidor IIS. Verifique que la columna “Host name” en los enlaces de IIS Manager sea la actual. Debe ser el nombre de dominio completo (FQDN) actual de su Enterprise Server.
   3. Verifique los valores de los siguientes parámetros en el archivo C:\Program Files (x86)\Altium\Altium365\LocalVault.ini.
      1. Domain – el nombre de su dominio.
      2. WebsiteDomain – el FQDN de su Enterprise Server.
      3. DataSourceType=Oracle – si utiliza Oracle DB.
      4. User=AESUSER313 – el propietario del esquema.
      5. Password=Altium – la contraseña del usuario definida por el DBA.
      6. DBLocation=FQDN o ip_address:1521 – la dirección de su servidor de base de datos.
      7. DatabaseName=xe – el nombre actual del servicio de red de la base de datos, contenido en tnsnames.ora.

Conclusión

Aunque el ejemplo anterior incluye detalles adicionales relacionados con la interfaz y manipulación de una base de datos Oracle, solo hay tres pasos clave para restaurar los datos de su Enterprise Server:

1. El paso 1 es detener los servicios IIS y los grupos de aplicaciones IIS de Enterprise Server.
2. El paso 2 es restaurar los datos de Enterprise Server .
3. El paso 3 es restaurar los datos de Oracle asociados con Enterprise Server.

Realizar este procedimiento en el orden descrito reduce en gran medida la probabilidad de corrupción de datos debido a una discrepancia entre la base de datos Oracle y los datos binarios de Enterprise Server.