AEM Forms for Backup voorbereiden

Laatst bijgewerkt: 14 juli 2024
  • Van toepassing op:
  • Experience Manager 6.5
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

de Steekproeven en de voorbeelden in dit document zijn slechts voor AEM Forms op milieu JEE.

Over de service Back-up en herstel

De reserve en herstelt dienst laat u AEM Forms in reservewijze zetten, die hete steunen toelaat 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 Forms Server. 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 Forms Server en kunnen PDF-bestanden, beleidsregels of formuliersjablonen bevatten. Als een van deze bestanden verloren gaat of beschadigd raakt, kunnen de processen op de Forms-server instabiel worden en kunnen 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 voor het maken van back-ups van de GDS of database die op de Forms-server is aangesloten.

OPMERKING
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.
OPMERKING
Voor meer informatie over wat te overwegen wanneer het uitvoeren van steunen voor AEM Forms, zie beleidshulp.
OPMERKING
Voor meer informatie over de Steun en herstelt dienst, zie Verwijzing van de Diensten voor AEM Forms.

Back-upmodus activeren op de Forms-server

U gaat reservewijze in om voor hete steunen van een Server van Forms toe te staan. Wanneer 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 in de back-upmodus te gaan, is het raadzaam de back-upprocedures te begrijpen die worden gebruikt nadat u de Forms-server in de back-upmodus hebt gezet. Voor meer informatie over wat te overwegen wanneer het uitvoeren van steunen voor AEM Forms, zie beleidshulp.

OPMERKING
Voor meer informatie over de Steun en herstelt dienst, zie Verwijzing van de Diensten voor 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.

omvat projectdossiers

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 plaats van deze dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.

creeer een voorwerp van de Cliënt BackupService API

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

besluit op een uniek etiket, bepaal de hoeveelheid tijd om de steun uit te voeren, en besluit 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 u de Forms-server in de back-upmodus wilt laten staan. Deze overwegingen zijn belangrijk om met de reserveprocedures te integreren die door uw organisatie worden gevestigd. (Zie beleidshulp.)

ga reservewijze binnen

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

wint informatie over de reservewijzeszitting op de server terug

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

voer de steun van GDS en gegevensbestand uit

Nadat u met succes de reservewijze ingaat, kunt u een steun van de Globale Opslag van het Document (GDS) en het gegevensbestand uitvoeren dat de Server van Forms met wordt 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.

    • Maak een ServiceClientFactory -object dat verbindingseigenschappen bevat. (Zie Plaatsende verbindingseigenschappen.)
    • Maak een BackupService -object door de constructor ervan te gebruiken en het ServiceClientFactory -object door te geven.

  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

    Beslis op een uniek etiket, bepaal de hoeveelheid tijd die u wilt toewijzen om de steun uit te voeren, en besluit of u de Server van Forms op ononderbroken reservewijze wilt blijven.

  4. Back-upmodus openen

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

    • Een 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.

    • Een int -waarde die aangeeft hoeveel minuten er in de back-upmodus moeten blijven. U kunt een waarde tussen 1 en 10080 opgeven (het aantal minuten in een week). Deze waarde wordt genegeerd bij gebruik van de modus voor continue back-up.

    • Een Boolean -waarde die aangeeft of de modus voor continue back-up moet worden geactiveerd. De waarde 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. De waarde False houdt in dat de modus voor continue back-up niet wordt gebruikt en dat na het verlaten van de back-upmodus het wissen van bestanden uit de GDS wordt hervat.

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

    Haal informatie op met het object BackupModeEntryResult dat wordt geretourneerd nadat de methode enterBackupMode is aangeroepen. 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 Global Document Storage (GDS) en de database waarmee uw Forms Server 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 Microsoft .NET cliëntassemblage, creeer een BackupServiceService voorwerp door zijn standaardaannemer aan te halen en de geloofsbrieven te specificeren gebruikend 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

    Beslis op een uniek etiket, bepaal de hoeveelheid tijd die u wilt toewijzen om de steun uit te voeren, en besluit of u de Server van Forms op ononderbroken reservewijze wilt 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:

    • Een 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.

    • Een Uint32 -waarde die het aantal minuten aangeeft dat nodig is om in de back-upmodus te blijven. U kunt een waarde tussen 1 en 10080 (aantal minuten in een week) opgeven. Deze waarde wordt genegeerd bij gebruik van de modus voor continue back-up.

    • Een Boolean -waarde die aangeeft of de modus voor continue back-up moet worden geactiveerd. De waarde 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.

      De waarde False houdt in dat de modus voor continue back-up niet wordt gebruikt en dat na het verlaten van de back-upmodus het wissen van bestanden uit de GDS wordt hervat.

  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 Global Document Storage (GDS) en de database waarmee uw Forms Server 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 Forms-server laten staan

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

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. Voor meer informatie over wat te overwegen wanneer het uitvoeren van steunen voor AEM Forms, zie beleidshulp.

OPMERKING
Voor meer informatie over de Steun en herstelt dienst, zie Verwijzing van de Diensten voor 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 Forms-server werd uitgevoerd.

omvat projectdossiers

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 plaats van deze dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.

creeer een voorwerp van de Cliënt BackupService API

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

Van het verlaten reservewijze

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.

wint informatie over de reservewijzeszitting terug die beëindigde

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.

    • Maak een ServiceClientFactory -object dat verbindingseigenschappen bevat. (Zie Plaatsende verbindingseigenschappen.)
    • Maak een BackupService -object door de constructor ervan te gebruiken en het ServiceClientFactory -object als parameter door te geven.

  3. Back-upmodus openen

    Maak een back-upmodus door de methode leaveBackupMode aan te roepen.

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

    Haal informatie op over de bewerking met het geretourneerde object BackupModeResult . 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.