You are here

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-ea.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.

    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 for more information.

You are now ready to install any additional software that you require. See Installing additional software for Alfresco Community Edition and Installing integrations 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.

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.