Updating HCI
You can update system software by uploading new update packages.
|
Important: Hitachi Vantara does not provide updates or security fixes for the host operating systems running on system instances. |
Before updating
In order for a system to be updated:
•All instances and services must be healthy.
•Each service must be running on its recommended number of instances. See Service list.
•Each instance must have enough disk space for the update.
•All required network ports must be available on each instance.
•There can be no in-progress package uploads or installations. See Packages.
During an update
•All running workflow tasks are paused.
•System availability considerations:
oInstances shut down and restart one-at-a-time during the upgrade. Other instances remain online and able to service requests.
oThe Search App remains accessible. Users can continue to search for data, but searches may take longer than usual to return results.
oThe Administration App remains available but is in a read-only state. You can monitor the progress of the update, but you cannot make any other changes to the system.
|
Note: Systems with two instances are more susceptible to availability outages during an update than systems with three or more instances. |
Checking update status
As an update runs, you can view its progress on the System Configuration > Updates page. Also on this page, you can view all system events related to system updates.
Results of an update
After an update, the system runs a new version of the software. Additionally:
•If any of the built-in plugins were updated, your system automatically uses the latest versions of those plugins.
•If an existing service is replaced with a new service, the system automatically runs that new, replacement service.
•If any new services were added, you may need to manually configure those services to run on the system instances.
For information on:
•Plugins, see Plugins
•Configuring where services run, see Moving and scaling services.
Update errors
If errors occur during an update, the Updates page displays information about each error and also displays a Retry button for starting the update over again. Some errors may not be resolved by restarting the update.
If you encounter errors during an update, contact your authorized service provider.
Update history
For information on viewing the update history for the system, see Viewing update history.
New services and components added during an update
A system update may add new services or plugins. You need to manually configure your system to start using these new components; your system does not start using them automatically.
Administration App instructions
To update system:
1.Click on System Configuration.
2.Click on the Updates .
3.Click on the Install Updates button.
4.Do one of these:
oIf the update file is stored on your computer, click and drag the file into the Upload panel.
oIf the update file is stored in one of your data sources, click on the Load panel. Then, select a data connection and browse for the file.
The update file is uploaded and system checks to make sure the file is valid. This may take several minutes.
5.On the Updates page, click on the View button in the Update Status panel.
6.The Verify & Apply Update page displays information about the contents of the update.
7.To start the update, click on the Apply Update button.
system begins checking to make sure the system is ready to be updated. If it isn't, the update stops. In this case, you need to correct the problems before the update can continue.
Related CLI command(s)
getUpdateStatus
installUpdate
deleteUpdate
loadUpdate
uploadUpdate
For information on running CLI commands, see CLI reference.
Related REST API method(s)
GET /update
POST /update/install
DELETE /update/package
POST /update/package
POST /update/package/load — (Retrieves update package from a data connection)
For information on specific REST API methods, in the Administration App, click on the help icon (). Then:
•To view the administrative REST API methods, click on Admin API.
•To view the API methods used for performing searches, click on Search API.
For general information about the administrative REST API, see REST API reference.
put API snippet hereTrademarks, Legal disclaimer, Third-party software in this documentation
© 2017 Hitachi Vantara Corporation. All rights reserved.