User Tools

Site Tools


Installing or Upgrading EASA Software

Download the EASA installer package either to begin a new installation, or to upgrade to a newer version.

New Installations

The new installation process requires the following:

  1. Install the EASA Server software.
  2. Request/install license keys for use beyond the 30-day trial period.
  3. Test the EASA Server.
  4. Configure user accounts on the EASA Server.
  5. Optionally, configure Compute Servers to work with the EASA Server.
  6. Optionally, configure connections from the EASA Server to external databases.

Upgrade Installations

The process to upgrade an existing installation to a newer version requires the following:

  1. Install the EASA Server.
  2. Test the EASA Server.

The EASA Help Pages provide detailed instructions on installing and testing the EASA Server and also provide solutions to many common problems. However if further assistance is needed, please email support@easasoftware.com.

Pre-Installation Issues

Before providing instructions on installing the EASA Server, there are a few issues regarding the installation of EASA that need to be addressed in order for the installation process to proceed smoothly.

Other Web Server Software

If another web server such as Microsoft Internet Information Services (IIS) is already installed and listening on port 80; the EASA Server will be installed on a different port which is displayed during the installation process. If no other web server software is running, the EASA Server will be installed on the default (HTTP) port 80.

Tomcat Already on EASA Server

Tomcat™ (6.x or 8.x) is third party software that is required and installed as part of the EASA Server.

However if Tomcat is already installed and running, we suggest one of two actions:

  • Select a different computer that does not have Tomcat installed on it to be the EASA Server, or
  • Remove the existing version of Tomcat from the computer before installing EASA on it.

Running EASA as a Service

On computers running Windows the EASA Server is installed and configured by default to run as a 'service'. On computers running Linux EASA can be set up to run as a service after completing the installation as described in Running EASA as a Service.


Note: Installing the EASA Server as a service during the EASA installation is completely automatic on Windows. If needed, manually configure the service to use a particular user account to login, as described in Running EASA as a Service.


Java Runtime Environment on Linux Servers

The EASA installer for Linux computers does not include a Java Runtime Environment (jre) as it did with past versions. A jre version 1.7 or later must be installed on the computer prior to installing EASA for the installation to work properly.

Packages in Linux

Linux distributions such as Ubuntu Server should have all of the packages required to run the EASA installer and to run the EASA Server. One exception to this is C Shell (csh), which may not be included in your distribution by default and is required for correct operation of Compute Servers. If you do not know if csh is included in your distribution, simply install EASA and afterwards, check the EASA→Administrator→Configure→Compute Servers EASA web page.

If the local Compute Server is showing as 'inactive', it is likely that csh needs to be installed, as follows:

  • yum install csh on RHEL variants
  • apt-get install csh on Debian variants

Installation of EASA Software

Please follow the step-by-step instructions provided below to install the EASA software.


Note: To upgrade from a previous version of EASA: first stop the EASA Server if it is running, and then remove any Start EASA or Start Tomcat shortcuts from the startup folder.


  • Log on to the EASA Server machine as Administrator on Windows or as root on Linux.
  • Start the installation process by performing one of the following steps:
    • On Windows double-click on the EASA Server installation executable (.exe) file
    • On Linux run the EASA Server installation executable (.sh) file
  • After the EASA Installation Wizard initializes, the first window to appear will be the 'Welcome' window, which provides an introduction to the installation process. To continue, click on Next
  • The next window to appear will be the License Agreement window. To continue installing EASA, the radio button next to 'I accept the agreement' must be selected and then click on Next. If the terms of the License Agreement are not accepted the installation process will be terminated.
  • The Select Destination Directory window appears next and prompts for the folder in which to install EASA. Make a selection and then click on Next to continue

Note: The selected folder will be referred to as <EASAROOT>


Next appears the 'Select Installation Type' window which offers three choices:

  • Standard installation – installs EASA Server with a commonly required set of components and with default server settings

  • Custom installation – installs EASA Server with default server settings, but allows selecting the components installed. Most commonly used to install the spreadsheet support or Compute Server components on remote Excel Servers or Compute Servers.

  • Advanced – allows a choice of both the components installed and the server settings. Most commonly used to install multiple EASA installations on the same computer

Select one and Click on Next to continue.

For Custom and Advanced installations, the Select Components window appears. Choose from the following components:

  • Default Container→cannot be unchecked, installs the Tomcat server

  • EASA Server→this is necessary to host the EASA Web Pages

  • Web Browser Access→the JSF components—necessary to run Web Browser Client based EASAPs and is also recommended for Excel Servers

  • Web Service Access→the web 'service' component required for web service access

  • Spreadsheet Support→installs the Excel Server component, required to open EASAPs that connect to an Excel spreadsheet

  • Compute Server →necessary to run batch processes on a remote server

The 'Data Folder' window appears next and prompts for a folder in which to save User data. This folder is also referred to as <SERVERDATA>. Make your selection and then click on Next to continue


Note: The full path of the 'Data Folder' cannot contain more than 218 characters.


The following two steps are completed only when performing an Advanced installation. These steps allow for installing multiple EASA Server installations on the same computer. In this case, each EASA Server must have a unique port number and a unique Windows service name.

  • For Advanced installations, the 'Server Port Number' screen appears. Set the server port number selected by the installer and the Shutdown port number here. The default value will be 80 for the Server port number unless it is already in use, then a different value, such as 8081, will be selected. Enter the desired values for both port numbers and then click on Next
  • For Windows: the next screen asks whether to install a Windows service for EASA and whether to change the service name. Make a selection and then click on Next

Now we check the configuration before installation begins:

  • The 'Summary' screen appears next, and if the settings are correct, then click on Next to install EASA
  • Finally the 'Completing Setup' window appears. Select whether to Start EASA Server now (Windows systems only) and click Finish

Note: The 'Completing Setup' window will display the URL or address that can be used to access EASA from the EASA Server. Please note if a port number other than 80 has been chosen. To access EASA from a different computer, the correct domain name must be substituted for ‘localhost’. See Testing the EASA Web Pages for details.