Installation Instructions

<< Click to Display Table of Contents >>

Navigation:  EnviroInsite > Installation and Licensing >

Installation Instructions

 

Note: If you are upgrading to EnviroInsite 7 and will be connecting to an EQuIS database, our licensing has changed. Please contact support@earthsoft.com to update your licenses.

 

 

Note: To use EnviroInsite 7 connected to an EQuIS database, an appropriate version of EQuIS Professional must be installed via the steps available here. Check that both the application version and the bitness (64-bit [x64] or 32-bit [x86]) match the version of EnviroInsite being installed. EQuIS Professional is not required to connect to an EnviroInsite database.

 

 

This article explains the process for installing EnviroInsite.

 

Prerequisite Programs

Installing EnviroInsite

Network/Remote Desktop Installation

The xcopy Install

Default Folder Locations

 

Prerequisite Programs

 

Prerequisite programs are operating system add-ons that EnviroInsite needs to access to run properly. These programs should be installed automatically when you run the EnviroInsite installation program. Should the program not run following installation, EarthSoft recommends to check the hardware and software requirements to ensure the proper prerequisites have been met.

 

Note: When using an EnviroInsite database and not an EQuIS database, the appropriate database driver must also be installed.

 

Determine whether these programs are installed by looking at the list of installed programs in the Programs and Features utility, which is accessible from the MS Windows Control panel.

 

Should any of the prerequisites not be installed automatically during the EnviroInsite installation, then install the version (x86 or x64) of each program that is consistent with the version of EnviroInsite. In other words, if the x86 version of EnviroInsite is installed, then check that the x86 version of the program is installed.  

 

To run the EnviroInsite forms or reports within EQuIS Professional, then the bitness of EnviroInsite must be consistent with the bitness of EQuIS Professional. If the 64-bit EQuIS Professional is installed and the 32-bit EnviroInsite installed then you may run equis_x86.exe from the 64-bit installation of EQuIS Pro when you need to run the EnviroInsite form or report from EQuIS Professional.  

 

Administrative privileges are required to install EnviroInsite, and only one version of the program can be installed on the system.

 

These prerequisites are also recommended on a server that will be running EnviroInsite reports or widgets within EQuIS Enterprise.

 

Installing EnviroInsite

 

Complete the following steps to install EnviroInsite:

 

Note: The 7.0.0.19300 Build of EnviroInsite does not include all of the prerequisite programs that are required to run EnviroInsite. If this is the first time EnviroInsite is being installed on the computer, the missing prerequisite programs may result in errors in EnviroInsite. See the forum known issue post for full details.

 

1.Have a registered member of the EarthSoft Community Center (ECC) download the appropriate version of EnviroInsite from the download page of the ECC and save to a known folder (e.g., Downloads). Check both the application version and the bitness (64-bit [x64] or 32-bit [x86]).
 

2.If upgrading from a previous version, uninstall the existing EnviroInsite version by:

a.Executing the install file from the previous version and selecting Remove when prompted, OR

b.In the Control Panel, going to Programs> Uninstall or Programs and Features, selecting EnviroInsite (may include a year in the name if uninstalling an older version), and Uninstall.
 

3.Right-click on the downloaded file, select Properties, and Unblock if blocked.
 

4.Right-click on the *.exe file of the download and Run as administrator (if available; if not, try Run) to start the install process.
 

5.Follow the prompts provided to complete the installation, allowing administrative permission if prompted:

 

50328-install1

 

50328-install2

 

50328-install3

 

In the Installation stage, you may be required to go through several additional prompts for the prerequisite programs listed in the previous section, particularly if this is the first time installing EnviroInsite on the system.

 

50328-install4

 

 

Network/Remote Desktop Installation

 

Users have experienced success in network installations of EnviroInsite and in using EnviroInsite with Remote Desktop Services. EarthSoft strongly encourage use of these technologies to allow for widespread use of EnviroInsite within organizations.  

 

However, these technologies allow for sharing of the EnviroInsite executable in ways that are inconsistent with the spirit of the legacy (non-EQuIS) single-seat license. For non-EQuIS users of EnviroInsite, it will only run in this mode if you are working off of a Concurrent Use License, or CUL (previously known as a floating/network license). On startup, EnviroInsite will check for its mode of installation. If it determines that it has been installed on and is being run from a server AND if it is running in trial mode or has been activated using a single-seat license, then you will receive a warning and be unable to use the program.  

 

Contact support@earthsoft.com if this occurs. We can temporarily create a CUL for testing of the remote installation and have our Sales department provide information on the cost of upgrading from the single-seat license to a CUL.

 

 

The xcopy Install

 

EQuIS EnviroInsite is now available as an xcopy zip install. This means that EnviroInsite can be run on a machine without doing a full uninstall/install. However, in order to have the needed prerequisite programs, EnviroInsite should have been installed once prior to using xcopy. This means that EnviroInsite can be run on a machine without doing a full uninstall/install. The xcopy zip file does not contain the older versions of third party dependencies (Infragistics, Syncfusion, etc.). Please follow Steps 4 and 5 below to ensure that all EnviroInsite reports and forms will be available within EQuIS Professional.

 

1.Download the EnviroInsite xcopy zip install from the Downloads Dashboard on the EarthSoft Community Center (ECC).

2.Unblock the downloaded zip file.

3.Extract the zip file.

4.Create a new folder in the file path C:\Program Files\EarthSoft\ and name it EnviroInsite.

5.Copy all of the files from the EnviroInsite [build number] folder and paste into the C:\Program Files\EarthSoft\EnviroInsite folder.

6.Browse to .\EnviroInsite.exe and double-click to run.

 

 

Default Folder Locations

 

By default, the latest version of the 32-bit and 64-bit EnviroInsite, respectively, will install to the following folders:

C:\Program Files (x86)\EarthSoft\EnviroInsite\

C:\Program Files\EarthSoft\EnviroInsite

 

Default locations for previous versions of EnviroInsite include the following.

2012: C:\Program Files\EnviroInsite2012NET

2014: C:\Program Files\HydroAnalysis\EnviroInsite2014

2016: C:\Program Files\EI LLC\EnviroInsite2016

 

The My EnviroInsite Work folder contains boring log templates, sample data files, and tutorial files. It should install to:

Libraries\Documents\My EnviroInsite Work

 

If not present in that location, the folder may have been installed to a common Documents folder, rather than the Documents folder associated with your user name. If the program was installed by someone that logged in as a different user, that might also account for the problem.

 

Legacy license information (single-seat licenses and CULs) is typically stored in:

C:\ProgramData\EarthSoft\ei7

 

The default location of this folder for previous versions of EnviroInsite (2012 to 2016) is:

C:\ProgramData\HydroAnalysis