Updating WebSphere DataPower XC10 appliance


Contents

  1. Updating the firmware
  2. Using the Update Installer to install maintenance packages
  3. Install fix packs using IBM Installation Manager
  4. Uninstall fix packs using IBM Installation Manager


Updating WebSphere DataPower XC10 appliance

To apply maintenance to your WebSphere DataPower XC10 appliance environment, first apply any firmware updates. Then, you can apply updates to the WXS client installations.


1. Updating the firmware

You can upgrade the IBM WebSphere DataPower XC10 appliance software by using firmware updates. Download new firmware versions from the Fix Central website and update your appliance software.

You must be assigned the Appliance administration permission to perform these steps.

Check to ensure that all active jobs are complete before starting the firmware update process. The firmware update process interrupts any jobs that are actively running, which can cause the data to become inconsistent. Ensure that you have planned for this behavior before beginning the update process.

If you are installing the firmware for the first time on a new appliance, run the clear-all command on the appliance after the firmware update completes.

You can update the firmware of the appliance by downloading a new firmware update from IBM and updating your appliance with the new firmware. You can run the firmware update in the user interface or on the command line.

If your appliances are in a collective, you must complete the firmware upgrade process on one appliance before starting the process on another appliance within the collective. If you attempt to update the firmware on multiple appliances in the collective simultaneously, data loss might occur.

After you upgrade either 9235-92X or 7199-92X appliance types with Version 2.0.0.x firmware, you cannot roll back to Version 1.0 firmware. You can roll back and upgrade between Version 2.0.0.x or firmware levels freely.

The appliance has the updated firmware version. To confirm the firmware upgrade was successful, you can view the current firmware level in the Firmware section of the Appliance > Settings panel. This panel also displays the appliance model type and appliance serial number. Repeat these steps for the other appliances in your collective.

If you are installing the firmware for the first time on a new appliance, run the clear-all command on the appliance after the firmware update completes. this command after the firmware update.


2. Using the Update Installer to install maintenance packages

Use the IBM Update Installer to update your WebSphere eXtreme Scale Client environment with various types of maintenance, such as interim fixes, fix packs, and refresh packs. Upgrade your appliance firmware before updating the WebSphere eXtreme Scale Client.

Use the IBM Update Installer to install and apply various types of maintenance packages for WebSphere eXtreme Scale Client. Because the Update Installer undergoes regular maintenance, use the most current version of the tool.

  1. Stop all processes that are running in your environment.

    • To stop all processes that are running in your WebSphere Application Server environment, see Command-line utilities.

  2. Download the latest version of the Update Installer. See Recommended fixes for more information.

  3. Install the Update Installer. See Install the Update Installer for WebSphere Software in the WebSphere Application Server Information Center for more information.

  4. Download into the updi_root/maintenance directory the maintenance packages that you intend to install. See the Support site for more information.

  5. Use the Update Installer to install the interim fix, fix pack, or refresh pack. You can install the maintenance package by running the graphical user interface (GUI), or by running the Update Installer in silent mode.

    Run the following command from the updi_root directory to start the GUI:

    • update.sh

    • update.bat

    Run the following command from the updi_root directory to run the Update Installer in silent mode:

    • ./update.sh -silent -options responsefile/file_name

    • update.bat -silent -options responsefile\file_name

If the installation process fails, see the temporary log file, which is in the updi_root/logs/update/tmp directory. The Update Installer creates the install_root/logs/update/maintenance_package.install directory in which the installation log files are located.


3. Install fix packs using IBM Installation Manager

Use IBM Installation Manager to update the product with the fix packs that are available for WebSphere eXtreme Scale Client product offerings. Fix packs can be installed from the GUI, the command line, or with response files.


3.1. Install fix packs with GUI

You can update WebSphere eXtreme Scale Client to a later version using the IBM Installation Manager wizard.

Upgrade your appliance firmware before updating the WebSphere eXtreme Scale Client. The most current information is available from the IBM Software Support Center and Fix Central.

IBM Installation Manager is used to apply product maintenance to the following product offerings:

Make sure that the web-based or local service repository location is listed and checked or that the Search service repositories during installation and updates option is selected on the Repositories panel in your Installation Manager preferences. For more information on using service repositories with Installation Manager, read the IBM Installation Manager Version 1.5 Information Center.

