Zum Hauptinhalt springen

Install

Overview​

Es gibt verschiedene Möglichkeiten, Alfresco Digital Workspace bereitzustellen. Sie können es mithilfe von Docker-Images bereitstellen, die in Helm-Charts gepackt sind, oder mithilfe von Docker Compose. Sie können Alfresco Content Services auch mithilfe von Standard-WAR-Dateien installieren, die in der ZIP-Datei der Distribution enthalten sind, und dann die Installation so konfigurieren, dass Alfresco Digital Workspace enthalten ist.

Die Bereitstellungsmethoden sind:

  • Installation in Tomcat
  • Installation auf einem anderen Webserver
  • Installation mit Docker Compose
    • Aufgrund der eingeschränkten Funktionen von Docker Compose wird diese Bereitstellungsmethode nur für Entwicklungs- und Testumgebungen empfohlen.

Installation in Tomcat​

Um Alfresco Digital Workspace in Tomcat zu installieren, müssen Sie zunächst Alfresco Content Services mithilfe der ZIP-Datei der Distribution installieren. Weitere Informationen finden Sie im Abschnitt Mit ZIP installieren der Dokumentation zu Alfresco Content Services.

Sie können die Release-Dateien von Hyland Community herunterladen. Melden Sie sich an, wählen Sie die Registerkarte Support und dann unter Software-Downloads die Option Alfresco-Downloads. Suchen Sie nach der gewünschten Produktversion und navigieren Sie zur Versionsseite.

  1. Laden Sie die Release-Datei alfresco-digital-workspace-adw-x.x.x.war herunter: wobei x.x.x die genaue Version ist, die in der Release-Datei angegeben ist.

  2. Verschieben Sie die WAR-Datei auf dem Server, der den digitalen Arbeitsbereich hosten wird, in den Ordner <TOMCAT_HOME>/webapps.

    Hinweis: Tomcat extrahiert die Dateien automatisch.

  3. Durchsuchen Sie das extrahierte Verzeichnis und öffnen Sie die Datei app.config.json in einem Texteditor.

  4. Bearbeiten Sie die Datei app.config.json und ändern Sie die Eigenschaft ecmHost so, dass sie mit Ihrem Alfresco Content Services-Server und dem zugewiesenen Port übereinstimmt. Beispiel: http://<acsservername>:port.

  5. Ändern Sie außerdem in der Datei app.config.json die Eigenschaft baseShareUrl so, dass sie mit Ihrem Digital Workspace-Server und dem zugewiesenen Port übereinstimmt. Beispiel: http://<appservername>:port/alfresco-digital-workspace-adw-x.x.x.

    Hinweis: Wenn Quickshare in Alfresco Content Services deaktiviert ist, ignorieren Sie diesen Schritt.

    Um Quickshare zu deaktivieren, setzen Sie system.quickshare.enabled=false in der Datei \tomcat\shared\classes\alfresco-global.properties. Weitere Informationen finden Sie im Abschnitt Verwendung von alfresco-global.properties in der Dokumentation zu Alfresco Content Services.

  6. Speichern Sie die Datei.

  7. Öffnen Sie Ihren Browser und rufen Sie den Digital Workspace auf: http://<appservername>:8080/alfresco-digital-workspace-adw-x.x.x.

Installation auf einem anderen Webserver​

Sie können Alfresco Digital Workspace auf einem anderen Webserver als dem, auf dem Alfresco Content Services ausgeführt wird, bereitstellen. Sie können eine andere Instanz von Tomcat, einen leichtgewichtigen Webserver wie NGINX oder einen Webserver Ihrer Wahl verwenden. Zunächst müssen Sie Alfresco Content Services mithilfe der ZIP-Datei der Distribution installieren. Weitere Informationen finden Sie im Abschnitt Installieren mit ZIP-Datei der Dokumentation zu Alfresco Content Services.

Sie können die Release-Dateien von der Hyland Community herunterladen. Melden Sie sich an, wählen Sie die Registerkarte Support und dann unter Software-Downloads die Option Alfresco-Downloads. Suchen Sie nach der gewünschten Produktversion und navigieren Sie zur Versionsseite.

  1. Laden Sie die Release-Datei alfresco-digital-workspace-adw-x.x.x.zip herunter. Dabei steht x.x.x für die genaue Version, die in der Release-Datei angegeben ist.

  2. Entpacken Sie die Dateien auf dem Server, auf dem Sie den Digital Workspace hosten möchten, unter <webserver-location>/html.

    Hinweis: Dies ist der öffentliche HTML-Ordner.

  3. Durchsuchen Sie die extrahierten Dateien und öffnen Sie app.config.json in einem Texteditor.

  4. Bearbeiten Sie die Datei app.config.json und ändern Sie die Eigenschaft ecmHost so, dass sie mit Ihrem Alfresco Content Services-Server und dem zugewiesenen Port übereinstimmt. Beispiel: http://<acsservername>:port.

  5. Ändern Sie in der Datei app.config.json auch die Eigenschaft baseShareUrl so, dass sie dem Servernamen des Digital Workspace entspricht. Beispiel: http://<appservername>:port/alfresco-digital-workspace-adw-x.x.x.

    Hinweis: Wenn Quickshare in Alfresco Content Services deaktiviert ist, ignorieren Sie diesen Schritt.

    Um Quickshare zu deaktivieren, setzen Sie system.quickshare.enabled=false in der Datei \tomcat\shared\classes\alfresco-global.properties. Weitere Informationen finden Sie im Abschnitt „Verwendung von alfresco-global.properties“ in der Dokumentation zu Alfresco Content Services.

  6. Speichern Sie die Datei.

  7. Öffnen Sie Ihren Browser und rufen Sie den Digital Workspace auf: http://<appservername>:8080/alfresco-digital-workspace-adw-x.x.x.

    Hinweis: Wenn Sie Alfresco Digital Workspace auf einem anderen Webserver bereitstellen, wird empfohlen, Cross-Origin Resource Sharing (CORS) einzurichten. Weitere Informationen finden Sie im Abschnitt zur CORS-Konfiguration in der Dokumentation zu Alfresco Content Services und auf der Website zu Cross-Origin Resource Sharing.

Installation mit Docker Compose​

Alfresco Digital Workspace wird als Teil von Alfresco Content Services mithilfe von Helm-Charts oder einer Docker Compose-Datei bereitgestellt. Beide Methoden umfassen einen leichtgewichtigen, vorkonfigurierten NGINX-Server und die Digital Workspace-Anwendung. Aufgrund der eingeschränkten Funktionen von Docker Compose wird diese Bereitstellungsmethode nur für Entwicklungs- und Testumgebungen empfohlen.

Es wird empfohlen, sich mit den Konzepten der containerisierten Bereitstellung vertraut zu machen, bevor Sie mit Helm-Charts und Docker arbeiten. Weitere Informationen finden Sie im Abschnitt Übersicht über Container der Alfresco Content Services Dokumentation.

Informationen zur Bereitstellung von Digital Workspace mit Helm-Charts oder Docker Compose finden Sie unter:

  • Abschnitt Installation mit Helm der Alfresco Content Services-Dokumentation
  • Abschnitt Installation mit Docker Compose der Alfresco Content Services-Dokumentation