Home » Managing the server and licenses » Configuring the BlackBerry Administration Service to use a proxy server » Configuring proxy selection for the BlackBerry Administration Service

Configuring proxy selection for the BlackBerry Administration Service

You can configure the BlackBerry® Administration Service to select a proxy server either manually or automatically.

To manually select a proxy server, you can use one of the following tools:

Proxy Configuration Tool (proxycfg.exe) with Windows Server® 2003 or earlier
Network Shell Utility (netsh.exe) with Windows Server 2008
Windows® Internet Explorer®

To automatically select a proxy server, you can use one of the following methods:

enable the Web Proxy Autodiscovery Protocol using the BlackBerry Enterprise Trait Tool
specify a URL for a PAC file using Windows Internet Explorer

Configuring manual proxy selection for a BlackBerry Administration Service instance

Depending on the operating system on the computer that hosts the BlackBerry® Administration Service instance, you can use the Proxy Configuration Tool or the Network Shell Utility to manually select a proxy server for a BlackBerry Administration Service instance. You must configure manual proxy selection for all of the computers that host a BlackBerry Administration Service instance. Both the Proxy Configuration Tool and the Network Shell Utility store the proxy server settings in the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\Connections\WinHttpSettings registry key. You must run both tools as an administrator.

The Proxy Configuration Tool works with Windows Server® 2003 or earlier, and it is located in one of the following locations:

For 32-bit Windows® operating systems, the Proxy Configuration Tool is located at c:\Windows\system32\.
For 64-bit Windows operating systems, the Proxy Configuration Tool is located at c:\Windows\sysWow64\.

For more information about the Proxy Configuration Tool, visit www.msdn.microsoft.com and search for proxycfg.exe.

The Network Shell Utility works with Windows Server 2008. For more information about the Network Shell Utility, visit technet.microsoft.com and search for Netsh.exe.

Configure manual proxy selection for the Windows account that runs the BlackBerry Administration Service

Perform this task on all of the computers that host a BlackBerry® Administration Service instance.

On the computer that hosts the BlackBerry Administration Service, log in using the Windows® account that runs the BlackBerry Administration Service.
Open Windows® Internet Explorer®.
Click Tools > Internet Options.
On the Connections tab, click LAN settings.
Select Use a proxy server for your LAN.
In the Address field, type the address for the proxy server.
In the Port field, type the port number for the proxy server.
Click OK.
Click OK.

Windows Internet Explorer stores the settings for the proxy server in the HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings registry key.

Configure the BlackBerry Administration Service to use the Web Proxy Autodiscovery Protocol to select a proxy server automatically

If you want to configure the BlackBerry® Administration Service to use the Web Proxy Autodiscovery Protocol to select a proxy server automatically, you must use the BlackBerry® Enterprise Trait Tool. The Web Proxy Autodiscovery Protocol uses DHCP and DNS to find a PAC file. Perform this task on any computer that hosts a BlackBerry Administration Service instance.

CAUTION:

If the proxy server authenticates using HTTP basic authentication, the Web Proxy Autodiscovery Protocol file must be on a computer that is separate from the proxy server and uses Windows® authentication or anonymous authentication.

On the computer that hosts the BlackBerry Administration Service, at the command prompt, navigate to the folder that contains the TraitTool.exe file.
To turn on Web Proxy Autodiscovery Protocol, type traittool -global -trait BASIsProxyWPADOptionEnabled -set 1.

Turn off Web Proxy Autodiscovery Protocol

Perform this task on any computer that hosts a BlackBerry Administration Service instance.

On the computer that hosts the BlackBerry Administration Service, at the command prompt, navigate to the folder that contains the TraitTool.exe file.
To turn off Web Proxy Autodiscovery Protocol, type traittool -global -trait BASIsProxyWPADOptionEnabled -erase.

Configure the BlackBerry Administration Service to use a PAC file to select a proxy server automatically

Perform this task on all of the computers that host a BlackBerry® Administration Service instance.

CAUTION:

If the proxy server authenticates using HTTP basic authentication, the PAC file must be on a computer that is separate from the proxy server and uses Windows® authentication or anonymous authentication.

Before you begin: Obtain the URL for the PAC file.

On the computer that hosts the BlackBerry Administration Service instance, log in using the Windows® account that runs the BlackBerry Administration Service.
Open Windows® Internet Explorer®.
Click Tools > Internet Options.
On the Connections tab, click LAN settings.
Select Use automatic configuration script.
In the Address field, type the URL for the PAC file.
Click OK.
Click OK.