Enterprise 7 Azure Installation

Notes:

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

•This article is for clients creating a new Enterprise Version 7.0 installation in a Microsoft Azure environment.

•This article requires an understanding of the Microsoft Azure web portal and creating and managing Web Apps. It also requires the EQuIS database already be created.

•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.

Prerequisites

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

Installation Instructions

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

1.Connect to the Azure Web App using an FTP client with the information provided by the Azure portal.

2.Upload EQuIS_Enterprise_7.0_pcp.zip to the Azure Web App FTP home.

3.Extract the application:

a.In the Azure web portal, open the CMD Debug Tool under Advanced Tools for the Web App.

b.In the command prompt type the following command and then hit enter to extract the zip contents:
unzip -o EQuIS_Enterprise_7.0_pcp.zip -d D:\home\site\wwwroot\

4.Configure the database connection:

a.In the Azure web portal, navigate to Configuration > application settings.

b.Connection String:

i.Name=localhost

ii.Value=database connection string
Example connection string: Data Source=SERVERNAME.database.windows.net,1433;User ID=USERNAME;Password=PASSWORD;Database=DATABASENAME;Pooling=true;Connection Timeout=180;

iii.Type drop-down menu=Custom

Note: An ampersand (&) should not be used in the password for the connectionString.

c.Navigate to Configuration > general settings.

i.Platform: 64-bit

ii.Set Always On to "On."

iii.Disable ARR Affinity (not required, but recommended).

d.Save.

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

a.Browse to your installation folder (e.g., .\site\wwwroot\).

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.

6.Apply licenses for the software:

a.Licenses for an Azure instance can be applied by directly connecting to the database with EQuIS Professional and applying the appropriate network licenses. Note: Azure supports ACALs for Enterprise licenses and CULs for Professional licenses.

b.Licenses for an Azure instance can also be applied through the Azure Web Portal.

i.In the Azure web portal, open the CMD Debug Tool under Advanced Tools for the Web App.

ii.In the command prompt, navigate to the Enterprise bin directory:
cd site\wwwroot\bin

iii.Enter the following command to retrieve the server ID:
register.exe -cn localhost -computerid

iv.Contact EarthSoft Support and provide this value to receive an activation code. Note, the activation code is different from other registration codes.

v.After you have received the activation code, enter the following command replacing the email address and activation code with the value received from Help Desk and the email address used to register for the activation code:
register.exe -cn localhost -activate emailaddress:activationcode

vi.Hit enter.

7.In the Azure Portal, navigate to Web Jobs and select Start.

Note: After completing the Enterprise 7 Azure installation, a variety of configuration settings should be implemented to ensure proper operation of the Enterprise site.