DocumentatieAEM 6.4Gids voor formulieren

AEM Forms for Backup voorbereiden

Laatst bijgewerkt: 4 mei 2023

Gemaakt voor:

  • Developer
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Over de service Back-up en herstel

Met de service Back-up en Herstellen kunt u AEM Forms in back-upmodus, waardoor hot back-ups kunnen worden uitgevoerd. De service Back-up en herstel voert geen back-up van AEM Forms uit of herstelt uw systeem niet. In plaats daarvan wordt de server in een status gezet voor consistente en betrouwbare back-ups, terwijl de server verder kan worden uitgevoerd. U bent verantwoordelijk voor de acties om een back-up te maken van de Global Document Storage (GDS) en de database die is verbonden met de formulierserver. De GDS is een map waarin bestanden worden opgeslagen die worden gebruikt in een langlevend proces.

De back-upmodus is een toestand die de server invoert zodat bestanden in de GDS niet worden gewist terwijl een back-upprocedure plaatsvindt. In plaats daarvan worden submappen gemaakt onder de GDS-map om een record bij te houden van bestanden die moeten worden gewist nadat de back-upmodus is beëindigd. Een bestand is bedoeld om het systeem opnieuw te laten opstarten en kan dagen, of zelfs jaren, beslaan. Deze bestanden vormen een essentieel onderdeel van de algemene status van de formulierserver en kunnen PDF-bestanden, beleidsregels of formuliersjablonen bevatten. Als een van deze bestanden verloren gaat of beschadigd raakt, kunnen de processen op de formulierserver instabiel worden en kunnen er gegevens verloren gaan.

U kunt ervoor kiezen back-ups van momentopnamen uit te voeren, waarbij u doorgaans de back-upmodus gedurende een periode start en vervolgens de back-upmodus verlaat nadat u de back-upactiviteiten hebt voltooid. Het verlaten van reservewijze wordt vereist zodat de dossiers van GDS kunnen worden gezuiverd om ervoor te zorgen dat het niet onnodig groot groeit. U kunt of reservewijze uitdrukkelijk verlaten of op de tijd wachten om op een reservewijzesessie te verlopen.

U kunt de server ook in de modus voor onbeperkte back-up laten. Dit is standaard het geval bij back-upstrategieën voor rolback-ups of continue systeemdekking. Rolling backup mode wijst erop dat het systeem altijd in reservewijze is, met een nieuwe reservewijzesessie die wordt geïnitieerd zodra de vorige zitting wordt vrijgegeven. In de modus voor continue back-up wordt een bestand na twee back-upmodussessies gewist en wordt er niet langer naar verwezen.

Met de service Back-up en herstel kunt u bestaande of nieuwe toepassingen uitbreiden die u maakt om back-ups te maken van de GDS of database die is verbonden met de formulierserver.

NOTE
Net als bij elk ander aspect van uw AEM Forms-implementatie, moet uw back-up- en herstelstrategie worden ontwikkeld en getest in een ontwikkelings- of testomgeving voordat deze in de productie wordt gebruikt om ervoor te zorgen dat de volledige oplossing werkt zoals u had verwacht zonder gegevensverlies.

U kunt deze taken uitvoeren met behulp van de service Back-up en herstel:

  • Ga reservewijze in.
  • Laat de back-upmodus staan.
NOTE
Ga voor meer informatie over wat u moet overwegen wanneer u back-ups maakt voor AEM Forms naar administratie Help.
NOTE
Ga voor meer informatie over de service Back-up en herstel naar Services Reference for AEM Forms.

Back-upmodus invoeren op de formulierserver

U gaat reservewijze in om voor hete steunen van een vormenserver toe te staan. Als u de back-upmodus activeert, geeft u de volgende informatie op op basis van de back-upprocedures van uw organisatie:

  • Een uniek label om de back-upmodussessie te identificeren die nuttig kan zijn voor uw back-upprocessen.
  • De tijd voor de reserveprocedure om te voltooien.
  • Een vlag om erop te wijzen of om op ononderbroken reservewijze te zijn, die slechts nuttig is als u het rollen steunen uitvoert.

Voordat u toepassingen gaat schrijven om de back-upmodus te activeren, is het raadzaam de back-upprocedures te begrijpen die worden gebruikt nadat u de formulierserver in de back-upmodus hebt gezet. Ga voor meer informatie over wat u moet overwegen wanneer u back-ups maakt voor AEM Forms naar administratie Help.

