Sauvegarder et récupérer le référentiel EMC Documentum backing-up-and-recovering-the-emc-documentum-repository

Cette section décrit les tâches requises pour sauvegarder et récupérer le référentiel EMC Documentum configuré pour votre environnement AEM Forms.

NOTE
Ces instructions supposent qu’AEM Forms avec Connectors for ECM et EMC Documentum Content Server sont installés et configurés selon les besoins.

Pour les processus de sauvegarde et de restauration, deux tâches principales sont nécessaires :

  • Sauvegarde (ou restauration) de l’environnement AEM Forms.
  • Sauvegarde (ou restauration) d’EMC Documentum Content Server.
NOTE
Sauvegardez les données d’AEM Forms avant de sauvegarder le système EMC Documentum, puis restaurez le système EMC Documentum avant de restaurer l’environnement AEM Forms.

Configuration logicielle requise software-requirements

Pour effectuer les tâches de sauvegarde nécessaires sur EMC Documentum Content Server, achetez un utilitaire tiers approprié, tel qu’EMC NetWorker auprès d’EMC ou CYA SmartRecovery pour EMC Documentum auprès de CYA. Les instructions suivantes décrivent les étapes d’utilisation du module EMC NetWorker version 7.2.2.

Vous avez besoin des modules EMC NetWorker suivants :

  • Module NetWorker
  • Assistant de configuration NetWorker
  • Assistant de configuration de dispositif NetWorker
  • Module NetWorker pour le type de base de données utilisé par votre serveur de contenu
  • Module NetWorker pour Documentum

Préparation d’EMC Document Content Server pour la sauvegarde et la récupération preparing-the-emc-document-content-server-for-backup-and-recovery

Cette section décrit l’installation et la configuration du logiciel EMC NetWorker sur le serveur de contenu.

Préparation du serveur EMC Documentum pour la sauvegarde

  1. Installez les modules EMC NetWorker sur EMC Documentum Content Server, en acceptant tous les paramètres par défaut.

    Au cours des processus d’installation, il vous est demandé de saisir le nom du serveur de l’ordinateur Content Server en tant que Nom du serveur NetWorker. Lors de l’installation du module EMC NetWorker pour votre base de données, sélectionnez une installation « complète ».

  2. En utilisant l’exemple de contenu ci-dessous, créez un fichier de configuration nommé nsrnmd_win.cfg et enregistrez-le à un emplacement accessible sur le serveur de contenu. Ce fichier sera appelé par les instructions de sauvegarde et de restauration.

    Le texte suivant contient des caractères de mise en forme pour les sauts de ligne. Si vous copiez ce texte en dehors de ce document, copiez-en une partie après l’autre, puis supprimez les caractères de mise en forme dans le nouvel emplacement.

    code language-shell
     ################################################
     # NetWorker Module for Documentum v1.2 nsrnmd_win.cfg D5.3+ example with
     # typical set of working parameters.  THIS FILE MUST BE SITE-CUSTOMISED.
     #
     # Parameters not shown can be set in this file (as per site customisation) #or from the command-line.
     #
     # See the user Guides for details on all parameters, including
     # those not listed below.
     # Note: DCTM environment for D6 is slightly different from D5, refer to D6
     # Installation Guide to update the values.
     ################################################
     #Can get values for most of below from doing as the dctm inst owner: cmd> set DOCUMENTUM=C:\Documentum
     DM_HOME=C:\Documentum\product\6.0
     JAVA_HOME=C:\Progra~1\Documentum\java\1.5.0_12
     JAVA_PATH=C:\Progra~1\Documentum\java\1.5.0_12\bin
     PATH=C:\WINNT\system32;C:\WINNT;C:\WINNT\system32\WBEM;C:\Documentum\product\6.0\bin;C:\Documentum\fulltext\fast;C:\Documentum\product\6.0\fusion;C:\Program Files\Documentum\Shared;C:\Program Files\Legato\nsr\bin;C:\Program Files\Microsoft SQL Server\80\Tools\Binn;C:\Program Files\Microsoft SQL Server\90\DTS\Binn\;C:\Program Files\Microsoft SQL Server\90\Tools\binn;C:\Program Files\Microsoft SQL Server\90\Tools\Binn\VSShell\Common7\IDE;C:\Program Files\Documentum\java\1.5.0_12\bin;C:\Documentum\config;C:\Documentum
     #See also manifest dctm.jar file for class path locations
     CLASSPATH=.;C:\Program Files\Legato\nsr\bin;C:\Program Files\Legato\nsr\bin\nsrnmdde.jar;C:\Program Files\Documentum\java\1.5.0_12\lib\tools.jar;C:\Program Files\Documentum\Shared\dfc.jar;C:\Program Files\Documentum\Shared\aspectjrt.jar;C:\Program Files\Documentum\dctm.jar;C:\Program Files\Documentum\Shared\workflow.jar;C:\Program Files\Documentum\Shared\log4j.jar;C:\Program Files\Documentum\java\1.5.0_12\lib\dt.jar;C:\Documentum\config
    
     ################################################
     #If not using nsrnmdsv -m ALL|DB|DB_LOG|FTI|FTI_ALL|ICF|SA|SA_ALL, set #for backup
     NMD_SCOPE=ALL
     #Mandatory when scope (backup or restore) is FTI/SA without -a option
     #NMD_OBJECT_NAME=filestore_01
     ################################################
     NMDDE_DM_DOCBASE=Docbase
     NMDDE_DM_USER=Administrator
     #NMDDE_DM_PASSWD must be set via running: nsrnmdsv -f <nmdcfg> -P <pwd>.
     ################################################
     #DB related hooks to invoke arbitrary scripts:
     #Set if DB is on a remote host
     #NMD_DB_HOST=dbhost
     #Pure basename implies remote host execution; absolute path ... local
     #execution as in NMD v1.0.
     #
     #Remote execution requires script be put in remote nsrexecd bin directory
     #and D5.3+ host be added to remote nsr\res\servers file w/ nsrexecd recycled
     #
     #Refer to user Guides for sample script code.
     NMD_DB_FULL_BACKUP_CMD=C:\DocumentumBackup\Scripts\nsrnmddbf.bat
     NMD_DB_LOG_BACKUP_CMD=C:\DocumentumBackup\Scripts\nsrnmddbl.bat
     NMD_DB_INCR_BACKUP_CMD=C:\DocumentumBackup\Scripts\nsrnmddbi.bat
     ################################################
     #For D5.3+ only: NMD_FTI_INCLUDED, NMD_FTI_HOST, NMD_FTI_USER,
     #NMD_FTI_PASSWD & NMD_FTI_SUBDIRS.
     #Optional for remote D5.3+ FTI server
     NMD_FTI_INCLUDED=no
     #NMD_FTI_HOST=ftihost
     #Recommended for D5.3+ FTI server quiesce/unquiesce
     #NMD_FTI_USER=ftiadmin
     #The index name: optional for D5.3+ FTI server, used with -M FTI_ALL or
     #-M ALL
     #NMD_FTI_NAME=rep_name_ftindex_01
     #Recommended for D5.3+ FTI server quiesce/unquiesce
     #NMDDE_FTI_PASSWD must be set via running: nsrnmdsv -f <nmdcfg> -P <pwd>
     #-M FTI.
     #Pure basename implies remote host execution; absolute path ... local execution
     #as in NMD v1.0.
     #
     #Remote execution requires script be put in remote nsrexecd bin directory
     #and D5.3+ host be added to remote nsr\res\servers file w/ nsrexecd
     #recycled.
     #
     #See example nsrnmdfti*.bat examples.
     #
     #Mandatory for D5.3+
     #NMD_BACKUP_FTI_QUIESCE=nsrnmdftiq.bat
     #NMD_BACKUP_FTI_UNQUIESCE=nsrnmdftiu.bat
     #Used for D5.3+ to get InstallProfile.xml FTI file in multinode
     #discovery.
     #Optional, if not specified, will treat as single-node FTI.
     #NMD_FTI_GET_INSTPROF=nsrnmdfti_instprof.bat
     #Mandatory for D5.3+. No spaces in paths or around comma separators.
     #For remote FTI, paths must be valid at the FTI host.
     #NMD_FTI_SUBDIRS=F:\Documentum_idx\data\fulltext\fixml,F:\Documentum_idx
     #\data\fulltext\index
     ################################################
     #Mandatory. No spaces in paths or before comma
     #separators in NMD_ICF_SUBDIRS_xxx:
     #NMD_ICF_INCLUDED=yes
     #NMD_ICF_SUBDIRS=C:\Documentum\dba,C:\Documentum\product\5.3
     ################################################
     NMD_FILEREPORT_INCLUDED=yes
     NMDDE_METADATA_OUTPUT_DEST=C:\docbase_freports\
     ################################################
     #Other misc recommended NMD_xxx parameters
     #Recommended to get more meaningful saveset names
     NMD_USE_DEFAULT_SAVESET_NAMES=yes
     #Use following to skip unwanted ICF, FTI and non-SnapImage SA dirs/files.
     #For example, "<</>> +skip: dm_ftwork_dir" line will skip non-data
     #files.
     #
     #The path will be the same and must exist on D5.3+, remote FTI host, and
     #RCS hosts correspondingly if used.
     #NMD_DIRECTIVES_FILE=E:\Program Files\Legato\nsr\res\nsrnmddirectives.txt
     #For non-SnapImage SA backup
     #NMD_SA_FULL_NUM_SAVESET=16
     #NMD_SA_INCR_NUM_SAVESET=4
     #NMD_USE_SNAPIMAGE=yes
     ################################################
     # DSA setup
     ################################################
     # Name of the config file at the remote sites;
     # Mandatory, listed in the config file at the primary host.
     # (if skipped, backup is treated as local)
     # NMD_RCS_CFG_FILE=rep_name_rcs.cfg
    
     # SA-host mapping add, optional, will override far-store list info.
     # No space around comma.
     # NMD_HOST_SAS_MAP=host01,sa_01,sa_02
     # NMD_HOST_SAS_MAP=host02,sa_03
     ################################################
     NSR_SERVER=con-dctm
     #NSR_CLIENT=d5svrhost
     NSR_GROUP=Default
     NSR_DATA_VOLUME_POOL=Default
     #NSR_SNAPIMAGE_DATA_VOLUME_POOL=Default
     #Relocation dir will be the same on D5+ and remote FTI/SA hosts.
     NSR_RELOCATION=C:\reloc
     #NSR_PARALLELISM=16
     NSR_DEBUG_FILE=C:\Program Files\Legato\nsr\applogs\nmd.log
     NSR_DEBUG_LEVEL=9
     ################################################
     NMDDE_DM_PASSWD=XAtup9pl
    

    Ne renseignez pas le champ du mot de passe du fichier de configuration NMDDE_DM_PASSWD. Vous définirez le mot de passe à l’étape suivante.

  3. Définissez le mot de passe du fichier de configuration comme suit :

    • Ouvrez une invite de commande, puis modifiez la valeur sur [NetWorker_root]\Legato\nsr\bin.
    • Exécutez la commande suivante : -nsrnmdsv.exe -f<path_to_cfg_file> -P <mot de passe>
  4. Créez les fichiers de commandes exécutables (.bat) utilisés pour sauvegarder la base de données. (Voir la documentation sur NetWorker.) Définissez les fichiers de commandes en fonction de votre installation.

    • Sauvegarde complète de la base de données (nsrnmddbf.bat) :

      NetWorker_database_module_root -s<Nom_Serveur_Networker> -U``[username] -P[mot de passe ]-l full<nom_base_de_données>

    • Sauvegarde incrémentielle de la base de données (nsrnmddbi.bat) :

      [NetWorker_database_module_root] -s<Nom_Serveur_Networker> -U``[username] -P``[password] -l 1 -R<nom_base_de_données>

    • Sauvegarde du journal de la base de données (nsrnmddbl.bat) :

      [NetWorker_database_module_root] -s``<NetWorker_Server_Name> -U``[username] -P``[password] -l incr -R<nom_base_de_données>

      Où :

      [NetWorker_database_module_root] est le répertoire d’installation du module NetWorker. Par exemple, le répertoire d’installation par défaut du module NetWorker pour SQL Server est C:\Program Files\Legato\nsr\bin\nsrsqlsv.

      NetWorker_Server_Name est le serveur sur lequel NetWorker est installé.

      username et password sont le nom d’utilisateur et le mot de passe de l’administrateur de la base de données.

      database_name est le nom de la base de données à sauvegarder.

Création d’un périphérique de sauvegarde

  1. Créez un répertoire sur le serveur EMC Documentum et partagez le dossier en accordant des droits complets à tous les utilisateurs et toutes les utilisatrices.

  2. Démarrez EMC NetWorker Administrator, puis cliquez sur Media Management > Devices.

  3. Cliquez avec le bouton droit de la souris sur Devices et sélectionnez Create.

  4. Saisissez les valeurs suivantes et cliquez sur OK :

    Nom : chemin d’accès complet au répertoire partagé

    Type de média : File

  5. Cliquez avec le bouton droit de la souris sur le nouveau périphérique, puis sélectionnez Operations.

  6. Cliquez sur Label, saisissez un nom, puis cliquez sur Mount.

Un périphérique est ajouté sur lequel les fichiers sauvegardés seront enregistrés. Vous pouvez ajouter plusieurs périphériques de formats différents.

Sauvegarde d’EMC Documentum Content Server back-up-the-emc-documentum-content-server

Après avoir réalisé une sauvegarde complète des données AEM Forms, effectuez les tâches ci-après. (voir Sauvegarde des données AEM Forms).

NOTE
Les scripts de commande exigent que le chemin d’accès complet soit configuré sur le fichier nsrnmd_win.cfg créé dans la section Préparation d’EMC Document Content Server pour la sauvegarde et la récupération.
  1. Ouvrez une invite de commande, puis modifiez la valeur sur [NetWorker_root]\Legato\nsr\bin.

  2. Exécutez la commande suivante :

    code language-shell
     - nsrnmdsv.exe -f <path_to_cfg_file>
    

Restauration d’EMC Documentum Content Server restore-the-emc-documentum-content-server

Avant de restaurer les données AEM Forms, effectuez les tâches ci-après. (voir Récupération des données AEM Forms).

NOTE
Les scripts de commande exigent le chemin d’accès complet au fichier nsrnmd_win.cfg créé dans la section Préparation d’EMC Document Content Server pour la sauvegarde et la récupération.
  1. Arrêtez le service Docbase en cours de restauration.

  2. Démarrez l’utilitaire NetWorker User pour votre module de base de données (par exemple, NetWorker User pour SQL Server).

  3. Cliquez sur l’outil Restore, puis sélectionnez Normal.

  4. À gauche de l’écran, sélectionnez la base de données correspondant à votre Docbase, puis cliquez sur le bouton Démarrer de la barre d’outils.

  5. Lorsque la base de données est restaurée, redémarrez le service Docbase.

  6. Ouvrez une invite de commande, puis saisissez [racine_NetWorker]\Legato\nsr\bin

  7. Exécutez la commande suivante :

    code language-shell
     - nsrnmdrs.exe -B <docbase_name> -f <path_to_cfg_file> -C SA
    
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2