Configure a proxy server for connecting VuGen to a remote Git server

VuGen 12.53 supports integration with Git, enabling you to store scripts in a local or a remote Git repository. If a proxy server is needed to access the remote repository, the proxy configuration needs to be set up manually outside of VuGen using a Git command line client.

VuGen does not include a Git command line client, so it must be installed manually.

Follow the instructions below to set up a proxy server for Git:

  1. Install any Git command line client i.e. Git-SMC (the portable version will also work)
  2. Open the Git client (If you installed the Git-SMC run the git-cmd.exe)
  3. Execute the following command (replace the <proxy_server> and <port_number> with the correct values, note the two consecutive hyphens prepending the global option)
    git config –global http.proxy <proxy_server>:<port_number>
  4. To reset the proxy settings execute the following command (note the two consecutive hyphens prepending the global and unset options):
    git config –global –unset http.proxy
Advertisements

VuGen support for recording and replay of HTTP/2 enabled web sites

As of version 12.53 VuGen supports HTTP/2 (including multiplexing) enabled web sites for recording and replay.

In order to enable recording of HTTP/2 the following recording option must be set:

  1. Record > Recording Options > Network > Mapping and Filtering.
  2. Click Options to open the Advanced Port Mapping Settings dialog box
  3. In the SSL Version dropdown, select TLS ALPN.
  4. Click Update.

alpn

ALPN is a Transport Layer Security extension for application layer protocol negotiation within the TLS handshake. It allows the application layer to negotiate which protocol should be performed over a secure connection in a manner which avoids additional round trips and which is independent of the application layer protocols.

In order to enable replaying of HTTP/2, make sure the correct TLS version is set in the script:

web_set_sockets_option(‘SSL_VERSION’, ‘TLS1.2’);

To verify that HTTP/2 was used for replay, enable Advanced Trace in the Log runtime settings. After replay, see the Replay log and note the references to HTTP/2.
Below is an example log from a replay of a HTTP/2 web server.

Action.c(13): The request to server https://<hostname>/” is done with headers:
Action.c(13):     :authority = <hostname>
Action.c(13):     :method = GET
Action.c(13):     :path = /
Action.c(13):     :scheme = https
Action.c(13):     user-agent = Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gec
Action.c(13):     ko) Chrome/46.0.2486.0 Safari/537.36 Edge/13.10586
Action.c(13):     accept-encoding = gzip, deflate
Action.c(13):     accept-language = en-US
Action.c(13):     accept = */*
Action.c(13): t=2026ms: 139-byte response headers for “
https://<hostname>/” (RelFrameId=1, Internal ID=1)
Action.c(13):     HTTP/2.0 200\r\n
Action.c(13):     Status: 200\r\n
Action.c(13):     Server: nginx\r\n
Action.c(13):     Date: Fri, 03 Jun 2016 07:27:29 GMT\r\n
Action.c(13):     Content-Type: text/html; charset=UTF-8\r\n

License features used by the HP (Former Mercury) Functional Testing Concurrent License Server when working with QuickTest Professional (QTP) or Service Test (ST)

List of license features
The features below are used by the Concurrent License Server and are displayed in the tools that are shipped with it, such as WlmAdmin, Wcommute, or LSdecode: Common/Latest/Most-used features:

* UnifiedFunctionalTesting – Unified Functional Testing (UFT)
Usage: Unified Functional Testing (version 11.5 and above), QuickTest Professional (version 11.00 and above) and Service Test (version 11.00 and above) core products and QuickTest Professional add-ins. * HpFunctionalTesting – HP Functional Testing
Usage: Only for QuickTest Professional (version 9.5 and above) and WinRunner (only 9.2) core products and their add-ins, not working for UFT 11.50 and above!!! * FT-unified – Functional Testing core
Usage: QuickTest Professional (version 6.5 and above) and WinRunner (version 7.6 and above) core products and the core add-ins (Visual Basic, Active X and Web). * FTAddins – Functional Testing add-ins
Usage: WinRunner (version 7.6 and above) and QuickTest Professional (version 6.5 and above) external add-ins that are not shipped with the core product. * QuickTestPro – QuickTest Professional core
Usage: QuickTest Professional (version 6.5 and above) core program and the core add-ins (Visual Basic, Active X and Web). * QTAddins – QuickTest Professional add-in
Usage: QuickTest Professional (version 6.5 and above) external add-ins that are not shipped with the core product. * QTPEssentials – QuickTest Professional Essentials
Usage: Enables only QTP 11 basic features (version 11.00 and above), meaning ActiveX, Visual Basic, Web, Java and .NET add-ins. All other installed add-ins will be disabled as well as UFT check-box. * ServiceTest – Service Test
Usage: Service Test VuGen (10.x and older) and Service Test Visual Test Designer (11.x and newer). Other/Older features:

* WR-core – WinRunner core
Usage: WinRunner (version 7.6 and above) core program and the four add-ins that are shipped with it. * WRAddins – WinRunner add-ins
Usage: WinRunner (version 7.6 and above) external add-ins that are not shipped with the core product. * Java – QuickTest Professional Java add-in
Usage: QuickTest Professional Java add-in version 8.2 and above. * WinForms – QuickTest Professional .Net add-in
Usage: QuickTest Professional .Net add-in version 8.2 and above. * SapGui – QuickTest Professional mySAP.com add-in
Usage: QuickTest Professional mySAP.com add-in version 8.2 and above. * Siebel – QuickTest Professional Siebel add-in
Usage: QuickTest Professional Siebel add-in version 8.01 and above. * TerminalEmulators – QuickTest Professional Terminal Emulator add-in Usage: QuickTest Professional Terminal Emulator add-in version 8.0 and above. * Oracle – QuickTest Professional Oracle add-in
Usage: QuickTest Professional Oracle add-in version 8.2 and above. * PeopleSoft – QuickTest Professional PeopleSoft add-in
Usage: QuickTest Professional PeopleSoft add-in version 8.2 and above. * Stingray – QuickTest Professional Stingray add-in
Usage: QuickTest Professional Stingray add-in version 8.2 and above. * VisualAge – QuickTest Professional VisualAge SmallTalk add-in Usage: QuickTest Professional VisualAge SmallTalk add-in version 8.2 and above.

Install/set up a redundant license server pool

These are the required steps to install redundant licenses:
1. Make sure there is no concurrent license already installed on the license servers (look for the LSERVRC environment variable or for “lservrc” on Windows search, if the file exists, remove any concurrent license keys contained on it or remove the file).
2. Stop the Sentinel RMS service for all the license server machines that will be on the redundant license pool (go to Start > Control Panel > Administrative tools > Services).
3. Use the WRlfTool utility to add the servers (name and IP address) and the redundant license key to the “lservrlf” file (redundant license file). The WRlfTool is located under the “utils” folder on the License Server installation files.
4. Save the lservrlf file under the License Server’s installation path (i.e. C:\Program Files\Common Files\SafeNet Sentinel\Sentinel RMS License Manager Server\WinNT)
5. Copy and paste the lservrlf file into the other license servers on the pool in the same path as saved on the Leader license server (i.e. C:\Program Files\Common Files\SafeNet Sentinel\Sentinel RMS License Manager Server\WinNT).
6. Start the Sentinel RMS service for all the license server machines that will be on the redundant license pool.
7. On the UFT/QTP client machine, create the LSHOST environment variable under the user variables (go to Start > Control Panel > System > Advanced > Environment variables). The value should be the name or IP address of all the license servers on the pool, separated by colon (i.e. lserver01:lserver02:lserver03 ) or semi-colon (i.e. lserver01;lserver02;lserver03 ) depending on the environment.
8. The Redundant License pool should be set now. Launch UFT/QTP to verify it is working fine.
Note: The redundant license servers use the majority rule. This means that a majority (over half) of the redundant license servers must be up and running in order to get a license for UFT/QTP. For example, if there are 3 redundant license servers, at least 2 of them must be up and running. If there are 5 redundant license servers, 3 of them must be up and running to get a license.
For more information about setting up a redundant license server pool, refer to “Setting up the Redundant License Servers” on the license server installation files at\LicenseServer\server\SysAdminHelp\Default.htm

How to set the LSHOST or LSFORCEHOST system variable

Determine which variable to use then set the system variable

On Windows NT
1. Bring up the System Properties dialog:
a. Right-click on “My Computer.”
b. Choose Properties.

OR

a. Go to Start -> Settings -> Control Panel.
b. Double-click on System.

2. Select the Environment tab.
3. Select a variable in the System Variables group.
4. Replace the Variable name with “LSHOST” or “LSFORCEHOST.” 5. Replace the Value with the License Server name or names.

Note:
You can use the name or IP address of the server machine.

6. Click .
7. Click .

On Windows 2000, XP and Vista
1. Bring up the System Properties dialog:
a. Right-click on “My Computer.”
b. Choose Properties.

OR

a. Go to Start -> Settings -> Control Panel.
b. Double-click on System. (i.e. System can be found in the “Classic View” of both Windows XP and Vista). For Windows XP, if you have a list of categories, you can find System in the “Performance and Maintenance” category. For Windows Vista, you can find System in the “System and Maintenance” category and click on the “Advanced system settings” in the left panel.

2. Select the Advanced tab.
3. Click .
4. Click for System Variables.
5. Enter “LSHOST” or “LSFORCEHOST” for the Variable name.
6. Enter the License Server name or names for the Value.

Note:
You can use the name or IP address of the server machine.

7. Click
8. Click

On Windows 95/98/Me
1. Go to Start -> Run.
2. In the Open edit field, type sysedit.
3. Click .
4. Set the LSHOST or LSFORCEHOST variable.

Example:
Set LSHOST=

OR

Set LSFORCEHOST=.

Note:
You can use the name or IP address of the server machine.

5. Save and close the autoexec.bat file.
6. Reboot the machine. This will force the information added to the autoexec.bat file to be entered into the system environment.

When should LSHOST and LSFORCEHOST be defined

Defining the LSHOST and LSFORCEHOST variables
Note:
These variables only need to be defined if WinRunner has trouble locating your License manager server or if you want the specified effect. Define LSHOST:
1. When the client and server are in different domains.
2. If you want the client to use more than one available server, in a specific order.
Define LSHOST to be the server names in the order you would like to search them. Separate the server names with a semicolon (“;”). Note:
When LSHOST is used, WinRunner will first look for a license on the specified servers, in the specified order. If a license is not found there, WinRunner will search your network for one.
Define LSFORCEHOST when you want the client to search the license on only ONE specific server. Define LSFORCEHOST to be the name of that server.

Install / delete a license code with the lslic utility

The lslic utility installs or deletes a license. lslic can be run on supported version of Windows and UNIX. It can be run from the operating system command prompt by an administrative user on a stand-alone, client, or license server computer. It works for both stand-alone and network computers.

Use lslic in the following format:
lslic [option]
Where the option might be:
-a license-code

Adds a license code to the contacted license server without updating the license file. Note: Change is temporary until the license server is restarted.

-f filename

Adds all the license codes in the supplied file to the contacted license server without updating the license file (lservrc). Note: Change is temporary until the license server is restarted.

-A license-code

Adds a license code to the license server’s license file (lservrc) and communicates the change to the contacted license server. Note: Change is permanent

-F filename

Adds all the license codes in the supplied file to the license server’s license file (lservrc) and communicates the new information to the contacted license server. Note: Change is permanent

-df feature_name feature_version[capacity | NOLIMIT]

License(s) with specified feature name and version are deleted from the license server memory. Note: Change is temporary until the license server is restarted.

-removeall

Removes all license codes (redundant and non-redundant) from the license server but does not delete them form the license file. Note: Change is temporary until the license server is restarted.

-removeallcap [feature version]

Removes capacity for specific license from the license server but does not delete them from the license file. Note: Change is temporary until the license server is restarted.

-DL feature-name
feature version
license hash
[capacity | NOLIMIT]

License with specified feature_name, version and license hash is deleted from the license server memory and file. Note: Change is permanent Tip: The license hash can be obtained using the lsmon utility.

-p feature-name
feature version
license hash
precedence

Sets the precedence of a trial license. The license hash can be obtained from WlmAdmin or lsmon.

-p

Pauses the utility and then shows the output in another console. Only for Windows Vista, 7, and Server 2008.

Tips on Using lslic

* If you do not include necessary information on the command line, lslic will ask for the missing information.

* You can use the LSFORCEHOST environment variable to add/delete licenses to a particular license server.

* When you enter a license code, if you are entering an encrypted license code, type only the characters before the # symbol.

* lslic can add or delete licenses without stopping and restarting the license server, but the change is only temporary unless you use an option that makes the change to the license file.

* To use lslic to modify a license file or redundant license file for a license server on a remote computer, use the LSFORCEHOST environment variable to point your computer to the computer containing that license server.

* If you are using lslic to modify a license file on a remote computer, you must have write-access to that computer.

* License deletion is not supported for the following licenses:

* Checked out commuter license tokens residing on the local computers

* Grace licenses being used on the non-networked computers

* Licenses in the redundant license files (lservrlf)
For further information, please consult Sentinel RMS Kit System Administrator’s Help that can be found in \LicenseServer\server\SysAdminHelp\Default.htm.