Installing GS Analyze version 9.4

GS Analyze provides a browser-based portal for GainSeeker data analysis. This makes it easy for you to give colleagues and customers access to the data they require.

You must install the GainSeeker client on the web server or intranet server, before installing GS Analyze.

Install GS Analyze on your web server or intranet server, using the following instructions.

 

Contents  [Hide]

 

A. Install GainSeeker version 8 or later on other computers

Before installing GS Analyze, you should first install GainSeeker version 8.0 or later on one or more computers on your network. For instructions, see Installing or Upgrading GainSeeker.

B. Set up a GainSeeker User with Module Access to GS Analyze

At one of the GainSeeker workstations, configure one or more GainSeeker Users with a Role that has Module Access for GS Analyze.

C. Copy the installation package to the local drive (recommended)

If Windows needs to perform a Change (repair) for the GainSeeker client or for GS Analyze, it may need to access the GainSeeker installation package to complete the repair. It will try to access the installation package in the same location that was used to install the GainSeeker client or GS Analyze on this server.

To avoid problems finding the GainSeeker installation package each time a Change (repair) is needed on this server, Hertzler Systems recommends the following strategy:

  1. Copy the GainSeeker client installation to a folder on the local drive – either the entire installation package or only the .\SPC\DISK1\ folder.

  2. Copy the GS Analyze installation to a folder on the local drive – either the entire installation package or only the .\GSAnalyze folder (and subfolders).

  3. Use this local copy of the installation package when installing the GainSeeker client and GS Analyze on this server.

D. Meet System Requirements

Make sure your system meets the Workstation Requirements for installing the GainSeeker client and the Web Server Requirements for installing GS Analyze.

E. Add and configure Server Role for Web Server (IIS)

Installation details are provided for Windows Server 2012 R2 Standard. If your web server or intranet server uses a different version of Windows server, you should determine the equivalent for your server.

  1. In the Server Manager utility, launch the Add Roles and Features Wizard.

  2. On the Select server roles page, chose Web Server (IIS) and then click Next.

  3. On the Select features page, expand .NET Framework 4.5 Features. Then check both .NET Framework 4.5 and ASP.NET 4.5 and click Next.

  4. On the Web Server role (IIS) page, click Next.

  5. On the Select role services page, expand Web Server and Application Development. Then check ASP.NET 4.5 and click Next.

  6. On the Confirm installation selections page, check Restart the destination server automatically if required and then click Install.

F. Install the GainSeeker client on the IIS server

Use the same instructions for Installing the GainSeeker client that were used to install GainSeeker on other computers.

G. Install GS Analyze on the IIS server

Use one of these methods to begin the installation:

H. Change all drive letter file paths to UNC paths or relative paths

GS Analyze is designed to access your GainSeeker data even when no domain users are logged on to the web server or intranet server.

Because drive letters are only mapped when a domain user is logged on to the server, it is important to set up GS Analyze with file paths that do not contain drive letters so that it can access GainSeeker files on your network even when no domain users are logged on to the web server or intranet server.

in Cms.ini

Use Windows to search for all instances of the file named Cms.ini on this computer, and in each file change the config_path= setting to use a UNC path instead of a drive letter path.

After making this change, verify that GainSeeker still runs correctly by launching a GainSeeker module and logging in. Then close the GainSeeker module.

in Redirect.hsi

Use Windows to search for all instances of the file named Redirect.hsi on this computer, and in each file change the redirect= setting to use a UNC path instead of a drive letter path.

After making this change, verify that GainSeeker still runs correctly by launching a GainSeeker module and logging in. Then close the GainSeeker module.

in the Administration module

Log in to the Administration module and change all file paths for all configurations to use UNC paths or relative paths (e.g., .\foldername\ ) instead of fixed drive letter paths.

I. Identify a GainSeeker login to test GS Analyze access

Log in to the GainSeeker System Administration module at any GainSeeker workstation and identify the User (and password) that you will use to test your access to log in to GS Analyze.

You can either choose an existing user or create a new user.

The User you choose should be assigned to a Role with module access to GS Analyze. This User should also be assigned to a Configuration that contains some standards and data.

J. Create a domain user for GS Analyze

Create a new domain user (or choose an existing domain user) that GS Analyze and Windows Internet Information Services (IIS) can use to access GainSeeker data on the network.

You must configure this domain user with:

After you have configured this domain user with the necessary access to the config_path= folder and the GainSeeker database, the remaining steps will configure Windows Internet Information Services (IIS) and GS Analyze to use this domain user when accessing GainSeeker data.

K. Add the domain user to the "Power Users" group

Add the domain user to the "Power Users" group on the web server or intranet server.

L. Log in as the domain user

Now log in to the web server or intranet server as the domain user. This will set up the necessary windows user profile, folders, registry settings, and other items for this user.

M. Configure the App Pool to access GainSeeker as the domain user

  1. In IIS Manager, navigate to Application Pools.  Right-click GSAppPool and choose Advanced Properties.

  1. In the Advanced Settings, edit the Identity property.

  2. Change the Identity property to Custom Account, then choose the domain user you created for GS Analyze.

N. Test GS Analyze at the IIS server

Before you try to run GS Analyze at another computer, you should first test it at the IIS server.

Launch a browser at the server and go to http://localhost/gsanalyze .

This should take you to the GS Analyze login page and allow you to type the GainSeeker user name and password that you identified in step B (above).

O. Test GS Analyze from any device on the network (intranet server only)

At any device on your local area network, launch a web browser and go to http://<server_name>/gsanalyze .

This should take you to the GS Analyze login page and allow you to type the GainSeeker user name and password that you identified in step B (above).

For a company intranet, this is the address that you should make available to employees who need to use GS Analyze. You also need to provide a GainSeeker user name and password for them to log in to GS Analyze.

P. Test GS Analyze from any device outside your network (web server only)

At any device that is not connected to your local area network, launch a web browser and go to http://<URL>/gsanalyze .

This should take you to the GS Analyze login page and allow you to type the GainSeeker user name and password that you identified in step B (above).

For a website that is available to computers across the internet, this is the address that you should make available to people who need to use GS Analyze. You also need to provide a GainSeeker user name and password for them to log in to GS Analyze.

Upgrading GS Analyze from a previous version

If you are upgrading GS Analyze from version 9.2.1 or earlier, you must manually update the web.config file on the web server after installing the new versions of the GainSeeker client and GS Analyze.

  1. Use Windows NotePad to open the file <local drive letter>:\inetpub\wwwroot\gsanalyze\web.config .

  2. In this file, find the following line:
    <bindingRedirect oldVersion="0.0.0.0-7.0.0.0" newVersion="7.0.0.0" />

  3. Replace that line with this one:
    <bindingRedirect oldVersion="0.0.0.0-11.0.0.0" newVersion="11.0.0.0" />

  4. Save your changes to web.config.

More information

Using GS Analyze