Introducción del modo de copia de seguridad en Forms Server
Se entra en modo de copia de seguridad para permitir copias de seguridad en caliente de un servidor de Forms. Al entrar en el modo de copia de seguridad, debe especificar la siguiente información en función de los procedimientos de copia de seguridad de su organización:
- Una etiqueta única para identificar la sesión del modo de copia de seguridad que puede ser útil para los procesos de copia de seguridad.
- Hora a la que se completó el procedimiento de copia de seguridad.
- Un indicador que indica si se debe estar en modo de copia de seguridad continua, lo que resulta útil solo si se realizan copias de seguridad móviles.
Antes de escribir aplicaciones para entrar en modo de copia de seguridad, se recomienda que comprenda los procedimientos de copia de seguridad que se utilizan después de poner el servidor de Forms en modo de copia de seguridad. Para obtener más información acerca de qué considerar al realizar copias de seguridad para AEM Forms, consulte ayuda de administración.
Resumen de los pasos
Para crear una aplicación que entre en modo de copia de seguridad, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de cliente BackupService.
- Determine una etiqueta única, la cantidad de tiempo para realizar la copia de seguridad y si debe estar en modo de copia de seguridad continua.
- Entrar en modo de copia de seguridad.
- (Opcional) Recupere información sobre la sesión del modo de copia de seguridad en el servidor.
- Realizar la copia de seguridad del GDS (almacén de datos global) y de la base de datos.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Es importante incluir estos archivos en el proyecto para compilar el código correctamente y utilizar la API del servicio de copia de seguridad y restauración.
Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de API de cliente de BackupService
Para salir del modo de copia de seguridad mediante programación, cree un objeto de cliente BackupService para utilizar la API del servicio de copia de seguridad y restauración.
Decida una etiqueta única, determine la cantidad de tiempo para realizar la copia de seguridad y decida si desea estar en modo de copia de seguridad continua
Antes de entrar en el modo de copia de seguridad, debe decidir una etiqueta única, determinar la cantidad de tiempo que desea asignar para realizar la copia de seguridad y decidir si desea que el servidor de Forms permanezca en modo de copia de seguridad. Estas consideraciones son importantes para integrarlas con los procedimientos de copia de seguridad establecidos por su organización. (Consulte ayuda de administración.)
Ingresar al modo de copia de seguridad
Introduzca el modo de copia de seguridad con los parámetros que son coherentes con los procedimientos de copia de seguridad de su organización.
Recuperar información sobre la sesión del modo de copia de seguridad en el servidor
Después de entrar en el modo de copia de seguridad, puede recuperar información sobre la sesión. Esta información se puede utilizar para integrarla con los procedimientos de copia de seguridad
Realizar la copia de seguridad del GDS y de la base de datos
Después de entrar correctamente en el modo de copia de seguridad, puede realizar una copia de seguridad de Global Document Storage (GDS) y de la base de datos a la que está conectado el servidor de Forms. Este paso es específico de su organización, ya que puede realizarlo manualmente o ejecutar otras herramientas para realizar el procedimiento de copia de seguridad.
Acceder al modo de copia de seguridad mediante la API de Java
Inicie el modo de copia de seguridad mediante la API del servicio de copia de seguridad y restauración:
-
Incluir archivos de proyecto
Incluya los archivos JAR de cliente necesarios, como adobe-backup-restore-client-sdk.jar, en la ruta de clase del proyecto Java. Para crear la aplicación cliente Java, se deben agregar los siguientes archivos JAR a la ruta de clase del proyecto:
- adobe-backup-restore-client-sdk.jar
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
- jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
-
Crear un objeto de API de cliente de BackupService
Utiliza un objeto
ServiceClientFactory
y el objeto API de cliente BackupService juntos.- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. (Consulte Establecimiento de propiedades de conexión.) - Cree un objeto
BackupService
utilizando su constructor y pasando el objetoServiceClientFactory
.
- Cree un objeto
-
Decida una etiqueta única, determine la cantidad de tiempo para realizar la copia de seguridad y decida si desea estar en modo de copia de seguridad continua
Decida una etiqueta única, determine la cantidad de tiempo que desea asignar para realizar la copia de seguridad y decida si desea que el servidor de Forms permanezca en modo de copia de seguridad continua.
-
Entrar en modo de copia de seguridad
Especifique el modo de copia de seguridad invocando el método
enterBackupMode
con los parámetros siguientes:-
Valor de
String
que especifica una etiqueta única legible en lenguaje natural que identifica la sesión del modo de copia de seguridad. Se recomienda no utilizar espacios ni caracteres que no se puedan codificar en formato XML. -
Valor de
int
que especifica el número de minutos que se mantendrán en el modo de copia de seguridad. Puede especificar un valor de1
a10080
(la cantidad de minutos en una semana). Este valor se omite al utilizar el modo de copia de seguridad continua. -
Valor de
Boolean
que especifica si se va a realizar una copia de seguridad continua. Un valor deTrue
especifica que está en modo de copia de seguridad continua. En el modo de copia de seguridad continua, se omite el valor especificado para el número de minutos que deben permanecer en el modo de copia de seguridad.El modo de copia de seguridad continua significa que se inicia una nueva sesión de modo de copia de seguridad después de que se complete la actual. Un valor de
False
significa que no se utiliza el modo de copia de seguridad continua y, después de salir del modo de copia de seguridad, se reanuda la depuración de archivos de GDS.
-
-
Recuperar información sobre la sesión del modo de copia de seguridad en el servidor
Recupere información utilizando el objeto
BackupModeEntryResult
devuelto después de invocar el métodoenterBackupMode
. La información que puede recuperar después de entrar en el modo de copia de seguridad puede ser útil para la integración con sus procedimientos de copia de seguridad. Por ejemplo, la etiqueta, el ID de copia de seguridad y la hora de inicio pueden ser útiles como entrada para los nombres de archivo del procedimiento de copia de seguridad. -
Realizar la copia de seguridad del GDS y la base de datos
Haga una copia de seguridad de Global Document Storage (GDS) y de la base de datos a la que está conectado Forms Server. Las acciones para realizar la copia de seguridad no forman parte del SDK de AEM Forms y pueden incluso incluir pasos manuales específicos de los procedimientos de copia de seguridad de su organización.
Acceder al modo de copia de seguridad mediante la API de servicio web
Inicie el modo de copia de seguridad mediante el servicio web proporcionado por la API del servicio de copia de seguridad y restauración:
-
Incluir archivos de proyecto
- Cree un ensamblado de cliente de Microsoft .NET que consuma el WSDL de la API del servicio de copia de seguridad y restauración.
- Hacer referencia al ensamblado de cliente de Microsoft .NET.
-
Crear un objeto de API de cliente de BackupService
Mediante el ensamblado de cliente de Microsoft .NET, cree un objeto
BackupServiceService
invocando su constructor predeterminado y especifique las credenciales mediante el métodoCredentials
. -
Decida una etiqueta única, determine la cantidad de tiempo para realizar la copia de seguridad y decida si desea estar en modo de copia de seguridad continua
Decida una etiqueta única, determine la cantidad de tiempo que desea asignar para realizar la copia de seguridad y decida si desea que el servidor de Forms permanezca en modo de copia de seguridad continua.
-
Entrar en modo de copia de seguridad
Para entrar en el modo de copia de seguridad, invoque el método enterBackupMode y pase los siguientes valores:
-
Valor de
String
que especifica una etiqueta única legible en lenguaje natural que identifica la sesión del modo de copia de seguridad. Se recomienda no utilizar espacios ni caracteres que no se puedan codificar en formato XML. -
Valor de
Uint32
que especifica el número de minutos que deben permanecer en el modo de copia de seguridad. Puede especificar un valor de1
a10080
(cantidad de minutos en una semana). Este valor se omite al utilizar el modo de copia de seguridad continua. -
Valor de
Boolean
que especifica si se va a realizar una copia de seguridad continua. Un valor deTrue
especifica que está en modo de copia de seguridad continua. En el modo de copia de seguridad continua, se omite el valor especificado para el número de minutos que deben permanecer en el modo de copia de seguridad. El modo de copia de seguridad continua significa que se inicia una nueva sesión de modo de copia de seguridad después de que se complete la actual.Un valor de
False
significa que no se utiliza el modo de copia de seguridad continua y, después de salir del modo de copia de seguridad, se reanuda la depuración de archivos de GDS.
-
-
Recuperar información sobre la sesión del modo de copia de seguridad en el servidor
Recupere información acerca de la sesión del modo de copia de seguridad después de invocar el método enterBackupMode desde BackupModeEntryResult que se devuelve para comprobar que se realizó correctamente. La información que puede recuperar después de entrar en el modo de copia de seguridad puede ser útil para la integración con sus procedimientos de copia de seguridad. Por ejemplo, la etiqueta, el ID de copia de seguridad y la hora de inicio pueden ser útiles como entrada para los nombres de archivo del procedimiento de copia de seguridad.
-
Realizar la copia de seguridad del GDS y la base de datos
Haga una copia de seguridad de Global Document Storage (GDS) y de la base de datos a la que está conectado Forms Server. Las acciones para realizar la copia de seguridad no forman parte del SDK de AEM Forms y pueden incluso incluir pasos manuales específicos de los procedimientos de copia de seguridad de su organización.
Dejar el modo de copia de seguridad en Forms Server
Se abandona el modo de copia de seguridad para que Forms Server reanude la depuración de archivos del GDS (Global Document Storage) en Forms Server.
Antes de escribir las aplicaciones para entrar en el modo de salida, se recomienda que comprenda los procedimientos de copia de seguridad que se utilizan con AEM Forms. Para obtener más información acerca de qué considerar al realizar copias de seguridad para AEM Forms, consulte ayuda de administración.
Resumen de los pasos
Para salir del modo de copia de seguridad, realice los siguientes pasos:
- Incluir archivos de proyecto.
- Cree un objeto de cliente BackupService.
- Dejar el modo de copia de seguridad.
- (Opcional) Recupere información sobre la sesión del modo de copia de seguridad que se estaba ejecutando en el servidor de Forms.
Incluir archivos de proyecto
Incluya todos los archivos necesarios en el proyecto de desarrollo. Estos archivos son importantes para compilar el código correctamente y utilizar la API del servicio de copia de seguridad y restauración.
Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Crear un objeto de API de cliente de BackupService
Para salir del modo de copia de seguridad mediante programación, cree un objeto de cliente BackupService para utilizar la API del servicio de copia de seguridad y restauración.
Dejar el modo de copia de seguridad
Deje el modo de copia de seguridad para reanudar la depuración normal de archivos del almacenamiento global de documentos (GDS). Antes de salir del modo de copia de seguridad, debe comprobar que se han completado los procedimientos de copia de seguridad.
Recuperar información sobre la sesión del modo de copia de seguridad que finalizó
Una vez que haya abandonado el modo de copia de seguridad, podrá recuperar información sobre la sesión. Esta información se puede utilizar para integrarla con los procedimientos de copia de seguridad.
Dejar el modo de copia de seguridad mediante la API de Java
Dejar el modo de copia de seguridad mediante la API del servicio de copia de seguridad y restauración (Java):
-
Incluir archivos de proyecto
Incluya los archivos JAR de cliente necesarios, como adobe-backup-restore-client-sdk.jar, en la ruta de clase del proyecto Java. Para crear una aplicación cliente Java, se deben añadir los siguientes archivos JAR a la ruta de clase del proyecto:
- adobe-backup-restore-client-sdk.jar
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
- jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
-
Crear un objeto de API de cliente de BackupService
Utiliza un objeto
ServiceClientFactory
y el objeto API de cliente BackupService juntos.- Cree un objeto
ServiceClientFactory
que contenga propiedades de conexión. (Consulte Establecimiento de propiedades de conexión.) - Cree un objeto
BackupService
utilizando su constructor y pasando el objetoServiceClientFactory
como parámetro.
- Cree un objeto
-
Entrar en modo de copia de seguridad
Salga del modo de copia de seguridad invocando el método
leaveBackupMode
. -
Recuperar información sobre la sesión del modo de copia de seguridad en el servidor
Recupere información sobre la operación utilizando el objeto
BackupModeResult
que se ha devuelto. La información que puede recuperar después de entrar en el modo de copia de seguridad puede ser útil para la integración con sus procedimientos de copia de seguridad. Por ejemplo, la etiqueta, el ID de copia de seguridad y la hora de inicio pueden ser útiles como entrada para los nombres de archivo del procedimiento de copia de seguridad.