Linux Installation and Upgrade Instructions
  • 02 Jun 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Linux Installation and Upgrade Instructions

  • Dark
    Light
  • PDF

The SysAid package is available as a Web Archive file (.WAR file) and should be deployed to an existing Tomcat web application server. You will receive a link (http://cdn3.sysaid.com/sysaid-server-linux.tar.gz) to download this .war file when you either purchase or request a trial of SysAid.

 Installation with a MySQL database

Note:
If you are installing version15.4 or higher, ensure that you have allocated at least 1 GB of RAM. We recommend allocating 2 GB or more if your Linux architecture allows for it.
  1. Install any version of Oracle JAVA JRE 1.8. Java is available at http://java.sun.com/
  2. Install Tomcat 7.0.57. Tomcat is available at http://jakarta.apache.org/tomcat/
  3. Install MySQL version 5.x database server or above. MySQL is available in most of the Linux distributions and also available at http://dev.mysql.com/downloads/mysql/
  4. Create an empty database in the MySQL server.
  5. Deploy the sysaid.war file to the tomcat server. Usually, you will just need to copy it to the webapps directory, and Tomcat will automatically deploy it. A sysaid directory tree will be created in the deployed location (default is tomcat/webapps/sysaid).
  6. Stop the Tomcat server.
  7. For SysAid Basic/Full editions only: Place the license file (activation.xml) in tomcat/webapps/sysaid/WEB-INF/conf/activation.xml.
  8. Execute the init-sysaid.sh script. The first and only required parameter is the location of the deployed SysAid web application (e.g., ./init-sysaid.sh /usr/local/tomcat/webapps/sysaid ). Follow the instructions in that initialization script.
  1. Start the tomcat server.
  2. Try to access SysAid at http://<host>:<port>/sysaid.

 If you have any questions or problems, please email support@sysaid.com. In any case of error during installation, please attach the content of the logs folder at .../sysaid/WEB-INF/logs.

 Upgrade instructions for Linux

 In order to upgrade your SysAid to the latest version, please do the following: 

Note
If you are upgrading to version15.4 or higher, ensure that you have allocated at least 1 GB of RAM. We recommend allocating 2 GB or more if your Linux architecture allows for it.
  1. Download the latest upgrade patch for Linux at http://www.sysaid.com/release-upgrades.htm.
  2. Extract the file that you downloaded. Note the name of the extracted file.
  3. Stop the tomcat service.
  4. Run the shell script using the following syntax:
    sh <Extracted file name>
  5. Restart the tomcat service.
    Note:
    To run the above commands, you may need 'root' access.

 Upgrade instructions for Apache Tomcat

 Starting with version 8.5, SysAid supports Apache Tomcat 7.0.57. The following steps explains how to upgrade Apache Tomcat from version 6 to version 7 after upgrading to a Linux installation of SysAid version 8.5 or higher.

 To upgrade Tomcat from version 6 to version 7:

  1. Upgrade your SysAid to version 8.5.
  2. Install Apache Tomcat 7.0.57 (Can be installed in same folder as version 6).
  3. Move your SysAid folder (e.g. tomcat6/webapps/sysaid) to the Tomcat 7 destination folder (under webapps, e.g. tomcat7/webapps/sysaid).
  4. In the folder ../sysaid/WEB-INF/lib (e.g. tomcat7/webapps/sysaid/WEB-INF/lib), rename the following files:
    catalina.jar> catalina.jar_bk
    servlet-api.jar> servlet-api.jar_bk
  5. Start Tomcat.

Increase RAM for Java

 By default, only 256 MB of RAM are allocated for Java. However, it is recommended to allocate 1280 MB for the SysAid server on a 32 bit OS and 2048 MB for a 64 bit OS.

 To increase the amount of RAM allocated for JAVA for SysAid

  1. Backup the catalina.sh file.
  2. Edit the catalina.sh file located in the Tomcat bin directory.
  3. To increase the maximum Java heap size to:
    • 1280 MB: please insert the following lines:
      export JAVA_OPTS="-Xmx1280000000"
    •  2048 MB: please insert the following lines:
      export JAVA_OPTS="-Xmx2048000000"
  4. Save your changes and restart the Tomcat service

Was this article helpful?