Pakete bieten Ihnen die Möglichkeit, Repository-Inhalte zu importieren und zu exportieren. Sie können Pakete beispielsweise verwenden, um neue Funktionen zu installieren, Inhalte zwischen Instanzen auszutauschen und Repository-Inhalte zu sichern.
Sie können von den folgenden Seiten aus auf Pakete zugreifen und/oder Pakete verwalten:
Package Manager, mit dessen Hilfe Sie die Pakete auf der lokalen AEM-Instanz verwalten.
Package Share, einem zentralen Server, auf dem sowohl öffentlich verfügbare Pakete als auch private Pakete Ihrer Firma gespeichert sind. Die öffentlichen Pakete können Hotfixes, neue Funktionen, Dokumentationen usw. enthalten.
Sie können Pakete zwischen Package Manager, Package Share und Ihrem Dateisystem übertragen.
Ein Paket ist eine Zip-Datei mit Repository-Inhalten in Form einer Dateisystem-Serialisierung (auch „Vault“-Serialisierung genannt). Dies ermöglicht eine benutzerfreundliche und einfach zu bearbeitende Darstellung der Dateien und Ordner.
Pakete enthalten sowohl Seiteninhalte als auch projektspezifische Inhalte, die mithilfe von Filtern ausgewählt werden.
Ein Paket enthält auch Vault-Metadaten, einschließlich der Filterdefinitionen und Informationen zur Import-Konfiguration. Zusätzliche Inhaltseigenschaften (die nicht für die Paketextraktion verwendet werden) können in das Paket aufgenommen werden, z. B. eine Beschreibung, ein visuelles Bild oder ein Symbol. Diese Eigenschaften dienen nur dem Inhaltspaket-Verbraucher und Informationszwecken.
Pakete repräsentieren die aktuelle Version der Inhalte zum Zeitpunkt der Erstellung des Pakets. Sie umfassen keine früheren Versionen der Inhalte, die AEM im Repository speichert.
Sie können die folgenden Aktionen hinsichtlich der Pakete ausführen:
Eine Paketdefinition umfasst verschiedene Arten von Informationen:
Sie können eine Vielzahl von Paketeinstellungen bearbeiten, um Aspekte wie die Paketbeschreibung, verwandte Fehler, Abhängigkeiten und Anbieterinformationen zu definieren.
Rufen Sie das Dialogfeld Paketeinstellungen über die Schaltfläche Bearbeiten auf, wenn Sie ein Paket erstellen oder bearbeiten. Es enthält drei zur Konfiguration dienende Registerkarten. Klicken Sie nach dem Vornehmen der Änderungen auf OK, um diese Einstellungen zu speichern.
Feld | Beschreibung |
---|---|
Name | Der Name des Pakets. |
Gruppe | Der Name der Gruppe, der das Paket hinzugefügt werden soll, um Pakete zu organisieren. Geben Sie den Namen für eine neue Gruppe ein oder wählen Sie eine vorhandene Gruppe aus. |
Version | Text für die benutzerdefinierte Version. |
Beschreibung | Eine kurze Beschreibung des Pakets. HTML-Markup kann zum Formatieren verwendet werden. |
Miniaturansicht | Das Symbol, das mit der Paketliste angezeigt wird. Klicken Sie auf „Durchsuchen“, um eine lokale Datei auszuwählen. |
Feld | Beschreibung | Format/Beispiel |
---|---|---|
Name | Name des Anbieters. | AEM Geometrixx |
URL | URL des Anbieters. | https://www.aem-geometrixx.com |
Link | Paketspezifischer Link zu einer Anbieterseite. | https://www.aem-geometrixx.com/mypackage.html |
Erfordert |
|
|
AC-Verwaltung | Legen Sie fest, wie die im Paket definierten Zugriffssteuerungsinformationen beim Importieren des Pakets verarbeitet werden:
Der Standardwert lautet Ignorieren. |
|
Feld | Beschreibung | Format/Beispiel |
---|---|---|
Getestet mit | Der Produktname und die Version, auf die dieses Paket ausgerichtet ist oder mit denen es kompatibel ist. | AEM6 |
Behobene Fehler/Probleme | Ein Textfeld, in dem Sie Details zu Fehlern auflisten können, die mit diesem Paket behoben wurden. Listen Sie die einzelnen Fehler in separaten Zeilen auf. | bug-nr summary |
Hängt ab von | Listet Abhängigkeitsinformationen auf, die beachtet werden müssen, wenn andere Pakete erforderlich sind, damit das aktuelle Paket erwartungsgemäß ausgeführt werden kann. Dieses Feld ist bei Verwendung von Hotfixes wichtig. | groupId:name:version |
Ersetzt | Eine Liste veralteter Pakete, die dieses Paket ersetzt. Überprüfen Sie vor der Installation, ob dieses Paket alle erforderlichen Inhalte von den veralteten Paketen beinhaltet, sodass keine Inhalte überschrieben werden. | groupId:name:version |
Filter identifizieren die Repository-Knoten, die in das Paket eingeschlossen werden sollen. Eine Filterdefinition legt die folgenden Informationen fest:
Filter können keine oder mehr Regeln enthalten. Wenn keine Regeln definiert sind, enthält das Paket alle Inhalte unter dem Stammpfad.
Sie können eine oder mehrere Filterdefinitionen für ein Paket definieren. Verwenden Sie mehr als einen Filter, um Inhalte von mehreren Stammpfaden einzuschließen.
In der folgenden Tabelle sind diese Regeln und einige Beispiele beschrieben:
Regeltyp | Beschreibung | Beispiel |
---|---|---|
include | Sie können einen Pfad definieren oder einen regulären Ausdruck verwenden, um alle Knoten anzugeben, die Sie einschließen möchten. Wird ein Verzeichnis eingeschlossen:
|
/libs/sling/install(/.*?lang=de)? |
exclude | Sie können einen Pfad angeben oder einen regulären Ausdruck verwenden, um alle Knoten anzugeben, die Sie ausschließen möchten. Wird ein Verzeichnis ausgeschlossen, werden dieses Verzeichnis und alle Dateien und Ordner in diesem Verzeichnis (d. h. die gesamte Unterstruktur) ausgeschlossen. |
/libs/wcm/foundation/components(/.*?lang=de)? |
Ein Paket kann mehrere Filterdefinitionen enthalten, sodass sich Knoten von verschiedenen Orten einfach in einem Paket kombinieren lassen.
Paketfilter werden in den meisten Fällen bei der Erstellung des Pakets definiert, sie können aber auch zu einem späteren Zeitpunkt bearbeitet werden (anschließend sollte das Paket neu erstellt werden).
Sie können Screenshots an das Paket anhängen, um eine visuelle Darstellung vom Erscheinungsbild der Inhalte bereitzustellen. So können Sie beispielsweise Screenshots von neuen Funktionen bereitstellen.
Sie können auch ein Symbol an das Paket anhängen, um eine schnelle visuelle Darstellung von dem bereitzustellen, was im Paket enthalten ist. Dieses wird dann in der Paketliste angezeigt und ermöglicht Ihnen, das Paket oder die Klasse des Pakets auf einfache Weise zu identifizieren.
Da ein Paket ein Symbol enthalten kann, gelten folgende Konventionen für offizielle Pakete:
Um Verwirrungen zu vermeiden, sollten Sie ein aussagekräftiges Symbol für das Paket und keines der offiziellen Symbole verwenden.
Offizielles Hotfix-Paket:
Offizielles AEM-Installations- oder AEM-Erweiterungspaket:
Offizielle Funktionspakete:
Der Package Manager verwaltet die Pakete auf der lokalen AEM-Installation. Nachdem Sie die erforderlichen Berechtigungen zugewiesen haben, können Sie den Package Manager für verschiedene Aktionen, u. a. zum Konfigurieren, Erstellen, Herunterladen und Installieren von Paketen, verwenden. Folgende wichtige Elemente sind zu konfigurieren:
Wenn Sie Benutzern das Recht zum Erstellen, Ändern, Hochladen und Installieren von Paketen gewähren wollen, müssen Sie ihnen die entsprechenden Berechtigungen für die folgenden Orte zuweisen:
Weitere Informationen zum Ändern von Berechtigungen finden Sie in Festlegen von Berechtigungen.
So erstellen Sie eine neue Paketdefinition:
Klicken Sie auf dem AEM Begrüßungsbildschirm auf Pakete (oder von Instrumente Doppelklicken auf Konsole Pakete).
Wählen Sie dann Package Manager aus.
Klicken Sie auf Paket erstellen.
Wenn Ihre Instanz über viele Pakete verfügt, ist möglicherweise eine Ordnerstruktur vorhanden, sodass Sie vor der Erstellung des neuen Pakets zum erforderlichen Zielordner navigieren können.
Im Dialogfeld:
Geben Sie Folgendes ein:
Gruppenname
Der Name der Zielgruppe (oder des Ordners). Gruppen sollen Ihnen bei der Organisation Ihrer Pakete helfen.
Das System legt einen Ordner für die Gruppe an, sollte sie noch nicht vorhanden sein. Wenn Sie keinen Gruppennamen eingeben, wird das Paket in der Hauptpaketliste („Startseite“ > „Pakete“) erstellt.
Paket-Name
Der Name des neuen Pakets. Wählen Sie einen beschreibenden Namen aus, über den Sie (und andere) die Inhalte des Pakets leicht identifizieren können.
Version
Ein Textfeld zur Eingabe einer Version. Diese wird an den Paketnamen angehängt, um den Namen der ZIP-Datei zu bilden.
Klicken Sie auf OK, um das Paket zu erstellen.
AEM listet das neue Paket im entsprechenden Gruppenordner auf.
Klicken Sie auf das Symbol oder den Paketnamen, um es zu öffnen.
Sie können ggf. zu einem späteren Zeitpunkt zu dieser Seite zurückkehren.
Klicken Sie auf Bearbeiten, um die Paketeinstellungen zu bearbeiten.
Hier können Sie Informationen hinzufügen und/oder bestimmte Einstellungen festlegen. Dazu gehören z. B. eine Beschreibung, das Symbol, verwandte Fehler und das Hinzufügen von Anbieterdetails.
Klicken Sie auf OK, wenn Sie mit der Bearbeitung der Einstellungen fertig sind.
Fügen Sie dem Paket bei Bedarf Screenshots hinzu. Eine Instanz ist verfügbar, wenn das Paket erstellt wurde. Fügen Sie weitere hinzu, falls dies erforderlich sein sollte, indem Sie die Option Paket-Screenshot im Sidekick verwenden.
Fügen Sie das Ist-Bild hinzu, indem Sie auf die Bildkomponente im Bereich Screenshots doppelklicken, ein Bild hinzufügen und auf OK klicken.
Definieren Sie die Paketfilter, indem Sie die Instanzen der Filterdefinition aus dem Sidekick ziehen und dann darauf doppelklicken, um sie zur Bearbeitung zu öffnen:
Geben Sie Folgendes an:
Stammpfad Die zu packenden Inhalte. Dabei kann es sich um den Stamm einer Unterstruktur handeln.
Regeln Regeln sind optional. Bei einfachen Paketdefinitionen ist es nicht notwendig, Regeln zum Ein- oder Ausschließen festzulegen.
Bei Bedarf können Sie Regeln zum Einschließen oder Ausschließen definieren, um die Paketinhalte genau festzulegen.
Fügen Sie Regeln mithilfe des +-Symbols hinzu und entfernen Sie Regeln mithilfe des --Symbols. Regeln werden entsprechend ihrer Reihenfolge angewendet. Positionieren Sie sie daher mit den Schaltflächen Nach oben und Nach unten wie gewünscht.
Klicken Sie dann auf OK, um den Filter zu speichern.
Sie können so viele Filterdefinitionen verwenden, wie Sie brauchen. Achten Sie jedoch darauf, dass sie nicht in Konflikt miteinander stehen. Vergewissern Sie sich mithilfe der Vorschau, welche Inhalte im Paket enthalten sind.
Sie können mithilfe der Vorschau feststellen, welche Inhalte im Paket enthalten sind. Bei Auswahl dieser Option wird der Erstellungsprozess in einem Probelauf durchgeführt und anschließend alles aufgelistet, was zum Paket hinzugefügt wird, wenn es tatsächlich erstellt wird.
Sie können nun das Paket aufbauen.
Es ist nicht zwingend erforderlich, das Paket an diesem Punkt zu erstellen, Sie können dies auch zu einem späteren Zeitpunkt tun.
In den meisten Fällen wird das Paket erstellt, wenn die Paketdefinition erstellt wird, Sie können aber auch zu einem späteren Zeitpunkt zurückkehren, um das Paket entweder zu erstellen oder neu zu erstellen. Dies ist beispielsweise dann nützlich, wenn sich die Inhalte innerhalb des Repositorys geändert haben.
Bevor Sie das Paket erstellen, kann es hilfreich sein, die Inhalte des Pakets in einer Vorschau anzuzeigen. Klicken Sie dazu auf Vorschau.
Öffnen Sie die Paketdefinition im Package Manager (klicken Sie auf das Paketsymbol oder den Paketnamen).
Klicken Sie auf Aufbauen. Es wird ein Dialogfeld mit der Aufforderung zur Bestätigung angezeigt, dass Sie das Paket erstellen wollen.
Dies ist insbesondere dann wichtig, wenn Sie ein Paket neu erstellen, da die Paketinhalte dabei überschrieben werden.
Klicken Sie auf OK. AEM erstellt das Paket und listet währenddessen alle Inhalte auf, die dem Paket hinzugefügt werden. Nachdem der Vorgang abgeschlossen ist, zeigt AEM eine Bestätigung an, dass das Paket aufgebaut wurde. Zudem aktualisiert AEM die Paketlisteninformationen (wenn Sie das Dialogfeld schließen).
Nach der Erstellung kann das Paket bei Bedarf neu eingegliedert werden.
Bei einer Neueingliederung werden die Paketinformationen ohne Änderung der Paketinhalte geändert. Zu den Paketinformationen gehören die Miniaturansicht, die Beschreibung usw., d. h. alle Informationen, die Sie im Dialogfeld Paketeinstellungen bearbeiten können (klicken Sie zum Öffnen des Dialogfelds auf Bearbeiten).
Hauptsächlich wird die Neueingliederungsfunktion bei der Vorbereitung eines Pakets für Package Share eingesetzt. Es könnte beispielsweise sein, dass Sie ein vorhandenes Paket haben, das Sie für andere freigeben möchten. Bevor Sie dies tun, möchten Sie eine Miniaturansicht und eine Beschreibung hinzufügen. Anstatt das gesamte Paket mit allen Funktionen neu zu erstellen (was möglicherweise einige Zeit in Anspruch nimmt und das Risiko birgt, dass das Paket nicht mit dem Original identisch ist), können Sie es neu eingliedern und nur die Miniaturansicht und die Beschreibung hinzufügen.
Öffnen Sie die Paketdefinition im Package Manager (klicken Sie auf das Paketsymbol oder den Paketnamen).
Klicken Sie auf Bearbeiten und aktualisieren Sie die Paketeinstellungen nach Bedarf. Klicken Sie zum Speichern auf OK.
Klicken Sie auf Erneut verpacken. Daraufhin wird ein Bestätigungsdialogfeld angezeigt.
So zeigen Sie Informationen zu einer Paketdefinition an oder bearbeiten sie:
Navigieren Sie im Package Manager zum anzuzeigenden Paket.
Klicken Sie auf das Paketsymbol des anzuzeigenden Pakets. Daraufhin wird die Paketseite aufgerufen, auf der Informationen zur Paketdefinition aufgelistet sind:
Sie können das Paket über diese Seite auch bearbeiten und bestimmte Aktionen hinsichtlich des Pakets durchführen.
Welche Schaltflächen verfügbar sind, hängt davon ab, ob das Paket bereits erstellt wurde oder nicht.
Wurde das Paket bereits erstellt, klicken Sie auf „Inhalte“, woraufhin ein Fenster mit einer Liste der gesamten Inhalte des Pakets geöffnet wird:
Nach der Erstellung eines Pakets können Sie dessen Inhalte anzeigen:
Navigieren Sie im Package Manager zum anzuzeigenden Paket.
Klicken Sie auf das Paketsymbol des anzuzeigenden Pakets. Daraufhin wird die Paketseite aufgerufen, auf der Informationen zur Paketdefinition aufgelistet sind.
Klicken Sie zum Anzeigen der Inhalte auf Inhalte, woraufhin ein Fenster mit einer Liste der gesamten Inhalte des Pakets geöffnet wird:
Klicken Sie auf Testinstallation, um einen Probedurchlauf der Installation durchzuführen. Nachdem Sie die Aktion bestätigt haben, wird ein Fenster geöffnet, in dem die Ergebnisse wie bei einer echten Installation angezeigt werden:
In diesem Abschnitt wird beschrieben, wie Sie mit dem Package Manager ein Paket von AEM in das Dateisystem herunterladen.
Informationen zum Herunterladen von Hotfixes, Funktionspaketen sowie Paketen aus dem öffentlichen Bereich und dem firmeninternen Bereich von Package Share finden Sie in Package Share.
Sie können von Package Share aus:
Pakete von Package Share direkt in die lokale AEM-Instanz herunterladen.
Nach dem Download wird das Paket in das Repository importiert. Anschließend können Sie es mithilfe des Package Managers sofort auf der lokalen Instanz installieren. Diese Pakete enthalten Hotfixes und andere gemeinsame Pakete.
Pakete von Package Share in das Dateisystem herunterladen.
Klicken Sie auf dem AEM Begrüßungsbildschirm auf Pakete, wählen Sie Package Manager.
Navigieren Sie zum Paket, das Sie herunterladen möchten.
Klicken Sie auf den Link, der sich aus dem Namen der ZIP-Datei (unterstrichen) für das Paket ergibt, das Sie herunterladen möchten. Beispiel: export-for-offline.zip
.
AEM lädt das Paket auf Ihren Computer herunter (mithilfe eines standardmäßigen Browser-Download-Dialogfelds).
Mit einem Package-Upload können Sie ein Paket aus Ihrem Dateisystem in den AEM Package Manager hochladen.
Siehe Hochladen von Paketen in die unternehmensinterne Paketfreigabe , um ein Paket in den privaten Bereich von Package Share Ihres Unternehmens hochzuladen.
So laden Sie ein Paket hoch:
Navigieren Sie zum Package Manager. Klicken Sie dann auf den Gruppenordner, in den Sie das Paket hochladen wollen.
Klicken Sie auf Paket hochladen.
File
Sie können entweder den Dateinamen direkt eingeben oder die Durchsuchen… Dialogfeld zum Auswählen des erforderlichen Pakets aus Ihrem lokalen Dateisystem (klicken Sie nach Auswahl auf OK).
Hochladen erzwingen
Wenn bereits ein Paket mit diesem Namen existiert, können Sie auf dieses klicken, um den Upload zu erzwingen (und das vorhandene Paket zu überschreiben).
Klicken Sie auf OK, damit das neue Paket hochgeladen und in der Package Manager-Liste angezeigt wird.
Denken Sie daran, das Paket zu installieren, damit die Inhalte in AEM verfügbar sind.
Vor der Installation eines Pakets sollten Sie seinen Inhalt überprüfen. Da Pakete überlagerte Dateien ändern können unter /apps
und/oder fügen, ändern und entfernen Sie ACLs, es ist oft nützlich, diese Änderungen vor der Installation zu validieren.
Der Validierungsmechanismus kann folgende Merkmale des Pakets überprüfen:
Diese Optionen werden nachfolgend beschrieben.
Validieren von OSGi-Paketimporten
Prüfumfang
Diese Validierung prüft das Paket auf JAR-Dateien (OSGi-Bundles), extrahiert deren manifest.xml
-Datei (die die versionierten Abhängigkeiten enthält, die für das OSGi-Bundle erforderlich sind) und stellt sicher, dass die AEM-Instanz die Abhängigkeiten mit den richtigen Versionen exportiert.
Reporting
Alle versionierten Abhängigkeiten, die von der AEM nicht erfüllt werden können, werden im Aktivitätsprotokoll des Package Managers.
Fehlerstatus
Sind die Abhängigkeiten nicht erfüllt, werden die OSGi-Bundles im Paket mit diesen Abhängigkeiten nicht gestartet. Dies führt zu einer fehlerhaften Anwendungsbereitstellung, da alle auf dem nicht gestarteten OSGi-Bundle basierenden Prozesse nicht ordnungsgemäß funktionieren.
Fehlerbehebung
Um die Fehler zu beheben, die auf OSGi-Bundles mit nicht erfüllten Abhängigkeiten basieren, muss die Abhängigkeitsversion in diesen Bundles angepasst werden.
Bestätigen von Überlagerungen
Prüfumfang
Diese Validierung ermittelt, ob das zu installierende Paket eine Datei enthält, die bereits in der AEM-Zielinstanz überlagert ist.
Beispiel: Bei einer bestehenden Überlagerung unter /apps/sling/servlet/errorhandler/404.jsp
ändert ein Paket, das /libs/sling/servlet/errorhandler/404.jsp
enthält, die vorhandene Datei unter /libs/sling/servlet/errorhandler/404.jsp
.
Reporting
Solche Überlagerungen werden im Aktivitätsprotokoll von Package Manager beschrieben.
Fehlerstatus
Ein Fehlerstatus bedeutet, dass das Paket versucht, eine bereits überlagerte Datei bereitzustellen. Die Änderungen im Paket werden somit durch die Überlagerung überschrieben (und „ausgeblendet“) und nicht umgesetzt.
Fehlerbehebung
Um dieses Problem zu beheben, muss der Betreuer der Überlagerungsdatei in /apps
muss die Änderungen an der überlagerten Datei in /libs
und die erforderlichen Änderungen in die Überlagerung ( /apps
) und stellen Sie die überlagerte Datei erneut bereit.
Beachten Sie, dass der Validierungsmechanismus keine Möglichkeit zur Abstimmung bietet, wenn der überlagerte Inhalt ordnungsgemäß in die Überlagerungsdatei integriert wurde. Daher berichtet diese Validierung auch weiterhin über Konflikte, selbst wenn die erforderlichen Änderungen vorgenommen wurden.
Bestätigen von ACLs
Prüfumfang
Diese Validierung prüft, welche Berechtigungen hinzugefügt werden, wie diese verarbeitet werden (zusammenführen/ersetzen) und ob sie sich auf aktuelle Berechtigungen auswirken.
Reporting
Die Berechtigungen werden im Aktivitätsprotokoll von Package Manager beschrieben.
Fehlerstatus
Die Angabe von expliziten Fehlern ist nicht möglich. Die Validierung gibt lediglich an, ob durch Installieren des Pakets neue ACL-Berechtigungen hinzugefügt oder aktuelle beeinträchtigt werden.
Fehlerbehebung
Anhand der von der Validierung bereitgestellten Informationen können die betroffenen Knoten in CRXDE überprüft und die ACLs nach Bedarf im Paket angepasst werden.
Als Best Practice wird empfohlen, dass Pakete keine Auswirkungen auf von AEM bereitgestellte ACLs haben sollten, da dies möglicherweise zu unerwartetem Produktverhalten führen kann.
Die Validierung von Paketen kann auf zweierlei Weise erfolgen:
Führen Sie die Validierung stets nach dem Hochladen und vor dem Installieren eines Pakets durch.
Paketvalidierung über Package Manager
Öffnen Sie Package Manager unter https://<server>:<port>/crx/packmgr
Wählen Sie das Paket in der Liste aus und klicken Sie auf Mehr Dropdown-Liste aus der Überschrift und Bestätigen aus dem Dropdown-Menü.
Führen Sie diesen Schritt nach dem Hochladen des Inhaltspakets aber vor seiner Installation aus.
Aktivieren Sie im angezeigten modalen Dialogfeld das Kontrollkästchen der gewünschten Validierungstypen und starten Sie die Validierung durch Klicken auf Überprüfen. Alternativ können Sie auf Abbrechen klicken.
Die ausgewählten Validierungen werden ausgeführt. Die Ergebnisse werden im Aktivitätsprotokoll von Package Manager angezeigt.
Paketvalidierung über HTTP-POST-Anfrage
Die POST-Anfrage hat folgendes Format.
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
Der Parameter type
kann eine ungeordnete und durch Kommas getrennte Liste aus folgenden Elementen sein:
osgiPackageImports
overlays
acls
Der Wert von type
standardmäßig auf osgiPackageImports
wenn nicht übergeben wurde.
Im Folgenden finden Sie ein Beispiel für die Verwendung von cURL zur Ausführung einer Paketvalidierung.
Wenn Sie cURL verwenden, führen Sie eine Anweisung ähnlich der folgenden aus:
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'
Die gewünschte Validierung wird ausgeführt und die Antwort als JSON-Objekt zurückgesendet.
Die Antwort auf eine HTTP POST-Anfrage ist ein JSON-Objekt mit den Ergebnissen der Validierung.
Nachdem Sie ein Paket hochgeladen haben, müssen Sie dessen Inhalte installieren. Damit die Paketinhalte installiert und verwendet werden können, müssen sie:
in AEM geladen (entweder aus Ihrem Dateisystem hochgeladen oder heruntergeladen von Package Share)
installiert werden.
Beim Installieren eines Pakets können vorhandene Inhalte überschrieben oder gelöscht werden. Laden Sie ein Paket nur hoch, wenn Sie sich sicher sind, dass dadurch keine benötigten Inhalte gelöscht oder überschrieben werden.
Um die Inhalte oder Auswirkungen eines Pakets anzuzeigen, können Sie:
Führen Sie eine Testinstallation des Pakets durch, ohne den Inhalt zu ändern:
Öffnen Sie das Paket (klicken Sie auf das Paketsymbol oder den Paketnamen) und klicken Sie auf Testen der Installation.
Eine Liste der Paketinhalte anzeigen:
Öffnen Sie das Paket und klicken Sie auf Inhalt.
Unmittelbar vor der Installation des Pakets wird ein Snapshot-Paket erstellt, das die Inhalte enthält, die überschrieben werden.
Dieser Snapshot wird wieder installiert, wenn Sie das Paket deinstallieren.
Wenn Sie digitale Assets installieren, müssen Sie:
als Erstes den WorkflowLauncher deaktivieren.
Verwenden Sie die Menüoption „Komponenten“ der OSGi-Konsole zur Deaktivierung der Option com.day.cq.workflow.launcher.impl.WorkflowLauncherImpl
.
als Nächstes den WorkflowLauncher reaktivieren, wenn die Installation abgeschlossen ist.
Die Deaktivierung des WorkflowLauncher gewährleistet, dass die Assets nach der Installation nicht (versehentlich) vom Asset-Importer-Framework verändert werden.
Navigieren Sie im Package Manager zum Paket, das Sie installieren wollen.
Die Schaltfläche Installieren wird neben den Paketen angezeigt, die noch nicht installiert wurden.
Alternativ können Sie das Paket öffnen, indem Sie auf das zugehörige Symbol klicken und dann auf die Schaltfläche Installieren zugreifen.
Klicken Sie auf Installieren, um die Installation zu starten. Es wird ein Dialogfeld mit einer Liste aller vorgenommenen Änderungen und der Aufforderung zur Bestätigung angezeigt. Wenn Sie fertig sind, klicken Sie im Dialogfeld auf Schließen.
Das Wort Installiert wird neben dem Paket angezeigt, nachdem es installiert wurde.
Es gibt eine alternative Methode, um Pakete auf Ihre Instanz hochzuladen und dort zu installieren. In Ihrem Dateisystem verfügen Sie über eine crx-quicksart
Ordner neben Ihrer JAR-Datei und license.properties
-Datei. Sie müssen einen Ordner mit dem Namen install
under crx-quickstart
. Sie haben dann Folgendes: <aem_home>/crx-quickstart/install
In diesem „install“-Ordner können Sie die Pakete direkt hinzufügen. Sie werden automatisch auf Ihre Instanz hochgeladen und dort installiert. Anschließend können Sie die Pakete im Package Manager sehen.
Wird Ihre Instanz ausgeführt und Sie fügen dem install
-Ordner ein Paket hinzu, werden der Upload und die Installation direkt auf der Instanz gestartet. Wird Ihre Instanz nicht ausgeführt, werden die von Ihnen dem install
-Ordner hinzugefügten Pakete beim Start in alphabetischer Reihenfolge installiert.
Sie können dies auch tun, bevor Sie die Instanz das erste Mal starten. Dazu müssen Sie zunächst den Ordner crx-quickstart
manuell erstellen, dann unter diesem Ordner den Ordner install
erstellen und die Pakete dort speichern. Wenn Sie dann Ihre Instanz das erste Mal starten, werden die Pakete in alphabetischer Reihenfolge installiert.
AEM ermöglicht die Deinstallation von Paketen. Durch diese Aktion werden die Inhalte des Repositorys zurückgesetzt, die im Snapshot enthalten sind, der unmittelbar vor der Paketinstallation erstellt wurde.
Nach der Installation wird ein Snapshot-Paket erstellt, das die Inhalte enthält, die überschrieben werden.
Dieses Paket wird wieder installiert, wenn Sie das Paket deinstallieren.
So löschen Sie ein Paket aus der/den Package Manager-Liste(n):
Die installierten Dateien/Knoten aus dem Paket werden nicht gelöscht.
Im Instrumente Konsolen, erweitern Sie die Pakete Ordner, um Ihr Paket im rechten Bereich anzuzeigen.
Klicken Sie auf das zu löschende Paket, um es zu markieren, und:
Daraufhin werden sie von AEM aufgefordert zu bestätigen, dass Sie das Paket löschen möchten. Klicken Sie auf OK, um den Löschvorgang zu bestätigen.
Falls dieses Paket bereits installiert wurde, werden die installierten Inhalte nicht gelöscht.
Replizieren Sie die Inhalte eines Pakets, um sie auf der veröffentlichten Instanz zu installieren:
Navigieren Sie im Package Manager zu dem Paket, das Sie replizieren möchten.
Klicken Sie auf das Symbol oder den Namen des Pakets, das Sie replizieren möchten, um es zu erweitern.
Wählen Sie in der Symbolleiste das Dropdown-Menü Mehr und dann die Option Replizieren aus.
Package Share war ein zentralisierter Server, der öffentlich für die Freigabe von Inhaltspaketen zur Verfügung gestellt wurde.
Sie wurde ersetzt durch Softwareverteilung.
Softwareverteilung ist die neue Benutzeroberfläche, die die Suche und den Download von AEM-Paketen vereinfacht.
Weitere Informationen finden Sie in der Dokumentation zur Software-Verteilung.
AEM Paketmanager kann derzeit nicht mit Software Distribution verwendet werden. Sie laden Ihre Pakete auf Ihre lokale Festplatte herunter.