BlackBerry Administration Service console is not accessible due to a port conflict with other software

Article ID: KB18175

Type: Support Content

Last Modified: 04-26-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Server
CollapseEnvironment
  • BlackBerry Enterprise Server 5.0
  • Microsoft Windows Server 2008
CollapseOverview
When the BlackBerry Enterprise Server 5.0 installation process has completed the BlackBerry Administration Service console may not be viewable from the browser. This is because the BlackBerry Administration Service - Application Server starts, but eventually stops.
CollapseCause

A port binding conflict has occurred on port 443 with another application on the same server as the BlackBerry Administration Service.

When this issue occurs, the following log lines appear in the BlackBerry Administration Service - Application Server log file:

java.net.BindException: Address already in use: JVM_Bind:443...
LifecycleException: Protocol handler initialization failed: java.net.BindException: Address already in use: JVM_Bind:443

To confirm this issue, verify that another application has port 443 in use. This can be accomplished by performing a netstat -ano from a command prompt, or by using other tools, such as TCPView with the BlackBerry Administration Service - Application Server stopped.

For example:

C:\Documents and Settings\hostname>netstat -ano | find ":443"
TCP 0.0.0.0:443 0.0.0.0:0 LISTENING 4

For the above example:

Protocol = TCP, source IP = 0.0.0.0, source port = 443, destination IP = 0.0.0.0, status = LISTENING, PID = 4

The 4 represents the process ID of the listening connection at 0.0.0.0 on port 443 which is always the local system process of the machine. When the SSL port on the IIS website is set, it is displayed as 0.0.0.0:(port) when using Internet Information Services (IIS).

CollapseResolution

There are two ways to resolve the port conflict:

Resolution 1

Change the IIS web site SSL port to something other than 443 (for example, port 663) or disable SSL by removing the port from the field.

Resolution 2

Change the BlackBerry Administration Service - Application Server port to an available port by completing the following steps:

  1. Stop the BlackBerry Administration Service - Application Server service and the BlackBerry Administration Service - Native Code Container.
  2. Open the BlackBerry Server Configuration tool from Start > Programs > BlackBerry Enterprise Server.
  3. Select the Administration Service - High Availability tab.
  4. Change the HTTPS Service Port value from 443 to a port that does not conflict with any other application (for example, port 663).
  5. Click Apply, and then OK.
  6. Start the BlackBerry Administration Service - Application Server service and the BlackBerry Administration Service - Native Code Container.

Note: After this change is made make sure to specify the new port to use when accessing the BlackBerry Administration Service user interface. For example, if the port is changed to 663, the Uniform Resource Locator (URL) used to access the BlackBerry Administration Service will now be https://server.domain.com:663/webconsole/app.

To update the browser shortcut, navigate to C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BAS\External\Bin , right-click AccessBlackBerryAdministrationService.url, click Properties, and change the port number in the URL field.

When trying to change the port number in Microsoft Windows Server 2008 you may encounter the following message:

Cannot apply changes to this Internet Shortcut.

To work around this issue copy the file to another directory or to the Desktop and make the change to the port number and then copy or move the file back and replace the previous version when prompted.

CollapseAdditional Information

Note: To update the HTTPS Service Port on Windows Server 2008 with User Account Control enabled, right-click the BlackBerry Server Configuration tool and select Run As Administrator.

Note: To configure the new web site in IIS to use TCP port 443 for SSL, complete the following steps:

  1. Click Start, point to All Programs, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.
  2. In Internet Information Services (IIS) Manager, expand ServerName, and then expand Web Sites.
  3. Right-click the name of the web site that you just created (WebSite in this example), and then click Properties.
  4. On the Web Site tab, in the Web site identification section, in the SSL port box, type 443.
  5. Click Apply.
  6. Close OK to close the Properties page.

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.