Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This feature will list the available patches/hotfixes for hypervisors connected to Cloudstack and the Cloudstack admin will be able to see the available updates on Cloudstack UI, this is functional specification of feature "XS alert hotfix notification" which has Jira ID CS-16206

References

Feature Specifications

  • Requirements
    • Display available and applied updates for a hostSearch available updates released for applicable XenServer versions and display them on CloudStack dashboard so that admin can see the available updates and apply them manually.
  • Non-requirements
    • If the updates are available, admin can install them manually.
  • Test guidelines
    • Functional test
  • Configuration
    • There are two global configuration parameters:
      • xen.update.url - URL to get latest Xenserver Updates.
      • update.check.interval (in sec) - How frequently should CloudStack check for Xenserver Updates.
  • User permission
    • Root-Admin would have privilege to list the available updates.

Use Cases

Admin can check the updates available to any host and install them manually

Admin can decide on how frequently he wants Cloudstack to check for updates and set the interval by changing the global config parameter update.check.interval .

Architecture and Design description

...

Once in a week, thread will check this location to search for updates and fill the database with available updates(if any) or admin can change the time interval to check the updates by changing the value of xen.update.check.interval global config parameter( by default interval is set to check the updates "Once in a week").

List Host Updates

http://10.102.125.207MS-SERVER:8096/client/api?command=listHostUpdates&id=&hostid=&applied=true/false

Parameter

Description

id

uuid of update

hostid

uuid of host

applied

if the patch/update is applied or not(true/false)

In the above mentioned API link, only hostid is required parameter and the other parameters (id and applied) are optional. If admin wants to list all the patches that are not yet applied to a host, set the applied parameter as false and if admin wants to list the applied ones, set the applied parameter as true. If applied parameter is not passed with the API, it will return the list of all applied and not applied patches. To get the details about the single patch, admin need to pass the id (uuid)* *of the patch.

DB Schema changes

New tables

...

ApiName

Request parameters

Response parameters

Available to regular user

listHostUpdates

  • id
  • hostid (required)
  • applied
  • idhost Id
  • update Label
  • description
  • update URL
  • timestamp
  • isApplied

No

...