User Tools

Site Tools


Update from EASA 6.0 to EASA 6.1 with a local database

These steps apply to an EASA Server with local internal MySQL database (the default installation).

An EASA Server which utilizes a remote internal EASA database will need to follow:
Update from EASA 6.0 to EASA 6.1 with a remote database

As the schema has changed slightly between EASA 6.0 and EASA 6.1


A. Before running the installer on the EASA Server

1. Contact us for link to download the EASA installer for Windows: support@easasoftware.com, then download it.

2. Download MySQL below, the default EASA with an internal database (or alternatively stop and follow these steps for a remote database).

Save this file into the same folder as the EASA installer.

3. Check there is enough disk space.

4. Stop the EASA 6.0 service if it is running.

By default, the EASA Server will run in plain HTTP-mode, we may enable and configure HTTPS-mode later on.


B. Run the EASA 6.1 installer on the EASA Server

1. Run the EASA installer *.exe file on the machine designated to be the EASA Server.

2. Select a new folder for <EASAROOT>

3. Select which components should be installed on the EASA Server first. For each subsequent machine in an EASA cluster we will adjust which components are selected at this stage of installation. Some common configurations are shown and described.

  • One (and only one) EASA Server in a cluster is required.
  • 'EASAP Server' if Users will run EASAPs on this machine via a browser, unselect if this machine will not serve EASAPs.
  • 'EASAP Web Service' to enable 'Web Service Client' (see EASA Web Service Client).
  • 'MS Excel Server Support' if the machine will be used as an Excel Server, unselect if this machine will not run as an Excel Server.

4. At the final screen untick 'Start EASA Server now?' as we have a configuration step to do first.

5. By default the EASA Server will run as SYSTEM which will cause problems if 'MS Excel Server Support' was installed. Here we configure the EASA Tomcat service to run as a local Windows user with administrator privileges (for further background and detail read Configure EASA service to run as a non-SYSTEM user).

  • Go to: Task Manager > Services > Open Services
  • Right-click EASA Tomcat8 select: Properties
  • Click the 'Log On' tab
  • Enter credentials for the local user ('EASA-user' in our example below)
  • Click: OK
  • Right-click: Services > EASA Tomcat8
  • Select: Start

6. In 'Task Manager > Processes > Background Processes' confirm mysqld.exe is running, note its process ID, or PID.

In 'Task Manager > Services' confirm Tomcat8 service is running, note its process ID, or PID.

If 'MS Excel Support' was included, confirm there are EXCEL.exe or 'Microsoft Excel' background processes

7. Confirm a mysqld.exe background process and 'EASA Tomcat8' service are listening on the expected ports.

  • In a cmd.exe window type: netstat -aon
  • Check to see both mysqld.exe and Tomcat8 PID's are LISTENING on the desired ports, 3306 and 80, respectively by default


C. Run the EASA 6.1 installer on any other EASA cluster machines

We run through many of the same steps in A. and B. for every remote EASAP Server, remote Excel Server, remote Compute Server, remote Web Service Server and any machine which combines these server roles.

1. Contact us for a link to download the EASA installer for Windows: support@easasoftware.com, then download it.

2. Stop the EASA Tomcat service.

3. Run the EASA installer *.exe file on the target machine.

4. Select a new folder for <EASAROOT>

5. Select which components should be installed on the target machine. Two common configurations are shown and described.

remote EASAP/Excel Server - Many customers with significant Excel requirements choose to combine 'MS Excel Server Support' in an EASAP Server (complicated spreadsheets or high user load may require multiple EASAP/Excel Servers)

remote Compute Server - Engineering simulations running a third party software like Matlab or CAD require only the Compute Server component.

