User Tools

Site Tools


Install or Upgrade EASA Software

To begin a new installation or upgrade to a newer version, download the EASA installer.


New Installation

The new installation process involves the following sequence of steps:

  • Install the EASA Server software.
  • Request and install license keys for use beyond the 30-day trial period.
  • Test the EASA Server.
  • Configure user accounts on the EASA Server.
  • Optionally, configure Compute Servers to work with the EASA Server.
  • 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:

  • Install the EASA Server.
  • 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, especially when migrating to a newer version of EASA, please email support@easasoftware.com.


Pre-Installation Issues


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 install itself on a different port displayed during installation. If no other web server software is running, the EASA Server will install itself on the default HTTP port 80.


Tomcat Already installed on an 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, follow one of these suggestions:

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

Run EASA as a Service

On computers running Windows the EASA Server is installed and configured automatically by default to run as a 'service'. To manually configure the service to use a particular user account to log in, see Run EASA as a Service.

On computers running Linux EASA can be set up to run as a service after completing the installation as described in Run 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 beforehand if EASA is 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 the distribution by default but is required for correct operation of Compute Servers. If csh is not included in the distribution, simply install EASA and afterwards, check the page:

  • EASA→Administrator→Configure→Compute Servers

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

Install EASA

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

To upgrade from a previous version of EASA:

  • Stop the EASA Server if it is running
  • 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)
    • 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. The installation process terminate if the terms of the License Agreement are not accepted.
  • The Select Destination Directory window appears next
  • Select a folder in which to install EASA
  • Click Next

These Help Pages will refer to the selected folder as <EASAROOT> or the installation folder.

At the 'Select Installation Type' window, choose from the following:

  • Standard installation→Install EASA Server with a commonly required set of components and with default server settings.
  • Custom installation→Install EASA Server with default server settings, but select the components to install. (ie. Install spreadsheet support or Compute Server components on remote Excel Servers or Compute Servers.)
  • Advanced→Select components to install and modify 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→Install the Tomcat server (cannot be unchecked).
  • EASA Server→Necessary to host the EASA Web Pages.
  • Web Browser Access→JSF components—necessary to run Web Browser Client based EASAPs, also recommended for Excel Servers.
  • Web Service Access→Web 'service' component required for web service access.
  • Spreadsheet Support→Install 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 or <SERVERDATA> window appears.

  • Choose a folder in which to save User data. Select a location and then click on Next to continue

The full path of the data folder cannot contain more than 218 characters.

Complete the following two steps for 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 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

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 is chosen. For remote access, the correct domain name must be substituted for ‘localhost’. See Test the EASA Web Pages.