Webgate Customization Readme
HP ALM
Software Version: 12.21
This readme provides information about HP ALM 12.21 Webgate Customization:
This section provides an overview of the features that were introduced or enhanced in the HP ALM 12.21 Webgate Customization.
HP ALM Webgate Customization has been updated to work with HP ALM version 12.21.
Webgate Customization is used when:
In ALM, click Help > ALM Tools to open the ALM Tools page. On the ALM Tools page, click Webgate Customization to open the HP ALM Webgate Customization page. On the HP ALM Webgate Customization page, click Download Tool to run Webgate Customization. The WebGate Customization dialog box opens.
The WebGate Customization dialog box contains the settings for the WebGate Client component. The settings are maintained in the HKEY_CURRENT_USER\SOFTWARE\Mercury Interactive\TestDirector\WEB_CLNT_DEBUG and HKEY_CURRENT_USER\SOFTWARE\Mercury Interactive\TestDirector\WEB registry keys.
The following sections describe the various tabs of the WebGate Customization dialog box.
Web Server Settings
The Web Server Settings tab configures the Web Server credentials, WebClient certificates, and general HTTP settings.
Web Server Credentials: When the web server requires user credentials, for example with SSO, enter Web Server Username, Web Server Password, and Domain. Select Always ask for credentials to force credentials to be entered for the web server to load.
Note: Selecting Always ask for credentials causes ALM Explorer to ask for Web/Proxy credentials even if they are specified by the tool. If a user is not working with ALM Explorer, do not select this setting.
Headers: For SSO users, enable Add basic authentication header and select whether to add the header when a cookie is present.
WebClient Certificates: Select Use client certificate according to the desired mode to define a client certificate if the HTTP server requires it for authentication. After selecting the mode, click Select to select the certificate.
Not specify mode: No specific execution mode is set, but the OTA script displays user dialogs.
Interactive mode: The OTA script displays user dialogs.
Non-interactive mode: The OTA script does not display user dialogs.
Note: To run UFT tests in a smart card authentication environment, select Non-interactive mode and select a valid client certificate. Ensure that the Certificate Authority that issued your client certificate is added to the Trusted Root Configuration Authorities list for the current user.
General HTTP Settings: Set the following HTTP settings:
Connection Timeout: Set the timeout in seconds for the HTTP connection between the ALM client or OTA script and the ALM server.
Enable HTTP Compression: The HTTP traffic from the ALM server to the ALM client is compressed with a standard HTTP-compliant gzip compression.
Use Default User Agent: Regulate the user agent value in HTTP requests to the ALM server. Select this checkbox to use the TeamSoft WinInet Component; otherwise,the user agent is the same as for Internet Explorer.
Proxy Settings
The Proxy Settings tab configures the proxy server and proxy credentials.
Proxy: Set the type of proxy server:
Use a Proxy Server: Select this option if the ALM client or OTA script is using a proxy to connect to the ALM server. Enter the proxy server port in Proxy Port, and enter the proxy server I.P. or machine name in Proxy Server.
Use IE Proxy Server: Select this option if the Internet Explorer proxy setting is used for the ALM client or OTA script connection to the ALM server. This option and the Use a Proxy Server option are mutually exclusive.
Bypass Proxy Server: Select this option to bypass the proxy settings, when the ALM client or OTA script does not use a proxy to connect to the ALM server
Proxy Credentials: Enter Proxy Username, Proxy Password, and Domain if the proxy server requires user credentials. Select Always ask for credentials to force credentials to be entered for the proxy server to load.
Note: Selecting Always ask for credentials causes ALM Explorer to ask for Web/Proxy credentials even if they are specified by the tool. If a user is not working with ALM Explorer, do not select this setting.
Log Settings
The Log Settings tab configures the log file.
WebClient Log: Select Write Client Side Log File and enter a path to create a log file for the WebGate component in the specified path.
Running Webgate Customization from the Command Line
Webgate Customization can be run from the command line.
To run WebGate Customization in silent mode, enter WebGateTool.exe /silent followed by the appropriate parameters. Following is a list of the parameters:
| Parameter Name | Short Name |
|---|---|
| Silent | S |
| UseProxy | P |
| UseIEProxy | IE |
| BypassProxy | BP |
| ProxyPort | PrP |
| ProxyUrl | PrU |
| ProxyUserDomain | PrUD |
| ProxyUserName | PrUN |
| ProxyPassword | PrUP |
| ProxyAlwaysAskCreds | PrAC |
| ShouldFilterCertificates | CeF |
| CertSNForNotspecifyMode | CeNS |
| CertSNForInteractiveMode | CeI |
| CertSNForNoninteractiveMode | CeNI |
| IISUserDomain | SUD |
| IISUserName | SUN |
| IISPassword | SUP |
| IISAlwaysAskCreds | SAC |
| ConnectionTimeout | CTO |
| AcceptCompressedResponse | ACR |
| UserAgent | UA |
| SslType | SslT |
| AddBasicAuthHeader | ABAH |
| ForceAddBasicAuthHeader | FABAH |
| MakeLog | ML |
| LogPath | LP |
For example, to set the log path and make a log checkbox in silent mode, run WebGateTool.exe /Silent /LogPath="C:\logs" /MakeLog=y or WebGateTool.exe /s /lp="C:\logs" /ml=y.
You can visit the HP Software support web site at:
www.hp.com/go/hpsoftwaresupport
This web site provides contact information and details about the products, services, and support that HP Software offers. For more information, visit the HP Support web site at: HP Software Support Online.
HP Software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by being able to:
Search for knowledge documents of interest
Submit and track progress on support cases
Submit enhancement requests online
Download software patches
Manage a support contract
Look up HP support contacts
Review information about available services
Enter discussions with other software customers
Research and register for software training
To access the Self-solve knowledge base, visit the Self-solve knowledge search home page.
Note: Most of the support areas require that you register as an HP Passport user and sign in. Many also require an active support contract. To find more information about support access levels, go to: Access levels.
To register for an HP Passport ID, go to: HP Passport Registration.
© Copyright 1992 - 2015 Hewlett-Packard Development Company, L.P.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Windows® is a U.S registered trademark of Microsoft Corporation.
If you have any comments or suggestions regarding this document, please send them by e-mail to SW-Doc@hp.com.