Installation des Anwendungs-Servers

Letzte Aktualisierung: 2023-12-04
HINWEIS

JAR und WAR sind die Dateitypen, in denen Adobe Experience Manager (AEM) veröffentlicht wird. Diese Formate unterliegen einer Qualitätssicherung, um den Support-Level zu berücksichtigen, zu denen sich Adobe verpflichtet hat.

In diesem Abschnitt erfahren Sie, wie Sie Adobe Experience Manager (AEM) mit einem Anwendungsserver installieren. Lesen Sie die Unterstützte Plattformen Informationen zu den spezifischen Unterstützungsebenen für die einzelnen Anwendungsserver.

Es werden die Installationsschritte der folgenden Anwendungsserver beschrieben:

Lesen Sie die entsprechende Anwendungsserverdokumentation, um weitere Informationen über das Installieren von Webanwendungen, Serverkonfigurationen und darüber zu erhalten, wie der Server gestartet und angehalten wird.

HINWEIS

Wenn Sie Dynamic Media in einer WAR-Bereitstellung verwenden, lesen Sie Dynamic Media-Dokumentation.

Allgemeine Beschreibung

Standardverhalten beim Installieren von AEM auf einem Anwendungsserver

AEM wird als einzelne WAR-Datei bereitgestellt.

Bei Bereitstellung geschieht standardmäßig Folgendes:

  • Der Ausführungsmodus lautet author.

  • Die Instanz (Repository, Felix OSGI-Umgebung, Bundles usw.) wird in installiert. ${user.dir}/crx-quickstartwhere ${user.dir} das aktuelle Arbeitsverzeichnis ist, wird dieser Pfad zu crx-quickstart aufgerufen sling.home

  • Der Kontextstamm ist beispielsweise der Name der WAR-Datei. aem-6

Konfiguration

Sie können das Standardverhalten wie folgt ändern:

  • Ausführungsmodus: Konfigurieren Sie den Parameter sling.run.modes in der Datei WEB-INF/web.xml der AEM-WAR-Datei vor der Bereitstellung.

  • sling.home: Konfigurieren Sie den Parameter sling.home in der Datei WEB-INF/web.xml der AEM-WAR-Datei vor der Bereitstellung.

  • Kontextstamm: Benennen Sie die AEM-WAR-Datei um.

Installationsveröffentlichung

Um eine Veröffentlichungsinstanz bereitzustellen, müssen Sie den Ausführungsmodus auf "publish"festlegen:

  • Entpacken Sie WEB-INF/web.xml aus der WAR-Datei AEM
  • Ändern Sie den Parameter „sling.run.modes“ in „publish“ (veröffentlichen).
  • Datei "web.xml"in AEM WAR-Datei replizieren
  • Stellen Sie die AEM-WAR-Datei bereit.

Installationsprüfung

Um zu überprüfen, ob alle installiert sind, können Sie Folgendes tun:

  • Untersuchen der Datei error.log, um anzuzeigen, ob der gesamte Inhalt installiert ist.
  • Überprüfen in /system/console, ob alle Bundles installiert sind

Zwei Instanzen auf demselben Anwendungsserver

Zu Demonstrationszwecken kann es sinnvoll sein, die Autoren- und Veröffentlichungsinstanz auf einem Anwendungsserver zu installieren. Gehen Sie dazu wie folgt vor:

  1. Ändern Sie die Variablen „sling.home“ und „sling.run.modes“ der Veröffentlichungsinstanz.
  2. Entpacken Sie die Datei „WEB-INF/web.xml“ aus der AEM-WAR-Datei.
  3. Ändern Sie den Parameter sling.home in einen anderen Pfad (absolute und relative Pfade sind möglich).
  4. Ändern Sie „sling.run.modes“ für die Veröffentlichungsinstanz in „publish“ (veröffentlichen).
  5. Packen Sie die Datei „web.xml“ erneut.
  6. Benennen Sie die WAR-Dateien um, sodass sie unterschiedliche Namen haben. Beispielsweise wird ein Name in aemauthor.war und ein anderer in aempublish.war umbenannt.
  7. Verwenden Sie höhere Speichereinstellungen. Beispiel: Standardinstanzen verwenden AEM -Xmx3072m
  8. Stellen Sie die beiden Webanwendungen bereit.
  9. Halten Sie nach der Bereitstellung die beiden Webanwendungen an.
  10. Stellen Sie in den Erstellungs- und Veröffentlichungsinstanzen sicher, dass in den „sling.properties“-Dateien die Eigenschaft „felix.service.urlhandlers=false“ auf „false“ festgelegt ist (standardmäßig ist der Wert auf „true“ gesetzt).
  11. Starten Sie die beiden Webanwendungen erneut.

