Alfresco Documentation
Published on Alfresco Documentation (https://docs.alfresco.com)

Home > Alfresco Community Edition 201911 GA > Deploying > Installing using distribution zip > Installing Alfresco Community Edition on Tomcat > Installing the Alfresco WARs

Installing the Alfresco WARs

A WAR file is an archive file used to distribute a collection of files (JavaServer Pages, servlets, Java classes, XML files, tag libraries, and static web pages) that together constitute a web application.
Use this method of installing if you've already installed a JRE, a supported database, an application server, a message broker, and the additional components.
The Alfresco Community Edition Distribution file is a zip containing the required WAR files, in addition to the additional commands, and configuration files for a manual installation.
  1. Download the following file:

    alfresco-content-services-community-distribution-6.2.0-ga.zip

  2. Specify a location for the download and extract the file to a system directory; for example <installLocation>.

    You'll see the following directory structure. For more details, see Alfresco Community Edition directory structure [1].

    alfresco-pdf-renderer
    amps
    bin
    licenses
    web-server

    Important: If you do not apply the Share Services AMP to the repository, Alfresco Share will not work correctly, and when you start up Share, you will see the message: Alfresco Community Edition is running without Share Services. See your System Administrator for more details.

  3. Move the WAR files from /web-server/webapps to the appropriate location for your application server.

    For example, for Tomcat, move the WAR files to the <TOMCAT_HOME>/webapps directory.

  4. Move the contents from /conf, and /lib under /web-server to the appropriate location for your application server.

    For example, for Tomcat, move the files to the existing directories under <TOMCAT_HOME>.

  5. Remove all directories in <TOMCAT_HOME>/webapps.

    If you don't remove these directories, then the WAR files aren't deployed when the server starts.

  6. Set the global properties as shown:
    1. Copy /web-server/shared/classes/alfresco-global.properties.sample to <TOMCAT_HOME>/shared/classes.
    2. Replace the sample configuration with the following:

      #
      # Set this property unless you have explicitly chosen to expose some repository APIs without authentication
      solr.secureComms=https
      
      #
      # Custom content and index data location
      #
      dir.root=/srv/alfresco/alf_data
      dir.keystore=${dir.root}/keystore
      
      #
      # Sample database connection properties
      #
      db.username=alfresco
      db.password=alfresco
      
      #
      # Choose DB connection properties for your database, e.g. for PostgreSQL
      #
      db.driver=org.postgresql.Driver
      db.url=jdbc:postgresql://localhost:5432/alfresco
      
      #
      # URL Generation Parameters (The ${localname} token is replaced by the local server name)
      #-------------
      alfresco.context=alfresco
      alfresco.host=${localname}
      alfresco.port=8080
      alfresco.protocol=http
      share.context=share
      share.host=${localname}
      share.port=8080
      share.protocol=http
  7. Save the file without the .sample extension.
  8. Install Alfresco Search Services.

    See Installing and configuring Alfresco Search Services [2] for more information.

You are now ready to install any additional software that you require. See Installing additional software for Alfresco Community Edition [3] and Installing integrations [4] for more information.
Note: If you deployed previous versions of Alfresco Community Edition, you must remove any temporary files created by your application server. Use the clean_tomcat.bat or clean_tomcat.sh command.
Important: After installation, you must generate and install your own certificates to secure the installation. For more information, see Generating secure keys [5].
  • Alfresco Community Edition directory structure [1] After you've extracted the Alfresco Community Edition distribution zip, several directories and configuration files will be available in the Alfresco Community Edition home directory. This includes the required WAR files, additional commands, and configuration files for a manual installation.
Parent topic: Installing Alfresco Community Edition on Tomcat [6]

Alfresco Community Edition directory structure

After you've extracted the Alfresco Community Edition distribution zip, several directories and configuration files will be available in the Alfresco Community Edition home directory. This includes the required WAR files, additional commands, and configuration files for a manual installation.

  • alfresco-pdf-renderer: This directory contains the alfresco-pdf-renderer binary files for Linux and Windows
    File name Description
    alfresco-pdf-renderer-1.0-linux.tgz alfresco-pdf-renderer binary for Linux
    alfresco-pdf-renderer-1.0-win64.tgz alfresco-pdf-renderer binary for Windows
  • amps: This directory contains the Alfresco Share AMP
  • bin: This directory contains the following files
    File name Description
    apply_amps.bat Windows batch file for Tomcat application server installs, used to apply all AMP files in the <installLocation> directory.
    apply_amps.sh Linux script file for Tomcat application server installs, used to apply all AMP files in the <installLocation> directory.
    clean_tomcat.bat Windows batch file for cleaning out temporary application server files from previous installations.
    clean_tomcat.sh Linux script for cleaning out temporary application server files from previous installations.
    alfresco-mmt.jar Alfresco Module Management Tool (MMT).
  • licenses: This directory contains third-party license files
  • web-server: This directory has a standard Tomcat structure and contains the following sub-folders and files
    Folder/File Description
    /lib This directory contains the PostgreSQL JDBC jar file
    /shared This directory includes a number of configuration files for Alfresco Content Services
     
    • /shared/classes/alfresco-global.properties.sample

      The sample global properties file, which is used for configuration properties

     
    • /shared/classes/alfresco-encrypted.properties.sample

      A sample encrypted properties overlay file

     
    • /shared/classes/alfresco

      Contains the directory structure for the configuration override files including the extension and web-extension directories

    /webapps Contains the following files:
     
    • alfresco.war - Alfresco WAR file
     
    • ROOT.war - Application for the server root

      The ROOT.war application is required to enable Alfresco Office Services (AOS). See Installing Alfresco Office Services manually into an existing web application [7].

     
    • share.war - Alfresco Share WAR file
  • VERSIONS.md: This file provides a list of recommended components for the latest Alfresco Community Edition release

Parent topic: Installing the Alfresco WARs [8]

Source URL: https://docs.alfresco.com/community/tasks/alf-war-install.html

Links:
[1] https://docs.alfresco.com/../concepts/dist-zip-structure.html
[2] https://docs.alfresco.com/search-community/concepts/solr-install-config.html
[3] https://docs.alfresco.com/../concepts/prereq-opt-install.html
[4] https://docs.alfresco.com/../concepts/install-integrations-overview.html
[5] https://docs.alfresco.com/search-community/concepts/generate-keys-overview.html
[6] https://docs.alfresco.com/../tasks/alf-tomcat-install.html
[7] https://docs.alfresco.com/aos/tasks/install-server-root.html
[8] https://docs.alfresco.com/../tasks/alf-war-install.html