Installing GainSeeker Mobile Web Service version 9.2

Note: For new deployments using iPads or other mobile tablets for data entry into GainSeeker, Hertzler Systems now recommends the use of a Microsoft Remote Desktop Client app to connect to a PC (or Remote Desktop Session Host server / Terminal server) that runs the full GainSeeker client.

This new recommendation supersedes earlier recommendations to use the legacy GS Collect app (which supports LiveCode scripting but not Python scripting) and the GainSeeker Mobile Web Service for iPad data entry.

For details, see Mobile App Requirements.

 

GainSeeker Mobile Web Service provides an internet or intranet portal to your GainSeeker system for the GS Collect Mobile App. This allows your iPad and iPad Mini users to enter data into GainSeeker.

Install GainSeeker Mobile Web Service on your web server or intranet server, using the following instructions. Details are provided for Windows Server 2003 Standard Edition and Windows Server 2008 R2 Standard. If your web server or intranet server uses a different Windows version, a few instructions or file locations may be different.

 

Contents  [Hide]

 

A. Install GainSeeker version 8 or later on other computers

Before you set up your web server or intranet server, 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. Copy the installation package to the local drive (recommended)

If Windows needs to perform a Change (repair) for GainSeeker Mobile Web Service, it may need to access the GainSeeker Mobile Web Service installation package to complete the repair. It will try to access the installation package in the same location that was used to install GainSeeker Mobile Web Service on this computer.

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

  1. Copy the GainSeeker Mobile Web Service installation package to a folder on the local drive - either the entire installation package or only the .\disk1 folder (and subfolders).

  2. Use this local copy of the installation package when installing GainSeeker Mobile Web Service on this server.

C. Before installing GainSeeker Mobile Web Service

System Requirements

On your web server or intranet server, make any changes necessary to meet the Workstation Requirements and Web Server Requirements for installing GainSeeker.

Install GainSeeker version 8.0 or later

Install GainSeeker on your web server or intranet server. The instructions for installing GainSeeker on your web server or intranet server are the same as for installing on any other GainSeeker workstation on your network, except that when installing from a copy of the GainSeeker installation package you should use the installation package copied to the local drive instead of the installation package copied to the network drive.

To ensure that GainSeeker was installed successfully on the web server or intranet server, launch one of the GainSeeker modules and log in. Then close the GainSeeker module.

Installed Windows components

Microsoft Internet Information Systems (IIS) version 5.0 or later must be installed on your web server or intranet server.

on Windows Server 2003 Standard Edition:

The minimum Windows components needed to run GainSeeker Mobile Web Service are:

Application Server

\ASP.NET

\Enable network COM+ access

\Internet Information Services (IIS)

\Common Files

\Internet Information Services Manager

\World Wide Web Service

\World Wide Web Service

On Windows Server 2003, Windows components can be added from Control Panel in Add or Remove Programs.

on Windows Server 2008 R2 Standard:

The Web Server (IIS) role must be installed with the following role services:

Web Server

\Common HTTP Features

\Static Content

\Default Document

\Directory Browsing

\HTTP Errors

\Application Development

\ASP.NET

\.NET Extensibility

\ISAPI Extensions

\ISAPI Filters

\Health and Diagnostics

\HTTP Logging

\Request Monitor

\Security

\Request Filtering

other authentication options as used by your existing web or intranet server (such as Windows Authentication for an intranet server)

\Performance

\Static Content Compression

\Management Tools

\IIS Management Console

On Windows Server 2008, roles and role services can be added from Server Manager.

Firewall exception for Port 80

A firewall exception for TCP Port 80 must be enabled so that other computers can access GainSeeker Mobile Web Service.

On Windows Server 2003 using Windows Firewall, this exception can be created from Control Panel in Windows Firewall on the Exceptions tab.

If Windows Server 2008 is installed with all of the default options and is using Windows Firewall, this firewall exception will be automatically enabled.

D. Register ASP.NET (run aspnet_regiis -i)

Refer to the Microsoft webpage support.microsoft.com/en-us/kb/329290 for information about encrypting credentials and session state connection strings.

Note: You may need to perform this step using Administrator privileges.

E. Enable 32-Bit Applications (64-bit OS only)

Run the IIS manager from the Administrative tools.

In the navigation tree on the left, click on the Application Pools branch.

For each Application Pool listed, edit the Advanced Settings and set Enable 32-Bit Applications to True.

F. Install GainSeeker Mobile Web Service

To begin the installation, browse to your GainSeeker Mobile Web Service installation package and run the SETUP program.

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

GainSeeker Mobile Web Service 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 GainSeeker Mobile Web Service 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.

H. Identify a GainSeeker login to test GainSeeker Mobile Web Service access

Log in to the Administration module and identify the User (and password) that you will use to test your access to log in to GainSeeker Mobile Web Service.

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

You will probably want to create or choose a user that is assigned to a Role with access to a module such as GainSeeker Charts.

I. Create a domain user for GainSeeker Mobile Web Service

Create a new domain user (or choose an existing domain user) that GainSeeker Mobile Web Service 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 GainSeeker Mobile Web Service to use this domain user when accessing GainSeeker data.

