Updating Db2 Analytics Accelerator on Z

Follow the steps in this section to upgrade Db2 Analytics Accelerator on Z. This procedure is valid for updates of product version 7.5.14, as well as for upgrades to Db2 Analytics Accelerator on Z 8.1 (migrations).

1. Open the Admin UI in a web browser. Enter the IPv4 address of the Secure Service Container (SSC) LPAR (see Figure 4). If you want to update a multi-node accelerator, enter the IPv4 address of the head node SSC LPAR.
2. On the Login page, log in with the Master user ID and Master password that you specified as you defined the SSC LPAR. (see Figure 4)
   You see the Accelerator Components Health Status page:

   

3. On the right side of the Accelerator Components Health Status page, click Update.
   The Update page is displayed.

   Important: If you are updating from a version earlier than 7.5.14, the step Run the update pre-check. and the Check button will not be visible on the Update page. In this case, continue with step 5.

   

4. Click Check to run the upgrade pre-check. See Figure 3.
   Important: Product versions before 7.5.14 do not have an upgrade pre-check. Therefore, you won't see a Check button. Continue with step 5 in this case.

   The upgrade pre-check does not change or do anything to a running accelerator. Should the upgrade pre-check report errors or warnings, you can go ahead and fix these issues, and then complete the upgrade at a later time. The accelerator continues to work in the meantime.

   

   The pre-upgrade check gives you one of the following results:

   Success

   A successful pre-check results in the following message:

   

   If you see the success message, you can continue with step 5.

   Error messages or warnings

   A message window lists errors or warnings that occurred during the pre-check. For example:

   

   Note: Some of the errors or warnings in Figure 5 can be reported multiple times.

   • To upgrade to a newer version of IBM Db2 Analytics Accelerator for z/OS Version 7.5, such as 7.5.14 or later, you can ignore these messages and continue with step 5.
   • If, however, you want to upgrade to IBM Db2 Analytics Accelerator for z/OS Version 8.1 or later, you must first fix the reported issues before you continue.
     Attention: If you do not fix the reported issues, your current accelerator installation might break. In this case, you have to re-install it from scratch.

5. To make sure that all accelerator operations are paused during the update, click Quiesce. See Figure 6.

   

   Quiescing the accelerator might take between 5 and 20 minutes. During that time, you might be logged out of the Admin UI due to a session timeout.

   • If no logout occurred, you see the following page when the quiescing process has finished:

     

   • If a logout did occur, you do not see such a message after logging in again. However, you can continue safely with the upgrade if the Accelerator status in the top right corner shows the value quiesced. See

     

     Notes:

     • A quiesced state does not exist in product versions before 7.5.14. That means that the Quiesce button won't be grayed out after a logout.
     • The missing success message is of no concern. You can continue with the upgrade by downloading the export file.
6. By clicking Download, you can save your current configuration to a local drive, so that it can be reloaded to complete the update. After the download, the Reboot button becomes active (clickable).
   Important:

   An export file is an encrypted file that not only contains the accelerator configuration (similar to the JSON configuration file), but also the keys required to access the data pools on the accelerator. All data on the accelerator disks is encrypted. The keys are only stored on the boot volume and in the export files you create. Without the keys, you cannot restore the accelerator data. Securely store all export files and refresh these files after every update and every configuration change. This way, you might be able to restore an accelerator without data loss even if you are facing a severe problem.

   If, after saving an export file from Db2 Analytics Accelerator on Z Version 7.5.5 or earlier, your accelerator does not restart properly, contact IBM support.

7. Click Reboot.
   A confirmation window is displayed:

   

8. Read the warnings and click Yes.
   A newly displayed window informs you about the start of the Secure Service Container Installer. The installer takes several minutes to launch fully. When the Secure Service Container Installer is online, the Login page is displayed:

   

9. On the Login page of the Secure Service Container Installer, log in with the Master user ID and Master password that you specified as you defined the SSC LPAR.
   For more information, see step 9 in Defining an LPAR for Db2 Analytics Accelerator on Z.
   You see the Welcome page:

   

10. Click on the Welcome page.
    You see the Install Software Appliance page:

    

11. Make sure that Upload image to target disk is selected.
12. Click Browse to select the appliance image (compressed file).
    The information on the Install Software Appliance page changes as follows:

    

13. Select the Device Type (disk type) and the Disk to upload the image to.
14. Click Apply.
    A confirmation window comes up:

    

15. In the confirmation window, click Yes.
    The upload process starts. This might take several minutes, depending on the network speed. When the upload has finished, the uploaded image is used to reboot your Db2 Analytics Accelerator on Z. This is indicated by the following page of the Secure Service Container Installer:

    

16. After a successful reboot, you see the Login page of the Admin UI again. Log in with the Master user ID and Master password.
    Review step 9 for more information.
17. Follow these steps:
    1. Read the Software License Agreement.
    2. Click Show non-IBM terms.
    3. Read the Non-IBM Terms.
    4. Click I Agree.
18. A confirmation window is displayed. Click I Agree once more.
    The Welcome page of the Admin UI is displayed:

    

19. Click Finalize an Update.
    You revisit the Update page that is shown in step 5.
20. Click Upload and select the encrypted configuration file that you exported in step 6.
    If your are updating a multi-node accelerator, you see the Multi-Node Credentials window. In this case, complete steps 20.a through 20.c. Otherwise, proceed with step 21.
    1. In the Multi-Node Credentials window, enter the IP addresses of the accelerator's data-node LPARs. Also provide the user ID and the password of each accelerator (SSC) LPAR, as defined by the HMC. This is required during the initial installation or during an upgrade of the accelerator.
       The HMC credentials are needed to deploy the images on the LPARs. When an initial installation or upgrade has been completed, the HMC credentials are no longer required. The HMC credentials are not stored or otherwise saved by the accelerator. Therefore, a change of the user IDs or passwords on the HMC has no impact on running accelerators.
       See Figure 1.

       

    2. Click Validate.
       Check the validation results. The Valid column on the very right of the window must show green dots for each node. Here is an example of a successful validation:

       

    3. If the credentials of all data nodes are valid (indicated by green icons), you can click Apply.
       A Status window is displayed, which indicates the progress:

       
21. Confirm the export file upload by clicking Yes in the confirmation window:

    

    The Db2 Analytics Accelerator on Z is rebooted again. After the reboot, the Login page of the Admin UI is displayed again.
22. Log in to the Admin UI again with your Master user ID and Master password.
    You see a message page with a progress indicator:

    

    While the update is running, you can follow the line of events by clicking the Logs tab. The page does not refresh automatically, but you can click the Refresh button in the upper right corner.

Results

When the update has finished, the Accelerator Components Health Status is displayed automatically. A working status (green icon) should be displayed for all required components. These are all components in the list, except for the GDPS® client component. For the latter component, an inactive status (gray icon) is shown if GDPS support is not installed. See the following figure: