Product Documentation

BlackBerry 4 Services

Jun 05, 2015
CloudPortal Services Manager BlackBerry 4 Services host BlackBerry Enterprise Server (BES) 4 from the cloud, providing push-based access to Exchange, Office Communications Server, Customer Relationship Management, and other applications from BlackBerry devices.

BlackBerry 4 Services support Exchange 2007 and 2003. Services Manager can manage multiple BESs.

Prerequisites

  • Provision customers and users with CloudPortal Services Manager Exchange Services.
  • Install CloudPortal Services Manager BlackBerry Web Service.
  • Install BESUserAdminService on the BES 4 server (and start the service) and install BESUserAdminClient on the server where the Services Manager BlackBerry Web Service is installed.

    Those components are included in the BES User Administration Tool that is available for download from the BES Resource Kit site.

  • Configure BESAdmin user (the user that runs the BlackBerry 4 Web Service) as an Enterprise Admin in BlackBerry Manager and add BESAdmin to the CortexAdmins group in Active Directory.

To customize BES to look up user addresses using LDAP

If you host a BES for multiple subscribers, you must customize address lookup to restrict users from accessing contact information from another organization.

  1. Log on to a BES 4 server, start the registry editor, and browse to HKEY_LOCAL_MACHINESoftwareResearch In MotionBlackBerry Enterprise ServerAgents.
  2. Create the following keys:
    Key type Name Value
    DWORD Value AllowAddressLookup 1
    DWORD Value HostedServer 1
    DWORD Value LDAPSearch 1
    DWORD Value LDAPALPSearch 1
    String Value LDAPCompanyField ExtensionAttribute15
  3. From the Services window (on the BES server), restart the BlackBerry Controller service.
  4. Repeat this procedure for each BES.

To configure BlackBerry 4 Services

  1. Enable the service (top level) and create a user plan:
    1. From the main menu, choose Configuration > System Manager > Service Deployment, and expand BlackBerry.
    2. Click User Plans, enter a name such as Default, click Create, click Apply Changes, and then click Save.
  2. Enable the service (location level): Under Service Filter, select Active Directory Location Services, choose a Location Filter if applicable, expand BlackBerry, and click Save.
  3. Add credentials: From the main menu, choose Configuration > System Manager > Credentials and add the Services Manager Web Services credentials.
  4. Enable the server:
    1. From the main menu, choose Configuration > System Manager > Servers.
    2. If the BES servers are not listed, click Refresh Server List.
    3. Expand the entry for each BES and verify that Server Enabled is selected.
  5. Assign server roles:
    1. From the main menu, choose Configuration > System Manager > Server Roles and then expand an entry for BES 4.
    2. Under Server Roles, select BlackBerry Enterprise Server, and click Save.
    3. Expand the server where the BlackBerry Web Service is installed and under Server Connection Components, select BlackBerry, and then click Save.
  6. Add a server connection:
    1. From the main menu, choose Configuration > System Manager > Server Connections, click New Connection, and then select or type the following information for the connection.
      Server Role
      Choose BlackBerry.
      Server
      Choose the server where the BlackBerry Web Service is installed.
      Credentials
      Choose the credentials for the BlackBerry Web Service.
      URL Base
      Enter /BlackBerryWS/BlackBerry.asmx.
      Protocol
      Select http.
      Port
      Defaults to 8097. If you change the port here, change it also in the web service.
      Timeout
      Defaults to 200000 milliseconds.
    2. Click Save.
    3. From the main menu, choose Configuration > System Manager > Server Connections and click the icon in the Test column for the server where the BlackBerry Web Service is 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.
  7. Configure service settings:
    1. Under Service Filter, select Active Directory Location Services, choose a Location Filter if applicable, and expand BlackBerry.
    2. Click Service Settings, update the settings as needed, click Apply changes and then click Save.
  8. Configure user plans:
    1. Under Service Filter, select Active Directory Location Services, choose a Location Filter if applicable, and expand BlackBerry.
    2. Click User Plans, expand a user plan, and specify the BESAdminClient Password, BESAdminClient Path, and BlackBerry Servers. The BESAdminClient Path must match the path set in the BlackBerry web.config file (AppSettings tab).
    3. Click Apply changes and then click Save.

To complete the configuration

  1. Log on to the server running the Services Manager BlackBerry Web Service.
  2. Open the BlackBerry web.config file, typically in C:Program FilesCitrixCortexCortexBlackBerryWSCortexBlackBerryWSRoot, and verify the BESAdminClient path and password under AppSettings:
    <add key="BESAdminClientPath" value="C:Program FilesCitrixCortexBESUserAdminClientBESUserAdminClient.exe"/>
    <add key="BESAdminClientPassword" value="password"/>
    
    The BESAdminClientPath is the path where BESAdminClient.exe and CE.dll are installed.
  3. Restart the BES 4 servers.