Installation and Configuration Guide

Local Navigation

Configuring communication with distributed components

Connecting to a BlackBerry Attachment Service

Perform the following actions if you installed the BlackBerry® Attachment Service on a computer that is separate from the computer that host the BlackBerry® Enterprise Server or BlackBerry Enterprise Server components that connect to the BlackBerry Attachment Service. These actions ensure that BlackBerry Enterprise Server components can connect to the BlackBerry Attachment Service.

Back To Top

Connect a BlackBerry MDS Connection Service to a remote BlackBerry Attachment Service

Perform the following task if you did not install the BlackBerry® Attachment Service on the same computer as the BlackBerry MDS Connection Service.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Connector.
  2. Click the BlackBerry Attachment Connector that is installed with the BlackBerry MDS Connection Service.
  3. Click Edit instance.
  4. On the Supported Attachment Server instances tab, in the Name drop-down list, select the BlackBerry Attachment Service instance that you want to connect the BlackBerry MDS Connection Service to.
  5. In the Results query period(s) field, type the number of seconds that you want the BlackBerry MDS Connection Service to wait for a response before it sends a request to another BlackBerry Attachment Service instance.
  6. In the Dedicated server drop-down list, click yes if you want the BlackBerry Attachment Service instance to process specific content types only for the BlackBerry MDS Connection Service.
  7. In the Pool drop-down list, perform one of the following actions:
    • To include the BlackBerry Attachment Service instance in the primary group of instances in a pool, select Primary. You must include at least one BlackBerry Attachment Service instance in the primary group. If you are not configuring high availability, select Primary.
    • To include the BlackBerry Attachment Service instance in the secondary group, select Secondary.
  8. Perform the following actions:
    • To turn on support for an attachment file format, in the Extensions section, type the file extension of the format. Click the Add icon beside the extension that you typed.
    • To turn off support for an attachment file format, in the Extensions section, click the Delete icon beside the file extension.
  9. Click the Add icon.
  10. Click Save All.
  11. Repeat steps 2 to 10 for each BlackBerry MDS Connection Service instance in your organization's environment that requires the BlackBerry Attachment Service instance.
Back To Top

Connect the BlackBerry Collaboration Service to a remote BlackBerry Attachment Service

Using the BlackBerry® Client for IBM® Lotus® Sametime®, users can send files to contacts in their contact lists. To optimize files for viewing on BlackBerry devices, the BlackBerry Collaboration Service must connect to a BlackBerry Attachment Service instance. If you did not install the BlackBerry Attachment Service instance on the same computer as the BlackBerry Collaboration Service, you must connect the BlackBerry Collaboration Service to a remote BlackBerry Attachment Service.
  1. On the computer that hosts the BlackBerry Collaboration Service, navigate to C:\Program Files\Research In Motion\BlackBerry Enterprise Server\BBIM\Servers\<server_name>\config.
  2. In a text editor, open the rimpublic.property file.
  3. At the end of the file, type the following text on separate lines:

    Attachment.Server.host=<attachment_server_host_name>

    Attachment.Server.port.asp=1900

    Attachment.Server.port.rqp=2000

  4. To connect another BlackBerry Collaboration Service to the BlackBerry Attachment Service instance, type the text that appears in step 3 for this BlackBerry Collaboration Service instance.
  5. Save and close the file.
  6. In the Windows® Services, restart the BlackBerry Collaboration Service.
  7. On the computer that hosts the BlackBerry Attachment Service, in the Registry Editor, navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BBAttachServer\BBAttachBESExtension.
  8. On the computer that hosts the BlackBerry Attachment Service, in the Registry Editor, perform one of the following actions:
    • If you are running a 32-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BBAttachServer\BBAttachBESExtension.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion\BBAttachServer\BBAttachBESExtension.
  9. Change AllowRemoteServices to 1.
  10. In the Windows Services, restart the BlackBerry Attachment Service.
Back To Top

Connect a BlackBerry Enterprise Server to a remote BlackBerry Attachment Service