Restriction: You cannot use the Installation Manager to upgrade an installation and add or remove the full WebSphere Application Server profile feature or the Liberty profile feature.

  1. Stop all processes that are running in your environment.

    • To stop all processes that are running in your WebSphere Application Server environment, see Command-line utilities.

  2. Log on to your system.

  3. Stop all servers and applications on the WebSphere Application Server installation that is being updated.

  4. Start Installation Manager.

  5. Click Update.

    Note: If you are prompted to authenticate, use the IBM ID and password that you use to access protected IBM software websites.

  6. Select the package group to update.

    If you select Update all, Installation Manager will search all of the added and predefined repositories for updates to all of the package groups that it has installed. Use this feature only if you have full control over which fixes are contained in the targeted repositories. If you create and point to a set of custom repositories that include only the specific fixes to install, you should be able to use this feature confidently. If you enable searching service repositories or install fixes directly from other live web-based repositories, then you might not want to select this option so that you can select only the fixes to install for each offering on subsequent panels.

  7. Click Next.

  8. Select the version to which you want to update under:

    • WebSphere eXtreme Scale Client in a stand-alone environment
    • WebSphere eXtreme Scale Client forWebSphere Application Server Version 6
    • WebSphere eXtreme Scale Client for WebSphere Application Server Version 7
    • WebSphere eXtreme Scale Client for WebSphere Application Server Version 8

  9. Select any fixes to install.

    Any recommended fixes are selected by default.

    If there are recommended fixes, you can select the option to show only recommended fixes and hide non-recommended fixes.

  10. Click Next.

  11. Accept the terms in the license agreements, and click Next.

  12. Select the optional features that you want in your updated installation.

  13. Review the summary information, and click Update.

    • If the installation is successful, the program displays a message indicating that installation is successful.

    • If the installation is not successful, click View Log File to troubleshoot the problem.

  14. Click Finish.

  15. Click File > Exit to close Installation Manager.


3.2. Install fix packs with scripts

Use the IBM Installation Manager from the command line to update the product with the fix packs that are available for WebSphere eXtreme Scale product offerings.

Upgrade your appliance firmware before updating the WebSphere eXtreme Scale Client. The most current information is available from the IBM Software Support Center and Fix Central.

IBM Installation Manager is used to apply product maintenance to the following product offerings:

Restriction: You cannot use the Installation Manager to upgrade an installation and add or remove the full WebSphere Application Server profile feature or the Liberty profile feature.

  1. For a list of interim fixes and fix packs that are available forWebSphere eXtreme Scale 8.5 and specific information about each fix, perform the following actions.

    1. Go to Fix Central.
    2. Select WebSphere as the product group.
    3. Select WebSphere eXtreme Scale as the product.
    4. Select 8.5 as the installed version.
    5. Select your operating system as the platform, and click Continue.
    6. Select Browse for fixes, and click Continue.
    7. Click More Information under each fix to view information about the fix.
    8. Make a note of the name of the fix pack that you would like to install.

  2. Update WebSphere eXtreme Scale Version 8.5 with the fix pack using the following procedure.

    • Download the file that contains the fix pack from Fix Central, and use local updating.

      You can download a compressed file that contains the fix pack from Fix Central. Each compressed fix-pack file contains an Installation Manager repository for the fix pack and usually has a .zip extension. After downloading and extracting the fix-pack file, use Installation Manager to update WebSphere Application Server Version 8.x with the fix pack.

      1. To download the fix pack, perform the following actions:

        1. Go to Fix Central.

        2. Select WebSphere as the product group.

        3. Select WebSphere eXtreme Scale as the product.

        4. Select 8.5 as the installed version.

        5. Select your operating system as the platform, and click Continue.

        6. Select Browse for fixes, and click Continue.

        7. Select the fix pack to download, and click Continue.

        8. Select your download options, and click Continue.

        9. Click I agree to agree to the terms and conditions.

        10. Click Download now to download the fix pack.

        11. Transfer the compressed file in binary format to the system on which it will be installed.

        12. Extract the compressed repository files to a directory on your system.

      2. To install a fix pack from a downloaded file, perform the following actions:

        1. Log on to your system.

        2. Stop all processes that are running in your environment. To stop all processes that are running in your WebSphere Application Server environment, see Command-line utilities.

        3. Change to the Installation_Manager_binaries/eclipse/tools directory, where Installation_Manager_binaries is the installation root directory for the Installation Manager.

        4. Install the fix pack.

          ./imcl install offering_ID_offering_version,optional_feature_ID
                 -installationDirectory product_installation_location
                 -repositories location_of_expanded_files
                 -acceptLicense

          imcl.exe install offering_ID_offering_version,optional_feature_ID
                   -installationDirectory product_installation_location
                   -repositories location_of_expanded_files
                   -acceptLicense

          Tips:

          • The offering_version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to install (8.5.0.20110503_0200 for example).

            • If offering_version is not specified, the latest version of the offering and all interim fixes for that version are installed.

            • If offering_version is specified, the specified version of the offering and no interim fixes for that version are installed.

            The offering version can be found attached to the end of the offering ID with an underscore when you run the following command against the repository:

              imcl listAvailablePackages -repositories source_repository

          • You can also specify none, recommended or all with the -installFixes argument to indicate which interim fixes you want installed with the offering.

            • If the offering version is not specified, the -installFixes option defaults to all.

            • If the offering version is specified, the -installFixes option defaults to none.

          • You can add a list of features that are separated by commas. If a list of features is not specified, the default features are installed.

        5. Optional: List all installed packages to verify the installation:

            ./imcl listInstalledPackages -long

            imcl.exe listInstalledPackages -long


