Product Documentation

BlackBerry 5

Jun 05, 2015
Updated: 2014-11-19
Deploying the BlackBerry 5 service to customers includes the following tasks:

For information about requirements for deploying the BlackBerry 5 service, refer to Plan to deploy the BlackBerry service.

To configure the BlackBerry 5 service

  1. Enable the service (top level) and create a default customer plan:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Service Deployment and then expand BlackBerry 5.
    2. Click Customer Plans, create a customer plan named Default, click Apply Service, and then click Save.
  2. Enable the service (location level):
    1. Under Service Filter, select Active Directory Location Services and choose a Location Filter if applicable.
    2. Expand BlackBerry 5 and click Save.
  3. Assign server roles:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Server Roles and then expand the entry for BES 5.
    2. Under Server Connection Components, select BlackBerry 5 API and then click Save.
  4. Add credentials for the service account:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Credentials.
    2. In the credentials table, click Add.
    3. In Username and Password, enter the user name and password for the BlackBerry service account.
    4. Leave Encrypted selected to encrypt the credentials as they are displayed on the page and stored in the database.
      Note: Citrix recommends encrypting credentials when Services Manager is deployed in a production environment. Use plain-text credentials only for debugging purposes.
    5. In Domain, enter the FQDN of the service account if the service account is an Active Directory account. If the service account is an internal BES account, enter CortexBESInternal.
  5. Add a server connection:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Server Connections, click New Connection, and then select or type the following information for the connection.
      Server Role
      Choose BlackBerry 5 API.
      Server
      Choose the BES 5 server.
      Credentials
      Choose the credentials for the BES.
      URL Bases
      Defaults to /.
      Protocol
      Defaults to http.
      Port
      Defaults to 443. If you change the port here, change it also in the BES.
      Timeout
      Defaults to 200000 milliseconds.
    2. Click Save.
    3. From the Services Manager menu bar, choose Configuration > System Manager > Server Connections and click the icon in the Test column for the server with the BlackBerry 5 API installed. The icon turns green for a successful connection. A red icon indicates an unsuccessful connection. Mouse over it for information about the failed connection.
  6. Configure service settings:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Service Deployment.
    2. Under Service Filter, select Active Directory Location Services, choose a Location Filter if applicable, and expand BlackBerry 5.
    3. Click Service Settings, update the settings as needed, click Apply changes and then click Save.
  7. Configure the customer plan:
    1. From the Services Manager menu bar, choose Configuration > System Manager > Service Deployment, select Active Directory Location Services, choose a Location Filter if applicable, expand BlackBerry 5, click Customer Plans, and then expand the Default customer plan.
    2. Select the Instance check box, click Reload if needed to load the BlackBerry instance data, and then select the check boxes for all applicable instances.
    3. Select the IT Policies check box, click Reload if needed to load the BlackBerry policies data, and then select the check boxes for all applicable policies.
    4. Click Apply changes and then click Save.