NOTE
Ga voor meer informatie over de service Back-up en herstel naar Services Reference for AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om een toepassing te maken die de back-upmodus activeert:

  1. Inclusief projectbestanden.
  2. Maak een BackupService-clientobject.
  3. Bepaal een uniek etiket, de hoeveelheid tijd om de steun uit te voeren, en of om op ononderbroken reservewijze te zijn.
  4. Ga reservewijze in.
  5. (Optioneel) Haal informatie op over de back-upmodussessie op de server.
  6. Maak een back-up van de GDS (Global Data Store) en de database.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Deze bestanden zijn belangrijk om in uw project op te nemen voor het correct compileren van uw code en het gebruik van de API voor back-up- en herstelservice.

Voor informatie over de locatie van deze bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een BackupService Client API-object maken

Als u de back-upmodus programmatisch wilt verlaten, maakt u een BackupService-clientobject om de API voor back-up en herstel te gebruiken.

Beslissen op een uniek etiket, bepalen de hoeveelheid tijd om de steun uit te voeren, en beslissen of om op ononderbroken reservewijze te zijn

Voordat u de back-upmodus activeert, moet u een uniek label kiezen, bepalen hoeveel tijd u wilt toewijzen om de back-up uit te voeren en bepalen of de formulierserver in de back-upmodus moet blijven. Deze overwegingen zijn belangrijk om met de reserveprocedures te integreren die door uw organisatie worden gevestigd. (Zie administratie Help.)

Back-upmodus openen

Ga reservewijze met de parameters in die met de reserveprocedures bij uw organisatie verenigbaar zijn.

Informatie ophalen over de back-upmodussessie op de server

Nadat u de back-upmodus hebt geactiveerd, kunt u informatie over de sessie ophalen. Deze informatie kan worden gebruikt om met uw reserveprocedures te integreren

Maak een back-up van de GDS en de database

Nadat u de back-upmodus hebt geactiveerd, kunt u een back-up maken van de GDS (Global Document Storage) en de database waarmee de formulierserver is verbonden. Deze stap is specifiek voor uw organisatie, aangezien u deze stap manueel kunt uitvoeren of u andere hulpmiddelen kunt in werking stellen om de reserveprocedure uit te voeren.

Back-upmodus starten met de Java API

Voer de back-upmodus in met de API voor back-up- en herstelservice:

  1. Projectbestanden opnemen

    Neem de benodigde client-JAR-bestanden op, zoals adobe-backup-restore-client-sdk.jar, in het klassenpad van uw Java-project. Als u de Java-clienttoepassing wilt maken, moeten de volgende JAR-bestanden worden toegevoegd aan het klassepad van uw project:

    • adobe-backup-restore-client-sdk.jar
    • adobe-livecycle-client.jar
    • adobe-usermanager-client.jar
    • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
    • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

  2. Een BackupService Client API-object maken

    U gebruikt een ServiceClientFactory -object en het BackupService client-API-object samen.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.)
    • Een BackupService object door de constructor ervan te gebruiken en door te geven ServiceClientFactory object.

  3. Beslissen op een uniek etiket, bepalen de hoeveelheid tijd om de steun uit te voeren, en beslissen of om op ononderbroken reservewijze te zijn

    Bepaal de hoeveelheid tijd die u wilt toewijzen om de back-up uit te voeren en bepaal of de formulierserver in de continue back-upmodus moet blijven.

  4. Back-upmodus openen

    Ga reservewijze door aan te halen binnen enterBackupMode methode met de volgende parameters:

    • A String waarde die een uniek, leesbaar label opgeeft dat de back-upmodussessie identificeert. U wordt aangeraden geen spaties of tekens te gebruiken die niet in XML-indeling kunnen worden gecodeerd.

    • An int waarde die het aantal minuten aangeeft dat moet worden bewaard in de back-upmodus. U kunt een waarde opgeven vanuit 1 tot 10080 (het aantal minuten in een week). Deze waarde wordt genegeerd bij gebruik van de modus voor continue back-up.

    • A Boolean waarde die aangeeft of de modus voor continue back-up moet worden geactiveerd. Een waarde van True geeft aan dat de modus voor continue back-up moet worden geactiveerd. In de modus voor continue back-up wordt de waarde die u opgeeft voor het aantal minuten dat u in de back-upmodus wilt blijven, genegeerd.

      In de modus Continue back-up wordt een nieuwe back-upmodus gestart nadat de huidige sessie is voltooid. Een waarde van False betekent dat de continue back-upmodus niet wordt gebruikt en dat, nadat de back-upmodus is verlaten, de bestanden uit de GDS opnieuw worden gezuiverd.

  5. Informatie ophalen over de back-upmodussessie op de server

    Gegevens ophalen met de opdracht BackupModeEntryResult object dat wordt geretourneerd nadat het object is aangeroepen enterBackupMode methode. De informatie die u kunt terugwinnen nadat u reservewijze ingaat kan nuttig zijn om met uw reserveprocedures te integreren. Het label, de back-up-id en de begintijd kunnen bijvoorbeeld handig zijn als invoer voor bestandsnamen voor de back-upprocedure.

  6. Maak een back-up van de GDS en de database

    Maak een back-up van de GDS (Global Document Storage) en de database waarmee de formulierserver is verbonden. De acties om de back-up uit te voeren maken geen deel uit van de SDK van AEM Forms en kunnen zelfs handmatige stappen bevatten die specifiek zijn voor de back-upprocedures in uw organisatie.

