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 al usar un backend de Oracle depende de cómo gestione su empresa 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 a lo largo de este documento

Aunque las configuraciones de Oracle pueden variar de un sitio a otro, en este documento se hacen las siguientes suposiciones:

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 previa de Enterprise Server, 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 está implementando 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 se simplifica 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 Windows Services es 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 máquina 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 que se usa con Enterprise Server para fines de copia de seguridad y restauración. 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 que se utiliza con fines de restauración cuando Enterprise Server está configurado con un backend de base de datos Firebird predeterminado, o cuando se usa 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.exe NOTno admite la restauración de los metadatos de su Enterprise Server en una base de datos Oracle. Esta función solo funciona en implementaciones de Enterprise Server que usan un backend de base de datos Firebird 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 cerrará automáticamente todos los servicios de Enterprise Server (incluidos los servicios de IIS) durante la restauración de datos y, tras una restauración correcta, reiniciará todos los servicios que haya detenido.

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 quizá no tengan un administrador de bases de datos Oracle (DBA) dedicado, pero que aun así necesiten restaurar su Enterprise Server y sus datos de Oracle asociados en su red. Los siguientes pasos muestran cómo se puede restaurar en una máquina nueva y en una nueva base de datos Oracle una copia de seguridad básica de Enterprise Server y de su base de datos Oracle asociada.

Elementos requeridos

• 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 del archivo .DMP de Oracle.
• 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 un 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 con 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. Detenga 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 .dmp de Oracle en esta carpeta (es útil tener rutas de archivo comunes, por ejemplo: C:\Backups).
   2. Elimine/suprima el esquema existente y la cuenta de usuario de la base de datos Oracle.

La eliminación de una cuenta de usuario de Oracle y su esquema asociado se puede realizar 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 una ventana de comandos con privilegios de administrador.
2. Detenga los servicios de 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 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. vuelva a activar 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 una ventana de comandos con privilegios de administrador 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 el Enterprise Server.

xe – nombre del servicio de red de la BD 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 apropiados).

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 BD).
   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. Revise 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 – FQDN de su Enterprise Server.
      3. DataSourceType=Oracle – si usa Oracle DB.
      4. User=AESUSER313 – propietario del esquema.
      5. Password=Altium – contraseña del usuario definida por el DBA.
      6. DBLocation=FQDN o ip_address:1521 – dirección de su servidor de BD.
      7. DatabaseName=xe – nombre actual del servicio de red de la BD, contenido en tnsnames.ora.

Conclusión

Aunque el ejemplo anterior incluye detalles adicionales relacionados con la conexión e interacción con 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 de IIS y los grupos de aplicaciones de 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 el 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.