We're here to help

Defining proxy settings

In Provar Version 1.9, the way Provar defines proxy information is changing. For information on defining your network settings in Versions 1.9 and later, read on. For information on defining proxy settings in Version 1.8 and earlier, refer to the section below, Defining Proxy Settings in Version 1.8.

 

Defining proxy settings in Version 1.9

As of Provar version 1.9, Provar has a new Network Settings feature to manage network and proxy settings in a user-friendly way from inside Provar Desktop.

The settings defined here will be persistent in the system across any Provar version starting from 1.9.1, with no changes required to modify them with each new installation. If you have multiple versions of Provar installed, changes made in one version will be reflected in all other versions.

Note: If you previously defined proxy settings in the provar.ini file, you can follow the new approach defined below once taking Provar version 1.9.1. The Provar.ini file will be refreshed automatically with the new version with no additional steps required by the user.

You can access Network Settings by clicking Help > Network Settings:

You can also access Network Settings via the License Manager (Help > License Manager):

Using System Provided Proxy Settings

Network Settings uses your standard system-provided proxy settings as the default option.

This means that you do not need to provide additional details unless the settings you want to use are different from the system-provided settings.

If Provar is using your system-provided defaults, Network Settings will show this as follows:

Testing network settings

You can test your default settings or any custom settings you define (see below) by clicking the ‘Test Settings’ button:

This will open a dialog box to test your settings against the URLs you select. This will test that Provar is able to reach these URLs using the selected network settings:

Note that you can also specify a custom URL in the ‘Other’ option:

Defining other network proxy settings

Proxy Server: In computer networks, a proxy server is a server (a computer system or an application) that acts as an intermediary for requests from clients seeking resources from other servers.

You can define any of the following proxy types in Network Settings:

  • HTTP Proxy: HTTP proxy operates between the sending Web server and your receiving Web client. It processes the HTTP protocol line-by-line for any potentially harmful content before sending it to an internal Web client. It also acts as a buffer between your Web server and potentially harmful Web clients by enforcing HTTP RFC compliance and preventing potential buffer overflow attacks.
  • SOCKS Proxy: Socket Secure (SOCKS) is an Internet protocol that exchanges network packets between a client and server through a proxy server
  • PAC Proxy: A proxy auto-config (PAC) file defines how web browsers and other user agents can automatically choose the appropriate proxy server (access method) for fetching a given URL.

 

There is also a Direct (no proxy) option for if you do not want Provar to use any proxy. This will instruct Provar to ignore the system default network settings.

To define any one of these options, click the ‘New’ button:

In the dialog which appears, provide a Configuration Name and select the proxy type.

Refer back to the definitions above if you are unsure which type to select.

Depending on the proxy type you select, additional fields will appear for you to complete.

If you select Direct (no proxy), there are no additional fields to complete.

If you select HTTP(S) or SOCKS Proxy, the following additional fields will appear:

  • HTTP/SOCKS Proxy Host (Required)
  • HTTP/SOCKS Proxy Port (Required)
  • Proxy User name
  • Proxy Password

HTTP(S):

SOCKS:

If you select PAC Proxy, you will be asked to provide the PAC URL:

Once you have finished adding any additional information, use the ‘Test Settings’ button to verify the details:

Then click the ‘Save’ button. Your new settings will be added to the Network Settings list in inactive mode:

To make your new settings active and apply the settings in Provar, click on the new settings so that they are highlighted and then click the ‘Activate’ button.

The following dialog box will appear:

To activate these changes immediately, click ‘Restart Now’ to relaunch Provar with the new settings. The new settings will not apply until Provar has been restarted.

 

Location of proxy settings

All proxy settings are stored in the .networking folder which can be found under your {UserHome}/Provar folder:

 

ANT/Jenkins run

If you are using a custom proxy setup and Jenkins/Ant execution is scheduled for Provar tests on Provar versions later than 1.9.1, please ensure that the .networking folder is placed under the same folder as the .license folder, i.e. so that both folders have the same parent folder. This only applies if you are using a custom proxy setup. If system defaults are used, there is no need to do this configuration. This is also referring to the standard location of licenses, {UserHome}/Provar, not a custom one.

Note: In Windows you cannot generally create a folder that begins with a period via the UI, so you may need to use the command prompt to create the folder.

On occasion errors can occur where Provar does not pick up .networking setup files from {UserHome}/Provar/.

If this occurs, it can be resolved by following the steps below:

Go to {UserHome}/Provar/ and copy the .networking folder.

Go to the location where Jenkins is trying to identify the networking folder.

Paste the .networking folder under the same folder as the .license folder, i.e. so that both folders have the same parent folder. There might be multiple custom proxy entries under networking folder.

Provar will seek the active setting from all the options and select it for execution. If there is no active proxy present in the .networkingfolder, Provar will automatically pick the system default settings.

Execute the tests via Jenkins now and this time the network settings should be identified.

 

Backwards compatibility 

In case you encounter any issues while defining proxy settings using the new Network Settings dialog, you can also fall back to the legacy method of configuring proxy information (see Defining Proxy Settings in Version 1.8 below). For this we need to add one more entry in provar.ini file:

-Dcom.provar.proxy.legacy=true

All other proxy entries will be same.

 

Important note 

This 1.9 proxy setup should done one time only per system. Provar will reflect these settings across all installed Provar versions, in the same way as for license information.

 

Defining proxy settings in Version 1.8

As of Provar version 1.8.11, Provar will attempt to detect proxy settings automatically and globally instead of from a ConnectionPlease note that, after taking version 1.8.11, proxy information defined at the Connection level will be ignored.

If Provar does not succeed in detecting your proxy settings automatically, you will need to define proxy information in the provar.ini file. Follow the steps below to do this.

Proxies without username and password

Djava.net.useSystemProxies=true
-DproxyHost=<host>
-DproxyPort=<port>
-Dcom.provar.proxy.host=<host> 
-Dcom.provar.proxy.port=<port>

If a proxy is not username and password enabled, the above arguments should be added to the provar.ini file.

To prevent errors, please click this link to access a plaintext file of the arguments above, then copy and paste the arguments into the provar.ini file, adding your own information where shown.

 

Proxies with username and password

Djava.net.useSystemProxies=true
-Dcom.provar.proxy.host=<host>
-Dcom.provar.proxy.port=<port>
-DproxyHost=<host>
-DproxyPort=<port>
-Dcom.provar.proxy.user=<userName>
-Dcom.provar.proxy.password=<password>

If a proxy is username and password enabled, the above arguments should be added to the provar.ini file.

 

 

PAC proxies

-Dcom.provar.pac.url=<PAC proxy URL>
-Djava.net.useSystemProxies=true

For a PAC proxy, the above arguments should be added to the provar.ini file.

 

MS exchange connections

As of Provar version 1.8.11.31, Provar also supports the use of Proxy/PAC for Microsoft Exchange Connections. Use the instructions above to define your proxy information.

You can also use the following tracing variable to provide more information about errors:

-Dcom.provar.exchange.trace=true

Copy and paste this into the provar.ini file: