IBM Db2 Analytics Accelerator for z/OS, Version 7.5.13
Updating Db2 Analytics Accelerator on Z
Follow the steps in this section to upload a new image (appliance) for Db2 Analytics Accelerator on Z and activate it.
Before you begin
Before the update, bring the entire system to a halt. That is, cancel all running
tasks, such as load jobs and so on, and stop the accelerator.
If incremental updates are enabled, also stop replication before
you proceed. Otherwise, the replicated tables end up in a state that requires a manual
re-enablement, and, possibly also a reload.
Remember: You must complete the following steps for
each Db2 subsystem or data sharing group that is connected to
the accelerator.
Use the selected administration client to proceed:
Stop replication and wait a few minutes, so that pending incremental updates
can be applied to the tables on the accelerator. Your wait time should roughly equal your
replication latency period.
For the following steps, you need Mozilla Firefox or Google Chrome. Other browsers are not
supported.
If the Login page does not show all the controls needed to login successfully, or if
after the logon an SSC installer window is not fully usable because controls are missing, change the
browser language to English and try again.
Open the Admin UI in a web browser. Enter the IPv4 address of the Secure
Service Container (SSC) LPAR (see Figure 4).
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:
On the right side of the Accelerator Components Health Status page, click
Update.
To make sure that all accelerator operations are paused during the update, click
Quiesce.
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.
Click Reboot.
A confirmation window is displayed:
Read the warnings and click Yes.
A newly displayed page 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:
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.
Make sure that Upload image to target disk is
selected.
Click Browse to select the appliance image (compressed
file).
The information in the Install Software Appliance
window changes as follows:
Select the Device Type (disk type) and the
Disk to upload the image to.
Click Apply.
A confirmation window comes up:
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:
After a successful reboot, you see the Login page of the Admin UI
again. Log in with the Master user ID and Master password.
A confirmation window is displayed. Click I Agree once
more.
The Welcome page of the Admin UI is displayed:
Click Finalize an Update.
You revisit the
Update page that is shown in step 4.
Click Upload and select the encrypted configuration
file that you exported in step 5.
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.
Log in to the Admin UI again with your Master user ID and Master
password.
You see a message window 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: