Installation and Upgrade

<< Click to Display Table of Contents >>

Navigation:  Professional > Setup >

Installation and Upgrade

This article explains the process for installing a new instance of EQuIS Professional as well as upgrading to a new build from a previous build.




See EQuIS Hardware and Software Requirements.


Install EQuIS Professional Program


Complete the following steps to install EQuIS:


1.Have a registered member of the EarthSoft Community Center (ECC) download the appropriate version of EQuIS Professional and save to a known folder (e.g. Downloads). Consider the distributions below when downloading the install.

oEarthSoft_EQuIS_{Build}_x64.msi is a machine install for EQuIS Professional.

Default installation path: C:\Program Files\EarthSoft\EQuIS directory or for per-user installation, include %localappdata%\Programs\EarthSoft\EQuIS\

Application will be available across user profiles in shared workstations.

Requires elevated privileges to install and modify content in the installation directory.

Bundled with  EarthSoft_EQuIS_{Build}_x64.exe to allow for standard users installing with elevated privileges in environments where this is required.

Registers EQuIS as an ArcMap extension during the installation process.


oEarthSoft_EQuIS_PerUser_{Build}_x64.msi is the per-user install for EQuIS Professional

Default installation path: C:\Users\<user>\AppData\Local\Programs\EarthSoft\EQuIS\

Does not require elevated permissions to install.

Application only accessible to the user installing EQuIS.

User can add/remove files to the installation directory without additional permissions.

Registering the ArcMap extension requires administrative privileges to run EarthSoft.Interfaces.ArcGIS.Desktop.bat.

oProfessional_Package_{Build} is the xcopy zip install

Can be extracted and run on a machine without doing a full uninstall/install.

See the online help article Install EQuIS Professional via xcopy for additional information.


2.If upgrading from a previous version, uninstall the existing EQuIS Professional version by following these steps:

a.Back up the existing EQuIS program folder (typically at .\Program Files\EarthSoft\) as a precaution if custom files such as reports need to be maintained.

b.Execute the install file from the previous version. Select Remove when prompted or go to Control Panel > Programs > Uninstall, select EarthSoft EQuIS Professional, and Uninstall.

c.Review remaining content in the EQuIS program folder. Delete the folder if not needed and retain custom files as desired.

3.Right-click on the downloaded .zip file and Unblock if blocked.

4.Extract all files from the .zip.

5.For installations (not xcopy), double-click the .msi or right-click on the .exe file and Run as administrator (if available; if not, try Run) to start the install process.

Note: Running the .msi alone will succeed but may not install all of the available features. The .exe runs any *.msi files in the right order.


6.Follow the prompts provided in the Installation Wizard. Custom Setup options in the Installation Wizard are shown in the following image.




The EQuIS Library is not installed by default and must be selected (if required). This option is recommended for the best EQuIS experience, as selecting the EQuIS Library will install the full EQuIS Standard Report Library.


There is no longer an option to select the ArcGIS version. Read Installing ArcMap in Professional for more information.


7.Once the software has been installed, open EQuIS from the icon that can be found in the Start Menu or on the Desktop.

Install New Deployment of EQuIS Professional


Follow the steps below if installing a new deployment of EQuIS Professional.


1.Create a database or set up a new connection.

2.Register the software or connect to a database server that contains network licensing. Request keys here or consult the help article Applying Network Licenses for more information on network licensing for EQuIS Professional.


Upgrade EQuIS Professional


Follow the steps below if upgrading from a previous version of EQuIS Professional.


Review the release notes for the new version.

If upgrading from EQuIS Version 5, please contact The upgrade process will involve converting the ID values in each database and preparing to upgrade to EQuIS Version 6 prior to upgrading to EQuIS Version 7. Note that this must be done prior to upgrading the database! This step is only done once when upgrading to EQuIS Version 6.x.

For all upgrades, update each EQuIS Database to the latest schema (SQL Server).

oThe ST_LOG table is intended to store logging information on a short-term basis. If your ST_LOG table is large, you may consider periodically truncating that table (e.g. prior to a database upgrade).

Custom formats created for EDP/EDGE for previous versions will need to be recompiled to work with EQuIS 7. Please contact for further information on recompiling the formats.


Note: When updating an EQuIS Database from EQuIS Professional (applies to SQL Server only), the database can only be selected if it has a recent backup (within same calendar day). Database updates cannot be reversed or undone, so it is essential to have a current backup before performing an update. In addition, after clicking the Update button, a warning message explaining that the update is irreversible will display. This warning must be acknowledged (Yes) in order to complete the database update process.


Use the EQuIS Report Publisher to update published System Reports to the current version.


As of EQuIS Version 6.5.0, Pick Reports have been renamed User Reports, and Build Reports are now referred to as System Reports.

All (Beta) reports have been renamed to remove the Beta reference and add a Roman Numeral suffix indicating the report is an updated version of the original. For example, the (Beta) Analytical Results reports are now Analytical Results II and the (Beta) Action Level Exceedance reports are Action Level Exceedance II. Therefore, when updating to EQuIS 6.5, previously saved <=6.4 version (Beta) User reports will not automatically associate with the newly published "II" System Reports. To associate previous version (Beta) User Reports with the published 6.5 "II" System Reports, use the Copy User Reports Form in EQuIS Professional.

Connections from the previous version are saved in %AppData%\Earthsoft\Connections.