How to configure access to documents on remote file systems

Article ID: KB21905

Type: Support Content

Last Modified: 12-19-2011

 

Product(s) Affected:

  • BlackBerry Bold 9700
  • BlackBerry Enterprise Server
  • BlackBerry Bold 9000
  • BlackBerry Tour 9630
  • BlackBerry Storm
Jump to: Environment | Overview
CollapseEnvironment
  • BlackBerry® Enterprise Server 5.0 SP1
  • BlackBerry® Device Software 5.0
CollapseOverview

By default, the BlackBerry® Mobile Data System (BlackBerry MDS) Connection Service can search your organization's Windows® network for any documents that users might want to access from the BlackBerry smartphone.

To configure the BlackBerry MDS Connection Service to search the remote file system, the BlackBerry MDS Connection Service must be defined how to communicate with the remote file system, add the communication information to a BlackBerry MDS Connection Service configuration set, and assign the configuration set to one or more BlackBerry MDS Connection Service instances.

Configure the BlackBerry MDS Connection Service to communicate with a remote file system

To permit the BlackBerry MDS Connection Service to communicate with a remote file system, specify the URL for the remote file system and the type of access (Linux® or Windows) that the domain of the remote file system supports. Credentials for the domain can also be provided so that users do not need to provide the credentials when trying to access the documents.

If the file system requires the BlackBerry MDS Connection Service to authenticate to the remote file system, create an account on the remote file system that the BlackBerry MDS Connection Service can use to authenticate when the BlackBerry MDS Connection Service receives requests for documents.

  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
  2. Click MDS Connection Service.
  3. Click Edit component.
  4. On the File tab, in the Name field, type a name for the communication method.
  5. In the Service URL field, type the UNC path to the remote file system using the following format: /<computer_name><fs_path>, where <computer_name> is the FQDN or IP address of a computer or the virtual view of the shared folders (for example, the DFS Namespace in Windows Server®) and <fs_path> is the optional directory path that can include a specific filename. When typing the UNC path, an asterisk (*) can be used to represent a sequence of arbitrary characters (including blank spaces), a question mark (?) to represent a single arbitrary character, and a backslash (\) to represent an escape character. You cannot type a URL that can search all of the computers in a Windows domain.

    Example:

    192.0.2.0 or *.test.example.com/*.

  6. If the file system requires the BlackBerry MDS Connection Service to authenticate with the remote file system, perform the following actions:
    • In the User ID field, type the name of the account that BlackBerry MDS Connection Service will use to authenticate to the remote file system.
    • In the Domain field, type the domain for the user account.
    • In the Password and Confirm Password fields, type the password for the user account.
    • In the Network provider drop-down list, click the network provider that BlackBerry MDS Connection Service should use to access the file system.

  7. Click Save all.

Add communication information to a BlackBerry MDS Connection Service configuration set

A BlackBerry MDS Connection Service configuration set is a set of service configurations that the BlackBerry MDS Connection Service instances in your organization can use to communicate with a remote file system, a Lightweight Directory Access Protocol (LDAP) server, a Directory Service Markup Language (DSML) certificate server, a certificate revocation list (CRL) server, an Online Certificate Status Protocol (OCSP) server, or a certification authority. Communication information must be added that the BlackBerry MDS Connection Service requires to communicate with servers to a configuration set so that a BlackBerry MDS Connection Service instance can communicate with the servers after you assign the configuration set to the instance.

  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology> BlackBerry Domain > Component view.
  2. Click MDS Connection Service.
  3. Click Edit component.
  4. On the Configuration Sets tab, perform one of the following actions:
    • To create a configuration set, in the Configuration set name section, type a name and description for the configuration set.
    • To change an existing configuration set, click the Edit icon.
  5. In the Priority Service group drop-down list, click the name of the service that you want to configure the communication method for.
  6. In the Service (Name : Description) drop-down list, click the name of the communication method that you want to configure.
  7. Click the Add icon.
  8. To specify the communication method that the BlackBerry MDS Connection Service should try to connect to the server with first, click the Up and Down arrows. The BlackBerry MDS Connection Service resolves conflicts by applying communication methods in the order that you specify. The order of that you specify for LDAP, DSML, or file communication applies to each communication method separately. The order permits the BlackBerry MDS Connection Service to resolve conflicts between domains if you created multiple communication methods for a specific URL.
  9. Perform one of the following actions:
    • To add a new configuration set, click the Add icon.
    • To update an existing configuration set, click the Update icon.
  10. Click Save all.
  11. To confirm your changes, click the View icon.

Assign a BlackBerry MDS Connection Service configuration set to a BlackBerry MDS Connection Service instance

You can assign a BlackBerry MDS Connection Service configuration set to a BlackBerry MDS Connection Service instance so that BlackBerry device users can access documents on remote file systems from BlackBerry devices, the BlackBerry MDS Connection Service can search for certificates and check for the status of the certificates from LDAP servers, DSML certificate servers, CRL servers, or OCSP servers, and the BlackBerry MDS Connection Service can send certificate requests to a certificate authority.

  1. In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view.
  2. Click MDS Connection Service.
  3. Click the instance that you want to change.
  4. Click Edit instance.
  5. On the Component Configuration Sets tab, in the Available component configuration sets section, in the Service configuration sets drop-down list, click the configuration set that you want to assign to the BlackBerry MDS Connection Service instance.
  6. Click Save all.
  7. To restart the BlackBerry MDS Connection Service instance, on the Instance information tab, in the Status list, click Restart instance.
  8. To assign the BlackBerry MDS Connection Service configuration set to another BlackBerry MDS Connection Service instance, repeat steps 3 to 7.

    Important: Restarting certain BlackBerry Enterprise Server services will delay email message delivery to BlackBerry smartphones, see article KB04789 for more 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.