Pakketbeheer

Pakketten maken het importeren en exporteren van inhoud in de opslagplaats mogelijk. U kunt pakketten gebruiken om nieuwe inhoud te installeren, nieuwe functionaliteit te installeren, inhoud over te brengen tussen instanties, en file bewaarplaats inhoud.

Met Package Manager kunt u pakketten overbrengen tussen uw AEM en uw lokale bestandssysteem voor ontwikkelingsdoeleinden.

Wat zijn pakketten?

Een pakket is een gecomprimeerd bestand met opslagplaats-inhoud in serialisatie van het bestandssysteem, zogenaamde vault serialization, waarmee bestanden en mappen eenvoudig kunnen worden weergegeven en bewerkt. Inhoud in het pakket wordt met filters gedefinieerd.

Een pakket bevat ook vault meta-informatie, met inbegrip van de filterdefinities en de informatie van de de invoerconfiguratie. Extra eigenschappen van inhoud, die niet worden gebruikt voor het uitpakken van pakketten, kunnen in het pakket worden opgenomen, zoals een beschrijving, een visuele afbeelding of een pictogram. Deze eigenschappen voor extra inhoud zijn alleen bedoeld voor de consument van het inhoudspakket en alleen ter informatie.

Pakketbeheer

Pakketbeheer beheert de pakketten op de AEM installatie. Nadat u toegewezen de noodzakelijke toestemmingen U kunt de Manager van het Pakket voor diverse acties gebruiken, met inbegrip van het vormen, het bouwen, het downloaden, en het installeren van uw pakketten.

Vereiste machtigingen

Gebruikers moeten over de juiste machtigingen voor het maken, wijzigen, uploaden en installeren van pakketten beschikken voor de volgende knooppunten:

• Volledige rechten behalve verwijderen op /etc/packages
• The node that contains the package contents

Pakketbeheer openen

U kunt tot de Manager van het Pakket op drie manieren toegang hebben:

1. Vanuit het AEM hoofdmenu -> Gereedschappen -> Implementatie -> Pakketten
2. Van CRXDE Lite de bovenste schakelbalk gebruiken
3. Direct door toegang te krijgen http://<host>:<port>/crx/packmgr/

Gebruikersinterface pakketbeheer

Pakketbeheer is verdeeld in vier belangrijke functionele gebieden:

• Deelvenster Linkernavigatie - In dit deelvenster kunt u de lijst met pakketten filteren en sorteren.
• Pakketlijst - Dit is de lijst van pakketten op uw instantie gefilterd en gesorteerd per selecties in het Linkerpaneel van de Navigatie.
• Activiteitenlogboek - Dit deelvenster wordt eerst geminimaliseerd en wordt uitgebreid om de activiteit van Package Manager nader te bepalen, bijvoorbeeld wanneer een pakket wordt gemaakt of geïnstalleerd. Er zijn extra knoppen op het tabblad Activiteitenlog:
  • Logboek wissen
  • Tonen/verbergen
• Werkbalk - De werkbalk bevat vernieuwingsknoppen voor de lijst Navigatievensters links en Pakket en knoppen voor het zoeken, maken en uploaden van pakketten.

Wanneer u op een optie in het linkernavigatievenster klikt, wordt de pakketlijst direct gefilterd.

Wanneer u op een pakketnaam klikt, wordt het item in de pakketlijst uitgebreid en worden meer details over het pakket weergegeven.

Er is een aantal acties dat op een pakket via de beschikbare toolbarknopen kan worden ondernomen wanneer het pakketdetail wordt uitgebreid.

• Bewerken
• Opbouwen
• Opnieuw installeren
• Downloaden
• Delen

Onder de Meer knop.

• Verwijderen
• Dekking
• Inhoud
• Omloop
• Andere versies
• Verwijderen
• Installeren testen
• Valideren
• Repliceren

Pakketstatus

Elk item in de pakketlijst heeft een statusindicator waarmee u in één oogopslag de status van het pakket kunt zien. Als u de muisaanwijzer boven de status houdt, wordt knopinfo met de details van de status weergegeven.

Als het pakket is gewijzigd of nooit is gemaakt, wordt de status weergegeven als een koppeling waarmee u snel actie kunt ondernemen om het pakket opnieuw samen te stellen of te installeren.

Pakketinstellingen

Een pakket is in wezen een set filters en de gegevens in de opslagplaats op basis van die filters. Met de interface van Package Manager kunt u op een pakket klikken en vervolgens de Bewerken om de details van een pakket met inbegrip van de volgende montages te bekijken.

• Algemene instellingen
• Pakketfilters
• Pakketafhankelijke onderdelen
• Geavanceerde instellingen
• Schermafbeeldingen verpakken

Algemene instellingen

U kunt diverse pakketinstellingen bewerken om informatie te definiëren, zoals de pakketbeschrijving, afhankelijkheden en providerdetails.

De Pakketinstellingen is beschikbaar via Bewerken knop wanneer maken of bewerken een pakket. Klik op Opslaan.

Miniaturen pakket

Een miniatuur geeft snel een visuele referentie van wat het pakket bevat. Dit wordt vervolgens weergegeven in de pakketlijst en kan u helpen het pakket of de klasse van het pakket gemakkelijk te identificeren.

Hieronder volgen voorbeelden van conventies voor officiële pakketten:

Officiële hotfix

Officiële AEM installatie van de extensie

Officieel servicepakket

Gebruik een uniek pictogram voor uw pakket. Gebruik geen pictogram dat door Adobe wordt gebruikt.

Pakketfilters

Filters identificeren de knooppunten in de opslagplaats die in het pakket moeten worden opgenomen. A Filterdefinitie geeft de volgende informatie op:

• De Hoofdpad van de inhoud die moet worden opgenomen
• Regels die specifieke knooppunten onder het hoofdpad bevatten of uitsluiten

Regels toevoegen met de opdracht + knop. Regels verwijderen met de opdracht - knop.

Regels worden toegepast volgens hun volgorde, zodat ze op de gewenste plaats worden geplaatst met behulp van de Omhoog en Omlaag pijlknoppen.

Filters kunnen nul of meer regels bevatten. Als er geen regels zijn gedefinieerd, bevat het pakket alle inhoud onder het hoofdpad.

U kunt een of meer filterdefinities definiëren voor een pakket. Gebruik meerdere filters om inhoud van meerdere hoofdpaden op te nemen.

Wanneer u filters maakt, kunt u een pad definiëren of een reguliere expressie gebruiken om alle knooppunten op te geven die u wilt opnemen in of uitsluiten.

Pakketfilters worden meestal gedefinieerd wanneer u het eerst Maak het pakket. U kunt ze echter ook later bewerken, waarna het pakket opnieuw moet worden samengesteld om de inhoud bij te werken op basis van de nieuwe filterdefinities.

Afhankelijkheden

Geavanceerde instellingen

Schermafbeeldingen verpakken

U kunt meerdere schermafbeeldingen aan het pakket toevoegen om een visuele weergave van de weergave van de inhoud te bieden.

Pakkethandelingen

Er zijn vele acties die op een pakket kunnen worden ondernomen.

Een pakket maken

1. Access Package Manager.

2. Klikken Pakket maken.

   TIP

   Als uw instantie veel pakketten bevat, is er mogelijk een mapstructuur aanwezig. In dergelijke gevallen is het eenvoudiger om naar de vereiste doelmap te navigeren voordat u het nieuwe pakket maakt.

3. In de Nieuw pakket voert u de volgende velden in:

   

   • Pakketnaam - Selecteer een beschrijvende naam, zodat u (en anderen) de inhoud van het pakket gemakkelijk kunt herkennen.

   • Versie - Dit is een tekstveld dat u kunt gebruiken om een versie aan te geven. Deze wordt aan de pakketnaam toegevoegd om de naam van het ZIP-bestand te vormen.

   • Groep - Dit is de naam van de doelgroep (of -map). Met groepen kunt u uw pakketten ordenen. Er wordt een map voor de groep gemaakt als deze nog niet bestaat. Als u de groepsnaam leeg laat, wordt het pakket gemaakt in de hoofdpakketlijst.

4. Klikken OK om het pakket te maken.

5. AEM geeft het nieuwe pakket boven aan de lijst met pakketten weer.

   

6. Klikken Bewerken om de inhoud van pakket. Klikken Opslaan nadat u klaar bent met het bewerken van de instellingen.

7. U kunt nu Opbouwen uw pakket.

Het is niet verplicht om het pakket onmiddellijk na het maken ervan te bouwen. Een ongebouwd pakket bevat geen inhoud en bestaat alleen uit de filtergegevens en andere metagegevens van het pakket.

Een pakket maken

Een pakket wordt vaak op hetzelfde moment als u gemaakt Maak het pakket, maar u kunt op een later tijdstip terugkeren om het pakket samen te stellen of opnieuw samen te stellen. Dit kan nuttig zijn als de inhoud in de opslagplaats is gewijzigd of de pakketfilters zijn gewijzigd.

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klikken Opbouwen. Er wordt een dialoogvenster weergegeven waarin u moet bevestigen dat u het pakket wilt maken, aangezien bestaande pakketinhoud wordt overschreven.

4. Klikken OK. AEM bouwt het pakket en geeft alle inhoud weer die aan het pakket is toegevoegd, zoals dit gebeurt in de lijst met activiteiten. Na voltooiing AEM wordt bevestigd dat het pakket is gemaakt en (wanneer u het dialoogvenster sluit) worden de gegevens in de pakketlijst bijgewerkt.

Een pakket bewerken

Nadat een pakket is geüpload naar AEM, kunt u de instellingen wijzigen.

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klikken Bewerken en de Pakketinstellingen zoals vereist.

4. Klikken Opslaan om op te slaan.

Het kan nodig zijn het pakket opnieuw opbouwen om de inhoud bij te werken op basis van de wijzigingen die u hebt aangebracht.

Een pakket opnieuw inpakken

Nadat een pakket is gemaakt, kan het opnieuw worden verpakt. Wanneer u de pakketgegevens opnieuw inpakt, worden deze zonder miniatuur, beschrijving, enzovoort gewijzigd. De pakketinhoud blijft ongewijzigd.

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klikken Bewerken en de Pakketinstellingen zoals vereist.

4. Klikken Opslaan om op te slaan.

5. Klikken Meer -> Omloop en een dialoog zal om bevestiging vragen.

Andere pakketversies weergeven

Omdat elke versie van een pakket in de lijst verschijnt zoals elk ander pakket, kan de Manager van het Pakket andere versies van een geselecteerd pakket vinden.

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klikken Meer -> Andere versies en er wordt een dialoogvenster geopend met een lijst van andere versies van hetzelfde pakket met statusinformatie.

Inhoud van pakket weergeven en installatie testen

Nadat een pakket is samengesteld, kunt u de inhoud bekijken.

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klik op Meer -> Inhoud en Package Manager geeft de volledige inhoud van het pakket weer in het activiteitenlogboek.

   

4. Klik op Meer -> Installeren testen en de rapporten van de Manager van het Pakket in het activiteitenlogboek de resultaten alsof de installatie werd uitgevoerd.

   

Pakketten naar uw bestandssysteem downloaden

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klik op de knop Downloaden of de gekoppelde bestandsnaam van het pakket in het gebied met pakketdetails.

4. AEM downloadt het pakket naar uw computer.

Een pakket delen

Het Aandeel van het pakket was een gecentraliseerde openbare dienst om inhoudspakketten te verspreiden. Delen van pakket is vervangen door Softwaredistributie en deze knop werkt niet meer.

Pakketten uploaden vanuit uw bestandssysteem

1. Access Package Manager.

2. Selecteer de groepsmap waarin u het pakket wilt uploaden.

3. Klik op de knop Pakket uploaden knop.

4. Geef de benodigde informatie over het geüploade pakket.

   

   • Pakket - Gebruik de Bladeren… om het vereiste pakket in uw lokale bestandssysteem te selecteren.
   • Uploaden forceren - Als er al een pakket met deze naam bestaat, wordt het uploaden afgedwongen en wordt het bestaande pakket overschreven.

5. Klikken OK en het geselecteerde pakket wordt geüpload en de pakketlijst wordt dienovereenkomstig bijgewerkt.

De pakketinhoud bestaat nu op AEM, maar als u de inhoud beschikbaar wilt maken voor gebruik, moet u het pakket installeren.

Pakketten valideren

Omdat pakketten bestaande inhoud kunnen wijzigen, is het vaak handig om deze wijzigingen te valideren voordat u ze installeert.

Validatieopties

Pakketbeheer kan de volgende validaties uitvoeren:

• OSGi-pakket importeren
• Bedekkingen
• ACLs

OSGi-pakketinvoer valideren

Wat wordt gecontroleerd

Deze validatie inspecteert het pakket voor alle JAR-bestanden (OSGi-bundels), extraheert de bestanden manifest.xml (die de versioned gebiedsdelen bevat waarop OSGi bundel baseert), en verifieert de AEM instantie uitvoert genoemde gebiedsdelen met de correcte versies.

Hoe het is gemeld

Om het even welke versioned gebiedsdelen die niet door de AEM instantie kunnen worden tevredengesteld zijn vermeld in het Logboek van de Activiteit van de Manager van het Pakket.

Foutstatussen

Als de gebiedsdelen ontevreden zijn, dan zullen de bundels OSGi in het pakket met die gebiedsdelen niet beginnen. Dit resulteert in een gebroken toepassingsplaatsing aangezien om het even wat die op de unstarted bundel OSGi baseert zal beurtelings niet behoorlijk functioneren.

Foutresolutie

Om fouten wegens ontevreden bundels op te lossen OSGi, moet de gebiedsdeelversie in de bundel met ontevreden invoer worden aangepast.

Bedekkingen valideren

Wat wordt gecontroleerd

Deze validatie bepaalt of het pakket dat wordt geïnstalleerd een bestand bevat dat al wordt bedekt in de AEM.

Als u bijvoorbeeld een bestaande overlay hebt van /apps/sling/servlet/errorhandler/404.jsp, een pakket dat /libs/sling/servlet/errorhandler/404.jsp, zodat het bestaande bestand wordt gewijzigd in /libs/sling/servlet/errorhandler/404.jsp.

Hoe het is gemeld

Dergelijke overlays worden beschreven in het activiteitenlogboek van Package Manager.

Foutstatussen

Een foutstatus houdt in dat het pakket probeert een bestand te implementeren dat al is bedekt. De wijzigingen in het pakket worden dus overschreven (en dus "verborgen") door de bedekking en worden niet van kracht.

Foutresolutie

U kunt dit probleem oplossen door het bestand met de overlay in /apps moet de wijzigingen in het bovenliggende bestand in /libs en neemt de wijzigingen waar nodig op in de overlay ( /apps), en het overlappende bestand opnieuw gebruiken.

ACLs bevestigen

Wat wordt gecontroleerd

Deze bevestiging controleert welke toestemmingen worden toegevoegd, hoe zij zullen worden behandeld (samenvoegen/vervangen), en als de huidige toestemmingen zullen worden beïnvloed.

Hoe het is gemeld

De toestemmingen worden beschreven in het Logboek van de Activiteit van de Manager van het Pakket.

