Installing Archibus Web Central with Linux or Unix

On Linux or Unix, you configure the Archibus Web Central application the same as you do when installing on Windows; however, the mechanics of installing the files are slightly different.

This section covers details of the reference installation using Apache Tomcat on Linux.

Install the JDK and Apache Tomcat

To install the application server

  1. Obtain the Java Development Kit or Runtime Edition.
  2. Obtain a Tomcat zipped archive file from http://www.apache.org
  3. Run the Java Development Kit setup program.
  4. Extract the Tomcat archive to an appropriate location, such as/opt/tomcat or /usr/local/tomcat.

 To start Tomcat without an initialization script:

  1. Set the JAVA_HOME variable. For instance:

    export JAVA_HOME=/usr/java/jdk1.x.x

  2. Set scripts execute permissions on startup.sh, shutdown.sh, and Catalina. For instance:

    chmod 750 startup.sh

  3. Change directories to the Tomcat directory and run \bin\startup.sh. For instance:

    cd /opt/tomcat
    [username@bart tomcat]$ bin/startup.sh

Install the Archibus Web Central Application

  1. Stop Tomcat if it automatically started during installation. To do so, run \bin\shutdown.sh from the Tomcat binary folder.
  2. Copy archibus.war to the <Tomcat Home>/webapps directory
  3. Make an archibus directory (e.g. use "mkdir archibus")
  4. Extract the WAR to the newly created archibus directory (you can use unzip, gzip, gunzip, etc., e.g. gunzip -r archibus.war)
  5. When extraction is complete, copy your ai-licenses.bin file to the <Tomcat Home>/webapps/archibus/WEB-INF/config directory.
  6. Also, modify <Tomcat Home>/webapps/archibus/WEB-INF\config\context\compatibility\afm-config.xml and <Tomcat Home>/webapps/archibus/WEB-INF/config/afm-projects.xml as appropriate for your location.
  7. Start Tomcat using the instructions above, or create an initialization script for Tomcat.