3.3. Install fix packs using a response file

You can update WebSphere eXtreme Scale Client to a later version using IBM Installation Manager with a response file.

As an alterative to the procedure that is described in this article, Installation Manager allows you to use the updateAll command in a response file or on the command line to search for and update all installed packages. Use this command only if you have full control over which fixes are contained in the targeted repositories. If you create and point to a set of custom repositories that include only the specific fixes to install, you should be able to use this command confidently. If you enable searching service repositories or install fixes directly from other live web-based repositories, then you might not want to select this option so that you can select only the fixes to install using the -installFixes option with the install command on the command line or the installFixes attribute in a response file.

  1. For a list of interim fixes and fix packs that are available for WebSphere eXtreme Scale Client Version 8.5 and specific information about each fix, perform the following actions.

    1. Go to Fix Central.
    2. Select WebSphere as the product group.
    3. Select WebSphere eXtreme Scale Client as the product.
    4. Select 8.x as the installed version.
    5. Select your operating system as the platform, and click Continue.
    6. Select Browse for fixes, and click Continue.
    7. Click More Information under each fix to view information about the fix.
    8. Recommendation: Make a note of the name of the fix pack that you would like to install.

  2. Update WebSphere eXtreme Scale Client 8.5 with the fix pack using the following procedure.

    • Download the file that contains the fix pack from Fix Central, and use local updating.

      You can download a compressed file that contains the fix pack from Fix Central. Each compressed fix-pack file contains an Installation Manager repository for the fix pack and usually has a .zip extension. After downloading and extracting the fix-pack file, use Installation Manager to update WebSphere eXtreme Scale Client Version 8.5 with the fix pack.

      1. To download the fix pack, perform the following actions:

        1. Go to Fix Central.

        2. Select WebSphere as the product group.

        3. Select WebSphere eXtreme Scale Client as the product.

        4. Select 8.5 as the installed version.

        5. Select your operating system as the platform, and click Continue.

        6. Select Browse for fixes, and click Continue.

        7. Select the fix pack to download, and click Continue.

        8. Select your download options, and click Continue.

        9. Click I agree to agree to the terms and conditions.

        10. Click Download now to download the fix pack.

        11. Transfer the compressed file in binary format to the system on which it will be installed.

        12. Extract the compressed repository files to a directory on your system.

      2. Perform the following actions:

        1. Log on to your system.

        2. If the repository requires a username and password, create a keyring file to access this repository.

          For more information on creating a keyring file for Installation Manager, read the IBM Installation Manager Version 1.5 Information Center.

          When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL specified.

        3. Change to the Installation_Manager_binaries/eclipse/tools directory, where Installation_Manager_binaries is the installation root directory for the Installation Manager.

        4. Install the fix pack using a response file.

          For example:

          • Administrator or non-administrator:

            imcl.exe -acceptLicense 
                     input C:\temp\update_response_file.xml 
                     -log C:\temp\update_log.xml 
                     -keyring C:\IM\im.keyring

          • Administrator:

            ./imcl -acceptLicense 
                   input /var/temp/update_response_file.xml 
                   -log /var/temp/update_log.xml 
                   -keyring /var/IM/im.keyring

          • Non-administrator:

            ./imcl -acceptLicense 
                   input $HOME/var/temp/update_response_file.xml 
                   -log $HOME/var/temp/update_log.xml 
                   -keyring $HOME/var/IM/im.keyring


4. Uninstall fix packs using IBM Installation Manager

Use IBM Installation Manager to rollback WebSphere eXtreme Scale Client product offerings to an earlier version. You can uninstall fix packs from the GUI, the command line, or with response files.


4.1. Uninstall fix packs with GUI

You can roll back WebSphere eXtreme Scale Client to an earlier version using the IBM Installation Manager GUI.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you install a package. If you change the default setting or delete the saved files, Installation Manager requires access to the repository that was used to install the earlier version.

