 dd8efe5f85
			
		
	
	dd8efe5f85
	
	
	
		
			
			Copy edits for typos, markup and other technical issues. Fix case typo Fix merge conflicts. Resolve FixMe issues. Minor copy edit updates. Signed-off-by: Ron Stone <ronald.stone@windriver.com> Change-Id: I7d710d3faa957c1cb66cc18c9a248a567e7c580f
		
			
				
	
	
		
			132 lines
		
	
	
		
			4.7 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
			
		
		
	
	
			132 lines
		
	
	
		
			4.7 KiB
		
	
	
	
		
			ReStructuredText
		
	
	
	
	
	
| 
 | |
| .. hfj1552920618138
 | |
| .. _installing-in-service-software-updates-using-the-cli:
 | |
| 
 | |
| =================================================
 | |
| Install In-Service Software Updates Using the CLI
 | |
| =================================================
 | |
| 
 | |
| The procedure for applying an in-service update is similar to that of a
 | |
| reboot-required update, except that the host does not need to be locked and
 | |
| unlocked as part of applying the update.
 | |
| 
 | |
| .. rubric:: |proc|
 | |
| 
 | |
| #.  Upload the update \(patch\).
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch upload INSVC_HORIZON_SYSINV.patch
 | |
|         INSVC_HORIZON_SYSINV is now available
 | |
| 
 | |
| #.  Confirm that the update is available.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch query
 | |
|               Patch ID        RR  Release  Patch State
 | |
|         ====================  ==  =======  ===========
 | |
|         INSVC_HORIZON_SYSINV  N    nn.nn    Available
 | |
| 
 | |
| #.  Check the status of the hosts.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch query-hosts
 | |
|           Hostname      IP Address    Patch Current  Reboot Required  Release  State
 | |
|         ============  ==============  =============  ===============  =======  =====
 | |
|         worker-0      192.168.204.24       Yes             No          nn.nn   idle
 | |
|         controller-0  192.168.204.3        Yes             No          nn.nn   idle
 | |
|         controller-1  192.168.204.4        Yes             No          nn.nn   idle
 | |
| 
 | |
| #.  Ensure that the original update files have been deleted from the root drive.
 | |
| 
 | |
|     After they are uploaded to the storage area, the original files are no
 | |
|     longer required. You must use the command-line interface to delete them, in
 | |
|     order to ensure enough disk space to complete the installation.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ rm </path/patchfile>
 | |
| 
 | |
|     .. caution::
 | |
|         If the original files are not deleted before the updates are applied,
 | |
|         the installation may fail due to a full disk.
 | |
| 
 | |
| #.  Apply the update \(patch\).
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch apply INSVC_HORIZON_SYSINV
 | |
|         INSVC_HORIZON_SYSINV is now in the repo
 | |
| 
 | |
|     The update state transitions to Partial-Apply:
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch query
 | |
|         Patch ID              RR  Release   Patch State
 | |
|         ====================  ==  =======  =============
 | |
|         INSVC_HORIZON_SYSINV  N    nn.nn   Partial-Apply
 | |
| 
 | |
|     As it is an in-service update, the hosts report that they are not 'patch
 | |
|     current', but they do not require a reboot.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch query-hosts
 | |
|         Hostname      IP Address      Patch Current  Reboot Required  Release  State
 | |
|         ============  ==============  =============  ===============  =======  =====
 | |
|         worker-0      192.168.204.24       No              No          nn.nn   idle
 | |
|         controller-0  192.168.204.3        No              No          nn.nn   idle
 | |
|         controller-1  192.168.204.4        No              No          nn.nn   idle
 | |
| 
 | |
| 
 | |
| #.  Install the update on controller-0.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch host-install controller-0
 | |
|         .............
 | |
|         Installation was successful.
 | |
| 
 | |
| #.  Query the hosts to check status.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch query-hosts
 | |
|         Hostname      IP Address    Patch Current  Reboot Required    Release  State
 | |
|         ============  ==============  =============  ===============  =======  =====
 | |
|         worker-0      192.168.204.24       No              No          nn.nn   idle
 | |
|         controller-0  192.168.204.3        Yes             No          nn.nn   idle
 | |
|         controller-1  192.168.204.4        No              No          nn.nn   idle
 | |
| 
 | |
|     The controller-1 host reports it is now 'patch current' and does not
 | |
|     require a reboot, without having been locked or rebooted
 | |
| 
 | |
| #.  Install the update on worker-0 \(and other worker nodes and storage nodes,
 | |
|     if present\)
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch host-install worker-0
 | |
|         ....
 | |
|         Installation was successful.
 | |
| 
 | |
|     You can query the hosts to confirm that all nodes are now 'patch current',
 | |
|     and that the update has transitioned to the Applied state.
 | |
| 
 | |
|     .. code-block:: none
 | |
| 
 | |
|         $ sudo sw-patch query-hosts
 | |
|         Hostname      IP Address      Patch Current  Reboot Required  Release  State
 | |
|         ============  ==============  =============  ===============  =======  =====
 | |
|         worker-0      192.168.204.24       Yes             No          nn.nn   idle
 | |
|         controller-0  192.168.204.3        Yes             No          nn.nn   idle
 | |
|         controller-1  192.168.204.4        Yes             No          nn.nn   idle
 | |
| 
 | |
|         $ sudo sw-patch query
 | |
|         Patch ID              RR  Release  Patch State
 | |
|         ====================  ==  =======  ===========
 | |
|         INSVC_HORIZON_SYSINV  N    nn.nn     Applied
 |