This is an old revision of the document!


Internet Proxy Server Setup

Some companies restrict internet connection from individual computers inside company's intranet / local area network, in which case individual computers can access internet through a Proxy Server. If your company uses proxy server, you must define the proxy server host and port number in config.properties (located in /www/MbrSvr/config/ folder) to allow TestOptimal server to access internet for software updates and license validation.


Define Proxy Server

To define proxy server, add / modify the following config settings:

  ProxyHost=myhost
  ProxyPort=1234
  ProxyUserID=abc
  ProxyPassword=xxx

ProxyUserID and ProxyPassword are only required if your proxy server requires user id and password. If your proxy server does not require user id and password to access the internet, then leave these properties blank or delete them.

Another way to define proxy server is to edit startTestOptimalServer.bat (for windows) or startTestOptimalServer.sh (for mac/linux) and add the following “-D” java command-line argument:

  java -Dhttp.proxyHost=myproxyserver.com -Dhttp.proxyPort=80 ...
  

Force Model to use Proxy Server

By default, proxy server is only used for validating license, checking for updates and downloading/applying updates. Therefore the model execution will not use proxy server even though proxy server is defined.

This is usually ok since most likely your AUT is running within your intranet thus no need to access internet. However should you want to test applications hosted on the internet and you also have proxy server defined, you can force the model execution to use proxy server by setting the following config property (rel.4.4.0):

proxy.force = true

Avoid Proxy Filter

Proxy server is capable of blocking certain internet requests using filters / rules. Your network admin may use the filters to block all non-browser requests. As the result TestOptimal server would not be able to access internet even though your browser is capable of browsing the internet on the same computer.

You can use one or both of the following config settings to make TestOptimal simulate http request from a certain browser (rel. 4.4.0):

HTTP.UserAgent=Mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/20100101 Firefox/22.0
HTTP.Referer=@ThisServer@

where @ThisServer@ will be dynamically replaced with your TestOptimal server url. You may change HTTP.UserAgent to a different browser user agent string to simulate a specific browser. You can find the user agent string for many of the browsers at: http://seehowitruns.info/index.php?report=1&action=view_report