Back-upmodus starten met de webservice-API

Voer de back-upmodus in met behulp van de webservice van de API voor back-up en herstel:

  1. Projectbestanden opnemen

    • Creeer een Microsoft .NET cliëntassemblage die de Reserve en Terugzetdienst API WSDL verbruikt.
    • Verwijs naar de Microsoft .NET cliëntassemblage.

  2. Een BackupService Client API-object maken

    Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een BackupServiceService object door de standaardconstructor aan te roepen en de referenties op te geven met de Credentials methode.

  3. Beslissen op een uniek etiket, bepalen de hoeveelheid tijd om de steun uit te voeren, en beslissen of om op ononderbroken reservewijze te zijn

    Bepaal de hoeveelheid tijd die u wilt toewijzen om de back-up uit te voeren en bepaal of de formulierserver in de continue back-upmodus moet blijven.

  4. Back-upmodus openen

    Als u de back-upmodus wilt inschakelen, roept u de methode enterBackupMode aan en geeft u de volgende waarden door:

    • A String waarde die een uniek, leesbaar label opgeeft dat de back-upmodussessie identificeert. U wordt aangeraden geen spaties of tekens te gebruiken die niet in XML-indeling kunnen worden gecodeerd.

    • A Uint32 waarde die het aantal minuten aangeeft dat moet worden bewaard in de back-upmodus. U kunt een waarde opgeven vanuit 1 tot 10080 (aantal minuten in één week). Deze waarde wordt genegeerd bij gebruik van de modus voor continue back-up.

    • A Boolean waarde die aangeeft of de modus voor continue back-up moet worden geactiveerd. Een waarde van True geeft aan dat de modus voor continue back-up moet worden geactiveerd. In de modus voor continue back-up wordt de waarde die u opgeeft voor het aantal minuten dat u in de back-upmodus wilt blijven, genegeerd. In de modus Continue back-up wordt een nieuwe back-upmodus gestart nadat de huidige sessie is voltooid.

      Een waarde van False betekent dat de continue back-upmodus niet wordt gebruikt en dat, nadat de back-upmodus is verlaten, de bestanden uit de GDS opnieuw worden gezuiverd.

  5. Informatie ophalen over de back-upmodussessie op de server

    Haal informatie op over de back-upmodussessie nadat u de enterBackupMode-methode hebt aangeroepen vanuit de BackupModeEntryResult die is geretourneerd om te controleren of deze is gelukt. De informatie die u kunt terugwinnen nadat u reservewijze ingaat kan nuttig zijn om met uw reserveprocedures te integreren. Het label, de back-up-id en de begintijd kunnen bijvoorbeeld handig zijn als invoer voor bestandsnamen voor de back-upprocedure.

  6. Maak een back-up van de GDS en de database

    Maak een back-up van de GDS (Global Document Storage) en de database waarmee de formulierserver is verbonden. De acties om de back-up uit te voeren maken geen deel uit van de SDK van AEM Forms en kunnen zelfs handmatige stappen bevatten die specifiek zijn voor de back-upprocedures in uw organisatie.

Back-upmodus op de formulierserver laten staan

U verlaat de back-upmodus, zodat de formulierserver bestanden hervat van de GDS (Global Document Storage) op de formulierserver.

