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 Content Services Distribution file is a zip containing the required WAR files, in addition to the additional commands, and configuration files for a manual installation.
  1. Browse to the Support Portal at http://support.alfresco.com.
  2. Download the following file:

    alfresco-content-services-distribution-6.1.x.zip

  3. 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 Content Services 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 Content Services is running without Share Services. See your System Administrator for more details.

  4. 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. If you already have a web application that's running in the server root, see Installing into an existing web application for instructions on how to merge the files into your application.

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

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

  7. 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
  8. Save the file without the .sample extension.
  9. 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 Content Services and Installing integrations for more information.
Note: If you deployed previous versions of Alfresco Content Services, you must remove any temporary files created by your application server. Use the clean_tomcat.bat or clean_tomcat.sh command.
Note: If you are installing the S3 Connector as part of your installation, do not start Alfresco Content Services before applying the S3 AMP file.
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.