Enterprise 6.6.x to 7 Upgrade

<< Click to Display Table of Contents >>

Navigation:  Enterprise > Installation > Upgrade Installation >

Enterprise 6.6.x to 7 Upgrade




Please read this entire article carefully, and plan appropriately before beginning.

This article is for clients that are upgrading from an existing 6.6 installation.

Custom formats created for EDP or EDGE for 6.x versions will need to be recompiled to work with EQuIS 7. Please contact EarthSoft Support for further information on recompiling the formats.

Starting with EQuIS Enterprise 6.4.1, recursive triggers must be enabled for the database. This can be enabled under the Options tab of the database properties in SQL Server Management Studio.

Requirements for standalone license databases have been modified and should be updated in v6.5. For more information and the script for creating an external license database, see the License Database article.


Warning: Enterprise 7 does not support "local" license keys for self-hosted clients with per-core licensing for EQuIS Enterprise. When installing Enterprise 7, these "local" license keys need to be replaced with "network" license keys (which are stored in the ST_LICENSE table in the database). If you are using "local" license keys on your web/application server, please contact sales@earthsoft.com prior to upgrading to Enterprise 7.




Prior to installation, please review the hardware and software requirements and release notes.  


Registry Backup


Be aware that changing the Windows Registry could cause problems. It is highly recommended that you back up the registry before making any changes.


Note: EarthSoft Assumes no liabilities for problems introduced when making changes to the registry.


To back up the registry in Windows:

1.Select Start , type regedit.exe in the search box, and then press Enter. If you are prompted for an administrator password or for confirmation, type the password or provide confirmation.

2.In the Registry Editor, locate and click the registry key or subkey that you want to back up.

3.Select File > Export.

4.In the Export Registry File dialog box, select the location to which you want to save the backup copy, and then type a name for the backup file in the File name field.

5.Select Save.


For more information, see Microsoft's How to back up and restore the registry in Windows article.


Prior to Installing EQuIS Enterprise

The following setup requirements should be completed prior to installing EQuIS Enterprise.

1.Install EQuIS Professional 7. See the Installation and Upgrade article for Professional for further information.

2.Enable the following Windows roles and features using Windows Server Manager:

a.Server Roles: Web Server (IIS) (installs with default selections)

b.Features: ASP.NET 4.8*

c.Server Roles > Web Server (IIS) > Application Development:

i..NET Extensibility 4.8*

ii.ASP.NET 4.8* (this will enable ISAPI Extensions and Filters)

*If using an older version of Windows Server, and Microsoft .NET Framework 4.8 is unavailable, select NET Framework 4.7, ASP.NET 4.7, and .NET Extensibility 4.7.


Warning: The "WebSocket Protocol" Windows feature is not compatible with EQuIS Enterprise.


3.Install the URL Rewrite module and create a registry key to allow Enterprise to correctly handle URL Rewriting in local (non-Azure) IIS Server environments. If you are running Enterprise in a local IIS Server environment and the URL Rewrite Module is not installed and enabled, you may encounter 500 server errors when navigating to your site.

a.Download the URL Rewrite module from https://www.iis.net/downloads/microsoft/url-rewrite and install on the machine hosting Enterprise.

b.Create a "UrlSegmentMaxLength" registry key in the Registry Editor: [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters]

i.Type: DWORD

ii.Data: decimal value of 00001000

iii.The result will appear as in the screenshot below:



Back Up Database Files


Prior to upgrading, it is highly recommended that existing files and the database have been backed up.

Make a backup of your SQL database.

Make a backup of the Enterprise Installation Directory (\Program Files\EarthSoft\Enterprise6).


Upgrade Instructions


The EQuIS Enterprise 7 download links are available for download at the EarthSoft Community Center.


1.Download the EQuIS Enterprise 7 installer (.zip) from the Download Dashboard (Products> EQuIS Enterprise> 7).

2.Stop the IIS application pool EnterpriseAppPool.

3.Stop the EQuIS Enterprise 6 Workflow service under Windows Services.

4.Make a backup copy of your *.config file (..\Enterprise6\bin\connectionStrings.config).

5.Uninstall the existing EQuIS Enterprise installation from the Windows Control Panel. Delete the Enterprise6 folder.

6.Extract the files downloaded in Step 1.

7.Run the EQuIS Enterprise 7 application (.exe) as administrator and step through the installation wizard.

8.Go to the extracted folder from Step 6 and copy the file widgets.equis.all.min.js. Place the file in the installation folder, which is usually C:\Program Files\EarthSoft\Enterprise7\assets\dist\js. This is only applicable to Enterprise 7 build 18212.

9.Update your database(s) with the equivalent version of EQuIS Professional using the steps outlined in the following article: Update EQuIS Database.

10.Restore the backed up *.config file backed up in Step 4 (..\Enterprise7\bin\connectionStrings.config).

11.If you are not using SSL (aka HTTPS), you need to do the following:

a.Browse to your installation folder (e.g., C:\Program Files\EarthSoft\Enterprise7).

b.Open the Web.config file with a text editor (e.g., Notepad).

c.Find <httpCookies requireSSL="true" lockItem="true"/>.

d.Change it to <httpCookies requireSSL="false" lockItem="true"/>.

e.Save and close the file.

12.If you are running in a local IIS Server environment, it may be necessary to comment out the staticContent block in the Web.config file.

a.Browse to your installation folder (e.g., C:\Program Files\EarthSoft\Enterprise7).

b.Open the Web.config file with a text editor (e.g., Notepad).

c.Find <staticContent>.

d.Comment out the staticContent as seen below:


     <mimeMap fileExtension=".json" mimeType="application/json"/>

     <mimeMap fileExtension=".woff" mimeType="font/woff"/>

     <mimeMap fileExtension=".woff2" mimeType="font/woff2"/>


     e. Save and close the file.

13.(Optional) Configure log4net.config. See Configure log4net for more information.

14.Start the EnterpriseAppPool application pool in IIS if it has not already been started.

15.Open your web browser to your installed web application URL (e.g., https://localhost/equis7/default.aspx).

16.Login using an EQuIS Enterprise administrator account (default account is administrator/admin).


Warning: For security reasons, the default administrator password of "admin" should be changed immediately after initial login is successful.


17.Append "action=deploy" to the URL to complete the deployment step. (e.g. https://localhost/equis7/default.aspx?action=deploy). You should see a list of files that were successfully processed as shown below:



18.Start the EQuIS Enterprise 7 Workflow service under Windows Services.

19.Navigate to the web application URL (e.g., https://localhost/equis7/default.aspx) to use EQuIS Enterprise.

20.If configuring Windows Authentication (LDAP Authentication), modifications are needed in the web.config file. See Using LDAP Authentication for more information.


Note: The \Enterprise7\App_Data folder contains the original installed widget, dashboard, and ST_CONFIG.DATASET deployment files. These can be copied from this folder into the \Enterprise7\deploy folder if any/all of the dashboards, widgets, or other files need to be deployed again. To deploy, append "action=deploy" to the Enterprise URL (e.g., https://localhost/equis7/default.aspx?action=deploy).