Perform the following actions if you did not install the BlackBerry® Attachment Service on the same computer as the BlackBerry® Enterprise Server. The BlackBerry Messaging Agent requires access to the remote BlackBerry Attachment Service so that it can process attachment requests.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Connector.
  2. Click the BlackBerry Attachment Connector that is installed with the BlackBerry Enterprise Server.
  3. Click Edit instance.
  4. On the Supported Attachment Server instances tab, in the Name drop-down list, select the BlackBerry Attachment Service instance that you want to connect to the BlackBerry Enterprise Server.
  5. In the Results query period(s) field, type the number of seconds that you want the BlackBerry Enterprise Server to wait for a response before it sends a request to another BlackBerry Attachment Service instance.
  6. In the Dedicated server drop-down list, click yes if you want the BlackBerry Attachment Service instance to process specific content types only for the BlackBerry Enterprise Server.
  7. In the Pool drop-down list, perform one of the following actions:
    • To include the BlackBerry Attachment Service instance in the primary group of instances in a pool, select Primary. You must include at least one BlackBerry Attachment Service instance in the primary group. If you are not configuring BlackBerry Attachment Service high availability, select Primary.
    • To include the BlackBerry Attachment Service instance in the secondary group, select Secondary.
  8. Perform the following actions:
    • To turn on support for an attachment file format, in the Extensions section, type the file extension of the format. Click the Add icon beside the extension that you typed.
    • To turn off support for an attachment file format, in the Extensions section, click the Delete icon beside the file extension.
  9. Click the Add icon.
  10. Click Save All.
  11. Repeat steps 2 to 10 for each BlackBerry Enterprise Server instance in your organization's environment that requires the BlackBerry Attachment Service instance.
  12. Restart the BlackBerry Enterprise Server.
    1. In the Component view, expand BlackBerry Enterprise Server.
    2. Click the BlackBerry Enterprise Server instance.
    3. Click Restart instance.
Back To Top

Connect a remote BlackBerry Attachment Service to a BlackBerry Enterprise Server

Perform the following actions if you did not install the BlackBerry® Attachment Service on the same computer as the BlackBerry® Enterprise Server. The BlackBerry Messaging Agent requires access to the remote BlackBerry Attachment Service so that it can process attachment requests.
  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Attachment > Server.
  2. Click the name of the remote BlackBerry Attachment Service.
  3. Click Edit instance.
  4. On the Supported Attachment Connector instances tab, add the BlackBerry Attachment Connector that is installed with the BlackBerry Enterprise Server.
  5. Click Save All.
  6. To restart the BlackBerry Attachment Service, on the Instance information tab, in the Status list, click Restart instance.
Back To Top

Connecting to a BlackBerry Router

Perform the following tasks if you installed the BlackBerry® Router on a computer that is separate from the computer that hosts the BlackBerry® Enterprise Server. These tasks ensure that the BlackBerry Enterprise Server can connect to the BlackBerry Router.

Back To Top

Permit a BlackBerry Enterprise Server to connect to a remote BlackBerry Router

If you installed a BlackBerry® Router on a computer that is separate from the computer that hosts a BlackBerry® Enterprise Server, you must permit the BlackBerry Dispatcher that you installed with the BlackBerry Enterprise Server to connect to the BlackBerry Router. The BlackBerry Router that you installed on a separate computer can send data packets from the BlackBerry Enterprise Server to BlackBerry devices.
  1. On the computer that hosts the BlackBerry Router, click Start > Run.
  2. Type regedit.
  3. Click OK.
  4. Perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to \\HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion.
    • If you are running a 64-bit version of Windows, navigate to \\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node \Research In Motion.
  5. Change the value of AllowRemoteServices to 1.
  6. If you want to change the port number that the BlackBerry Router uses to open connections to the BlackBerry Dispatcher, change the value of ServicePort to the port number that the BlackBerry Router should use, for example, port number 80. By default, the port number is 3101.
  7. In the Windows Services, restart the BlackBerry Router service.
Back To Top

Connect a BlackBerry Enterprise Server to a remote BlackBerry Router

  1. In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > BlackBerry Enterprise Server.
  2. Click the BlackBerry® Enterprise Server instance or BlackBerry Enterprise Server pair that you want to assign the BlackBerry Router to.
  3. Click Edit instance.
  4. In the Router address section, type the FQDN of the computer that hosts the BlackBerry Router.
  5. If the BlackBerry Router uses a port number other than port number 3101, in the Port override field, type the port number.
  6. Click the Add icon.
  7. Click Save All.
  8. Restart the BlackBerry Enterprise Server using one of the following methods:
    • If you changed a BlackBerry Enterprise Server instance, on the Instance tab, click Restart instance.
    • If you changed a BlackBerry Enterprise Server pair, click one of the instances and on the Instance tab, click Restart instance. Repeat this step for the other instance.
    • In the Windows® Services, restart the BlackBerry Dispatcher.
Back To Top

Was this information helpful? Send us your comments.