How can I set a proxy for Delta2D 4.0 and newer?

Delta2D needs to contact our web server for three possible reasons:

• to validate special, so called 'web checked' licenses
• to use Scouts for aquisition of data from web-based databases
• to check for updates

If your network situation demands to set your internet browser to use a proxy, then Delta2D very likely will need the same settings, otherwise you will see error messages saying that the license server or the update server could not be connected.

Delta2D 4.0 and newer enables you to specify a proxy very easily:

Open the Options window (Delta2D menu: Tools -> Options) and switch to the "General" settings.

Choose the "Web" Tab.

The default setting is to use the system proxy settings. If you have specified proxy settings for your computer in the control panel these will be used by Delta2D as well. Please note, that the proxy settings are not apopted by Delta2D if your computer determines them by an automatic configuration script.

To specify individual proxy settings for Delta2D, simply tick the radio button Manual Proxy Settings and type in the host name or ip address and the proxy port into the respective fields.

If you are using a floating license it might be necessary to do additional adjustments. Please ask your network or computer administrator whether or not the Delta2D license server is reachable via the proxy. If yes, you are done with the proxy settings. If not, you will need to exclude the license server from proxying: please click on the button More you see below the proxy field. There you can specify the host name or ip address of your license server in the No Proxy Hosts: field. Multiple entries can be separated with a comma.

Please note, that if your proxy settings done here are not correct and hence Delta2D cannot contact the license server, it might happen, that Delta2D does not start any more. In this case you will have to edit the corresponding settings file manually to reenable Delta2D to start. You can find it in your Delta2D settings folder:

<your user home>\.Delta2D\config\Preferences\org\netbeans\core.properties

It looks like this:

proxyType=2                                     # 0 = no proxy, 1 = system settings, 2 = as specified here
proxyHttpHost=yourproxhost                      # proxy host name or ip address
proxyHttpPort=4711                              # proxy Port, default is 80 or 8080
useProxyAuthentication=true                     # only necessary if authentication is required
proxyAuthenticationUsername=yourloginname       # only necessary if authentication is required
proxyAuthenticationPassword=yourpassword        # only necessary if authentication is required
proxyNonProxyHosts=localhost|127.0.0.1|foo|bar  # list of host names or ip addresses

You will not see all parameters in your file, only those you specified a value for.