EtaPRO Web Client

Installation and
Configuration Guide
 Copyright ©2021
GP Strategies Corporation
All rights reserved. This manual may not, in whole or in part, be copied, photocopied,
reproduced, translated, or reduced to any electronic medium or machine-readable
form without prior written permission from GP Strategies Corporation.

Disclaimers All information referred to and/or included in this manual is current as of the original issue date of
this manual. GP Strategies disclaims all warranties as to this software, whether express or implied,
including without limitation any implied warranties of merchantability, fitness for a particular
purpose, functionality, data integrity, or protection.
This manual could include technical inaccuracies or typographical errors. Changes are
made periodically to the information herein at the discretion of GP Strategies. These changes
will be incorporated in new revisions of this manual. GP Strategies reserves the right to
make improvements to the product(s) or program(s) described in this manual at any time and without
notice.
Trademark Information GP Strategies, GP Strategies and logo design, EtaPRO®, VirtualPlant, EtaPRO APR, EtaPRO
Predictor, EPArchive, EPTrendSetter, EPReporter, EPLog, EPAlert, OPSCenter, Can-alyzer,
GPCALCS, GPSteam, GPiLEARN, and PerformancePlus+ are trademarks or registered trademarks
of GP Strategies Corporation in the U.S. and other countries. All other names or products are
trademarks or registered trademarks of their respective owners.
Trademarks of other companies mentioned in this manual appear for identification purposes only
and are the property of their respective companies. GP Strategies notes these trademarks where they
occur in the text on only the first reference.

Prepared by GP Strategies Corporation

25 Northpointe Parkway ▪ Suite 100
Amherst, New York, 14228-2213 USA

Technical Support:
Phone: 716.799.1077 (800.803.6737)
Support Website: https://etaprosupport.com
Email: EtaPROSupport@gpstrategies.com

www.etapro.com

Printed in the United States of America

EPWC1350.V10.5 Issued: October 2014 Revised: May 2021

 Table of Contents
Getting Started ................................................................................................................................... 1-1
IIS Installation ..................................................................................................................................... 2-1
EtaPRO Web Client Installation....................................................................................................... 3-1
EtaPRO Web Site Configuration...................................................................................................... 4-1
Enabling the HTTPS Protocol .......................................................................................................... 5-1
EtaPRO Web Client Functionality ................................................................................................... 6-1
Troubles hooting.................................................................................................................................. 7-1

EtaPRO Web Client Installation and Configuration Guide iii

 Chapter

1
Getting Started
About the EtaPRO W eb Client Application .................................................................... 1-1
Prerequisites......................................................................................................................... 1-1
Installation Steps ................................................................................................................. 1-2

About the EtaPRO Web Client Application

The EtaPRO Web Client application provides the ability to view EtaPRO screens, trends, reports,
and EPLog entries using a web browser. It also offers an HTML-based version of EPTrendSetter
and the EtaPRO APR Concerns Viewer. The application consists of a web publishing service, an
IIS hosted web site, and a web browser. The EtaPRO Web Client application publishes data from
multiple EtaPRO web servers.
The following diagram illustrates the connectivity.

The server hosting IIS contains an EtaPRO Web Client publishing service. This service
automatically retrieves screens from the EtaPRO Servers and converts them into an SVG (Scalable
Vector Graphics) image for display in a browser. This conversion occurs automatically after any
EtaPRO server reconfiguration.

