How to manually upgrade the Java Runtime Environment on BlackBerry Enterprise Service 10 version 10.1 and 10.2

Article ID: KB34385

Type: Support Content

Last Modified: 03-27-2014

 

Product(s) Affected:

  • BlackBerry Enterprise Service 10
Jump to: Environment | Overview
CollapseEnvironment
  • BlackBerry Enterprise Service 10 version 10.1 to 10.2.1
CollapseOverview

Upgrades for the Java Runtime Environment version 7 software will be included in future maintenance releases for BlackBerry Enterprise Service 10.

Prior to proceeding with a manual upgrade of the Java Runtime Environment version 7 software, complete the following:

  • Check Business Support to determine if a maintenance release exists which may contain the version needed to install.
  • Refer to the BlackBerry Enterprise Service 10 Compatibility Matrix to verify if the version you wish to install has been certified as supported.
  • If the version you wish to install is not listed in the above document then please contact BlackBerry Technical Support Services to verify that the version of Java that is to be installed is currently supported.

BlackBerry Enterprise Service 10 version 10.1 and 10.2 software utilizes both 32-bit and 64-bit versions of the Java Runtime Environment version 7 software. If an upgrade of Java is performed on the server, then the following default services are affected:

  • BES10 - Administration Console
  • BES10 - BlackBerry Administration Service - Application Server
  • BES10 - BlackBerry Administration Service - Native Code Container
  • BES10 - BlackBerry MDS Connection Service
  • BES10 - BlackBerry Management Studio
  • BES10 - Enterprise Management Web Services
  • BES10 - BlackBerry Secure Connect Service
  • BES10 - BlackBerry Web Services
  • BES10 - BlackBerry Work Connect Notification Service
  • BES10 - Enterprise Management Web Service

In addition, the following optional components are affected:

  • BES10 - BlackBerry Collaboration Service

To perform an upgrade of the version of Java Runtime Environment on the server, complete the following:

  1. Contact BlackBerry Technical Support Services to verify that the version of Java that is being installed is currently supported.
  2. Obtain both the 32-bit and 64-bit versions of the Java Runtime Environment software from Oracle.
  3. Obtain the Java JCE Jurisdiction Policy files from Oracle.
  4. Perform a backup of the following registry keys:
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BAS-AS
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BAS-NCC
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerry MDS Connection Service
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerryMobileFusionStudio
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerryWebServices
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerryWorkConnectNotificationService
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - EMWS
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerry Collaboration Service
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\BES - BlackBerryAdministrationConsole
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\BES - BlackBerrySecureConnectAdapter
  5. Stop the following services
    • BES10 - Administration Console
    • BES10 - BlackBerry Administration Service - Application Server
    • BES10 - BlackBerry Administration Service - Native Code Container
    • BES10 - BlackBerry Controller
      Note: stopping this service will begin the process of stopping the following services:
      • BES10 - BlackBerry Web Services
      • BES10 - Blackberry Work Connect Notification Service
      • BES10 - Enterprise Management Web Service
      • BES10 - BlackBerry Management Studio
      • BES10 - BlackBerry MDS Connection Service
      • BES10 - BlackBerry Secure Connect Service
    • BES10 - BlackBerry Collaboration Service
  6. Install the new versions of Java using the following steps:
    1. Open a command prompt.
    2. Navigate to the location of the downloaded Java installation packages.
    3. Install the 32-bit version of Java using the following command, replacing XX with the update number:
      • jre-7uXX-windows-i586.exe /s /L STATIC=1 OEMUPDATE=1
    4. Install the 64-bit version of Java using the following command, replacing XX with the update number:
      • jre-7uXX-windows-x64.exe /s /L STATIC=1 OEMUPDATE=1
    5. These commands will silently install the Java packages into the following locations:
      • C:\Program Files (x86)\Java\jre1.7.0_XX
      • C:\Program Files\Java\jre1.7.0_XX
  7. Extract the local_policy.jar and US_export_policy.jar files from the Java JCE Jurisdiction Policy file package, and copy them to the following locations:
    • C:\Program Files (x86)\Java\jre1.7.0_XX\lib\security
    • C:\Program Files\Java\jre1.7.0_XX\lib\security
      Note: these files already exist in the above locations, but should be replaced as a result of this step.
  8. Open a registry editor.
  9. Navigate to each of the following registry keys and modify the JVM Library string to change the path to the newly installed version of Java, ensuring that only the XX portion of the path is modified and not the entire path:
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BAS-AS\Parameters
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BAS-NCC\Parameters
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerryMobileFusionStudio\Parameters
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerryWebServices\Parameters
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerryWorkConnectNotificationService\Parameters
    • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - EMWS\Parameters
  10. Navigate to each of the following registry keys and modify the JVM string to change the path to the newly installed version of Java, ensuring that only the XX portion of the path is modified and not the entire path:
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\BES - BlackBerryAdministrationConsole\Parameters\Java
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\BES - BlackBerrySecureConnectAdapter\Parameters\Java
  11. Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BES - BlackBerry MDS Connection Service and complete the following:
    1. Double-click the ImagePath string.
    2. Scroll through the value data to the jvmpath= section.
    3. Change the jvmpath to the newly installed version of Java, ensuring that only the XX portion of the path is modified and not the entire path.
  12. Repeat the above step for this registry location :
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\BES - BlackBerry Collaboration Service
  13. Once the above changes have been made, start the following services:
    • BES10 - Administration Console
    • BES10 - BlackBerry Administration Service - Application Server (the BlackBerry Administration Service - Native Code Container service will start automatically)
    • BES10 - BlackBerry Controller
      Note: starting this service will begin the process of starting the following services:
      • BES10 - BlackBerry Web Services
      • BES10 - Blackberry Work Connect Notification Service
      • BES10 - Enterprise Management Web Service
      • BES10 - BlackBerry Management Studio
      • BES10 - BlackBerry MDS Connection Service
      • BES10 - BlackBerry Secure Connect Service
    • BES10 - BlackBerry Collaboration Service

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.