Foutstatussen

Er kunnen geen expliciete fouten worden opgegeven. De bevestiging wijst eenvoudig erop of om het even welke nieuwe ACL toestemmingen zullen worden toegevoegd of beïnvloed door het pakket te installeren.

Foutresolutie

Gebruikend de informatie die door de bevestiging wordt verstrekt, kunnen de beïnvloede knopen in CRXDE worden herzien en ACLs kan in het pakket aanpassen zoals nodig.

Validatie uitvoeren

De validatie van pakketten kan op twee verschillende manieren worden uitgevoerd:

• Via de interface van Package Manager
• Via HTTP-POST request zoals with cURL

Validatie moet altijd plaatsvinden na het uploaden van het pakket, maar voordat het wordt geïnstalleerd.

Pakketvalidatie via pakketbeheer

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Als u het pakket wilt valideren, klikt u op Meer -> Valideren,

4. Gebruik in het modale dialoogvenster dat dan wordt weergegeven de selectievakjes om het type of de typen validatie te selecteren en de validatie te starten door op Valideren.

5. De gekozen validatie(s) worden dan uitgevoerd en de resultaten worden weergegeven in het activiteitenlog van Package Manager.

Pakketvalidatie via HTTP-POST-aanvraag

Het verzoek van de POST heeft de volgende vorm.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

De type parameter kan elke door komma's gescheiden, ongeordende lijst zijn die bestaat uit:

• osgiPackageImports
• overlays
• acls

De waarde van type standaardinstellingen osgiPackageImports indien niet expliciet doorgegeven.

Wanneer u cURL gebruikt, voert u een instructie uit die vergelijkbaar is met het volgende:

curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'

Bij validatie via een aanvraag voor een POST wordt het antwoord teruggestuurd als een JSON-object.

Pakketdekking weergeven

Pakketten worden gedefinieerd door hun filters. U kunt Package Manager filters van een pakket op uw bestaande opslagplaats inhoud laten toepassen om te tonen welke inhoud van de bewaarplaats door de filterdefinitie van het pakket wordt behandeld.

1. Access Package Manager.

2. Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.

3. Klikken Meer -> Dekking.

4. De dekkingsdetails worden vermeld in het activiteitenlog.

Pakketten installeren

Wanneer u een pakket uploadt, wordt alleen de pakketinhoud aan de opslagplaats toegevoegd, maar deze is niet toegankelijk. U moet het geüploade pakket installeren om de inhoud van het pakket te kunnen gebruiken.

Voordat u het pakket installeert, maakt Package Manager automatisch een pakket met momentopnamen dat de inhoud bevat die wordt overschreven. Deze momentopname wordt opnieuw geïnstalleerd als u het pakket verwijdert.

1. Access Package Manager.

2. Open in de pakketlijst de pakketdetails van het pakket dat u wilt installeren door op de pakketnaam te klikken.

3. Klik op de knop Installeren in de objectdetails of de Installeren in de pakketstatus.

4. In een dialoogvenster wordt bevestiging aangevraagd en kunnen aanvullende opties worden opgegeven.

   • Alleen extraheren - Extraheer het pakket alleen zodat er geen momentopname wordt gemaakt en het verwijderen daarom niet mogelijk is
   • Drempel opslaan - Aantal transiënte knooppunten totdat automatisch wordt opgeslagen (verhoog deze waarde als er uitzonderingen optreden die gelijktijdig worden gewijzigd)
   • Subpakketten extraheren - Automatisch extraheren van subpakketten inschakelen
   • Toegangsbeheer - Geeft aan hoe de toegangsbeheerinformatie die in het pakket is gedefinieerd, wordt verwerkt wanneer het pakket wordt geïnstalleerd (opties zijn gelijk aan de geavanceerde pakketinstellingen)
   • Afhankelijkheden verwerken - Specificeer hoe de gebiedsdelen tijdens installatie worden behandeld

