Enterprise 7 Azure Installation

<< Click to Display Table of Contents >>

EQuIS 7  >>  Enterprise > Installation and Configuration > New Installation >

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.

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

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

Microsoft SQL Server 2012, 2014, 2016 or Microsoft Azure SQL Database.

Microsoft Azure Subscription

Supported browsers: EDGE, Firefox, Chrome

 

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, open application settings.

b.Set Always to "On."

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

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

d.Click 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 support@earthsoft.com 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.(Optional) Configure log4net.config. See Configure log4net for more information.

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