Installation and Upgrade

<< Click to Display Table of Contents >>

Navigation:  Professional > Installation and Administration >

Installation and Upgrade

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




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). There are three things to consider when deciding what file to download.

a.The file type. EQuIS Professional is available as a full installation and a xcopy zip install. The xcopy can be run on a machine without doing a full uninstall/install. See Install EQuIS Professional via xcopy for additional information.

b.The application version (7.20.2, 7.20.3, etc.), and

c.The bitness (64-bit {x64} or 32-bit {x86}). Bitness for Windows can be found in the Control Panel\System under System type.

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

a.Backup 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.Once the files are extracted, 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 will not install all of the available features. The .exe runs all of the .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.