"Could not start the BlackBerry Mobile Data Service on Local Computer. Error 203 The system could not find the environment option that was entered" appears when starting the BlackBerry MDS Connection Service

Article ID: KB04329

Type: Support Content

Last Modified: 06-22-2012

 

Product(s) Affected:

  • BlackBerry Enterprise Server 5
  • BlackBerry Enterprise Server Express for Microsoft Exchange
CollapseEnvironment
  • BlackBerry® Enterprise Server 4.0 to 5.0 SP3
  • BlackBerry® Enterprise Server Express 5.0 SP1 to 5.0 SP2
CollapseOverview

After finishing the installation or applying updates to the computer on which BlackBerry® Enterprise Server is located, the following error message appears:

Could not start the BlackBerry Mobile Data Service on Local Computer. Error 203: The system could not find the environment option that was entered.

If the above error occurs, please see the below checklist. If the error still occurs after completing the resolution, follow the instructions in the Additional Information section.

1) Confirm that the JRE is installed

To check if the JRE is installed on the BlackBerry Enterprise Server, search for Java Runtime Environment in the list of currently installed programs in the Add/Remove Programs list.

If the JRE is not installed, go to the Sun Developer Network web site to download and install the correct version of the JRE. Please note the following:

  • JRE version 1.4.2 is required for BlackBerry Enterprise Server version 4.0
  • JRE version 1.5 or 1.6 is required for BlackBerry Enterprise Server version 4.1 and 5.0

2) Verify that the JRE is of the correct version

To resolve this issue, complete the following steps:

  1. In Windows® Explorer, navigate to C:\Program Files\Java\j2re1.4.2_03.
  2. If a supported version of JRE is not installed, go to the Sun Developer Network web site to download and install the correct JRE version.

Note: Remove any existing version of the JRE prior to installing this version.

  • JRE version 1.4.2 is required for BlackBerry Enterprise Server version 4.0
  • JRE version 1.5 or 1.6 is required for BlackBerry Enterprise Server version 4.1 and 5.0

3) Confirm that the jvm.dll referenced in the ImagePath is correct

The BlackBerry Enterprise Server is not pointing to the jvm.dll file. Check for the ImagePath string value in the following registry key:

For BlackBerry Enterprise Server version 4.0:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BlackBerry Mobile Data Service

If the ImagePath string value exists, the Value data field is blank or is pointing to the JRE folder from a previous version of the JRE.

For BlackBerry Enterprise Server version 4.1 and 5.0:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BlackBerry MDS Connection Service

Warning: The following procedure involves modifying the computer registry. This can cause substantial damage to the Windows operating system. Document and back up the registry entries prior to implementing any changes.

To resolve this issue, complete the following steps:

  1. Open the Registry Editor.
  2. Go to the registry key listed above to check for the ImagePath string value.
  3. If the ImagePath string value does not exist, repair the BlackBerry Enterprise Server installation through Add/Remove Programs. This updates the BlackBerry® Mobile Data Service (BlackBerry MDS) registry keys. For more information, see the BlackBerry Enterprise Server Installation Guide.

    Note : For BlackBerry Enterprise Server version 4.1 SP3 to 4.1 SP6 and 5.0, the option to repair is not available. Re-apply the service pack to replace the registry key.

    If the ImagePath string value exists, double-click it and type the correct path to the jvm.dll file in the Value data field, as shown in the following example for BlackBerry Enterprise Server version 4.1 and 5.0:

    "C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\bin\bmds.exe" -s jvmpath="C:\Program Files\Java\< JRE folder>\bin\client\jvm.dll" -XX:+DisableExplicitGC-Xss64K -Xmx256M -Xms96M -XX:NewSize=32M -XX:MaxNewSize=96M-XX:NewRatio=2 classpathdir="C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\classpath\\" wrkdir="C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\Servers\Instance\\" webserverdir="C:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\webserver\\" -log.console -rbes "<server_name>"

    where <server_name> is the name of the BlackBerry Enterprise Server MDS Connection Service and <JRE folder> is the name of the JRE folder located in C:\Program Files\Java\ .

  4. Press Enter and close the Registry Editor.
  5. Restart BlackBerry MDS from the Windows administrative tools.

Important: Restarting certain BlackBerry Enterprise Server services will delay email message delivery to BlackBerry smartphones. For more information, see KB04789 .

4) May have to increase or decrease the -XMX value in Registry for the MDS Connection Service for BlackBerry Enterprise Server 5.0 and above

-XMX value can be located in ImagePath string value in the following registry key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BlackBerry MDS Connection Service

5) Confirm that MSVCR71.dll file is installed in the proper location on the computer

Stop all the BlackBerry Services

  1. Copy the MSVCR71.dll file from <drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDSS\jre\bin or C:\Program Files\Java\<java directory>\bin to <drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\bin .
  2. Re-run the installer for BlackBerry Enterprise Server

    NOTE: If the administrator has not installed the BlackBerry MDS Integration Service, then MDSS directory will not be present on the BlackBerry Enterprise Server. If this is the case, copy the file from BlackBerry Enterprise Server installation folder.
CollapseAdditional Information

If the error still appears after completing the steps in the Resolution section, complete the following steps:

  1. Go to <drive>:\Program Files\Research In Motion\BlackBerry Enterprise Server\MDS\classpath
  2. Check for missing files in this directory. The following are common files that may be missing:
    • bmds.jar
    • clibwrapper_jiio.jar
    • commons-fileupload-1.0.jar
    • dom.jar (This file may be obsolete in newer BlackBerry Enterprise Server installations and not be present)
    • ecma.jar
    • jai_codec.jar
  3. If the files are missing, repair the BlackBerry Enterprise Server by selecting BlackBerry Enterprise Server in Add\Remove Programs in the Control Panel.
  4. Click Support Information and select Repair.
  5. Verify that the missing files are now installed on the BlackBerry Enterprise Server, and then restart BlackBerry MDS.

Important: Restarting certain BlackBerry Enterprise Server services will delay email message delivery to BlackBerry smartphones. For more information, see KB04789.

Note: When using the full installer, the JRE installer will be included and unzipped to the C:\Research In Motion\Utilities folder.

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.