Installationsverfahren für Anwendungsserver

WebSphere® 8.5

Lesen Sie oben Allgemeine Beschreibung, bevor Sie eine Bereitstellung vornehmen.

Servervorbereitung

  • Lassen Sie einfache Auth-Header durchgehen:

    • Eine Möglichkeit, AEM Benutzer authentifizieren zu können, besteht darin, die globale Verwaltungssicherheit des WebSphere®-Servers zu deaktivieren. Gehen Sie dazu zu Sicherheit > Globale Sicherheit und deaktivieren Sie das Kontrollkästchen Enable administrative security , speichern und starten Sie den Server neu.
  • set "JAVA_OPTS= -Xmx2048m"

  • Wenn Sie AEM mit Kontextstamm = / installieren möchten, ändern Sie den Kontextstamm der vorhandenen Standard-Webanwendung.

Bereitstellung der AEM-Webanwendung

  • Laden Sie die AEM-WAR-Datei herunter.

  • Nehmen Sie bei Bedarf Konfigurationen in web.xml vor (siehe oben in der allgemeinen Beschreibung).

    • Entpacken Sie die Datei „WEB-INF/web.xml“.
    • Ändern Sie den Parameter „sling.run.modes“ in „publish“ (veröffentlichen).
    • Entfernen Sie die Kommentarzeichen für den ursprünglichen Parameter „sling.home“ und legen Sie diesen Pfad nach Bedarf fest.
    • Packen Sie die Datei „web.xml“ erneut.
  • Bereitstellen der AEM-WAR-Datei

    • Wählen Sie einen Kontextstamm aus (wenn Sie die Sling-Ausführungsmodi festlegen möchten, müssen Sie die detaillierten Schritte des Bereitstellungsassistenten auswählen und dann in Schritt 6 des Assistenten angeben)
  • AEM Webanwendung starten

JBoss® EAP 6.3.0/6.4.0

Lesen Sie oben Allgemeine Beschreibung, bevor Sie eine Bereitstellung vornehmen.

Vorbereiten des JBoss®-Servers

Legen Sie Memory-Argumente in Ihrer conf-Datei fest (z. B. standalone.conf)

  • JAVA_OPTS="-Xms64m -Xmx2048m"

Wenn Sie den Bereitstellungsscanner verwenden, um die AEM Webanwendung zu installieren, kann es sinnvoll sein, die deployment-timeout, für die deployment-timeout -Attribut in der XML-Datei Ihrer Instanz (z. B. configuration/standalone.xml):

<subsystem xmlns="urn:jboss:domain:deployment-scanner:1.1">
            <deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" deployment-timeout="1000"/>
</subsystem>

Bereitstellung der AEM-Webanwendung

  • Laden Sie die AEM Webanwendung in Ihre JBoss® Administration Console hoch.

  • Aktivieren Sie die AEM-Webanwendung.

Oracle WebLogic 12.1.3/12.2

Lesen Sie oben Allgemeine Beschreibung, bevor Sie eine Bereitstellung vornehmen.

Hierbei wird ein einfaches Server-Layout mit nur einem Admin-Server verwendet.

WebLogic Server-Vorbereitung

  • Fügen Sie in ${myDomain}/config/config.xml Folgendes zum Abschnitt „security-configuration“ hinzu:

  • Erhöhen Sie den für die virtuelle Maschine eingestellten Arbeitsspeicherwert:

    • open ${myDomain}/bin/setDomainEnv.cmd (bzw. .sh) Suchen Sie nach WLS_MEM_ARGS, legen Sie beispielsweise WLS_MEM_ARGS_64BIT=-Xms256m -Xmx2048m
    • Starten Sie WebLogic Server neu.
  • Erstellen Sie unter ${myDomain} einen Ordner „packages“ und darin einen Ordner „cq“ mit einem Ordner „Plan“.

