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
- Obtain the Java Development Kit or Runtime Edition.
- Obtain a Tomcat zipped archive file from http://www.apache.org
- Run the Java Development Kit setup program.
- Extract the Tomcat
archive to an appropriate location, such as
/opt/tomcat
or/usr/local/tomcat
.
To start Tomcat without an initialization script:
- Set the JAVA_HOME
variable. For instance:
export JAVA_HOME=/usr/java/jdk1.x.x
- Set scripts execute
permissions on startup.sh, shutdown.sh, and Catalina. For instance:
chmod 750 startup.sh
- 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
- Stop Tomcat if it automatically started during installation. To do so, run \bin\shutdown.sh from the Tomcat binary folder.
- Copy
archibus.war
to the<Tomcat Home>
/webapps
directory - Make an archibus
directory (e.g. use "
mkdir archibus
") - Extract the WAR to
the newly created archibus directory (you can use unzip, gzip, gunzip,
etc., e.g.
gunzip -r
archibus.war
) - When extraction is
complete, copy your
ai-licenses.bin
file to the<Tomcat Home>
/webapps
/archibus
/WEB-INF/config
directory. - 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. - Start Tomcat using the instructions above, or create an initialization script for Tomcat.