Upgrading the SDK | HCL Digital Experience

Change your version of the SDK Java Technology Edition using the applicable HCL Digital Experience Combined fix pack.

Before you begin

Ensure that your Portal profile is created before you upgrade the SDK.

Procedure

  1. Start the IBM® Installation Manager.
  2. Install the latest supported version of IBM WebSphere SDK Java Technology Edition.
    Note: Starting with HCL Digital Experience Combined fix pack 05, you can change your SDK Java Technology Edition from version 7.0 to version 7.1.Starting with HCL Digital Experience Combined fix pack 12, you can change your SDK Java Technology Edition to version 8.0.
  3. Install one of the following PTF Groups or higher:
    • V7R1 for SDK version 7.1: PTF Group SF99572 level 15 or higher
    • V7R2 for SDK version 7.1: PTF Group SF99716 level 4 or higher
    • V7R1 for SDK version 8: PTF Group SF99572 level 20 or higher
    • V7R2 for SDK version 8: PTF Group SF99716 level 5 or higher
  4. Read the following information before you run the managesdk task:
    • For stand-alone environments: Stop the profile server (node) before you run the managesdk command.
    • For clustered environments:
      • If the profile is a federated node of a deployment manager, ensure that the deployment manager is running before you run the managesdk command to update the profile.
      • Stop all the nodes.
      • Ensure that the node agent for each node is started.
      • When you enable the SDK for a node, run the managesdk command from the /bin directory to which the node belongs. You can also run the command from the /bin directory of the profile that contains the node that you want to update.
      • A connection to the deployment manager must exist with a supported connector protocol in the following order of preference:
        • SOAP
        • Inter-Process Communications (IPC)
        • Remote Method Invocation (RMI)

        If the SOAP protocol is enabled, the managesdk command uses the SOAP protocol. If the SOAP protocol is not enabled but the IPC protocol is enabled, the command uses the IPC protocol. If the SOAP and IPC protocol are not enabled, then the command uses the RMI protocol.

      • You must provide the administrative user name and password with the managesdk command for each profile that contains a federated node or deployment manager node in a cell with security enabled. If you do not specify the -user and -password parameters, the managesdk command might fail or stop processing.
      • When you enable the SDK for a deployment manager, only the deployment manager server is enabled. None of the managed nodes of the deployment manager is enabled to use the specific SDK.
  5. Open a command prompt and change to the AppServer_root/bin directory.
  6. Run the following command to list the available SDK versions:

    Go to managesdk command for information about the managesdk commands.

    • AIX® HP-UX Linux Solaris: ./managesdk.sh -listAvailable
    • IBM® i: managesdk -listAvailable
    • Windows: managesdk.bat -listAvailable
    • z/OS®: ./managesdk.sh -listAvailable
  7. Run the following command to enable all existing profiles to use the new SDK version:
    Note: version_number is the supported SDK version number that was listed when you ran the managesdk -listAvailable command.
    • AIX® HP-UX Linux Solaris: ./managesdk.sh -enableProfileAll -sdkname version_number -enableServers
    • IBM® i: managesdk -enableProfileAll -sdkname version_number -enableServers
    • Windows: managesdk.bat -enableProfileAll -sdkname version_number -enableServers
    • z/OS®: ./managesdk.sh -enableProfileAll -sdkname version_number -enableServers
  8. Run the following commands to make the new SDK version the new default:
    • AIX® HP-UX Linux Solaris: ./managesdk.sh -setCommandDefault -sdkname version_number

      ./managesdk.sh -setNewProfileDefault -sdkname version_number

    • IBM® i: managesdk -setCommandDefault -sdkname version_number

      managesdk -setNewProfileDefault -sdkname version_number

    • Windows: managesdk.bat -setCommandDefault -sdkname version_number

      managesdk.bat -setNewProfileDefault -sdkname version_number

    • z/OS®: ./managesdk.sh -setCommandDefault -sdkname version_number

      ./managesdk.sh -setNewProfileDefault -sdkname version_number

  9. If you have a DB2® database, upgrade the JCC driver. Go to DB2 APAR PI47282 needed when using JAVA SDK8 in WebSphere Application Server V8.5.5.9+ for information.
  10. Repeat these steps on each node in your environment.
    Note: You cannot roll back to a version of HCL Digital Experience earlier than fix pack 11 while you use SDK Java Technology Edition version 8. Support for SDK Java Technology Edition version 8 does not exist in earlier releases of Portal. If you want to roll back to an earlier CF level, use the commands that are shown in steps 7 and 8 to switch back to SDK version 7.0 or 7.1 before you roll back.