6. A window will prompt for a URL for the EASA Server, enter a URL using a hostname, static IP address, or common name if HTTPS will be or has already been configured. (ie. https://easa-server1/easa )

7. A window may prompt for an URL for an EASAP Server (historically 'JSF Server'), enter an URL using a hostname, static IP address, or common name if HTTPS has been or will be configured. (ie. https://easap-server1/jsf-easa )

8. If 'MS Excel Server Support' was installed, configure the 'EASA Tomcat' service to run as a local Windows user with administrator privileges (for further background and detail read Configure EASA service to run as a non-SYSTEM user).

  • Go to: Task Manager > Services > Open Services
  • Right-click: EASA Tomcat8
  • Select: Properties
  • Click the 'Log On' tab
  • Enter credentials for the local user ('EASA-user' in our example below)
  • Click: OK
  • Right-click: Services > EASA Tomcat8
  • Select: Start


9. For an EASAP Server manually copy the following properties from one file to another.

  • Copy from <SERVERDATA>\shared.properties to <SERVERDATA>\jsf-easa\admin\config\context.properties
    • excel.provider=
    • easa.server.public=
    • easa.server.private=

10. For an Excel Server manually set the following property in two files.

  • Set easa.server.private=http://<IP_ADDRESS_OR_HOSTNAME_OF_EASA_SERVER>/easa
  • in both
    <SERVERDATA>\easa\admin\config\context.properties
    <SERVERDATA>\jsf-easa\admin\config\context.properties

11. Login and certify that the example EASAP's ('Mortgage Calculator', 'Cantilever Plate' and 'Stock Screener') run correctly.


D. Migrate SSL certificates to EASA 6.1

1. Stop the 'EASA Tomcat' service.

2. Make a backup copy of <EASAROOT>\tomcat\conf\server.xml and <EASAROOT>\tomcat\conf\easastore.jks

3. Update server.xml

  • Change: <Connector port=“80” redirectPort=“443” …
  • To: redirectPort=“8443”
  • Change: <Connector port=“443”
  • To: port=“8443”
  • Change the path to the keystore path to point to: easakeystore.jks

4. Start the 'EASA Tomcat' service.


Re-branding changes in EASA 6.1

Two main changes:

  1. Re-branding CSS files have been moved into <SERVERDATA> (copy files in the old folder, paste them into new folder after upgrade)
  • Pre-6.1 folder: <EASAROOT>/webapps/easa/installation/html/
  • From 6.1 onward folder: <SERVERDATA>/webapps/easa/installation/html/
    backgroundBanner.gif is no longer used
    rightBanner.png is a new version of the old rightBanner.jpg, the 'EASA logo'
  1. In the newer folder, easa.css has the updated look-and-feel CSS (below)
    • Adjust the existing base blue color by search-and-replace ' #93bee9 ' in ' .bannerBackground ' style
    • Adjust main tab and header dark blue color by search-and-replace ' #3a4e6a '

Re-branding possibilities include:

  1. Change the header and logo in: generic.html
  2. Change the tab colors or fonts in: easa.css
  3. Remove tabs (such as 'All Results') in: menu.ccl
  4. Rename all tabs via English.xls
  5. Change EASAP defaults in Style.css for HTML labels

new CSS in EASA 6.1

  .bannerBackground>tbody>tr:nth-child(1)>td>table>tbody>tr:nth-child(1)>td:first-child img{height:50px;}
  .bannerBackground>tbody>tr:nth-child(1)>td>table>tbody>tr:nth-child(2)>td.tabOffleft:first-child,
  .bannerBackground>tbody>tr:nth-child(1)>td>table>tbody>tr:nth-child(2)>td.tabOnleft:first-child{padding-left:25px;}
  .bannerBackground>tbody>tr:nth-child(1)>td>table>tbody>tr:nth-child(2)>td.tabOn,
  .bannerBackground>tbody>tr:nth-child(1)>td>table>tbody>tr:nth-child(2)>td.tabOffmid{padding:10px 20px;border-top-left-radius:5px;border-top-right-radius:5px;}
  .bannerBackground>tbody>tr:nth-child(2) td.tabOn,
  .bannerBackground>tbody>tr:nth-child(2) td.tabOffmid{padding:10px 20px;border-radius:0px;}
  .bannerBackground>tbody>tr:nth-child(2) td:first-child{padding-left:20px;}
  .bannerBackground>tbody>tr:nth-child(2)>td.tabOn .subSides{display:none;}
  .bannerBackground>tbody>tr:nth-child(2)>td.tabOn>table>tbody>tr:last-child{visibility:hidden}
  .bannerBackground>tbody>tr:nth-child(2)>td.tabOn>table{height:20px;}