Prerequisites
The following requirements must be met for the EtaPRO Web Client to function properly.
▪ Download the latest EtaPRO 10.5.x.x Web Client setup file with or without .NET 4.8 from the
EtaPRO Support website (https://etaprosupport.com) and transfer it to the server that will
host the EtaPRO Web Client. If you are not a registered user on this site, user the Register link
on the site to request access.
▪ The server hosting the EtaPRO Web Client should be running Microsoft®
Windows® 2012 or later.
▪ Microsoft Internet Information Server (IIS) Version 8 or later must be enabled on the server
hosting the EtaPRO Web Client.

EtaPRO Web Client Installation and Configuration Guide 1-1

 Getting Started 1-2

▪ Microsoft .NET™ Framework 4.8 must be installed on the server hosting the EtaPRO
Web Client.
▪ ASP.NET must be enabled.
▪ WCF (Windows Communication Foundation) HHTP Activation must be enabled.
▪ The IIS Web Site used for hosting the EtaPRO Web Client must be properly configured to use
Hyper-Text Transfer Protocol with SSL encryption (HTTPS).
▪ If using Single sign-on (SSO) - SSL must be enabled as well as Microsoft Azure Web Apps (see
the Single sign-on section in this document for more details).
▪ The EtaPRO Servers with data to be displayed through the EtaPRO Web Client must be
running EtaPRO Version 10.4 or later.
▪ The EtaPRO Servers with data to be displayed through the EtaPRO Web Client must be
accessible to the server hosting the EtaPRO Web Client over TCP port 5575.
▪ Clients should use Chrome™, Firefox®, Safari®, Microsoft Edge or other modern browser
with support for SVG graphics and the HTML5 Canvas Tag.

Installation Steps
1. Install IIS (see Chapter 2).
2. Install the EtaPRO Web Client (see Chapter 3).
3. Configure the EtaPRO Website (see Chapter 4).
4. Enable the HTTPS protocol (see Chapter 5).
 Chapter

2
IIS Installation

The EtaPRO web site can reside on any computer hosting Microsoft Internet Information Server
(IIS) 7 and later that can communicate with existing EtaPRO Servers over TCP port 5575. The
EtaPRO Web Client can run on the same computer used to host the EtaPRO Server or a
separate computer.
Before installing the EtaPRO Web Client, be sure IIS is properly installed. If IIS is already installed
and configured, skip to Chapter 3: EtaPRO Web Client Installation.

Windows 2012 or Later

1. Open the Server Manager (icon in lower left corner of Desktop toolbar).

2. Under the Manage menu, select Add Roles and Features.

3. The Add Roles and Features Wizard displays. From the Installation Type node, select Role-
based or Feature-based installation.

EtaPRO Web Client Installation and Configuration Guide 2-1

 IIS Installation 2-2

4. From the Server Selection node, select the appropriate server (the local server is selected by
default) and then click Next to continue.

5. From the Server Roles node, select the Web Server (IIS), and then click Next to continue.
2-3 IIS Installation

6. Under the Features node, select .NET Framework 4.5 Features. All entries under .NET
Framework 4.5 should be selected. Click Next to continue.

7. Continue through the steps by clicking Next until you reach the Select role services step. Under
the Web Server/Security section, select Basic Authentication and Windows Authentication.
Under the Web Server/Application Development section, make sure that .NET Extensibility 4.5
and ASP.NET 4.5 are selected. Under the Web Server/Management Tools section, select IIS
Management Console. Do not uncheck items that are selected by default.
 IIS Installation 2-4

8. Continue through the steps by clicking Next until you reach the Confirm installation
selections step. Click Install to complete the installation. It may take a few minutes to complete
this process and you may be required to restart the computer.
 Chapter

3
EtaPRO Web Client Installation

Now that the IIS is properly installed, you are ready to begin setting up the EtaPRO Web Client.
1. Right-click the setup file downloaded from the EtaPRO Support website and select to
Run as Administrator.
2. Click Install and then Next to continue through the setup routine.

3. At the End-User License Agreement step, accept the license end-user license agreement, and
then click Next to continue.

EtaPRO Web Client Installation and Configuration Guide 3-1

 EtaPRO Web Client Installation 3-2

4. At the Select Installation Address step, you can choose to accept the default web location or select
a different location. Enter a name for the Virtual directory. Choose your authentication method.
Click Next to continue.

5. The EtaPRO Web Client includes a configuration tool and screen converter service. At the
Destination Folder step, you can choose to accept the default destination folder for these items
or click Change to enter a different destination folder. Click Next to continue.
3-3 EtaPRO Web Client Installation

6. At the Ready to install EtaPRO 10 Web Client step, click Install to complete the installation.

7. Click Finish to complete the setup and close the EtaPRO Web Client Installation Wizard.
 Chapter

4
EtaPRO Web Site Configuration

In this section you will configure your EtaPRO Website to have access to your EtaPRO Server(s).
1. Right-click on the EtaPRO Web Client Configuration Tool in the Start|EtaPRO 10 folder
and select More|Run as Administrator to display this tool.

2. Click the button next to the EtaPRO Web Distribution Path field and then browse
and select the file path used by the EtaPRO Web Client. The path is typically
C:\Inetpub\wwwroot\EtaPROWeb. This path will change if IIS is not installed in the
default location.
3. You will need to add at least one EtaPRO Server for your EtaPRO Web Clients to access. Click
Add to display the Server Information form. Enter the Display Name, Computer Name or IP
Address, and Authentication Information. Do not use “localhost” as a server display name or
address. The Carousel Image option allows you to add an image for the button that will link to
this server. If left blank, the default EtaPRO banner will be used. Click Test to verify the
information you entered is correct and then click OK to save the server configuration and
return to the EtaPRO Web Client Configuration Tool.

EtaPRO Web Client Installation and Configuration Guide 4-1

 EtaPRO Web Site Configuration 4-2

4. Repeat Step 2 for each server added to the EtaPRO Web Configuration Tool.
5. To enable Single sign-on (SSO, click on the SSO (Beta) button. The SSO Configuration
window displays.

6. Check the Is Enabled box and make sure Azure is selected in the drop-down on the left (it is
currently the only option). To not use SSO, in this window, make sure the Is Enabled box is
not checked. The EtaPRO User Expiration field gives you the option to change the number of
days that a user will remain active in the SSO database. Default is 30.
7. Click Authentication to display the Azure SSO properties window will appear. The ClientId,
AADInstance, and TenantID properties must be entered into the fields then click OK.
Contact EtaPRO Support at EtaPROSupport@gpstrategies.com with questions about filling
out these fields.
4-3 EtaPRO Web Site Configuration

ClientID – ID of your application (located in

your app portal; i.e., Azure, etc.) Azure Portal
| Registrations | Client ID.

AADInstance – Instance of your Azure AD;

i.e., https://login.microsoftonline.com. This
is the base URL of the authorization server.
See your administrator for more information if
you are unsure where to obtain it.

TenantID – Global unique identifier (located

in your app portal; i.e., Azure, etc.). Sign into
your Azure Portal | Registrations |
Properties | Tenant ID field.

8. Click OK to return to the SSO Configuration window and OK again.

9. Click the Start Screen Converter Service button on the EtaPRO Web Configuration Tool. It
may some time for the web publishing service to convert all screens and prepare the EtaPRO
Web Client for initial use.
10. To confirm that everything has been published, click the button next to the EtaPRO Web
Distribution Path. Click on the Screens folder (the default path is
C:\Inetpub\wwwroot\EtaPROWeb\Screens). When the ScreenIndex.xml file is available, as
shown below, the web publishing service is complete.
11. To configure the navigation tree items to display in the EtaPRO Web Client, click the
Navigation Tree Configuration button. The Navigation Tree window displays.
12. Expand each node (root or branch) to reveal the sub items. Uncheck any that you do not want
to see in the EtaPRO Web Client. If you would like to hide EPTrendSetter™, EPLog™,
EPReporter™, or the Concerns Viewer features uncheck the check boxes associated with them.

13. In addition, you can choose to hide the navigation tree by enabling the Hide Navigation
Tree checkbox.
14. Click OK to complete the Navigation Tree configuration and return to the EtaPRO Web
Client Configuration Tool.
 EtaPRO Web Site Configuration 4-4

15. The Settings button allows you to select to use HTTP instead of HTTPS protocol. This is
not recommended.

16. Click Save to complete the web site configuration and close the tool.
17. The next step is to enable the HTTPS protocol.

Managing SSO Users

To manage users that are using SSO on your server:
1. In the SSO Configuration window click on Users.
2. From here you can view users in the SSO database as well as perform actions on these users
such as adding, deleting, and changing their active status.

3. You may manually add users here if you need to. When you add a user, they will automatically
appear in the table.
 Chapter

5
Enabling the HTTPS Protocol
Creating a Self-Signed Certificate ..................................................................................... 5-1
Obtaining a Certificate from a Certificate Authority..................................................... 5-2
Installing a Certificate ......................................................................................................... 5-4
Binding Certificate to HTTPS for the EtaPRO Viewer Web Site ................................ 5-5

The EtaPRO Web Client requires that all communications between the IIS and the browser use the
HTTPS protocol (Hyper-Text Transfer Protocol with SSL Encryption). HTTPS must be enabled
before the EtaPRO Web Client will function properly.
HTTPS allows the browser to communicate with the web server (IIS) over a secure channel. This is
required to ensure that the communication between the web browsers, IIS, and EtaPRO servers are
secure. To use HTTPS, a digital security certificate must be installed, and IIS must be configured to
use it. If your corporation has already obtained a certificate, you should contact your IT department
to obtain and install a server certificate.
Alternatively, a certificate may be obtained from a certificate authority or a self-signed certificate may
be used. If a self-signed certificate is used, users will be presented with a warning message in their
browser when using the EtaPRO Web Client. This behavior is normally expected. To eliminate the
warning, obtain and install a certificate from a valid certificate authority.

Creating a Self-Signed Certificate

1. Open the Server Manager and select the Roles|Web Server (IIS)|Internet Information Services node.
2. Highlight the root machine node and then double click Server Certificates in the Features pane.

3. In the Actions pane, click Create Self Signed Certificate.

EtaPRO Web Client Installation and Configuration Guide 5-1

 Enabling the HTTPS Protocol 5-2

4. Enter a name for the certificate and click OK. IIS will create a new self-signed crypto certificate
for you and register it on your machine.

5. The new self-signed certificate will be displayed in IIS.

Obtaining a Certificate from a Certificate Authority

1. Open the Server Manager and select the Roles|Web Server (IIS)|Internet Information Services node.
2. In the Connections pane, highlight the root machine node and then double click Server
Certificates in the Features pane.
5-3 Enabling the HTTPS Protocol

3. In the Actions pane, click Create Certificate Request to display the Request Certificate Wizard.

4. Enter the Distinguished Name Properties and then click Next to continue.

5. Select a Cryptographic Service Provider and Bit Length. The default settings may generally be
used. However, you should verify that they are compatible with the certificate authority and
meet your corporate IT department requirements. Click Next to continue.
 Enabling the HTTPS Protocol 5-4

6. Specify a file name and location for your certificate request file and then click Finish to close
the Request Certificate Wizard.

7. The certificate request file should be provided to a certificate authority. The certificate authority
will verify your identity and use the information contained in the file to create a server
certificate file to be installed in IIS. The following is a partial list of some of the common
certificate authorities.
Comodo Certification Authority www.comodo.com
DigiCert, Inc. www.digicert.com
DocuSign, Corporation www.docusign.com
Entrust, Inc. www.entrust.net
GeoTrust, Inc. www.geotrust.com
Thawte, Inc. www.Thawte.com
Symantec Corporation (Formally Verisign) www.verisign.com
8. Certificates vary in cost depending on the certificate authority selected, how long the certificate
is valid, and the level of verification performed by the certificate authority. If the EtaPRO Web
Client is only exposed to your corporate network, then a lower cost certificate with a reduced
level of verification may be used.

Installing a Certificate
After you have received a certificate file from a certificate authority, its needs to be installed.
5-5 Enabling the HTTPS Protocol

1. Open the Server Manager and select the Roles|Web Server (IIS)|Internet Information
Services node.
2. In the Connections pane, highlight the root machine node and then double click Server
Certificates in the Features pane.
3. In the Actions pane, select Complete Certificate Request to display the Complete Certificate
Request window.
4. Enter the location of the certificate request file and then click OK.

5. Your certificate will be displayed in IIS.

Binding Certificate to HTTPS for the EtaPRO Web Client Site

Once you have obtained a server certificate, the EtaPRO Web Client site needs to be updated to
enable HTTPS and begin using the certificate.
1. Open the Server Manager and select the Roles|Web Server (IIS)|Internet Information
Services node.
2. In the Connections pan, right-click on the web site associated with the EtaPRO Web Client to
display the short-cut menu. Select the Edit Bindings command.
 Enabling the HTTPS Protocol 5-6

3. Click Add on the Site Bindings window to display the Add Site Binding window. Select https for
the type and your SSL certificate. Click OK to close the Add Site Binding window and then click
Close at the Site Bindings window.
 Chapter

6
EtaPRO Web Client Functionality
Opening Web Client .......................................................................................................................... 6-1
Viewing Point Information and Screens .......................................................................................... 6-2
EPTrendSetter .................................................................................................................................... 6-4
EPLog ................................................................................................................................................... 6-6
Concerns Viewer ................................................................................................................................ 6-7
EPReporter .......................................................................................................................................... 6-8
Diagnostics........................................................................................................................................... 6-9
Closing Web Client ............................................................................................................................ 6-9

In this section you will learn the basic functionality of the EtaPRO Web Client.

Opening Web Client

1. Open your internet browser and enter the EtaPRO web site URL: https: //<YourServer
Address>/EtaPROWeb.
2. The EtaPRO Web Client will open and depending on if SSO has been enabled in the Web
Client Configuration Tool, a custom login window will appear.
3. If SSO is enabled, the login window will contain an option for the user to either use Single
sign-on with Azure or to use the traditional login with your Windows credentials. If SSO is not
enabled, the Single sign-on button will not appear and the only method of logging in will be
using your Windows credentials.
4. Logging in using Single sign-on (SSO) – Click on the Single sign-on with Azure button. The
browser will direct you to the azure portal authentication page. Enter your Azure AD
credentials to authenticate. On successful authentication you will be redirected back to the
EtaPRO Web Client.
Connect your credentials – The final step to log in with SSO is associating your Windows
credentials with your Azure AD credentials. Enter your Windows/AD credentials and on
successful authentication, the popup will disappear, and you will be authorized to access the
servers on the screen.
Logging in using Traditional Windows authentication – If SSO is not enabled or you choose
not to use SSO to authenticate, you may authenticate with your Windows/AD credentials. To
log in, enter your username and password and log in. When you successfully log in, the popup
will disappear, and you will be authorized to access the servers on the screen.

EtaPRO Web Client Installation and Configuration Guide 6-1

 EtaPRO Web Client Functionality 6-2

Viewing Point Information and Screens

1. Select the server to display its Navigation Tree.

2. Expand the nodes on the tree to view public and user screens, trends, and diagnostics.
3. The buttons at the top of the page allow you to use EPTrendSetter, EPLog, Concerns Viewer,
and download report files from EPReporter.
6-3 EtaPRO Web Client Functionality

4. Buttons and hotspots on the EtaPRO screens are fully functional in the EtaPRO Web Client.
5. Single-clicking on any point on a screen displays the short-term pop-up trend for that point.

6. You can also click on charts displayed on these pages to bring them up and view up to a
30-day trend.
 EtaPRO Web Client Functionality 6-4

7. Right-click on any point on a screen displays the configuration information for that point.

EPTrendSetter
Click the EPTrendSetter button on the top of the page to open EPTrendSetter and start building
long-term trends. Add points from the All Points grid to the Y Parameters list, choose your trending
options, and then click the Trend button to generate a long-term trend. Refer to the EtaPRO help
files in the EtaPRO Client for detailed instructions on how to set up time and X-Y trends with a
fixed or floating time period.
6-5 EtaPRO Web Client Functionality

You can zoom the data on the trend by dragging the left and right markers on the Range Selector
below the trend.
 EtaPRO Web Client Functionality 6-6

EPLog
Click the EPLog button and enter your EPLog username and password if appropriate. EPLog
displays the event logs configured on the EtaPRO server. Clicking on a column heading will sort
that column in descending or ascending order.
Use the Add an Entry button to make new entries or the Deactivate button to cross out the
highlighted entry in the currently displayed Event log.

The Filter button displays Create Filter tool. Select the filter options and then click Search. To save
these options when EPLog is opened, click Save Startup.

The Data Log button allows you to view the manual points configured for each unit and add new
values for those points.
6-7 EtaPRO Web Client Functionality

Refer to the EtaPRO help files in the EtaPRO Client for detailed instructions on how to set up
event logs, make entries, and use the Data Log to enter new values for manual points.

Concerns Viewer
Click the Concerns Viewer button display the EtaPRO APR Concerns Viewer. You can view and
address concerns, read concern notes, add other points to the asset, and view asset strip charts and
pop-up trends.

Refer to the EtaPRO help files in the EtaPRO Client for detailed instructions on how to use the
Concerns Viewer.
 EtaPRO Web Client Functionality 6-8

EPReporter
Click the EPReporter button to view the list of report files generated by EPReporter. Select a
report from the Reports list to view available downloads in the Distribution Files list.

Highlight a report in the Distribution Files list and then click Open to download the report to your
computer.

Refer to the EtaPRO help files in the EtaPRO Client for detailed instructions on how to create
EPReports and set the distribution of the reports.
6-9 EtaPRO Web Client Functionality

Diagnostics
Click on any of the diagnostics or Alert diagnostics in the Navigation tree. Use the buttons at the
top of the screen to step through the diagnostic.

Refer to the EtaPRO help files in the EtaPRO Client for detailed instructions on how to create
diagnostics and alert diagnostics.

Closing Web Client

Select the Log out option to close the Web Client.
 Chapter

7
Troubleshooting
ASP.NET 4.0 or ASP.NET 4.5 Not Installed or Improperly Installed .......................... 7-1
Windows Communication Foundation (WCF) Is Not Installed or
Improperly Installed .................................................................................................... 7-3
Another Web Server Product Is Installed and Using Port 80 a nd/or 443 ................... 7-3
HTTPS Not Ena bled ........................................................................................................... 7-4
Firewall Blocking Port 80 and/or Port 443 ....................................................................... 7-4
Invalid Web Distribution Path ........................................................................................... 7-5
Unable to Connect to EtaPRO or EtaPRO Server Credentials Not Valid .................. 7-6
Wrong Application Pool and/or Misconfigured Application Pool ................................. 7-7
Self-Signed or Untrusted Certificate Generates Warning Message............................. 7-8

The following is a list of some common problems that can prevent the EtaPRO Web Client from
installing and operating as expected.
▪ ASP.NET 4.0 or ASP.NET 4.5 are not installed or improperly installed.
▪ Windows Communication Foundation (WCF) is not installed or improperly installed.
▪ Another web server product is installed and using port 80 and/or 443.
▪ HTTPS is not enabled.
▪ The distribution path entered in the Web Client Configuration Tool is incorrect.
▪ A firewall is blocking port 80 and/or port 443.
▪ The Web Client is unable to connect to EtaPRO or has invalid EtaPRO server credentials.
▪ Changes made to EtaPRO screens using thick EtaPRO client fail to appear in web client.
▪ The wrong application pool is selected.
▪ A self-signed or untrusted certificate generates a warning message.

ASP.NET 4.0 or ASP.NET 4.5 Not Installed or

Improperly Installed
ASP.NET may not install properly if the .NET Framework was installed prior to installing IIS or if
IIS configuration has become corrupted for some unknown reason. If this occurs, the HTML pages
will not load and errors similar those shown in the figures below will display.

EtaPRO Web Client Installation and Configuration Guide 7-1

 Troubleshooting 7-2

To address this problem, verify that ASP.NET Role Service and WCF HTTP activation feature are
enabled. You can check if they are enabled as shown in the following sections.

Windows 2012 and Later – Verify ASP.NET 4.5 and WCF HTTP Activation
Enabled
7-3 Troubleshooting

Windows Communication Foundation (WCF) Is Not

Installed or Improperly Installed
If WCF is not enabled or properly installed, then web pages associated with the EtaPRO server may load
partially but will not display live data as shown below.

To resolve this issue, enable WCF http activation and repair ASP.NET as described in the previous section.

Another Web Server Product Is Installed and Using Port

80 and/or 443
The EtaPRO Web Client uses Microsoft Internet Information Server (IIS). If another web server
(e.g., Apache Tomcat) or a program that has an integrated web server (e.g., VMWare Converter) is
installed, IIS will not work properly. To resolve this issue, uninstall the other web server product,
 Troubleshooting 7-4

and reinstall IIS and the EtaPRO Web Client. Alternatively, install the EtaPRO Web Client on
another computer.

HTTPS Not Enabled

The EtaPRO Web Client uses HTTPS for all communications. If HTTPS is not enabled, it will fail
to work. A message like figure shown below will be display in the browser, indicating that a web
page cannot be displayed. To resolve this issue, enable HTTPS as described in Chapter 5: Enabling
the HTTPS Protocol .

Firewall Blocking Port 80 and/or Port 443

For IIS to deliver content via HTTP and HTTPS, traffic must be allowed through TCP port 80 and
TCP port 443. If these ports are blocked by firewall, you will not be able to view the EtaPRO Web
Client in the browser. A message like figure shown below will display, indicating that the web page
is unavailable or cannot be displayed.

The local computer firewall has rules for HTTP and HTTPS. These rules should be enabled by
default upon installation of IIS. If they are not enabled, the EtaPRO Web Client will not work. If a
remote firewall is blocking traffic, you will need to contact the firewall administrator and ask to have
it reconfigured to allow traffic.
7-5 Troubleshooting

Invalid Web Distribution Path

The installation location of the EtaPRO Web Client must be provided on the EtaPRO Web Client
Configuration Tool. This is the path to where the EtaPRO Web Client is installed. It is typically
C:\Inetpub\wwwroot\EtaPROWeb.

If a valid path is not provided, dynamically generated content will not be placed in the correct
location. The EtaPRO Web Client will fail to find navigation bar images and screens. The EtaPRO
Web Client may appear display errors as shown below when attempting to view screens.
 Troubleshooting 7-6

To address this problem, open the EtaPRO Web Configuration Tool and provide a valid web
distribution path. After providing a valid path, stop the web publishing service and then restart it. It
will take a few minutes after restarting the publishing service before the EtaPRO Web Client is
displayed correctly.

Unable to Connect to EtaPRO or EtaPRO Server

Credentials Not Valid
For the EtaPRO Web Client to generate dynamic content and acquire live updates, it must be
provided a valid EtaPRO address and credentials. If invalid credentials are provided, a user may be
able to see the logon page, but upon entering credentials, they will fail to authenticate, regardless of
what is entered. The EtaPRO Web Client may also freeze and appear to lock up. This is likely to
occur if someone modifies credentials using the thick EtaPRO client and then fails to use the EtaPRO
Web Client Configuration Tool to update the EtaPRO Web Client to use the same credentials.
To resolve a connection problem, open the EtaPRO Web Client Configuration Tool and provide the
correct server addresses, usernames, and passwords for each EtaPRO server that will be displayed in the
EtaPRO Web Client.

Changes Made to EtaPRO Screens Using Thick EtaPRO

Client Fail to Appear in Web Client
The EtaPRO Screen Converter Service converts EtaPRO thick client screens from a proprietary format
to Scalable Vector Graphics (SVG) files that are compatible with the EtaPRO web client. Conversions
are performed whenever a screen does not exist or when the EtaPRO Screen Converter service detects
that a screen has been changed.
If changes do not appear in the web client, reconfigure the EtaPRO server and verify that the EtaPRO
Screen Converter service is running. The EtaPRO Screen Converter service can be stopped and
started using the EtaPRO Web Client Configuration Tool.
7-7 Troubleshooting

If conversion problems continue to occur, force all screens to be converted again by deleting them
from the web directory and then stop and restart the EtaPRO Screen Converter Service. Note that it
will a few minutes for all screens to be downloaded and converted to SVG files.

Wrong Application Pool and/or Misconfigured

Application Pool
The EtaPRO Web Client installation routine creates an IIS application pool called “EtaPRO1” for
use by the EtaPRO Web Client. This application pool is used by IIS to run all EtaPRO-related
routines. If an IIS administrator reconfigures or deletes this application pool or reassigns the
EtaPRO Web Client to a different application pool, EtaPRO may behave in an unexpected manner.
 Troubleshooting 7-8

Self-Signed or Untrusted Certificate Generates

Warning Message
HTTPS uses a certificate for encrypting traffic. By design, browsers will display a warning message if
the certificate is not trusted. This is normal, expected behavior. For a browser to trust a certificate,
the certificate should be issued by a trusted root certification authority, must be current, and should
properly reference the address (URL) typed into the browser. To prevent the warning message from
being displayed, obtain a certificate from a trusted root certification authority as described in
Chapter 6: Enabling the HTTPS Protocol. You should contact your IT department for assistance.
Your IT department may already have a certificate that they can install. If the EtaPRO Web Client
is only visible on an internal network, it is generally safe to ignore the warning message. Example
warning messages for Internet Explorer and Google Chrome are shown below.
7-9 Troubleshooting