Voordat u toepassingen schrijft om in de modus Verlaten te gaan, is het raadzaam de back-upprocedures te begrijpen die bij AEM Forms worden gebruikt. Ga voor meer informatie over wat u moet overwegen wanneer u back-ups maakt voor AEM Forms naar administratie Help.

NOTE
Ga voor meer informatie over de service Back-up en herstel naar Services Reference for AEM Forms.

Overzicht van de stappen

Voer de volgende stappen uit om de back-upmodus te verlaten:

  1. Inclusief projectbestanden.
  2. Maak een BackupService-clientobject.
  3. Laat de back-upmodus staan.
  4. (Optioneel) Haal informatie op over de back-upmodussessie die op de formulierserver werd uitgevoerd.

Projectbestanden opnemen

Neem alle benodigde bestanden op in uw ontwikkelingsproject. Deze bestanden zijn belangrijk voor het correct compileren van uw code en het gebruik van de API voor back-up- en herstelservice.

Voor informatie over de locatie van deze bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een BackupService Client API-object maken

Als u de back-upmodus programmatisch wilt verlaten, maakt u een BackupService-clientobject om de API voor back-up en herstel te gebruiken.

Back-upmodus verlaten

Laat de back-upmodus ingeschakeld om bestanden van de Global Document Storage (GDS) weer op de normale manier te wissen. Voordat u de back-upmodus verlaat, moet u controleren of de back-upprocedures zijn voltooid.

Informatie ophalen over de sessie in de back-upmodus die is beëindigd

Nadat u de back-upmodus hebt verlaten, kunt u informatie over de sessie ophalen. Deze informatie kan worden gebruikt om met uw reserveprocedures te integreren.

Back-upmodus verlaten met de Java API

Maak een back-upmodus met de API voor back-up en herstel (Java):

  1. Projectbestanden opnemen

    Neem de benodigde client-JAR-bestanden op, zoals adobe-backup-restore-client-sdk.jar, in het klassenpad van uw Java-project. Als u een Java-clienttoepassing wilt maken, moeten de volgende JAR-bestanden worden toegevoegd aan het klassepad van uw project:

    • adobe-backup-restore-client-sdk.jar
    • adobe-livecycle-client.jar
    • adobe-usermanager-client.jar
    • adobe-utilities.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)
    • jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss Application Server)

  2. Een BackupService Client API-object maken

    U gebruikt een ServiceClientFactory -object en het BackupService client-API-object samen.

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat. (Zie Verbindingseigenschappen instellen.)
    • Een BackupService object door de constructor ervan te gebruiken en door te geven ServiceClientFactory object als parameter.

  3. Back-upmodus openen

    De back-upmodus verlaten door de leaveBackupMode methode.

  4. Informatie ophalen over de back-upmodussessie op de server

    Hiermee wordt informatie over de bewerking opgehaald met de opdracht BackupModeResult object dat wordt geretourneerd. De informatie die u kunt terugwinnen nadat u reservewijze ingaat kan nuttig zijn om met uw reserveprocedures te integreren. Het label, de back-up-id en de begintijd kunnen bijvoorbeeld handig zijn als invoer voor bestandsnamen voor de back-upprocedure.

Back-upmodus verlaten met de webservice-API

Maak een back-upmodus met de API voor back-up en herstel (webservice):

  1. Projectbestanden opnemen

    Als u webservices wilt gebruiken, moet u ervoor zorgen dat u de proxybestanden opneemt. Voer de volgende stappen uit om uw project te configureren voor het gebruik van de API voor back-up en herstel als webservice.

    • Creeer een Microsoft .NET cliëntassemblage die de Reserve en Terugzetdienst API WSDL verbruikt.
    • Verwijs naar de Microsoft .NET cliëntassemblage.

  2. Een BackupService Client API-object maken

    Gebruikend de de cliëntassemblage van Microsoft .NET, creeer een BackupServiceService object door de standaardconstructor aan te roepen.

  3. Back-upmodus openen

    De back-upmodus verlaten door de leaveBackupMode bewerking met webservices.

  4. Informatie ophalen over de back-upmodussessie op de server

    Haal de id van de back-upmodus na de bewerking op om te controleren of deze is gelukt. De informatie die u kunt terugwinnen nadat u reservewijze verlaat kan nuttig zijn om met uw reserveprocedures te integreren.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da