J. Add the domain user to the "Power Users" and "IIS_IUSRS" groups

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

If an "IIS_IUSRS" group exists on the web server or intranet server, add the designated network login to that group too. This group typically exists on Windows Vista, Windows 7, and Windows Server 2008.

K. Grant the domain user Full Control in the local GainSeeker Mobile Web Service folder

Use the following steps to grant full rights to the domain user in the <local drive letter>:\inetpub\wwwroot\GSWebService\ folder:

on Windows Server 2003 Standard Edition:

  1. Right-click the <local drive letter>:\inetpub\wwwroot\GSWebService\ folder.

  2. On the right-click menu, click Sharing and Security.

  3. Click the Security tab.

  4. Click Add and find the domain user.

  5. Select the Full Control checkbox, and then click OK.

on Windows Server 2008 R2 Standard:

  1. Right-click the <local drive letter>:\inetpub\wwwroot\GSWebService\ folder.

  2. On the right-click menu, point to Share with and then click Specific people.

  3. Click Add and find the domain user.

  4. Click in the Permission Level column and then click Read/Write.

  5. Click Share and then click Done.

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 necessary folders, registry settings, and other necessary items for this user.

To verify that GainSeeker runs correctly under this domain user: launch the GainSeeker Charts module, log in, and then close the module.

M. Grant permissions for COM objects (32-bit OS only)

If the web server or intranet server is running a 32-bit operating system, use the following instructions to grant permissions to four COM objects:

  1. Use Windows Start > Run to run DCOMCNFG .

  2. Double-click Component Services, Computers, and My Computer, and DCOM Config.

  3. Right-click VBINI.IniFuncs and then click Properties.

  4. Click the Security tab.

  5. In the Launch and Activation Permissions area, click Customize and then click Edit.

  6. Click Add and find the domain user.

  7. Select the check boxes for Local Launch and Local Activation.

N. Add the domain user to web.config

For information about encrypting credentials and session state connection strings, refer to the Microsoft webpage support.microsoft.com/en-us/kb/329290

Use the following instructions to configure GainSeeker Mobile Web Service to use the domain user when accessing GainSeeker data:

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

  2. In this file, find the following line:
    <identity impersonate="true" userName="(domain\user)" password="(password)"/>

  3. Replace (domain\user) with the domain and user.

  4. Replace (password) with the password for the domain user.

O. Test GainSeeker Mobile Web Service at the IIS server

Before you try to run GainSeeker Mobile Web Service at another computer, you should first test it at the IIS server.

To do this, launch a web browser and go to http://localhost/GSWebService/MobileDashboard.asmx

This should take you to the MobileDashboard page for GainSeeker Mobile Web Service.

P. Test GainSeeker Mobile Web Service from an iPad or iPad Mini

On an iPad or iPad Mini:

  1. Use the App Store to download and install the free GS Collect app.

  2. Launch the GS Collect app and touch the Settings button.

  3. In the Address of Web Service box, enter the address of your IIS server. Then touch the Done icon.

  1. At the GS Collect login page, enter the GainSeeker user name and password that you identified above in step H. Then touch the Login icon.

If you are able to successfully log in to GS Collect, then you should use this address to set up other iPads and iPad Minis for GS Collect. You also need to provide GS Collect users with GainSeeker user names and passwords to log in.

Q. Troubleshooting

Depending on the operating system, .NET framework version, and whether the Web Server is 32- or 64-bit, some of these troubleshooting ideas have been needed to get the system to run properly.

Instructions for turning off Request Validation in IIS Manager

Note: The following information only applies if you are Installing GainSeeker Mobile Web Service on a Windows 2012 server or later and you are receiving request validation errors.

If your system looks different from this, you can search the internet for specific instructions for your version of IIS.

This may be the problem if you can log in with GS Collect but get an error when submitting data.

These steps basically put the following line in the GSWebService web.config file:  
<httpRuntime requestValidationMode="2.0" />

 

  1. In the Windows Control Panel, start the Administrative Tools and then launch the Internet Information Services (IIS) Manager.
    In the Connections area, select your_server \ Sites \ Default Web Site \ GSWebService .

  2. In the GSWebService Home area, double-click the Configuration Editor icon .

 

  1. Click the Section list and choose sytem.web/httpRuntime.

  2. In the requestValidationMode property , enter 2.0 (as shown) and then press ENTER.

  3. In the Actions area, click Apply .

 

  1. Click the Section list and choose sytem.web/pages.

  2. In the validateRequest property , select False (as shown) and then press ENTER.

  3. In the Actions area, click Apply .

 

  1. In the Connections area, select your_server \ Sites \ Default Web Site .

  2. In the Manage Website area, click Restart .

 

Changing the Application Pool

In the Connections area, click Application Pools. Then change the Classic .Net AppPool and DefaultAppPool to .Net version 4.0.

Allowing ISAPI and CGI Restrictions

  1. In the Connections area, click your server name.

  2. In the server_name Home area, double-click the ISAPI and CGI Restrictions icon.

  3. In the ISAPI and CGI Restrictions area, double-click both ASP.NET v4.0x versions and select the "Allow extension path to execute." checkbox.