Restriction: You cannot use the Installation Manager to roll back an installation and add or remove a feature.

  1. Stop all processes that are running in your environment.

    • To stop all processes that are running in your WebSphere Application Server environment, see Command-line utilities.

  2. Start Installation Manager.

  3. Click Roll Back.

  4. Select the package group to roll back.

  5. Click Next.

  6. Select the version to which you want to roll back under.

  7. Click Next.

  8. Review the summary information, and click Roll Back.

    • If the rollback is successful, the program displays a message indicating that the rollback is successful.

    • If the rollback is not successful, click View Log File to troubleshoot the problem.

  9. Click Finish.

  10. Click File > Exit to close Installation Manager.


4.2. Uninstall fix packs with scripts

You can roll back WebSphere eXtreme Scale Client to an earlier version using IBM Installation Manager from the command line.

Restriction: In order to use this procedure, have Installation Manager Version 1.5 or later installed on your system.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you install a package. If you change the default setting or delete the saved files, Installation Manager requires access to the repository that was used to install the earlier version.

Restriction: You cannot use the Installation Manager to roll back an installation and add or remove the full WebSphere Application Server profile feature or the Liberty profile feature.

  1. Optional: If the repository requires a username and password, create a keyring file to access this repository.

    For more information on creating a keyring file for Installation Manager, read the IBM Installation Manager Version 1.5 Information Center.

    When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL specified.

  2. Log on to your system.

  3. Stop all processes that are running in your environment.

    • To stop all processes that are running in your WebSphere Application Server environment, see Command-line utilities.

  4. Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.

  5. Use the imcl command to roll back the product.

    ./imcl rollback offering_ID_offering_version
      -repositories source_repository 
      -installationDirectory installation_directory
      -preferences preference_key=value
      -properties property_key=value
      -keyring keyring_file -password password   -acceptLicense

    imcl.exe rollback offering_ID_offering_version
      -repositories source_repository 
      -installationDirectory installation_directory
      -preferences preference_key=value
      -properties property_key=value
      -keyring keyring_file -password password   -acceptLicense

    Tips:

    • The offering_version, which optionally can be attached to the offering ID with an underscore, is a specific version of the offering to which to roll back (8.5.0.20110503_0200 for example).

      • If offering_version is not specified, the installation rolls back to the previously installed version of the offering and all interim fixes for that version are installed.

      • If offering_version is specified, the installation rolls back to the specified earlier version of the offering and no interim fixes for that version are installed.

      The offering version can be found attached to the end of the offering ID with an underscore in the Package section of the report that is generated when you run the historyInfo or genHistoryReport command from the app_server_root/bin directory.

    For more information on using Installation Manager, read the IBM Installation Manager Version 1.5 Information Center.

  6. Optional: List all installed packages to verify the roll back.

    ./imcl listInstalledPackages -long

    imcl.exe listInstalledPackages -long


4.3. Uninstall fix packs with response files

You can roll back WebSphere eXtreme Scale Client to an earlier version using IBM Installation Manager with a response file.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you install a package. If you change the default setting or delete the saved files, Installation Manager requires access to the repository that was used to install the earlier version.

Restriction: You cannot use the Installation Manager to roll back an installation and add or remove the full WebSphere Application Server profile feature or the Liberty profile feature.

  1. Optional: If the repository requires a username and password, create a keyring file to access this repository.

    For more information on creating a keyring file for Installation Manager, read the IBM Installation Manager Version 1.5 Information Center.

    When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL specified.

  2. Log on to your system.

  3. Stop all processes that are running in your environment.

    • To stop all processes that are running in your WebSphere Application Server environment, see Command-line utilities.

  4. Use a response file to roll back the product.

    Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager, and roll back the product.

    For example:

    • Administrator or non-administrator:

      imcl.exe
        input C:\temp\rollback_response_file.xml 
        -log C:\temp\rollback_log.xml 
        -keyring C:\IM\im.keyring

    • Administrator:

      ./imcl
        input /var/temp/rollback_response_file.xml 
        -log /var/temp/rollback_log.xml 
        -keyring /var/IM/im.keyring

    • Non-administrator:

      ./imcl
        input $HOME/var/temp/rollback_response_file.xml 
        -log $HOME/var/temp/rollback_log.xml 
        -keyring $HOME/var/IM/im.keyring

    Note: The program might write important post-installation instructions to standard output.

    For more information on using Installation Manager, read the IBM Installation Manager Version 1.5 Information Center.

  5. Optional: List all installed packages to verify the roll back.

      ./imcl listInstalledPackages -long

      imcl.exe listInstalledPackages -long