Bereitstellung der AEM-Webanwendung

  • Laden Sie die AEM-WAR-Datei herunter.

  • Legen Sie die AEM-WAR-Datei im Ordner „${myDomain}/packages/cq“ ab.

  • Nehmen Sie bei Bedarf Konfigurationen in WEB-INF/web.xml vor (siehe oben unter „Allgemeine Beschreibung“).

    • Entpacken Sie die Datei WEB-INF/web.xml.
    • Ändern Sie den Parameter „sling.run.modes“ in „publish“ (veröffentlichen).
    • Entfernen Sie die Kommentarzeichen für den anfänglichen Parameter „sling.home“ und legen Sie diesen Pfad nach Bedarf fest (siehe „Allgemeine Beschreibung“).
    • Packen Sie die Datei „web.xml“ erneut.
  • Bereitstellen AEM WAR-Datei als Anwendung (für die anderen Einstellungen verwenden Sie die Standardeinstellungen)

  • Die Installation kann einige Zeit dauern…

  • Vergewissern Sie sich, dass die Installation wie oben in der allgemeinen Beschreibung beschrieben abgeschlossen ist (z. B. durch Aufrufen der Datei error.log).

  • Sie können den Kontextstamm auf der Konfigurationsregisterkarte der Webanwendung in der WebLogic-/console ändern.

Tomcat 8/8.5

Lesen Sie oben Allgemeine Beschreibung, bevor Sie eine Bereitstellung vornehmen.

  • Tomcat-Servervorbereitung

    • Erhöhen Sie den für die virtuelle Maschine eingestellten Arbeitsspeicherwert:

      • In bin/catalina.bat (resp catalina.sh Fügen Sie unter UNIX® die folgende Einstellung hinzu:
      • set "JAVA_OPTS= -Xmx2048m
    • Tomcat ermöglicht bei der Installation keinen Admin- oder Manager-Zugriff. Daher müssen Sie die tomcat-users.xml um Zugriff auf diese Konten zu gewähren:

      • Bearbeiten Sie tomcat-users.xml, um den Zugriff für Admin und Managerin bzw. Manager einzuschließen. Die Konfiguration sollte dem folgenden Beispiel ähneln:

        <?xml version='1.0' encoding='utf-8'?>
        <tomcat-users>
        role rolename="manager"/>
        role rolename="tomcat"/>
        <role rolename="admin"/>
        <role rolename="role1"/>
        <role rolename="manager-gui"/>
        <user username="both" password="tomcat" roles="tomcat,role1"/>
        <user username="tomcat" password="tomcat" roles="tomcat"/>
        <user username="admin" password="admin" roles="admin,manager-gui"/>
        <user username="role1" password="tomcat" roles="role1"/>
        </tomcat-users>
        
    • Wenn Sie AEM mit dem Kontextstamm "/"bereitstellen möchten, müssen Sie den Kontextstamm der vorhandenen ROOT-Webanwendung ändern:

      • Stoppen und Aufheben der Bereitstellung der ROOT-Webapp
      • Umbenennen des Ordners "ROOT.war"im Ordner "webapps"von Tomcat
      • Webapp erneut starten
    • Wenn Sie die AEM-Web-Anwendung mithilfe der manager-gui installieren, müssen Sie die maximale Größe einer hochgeladenen Datei erhöhen, da die Standardeinstellung nur eine Upload-Größe von 50 MB zulässt. Öffnen Sie dafür die Datei „web.xml“ der Manager-Webanwendung

      webapps/manager/WEB-INF/web.xml

      und erhöhen Sie die maximale Dateigröße und die maximale Anforderungsgröße auf mindestens 500 MB, siehe Folgendes multipart-config Beispiel eines solchen web.xml -Datei.

      <multipart-config>
      <!-- 500MB max -->
      <max-file-size>524288000</max-file-size>
      <max-request-size>524288000</max-request-size>
      <file-size-threshold>0</file-size-threshold>
      </multipart-config>
      
  • Bereitstellung der AEM-Webanwendung

    • Laden Sie die AEM-WAR-Datei herunter.

    • Nehmen Sie bei Bedarf Konfigurationen in web.xml vor (siehe oben in der allgemeinen Beschreibung).

      • Entpacken Sie die Datei „WEB-INF/web.xml“.
      • Ändern Sie den Parameter „sling.run.modes“ in „publish“ (veröffentlichen).
      • Entfernen Sie die Kommentarzeichen für den ursprünglichen Parameter „sling.home“ und legen Sie diesen Pfad nach Bedarf fest.
      • Packen Sie die Datei „web.xml“ erneut.
    • Benennen Sie AEM WAR-Datei in ROOT.war um, wenn Sie sie als Root-Webapp bereitstellen möchten. Benennen Sie sie beispielsweise in aemauthor.war um, wenn Sie aemauthor als Kontextstamm verwenden möchten.

    • Kopieren Sie es in den Ordner webapps von Tomcat.

    • warten, bis AEM installiert ist

Fehlerbehebung

Informationen zum Umgang mit Problemen, die während der Installation auftreten können, finden Sie unter:

Auf dieser Seite