Install Engine

The following guide explains how to install a Crafter Engine instance in a QA or production Unix-based server.

  1. Download the This file contains already Tomcat 7 with the Engine and Search WARs.
  2. Unzip the to any folder (from now on this folder will be referred as INSTALL_DIR). The recommended INSTALL_DIR is /opt/crafter/bin/delivery.
  3. Add the JAVA_HOME variable to INSTALL_DIR/apache-tomcat/bin/
  4. Add the JAVA_OPTS variable to INSTALL_DIR/apache-tomcat/bin/ (e.g. JAVA_OPTS="$JAVA_OPTS -server -Xms2G -Xmx8G -XX:MaxPermSize=512M").
  5. Remove the JAVA_OPTS variable from INSTALL_DIR/bin/
  6. If you need Engine to serve multiple sites, follow the guide Configure Multi-Tenancy in Engine.
  7. If you didn’t follow the multi tenancy guide, remember to change the root path of the site content:
    1. In INSTALL_DIR/apache-tomcat/shared/classes/crafter/engine/extension/, update the value of (e.g.
  8. Change the path where the preview Solr search indexes will be stored, e.g. /opt/crafter/data/preview-indexes:
    1. In INSTALL_DIR/apache-tomcat/solr-crafter/conf/solrconfig.xml, update the value of <dataDir> to the preview indexes folder path (e.g. <dataDir>/opt/crafter/data/preview-indexes</dataDir>).
  9. Change the path where the Tomcat and deployer logs will be stored. A good path is /opt/crafter/logs:
    1. In INSTALL_DIR/apache-tomcat/conf/, change the values of,, and to the logs folder path.
    2. In INSTALL_DIR/crafter-deployer/log4j.xml, change the value of File param of the file appender to include the logs folder path (e.g. /opt/crafter/logs/deployment.log).