|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Start-NcSystemImageUpdate
NAME
Start-NcSystemImageUpdate
SYNOPSIS
Perform software image upgrade/downgrade.
SYNTAX
Start-NcSystemImageUpdate [-Node] <String> [-Url] <String> [-NewName <String
>] [-Replace <String>] [-ReplacePackage] [-IgnoreCompatibility] [-SetDefault
] [-Controller <NcController[]>] [<CommonParameters>]
DESCRIPTION
Perform software image upgrade/downgrade. The progress can be monitored usi
ng Get-NcSystemImageUpdateStatus.
PARAMETERS
-Node <String>
The node on which the software image is located.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Url <String>
The location from which the software image is to be downloaded. The loca
tion can be specified in any of the following ways:
As an HTTP URL in the form http://[username[:password]@]host_name[:p
ort]/path_to_file. For instance, http://user:pass@example.com/downloads/
image.tgz. NOTE: The management utility does not check whether the Web
server is password protected; if a username and password are not provid
ed in the URL the command will nearly always fail with the error "Confir
mation needed"
As an FTP URL in the form ftp://host_name[:port]/path_to_file. For i
nstance, ftp://example.com/downloads/image.tgz.
As a TFTP URL in the form tftp://host_name[:port]/path_to_file. For
example, tftp://example.com/downloads/image.tgz. TFTP does not require a
user name or password.
As a path to a mounted file system in the form file://localhost/path
_to_file. For example, file://localhost/mroot/etc/software/image.tgz.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NewName <String>
Use this parameter to enter a package name that is different than the fi
le name in the URL.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Replace <String>
The image that is to be replaced when the node is booted from the networ
k.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ReplacePackage
If specified, the existing package is deleted and replaced with a new pa
ckage.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-IgnoreCompatibility
If specified, ignore version compatibility checking.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SetDefault
If specified, set the newly updated image as the default image (that is,
the image that runs the next time the node is restarted). Note that for
this parameter to work correctly, the cluster must be in quorum when th
e image is updated.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.C.Types.System.SystemImageUpdateProgress
NOTES
Category: system
API: system-image-update
Family: cluster
-------------- Example 1 --------------
C:\PS>Start-NcSystemImageUpdate -Node fas3070cluster01-01 -Url http://exampl
e.com/packages/image.tgz
Update the system image with the one located at http://example.com/packages/
image.tgz on node fas3070cluster01-01.
LastMessage : Downloading package. This may take up to 10 minutes.
RunStatus : Working
ExitStatus :
ExitMessage :
Phase : Download
RELATED LINKS
Get-NcSystemImageUpdateStatus
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|