Installing BlackBerry Device Service, Universal Device Service, and BlackBerry Management Studio on the same host server

Article ID: KB32547

Type: Support Content

Last Modified: 09-16-2013

 

Product(s) Affected:

  • BlackBerry Enterprise Service 10
  • BlackBerry Mobile Fusion Studio
  • BlackBerry Device Service
  • Universal Device Service
CollapseEnvironment
  • BlackBerry Enterprise Service 10
  • BlackBerry Management Studio
  • BlackBerry Device Service
  • Universal Device Service
CollapseOverview

BlackBerry Enterprise Service 10 helps to make managing mobile devices faster, easier and more organized than ever before. From a single, web-based interface, Administrators and Help Desk personnel can provision, audit and protect mobile devices, including BlackBerry smartphones, BlackBerry PlayBook tablets and devices that use iOS and Android operating systems. This unified approach helps provide secure mobile access to work email and data in a cost-effective way. BlackBerry Enterprise Service 10 is composed of three distinct components:

  • BlackBerry Device Service (BDS): Provides management features for BlackBerry PlayBook tablets and BlackBerry 10 smartphones.
  • Universal Device Service (UDS): Provides management features for devices that use iOS and Android operating systems.
  • BlackBerry Management Studio: A web application that provides a single place for management of mobile devices, users, configurations, policies and more.

All of these components can co-exist on the same host server. In order to install both BlackBerry Device Service and Universal Device Service on the same server in this configuration, it is recommended that BlackBerry Device Service be installed prior to Universal Device Service, to avoid any port conflicts. If Universal Device Service has already been installed and BlackBerry Device Service will be added afterwards, Universal Device Service default port configurations must be modified prior to BlackBerry Device Service installation or BlackBerry Device Service ports must be modified during BlackBerry Device Service installation, in order to avoid port conflicts.

BlackBerry Management Studio, the BlackBerry Device Service, and the Universal Device Service can all be installed on the same host server. This configuration supports a total of 6000 devices on the Universal Device Service and the BlackBerry Device Service. To avoid port conflicts during the installation, plan which ports are going to be used for each product.


Ports

By default BlackBerry Management Studio, the BlackBerry Device Service, and the Universal Device Service use port 443. The Universal Device Service uses port 443 for activities related to the Communication Module and for making connections to the Apple Root Certification Authority, to check the certificate revocation list, and to configure the APNs certificate. The Universal Device Service also uses port 443 during installation to connect to the BlackBerry Infrastructure. The BlackBerry Device Service and BlackBerry Management Studio use port 443 as the default HTTPS port. Default port 443 should be used for the Universal Device Service, while other open ports are used for the BlackBerry Device Service and BlackBerry Management Studio. Port 444 for the BlackBerry Device Service and 668 for BlackBerry Management Studio should be used, but any open and available port that supports SSL can be used.



New installation

When performing a new installation of these products on the same host server, install in the following order:

  1. BlackBerry Device Service
  2. BlackBerry Management Studio
  3. Universal Device Service


Upgrading

If one of the components is already installed on the computer, then the installed components must be upgraded before installing more.

If the BlackBerry Device Service is already installed and Universal Device Service is to be installed on the same computer, the default port configurations for the BlackBerry Device Service must be changed before installing the Universal Device Service. Alternatively, the ports for the Universal Device Service can be changed during the installation, in order to avoid port conflicts.

Change the port for the BlackBerry Device Service:

  1. Navigate to Start > Programs > BlackBerry Device Service > BlackBerry Server Configuration Panel > BlackBerry Administration Service Pool
  2. Modify the HTTPS Port number to the desired port number
  3. Click Apply
  4. Click Synchronize
  5. Restart the BlackBerry Administration Service Application Server (BAS-AS) and the BlackBerry Administration Service Native Code Container (BAS-NCC) services

The Server address will now be: https://<FQDNServerName>:<port>/webconsole/login

Update the BlackBerry Device Service shortcut:

  1. Navigate to C:\Program Files\Research In Motion\BlackBerry Device Service\
  2. Right-click on the shortcut and open the properties for BlackBerry_Administration_Service.
  3. Ensure that the URL includes the new port; if it does not, modify the URL and save the change.

Change the port for the BlackBerry Management Studio:

  1. On the host server, open the Windows Notepad application as an Administrator.
  2. Navigate to the location that BlackBerry Management Studio was installed to (the default is C:\Program Files\Research In Motion\BlackBerry Management Studio)
  3. In the Windows Notepad application, select All Files and open BlackBerryMobileFusion.xml.
  4. Modify the port listed as 443 to reflect the desired port.
  5. Save the file and restart the BlackBerry Mobile Fusion Studio service.

Note: The Server address will now be: https://<FQDNServerName>:<port>

Update the BlackBerry Management Studio shortcut:

  1. Navigate to Start > Programs > BlackBerry Management Studio.
  2. Right click on the BlackBerry_MOBILE_FUSION_STUDIO.url shortcut and select Properties.
  3. Ensure that the URL that is displayed includes the new port; if it does not, update the URL and save the change.


Additional Port Conflicts

There are additional port conflicts that should also be addressed. The Activation Configuration Enterprise Management Web Service (EMWS) port in BlackBerry Device Service defaults to port 8081 and this may conflict with the Universal Device Service Core module port, which also defaults to port 8081. However, the Universal Device Service uses ports 8082 and 8083, so it is not recommended to use those ports as the EMWS port for BlackBerry Device Service; doing so may cause wired and wireless enrollment issues. It is recommended that the Activation Configuration port be changed to 8085 or any open port (other than ports 8082 or 8083). To confirm the port change, log into the administration console and navigate to the path below.

BlackBerry Solution Topology > BlackBerry Domain > Component View > Enterprise Management Web Service > instance name

The WebServerListenPort (set to use port 8080 by default) and the WebServerListenSSLPort (set to use port 8443 by default) used in the MDS-CS component in BlackBerry Device Service may conflict with Tomcat and the Universal Device Service Console. It is recommended that both of these ports be updated to other values (such as 8099 and 8445 respectively). To make the change, log into the administration console and navigate to the path below.

BlackBerry Solution Topology > BlackBerry Domain > Component View > MDS Connection Service > instance name > General tab

CollapseAdditional Information

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.