5. Klikken Installeren.

6. In het activiteitenlog wordt de voortgang van de installatie beschreven.

Nadat de installatie is voltooid en voltooid, wordt de pakketlijst bijgewerkt en wordt het woord Geïnstalleerd wordt weergegeven in de pakketstatus.

Pakketten opnieuw installeren

Wanneer u pakketten opnieuw installeert, worden dezelfde stappen uitgevoerd op een reeds geïnstalleerd pakket die worden verwerkt wanneer het pakket aanvankelijk installeren.

Uploaden en installeren op basis van bestandssysteem

U kunt pakketbeheer volledig verlaten wanneer het installeren van pakketten. AEM kan pakketten detecteren die op een specifieke locatie in het lokale bestandssysteem van de hostcomputer zijn geplaatst en deze automatisch uploaden en installeren.

1. Onder de installatiemap AEM is er een crx-quicksart de map naast de pot en license.properties bestand. Een map maken met de naam install krachtens crx-quickstart resulterend in het pad <aem-home>/crx-quickstart/install.

2. Voeg in deze map uw pakketten toe. Deze worden automatisch geüpload en geïnstalleerd op uw exemplaar.

3. Nadat het uploaden en installeren is voltooid, kunt u de pakketten in Package Manager zien alsof u de interface van Package Manager hebt gebruikt om ze te installeren.

Als de instantie actief is, wordt het uploaden en de installatie onmiddellijk gestart wanneer u het aan het pakket toevoegt install map

Als de instantie niet wordt uitgevoerd, worden pakketten in de install worden bij het opstarten geïnstalleerd in alfabetische volgorde.

Pakketten verwijderen

Als u het pakket verwijdert, wordt de inhoud van de opslagplaats teruggezet naar de momentopname die vóór de installatie automatisch door Package Manager is gemaakt.

1. Access Package Manager.

2. Open de pakketdetails van het pakket dat u uit de pakketlijst wilt verwijderen door op de pakketnaam te klikken.

3. Klikken Meer -> Verwijderen om de inhoud van dit pakket uit de opslagplaats te verwijderen.

4. In een dialoogvenster wordt bevestiging gevraagd en worden alle aangebrachte wijzigingen vermeld.

5. Het pakket wordt verwijderd en de momentopname wordt toegepast. De voortgang van het proces wordt weergegeven in het activiteitenlog.

Pakketten verwijderen

Als u een pakket verwijdert, worden alleen de gegevens uit Package Manager verwijderd. Als dit pakket al is geïnstalleerd, wordt de geïnstalleerde inhoud niet verwijderd.

1. Access Package Manager.

2. Open de pakketdetails van het pakket dat u uit de pakketlijst wilt verwijderen door op de pakketnaam te klikken.

3. Pakketbeheer vraagt om bevestiging dat u het pakket wilt verwijderen. Klikken OK om de schrapping te bevestigen.

4. De pakketinformatie wordt verwijderd en de details worden gerapporteerd in het activiteitenlog.

Pakketten repliceren

Kopieer de inhoud van een pakket en installeer het op de publicatie-instantie.

1. Access Package Manager.

2. Open de pakketdetails van het pakket dat u wilt repliceren uit de pakketlijst door op de pakketnaam te klikken.

3. Klikken Meer -> Repliceren.

4. Het pakket wordt gerepliceerd en de details worden gerapporteerd in het activiteitenlog.

Softwaredistributie

AEM Pakketten kunnen worden gebruikt om inhoud te creëren en te delen over AEM milieu's.

Softwaredistributie is een gecentraliseerde dienst die wordt ontworpen om het zoeken en het downloaden van AEM pakketten te vereenvoudigen.

Raadpleeg voor meer informatie de Documentatie voor softwaredistributie.

Business.Adobe.com-bronnen

Multichannel Communication Style System Embedded Charts Theme Editor Customer Experience Management Content Management System