downloadsoftware

Edit online

Use the downloadsoftware command to download the selected code bundles either through Cloud Call Home (and optionally via a HTTP proxy) or using FTP over SSH (SFTP). This command can also be used to abort a download.

Syntax

The system supports two ways of downloading software packages from Fix Central. New for 8.4.2, you can download software packages from Fix Central using Cloud Call Home through esupport.ibm.com, which uses an IBMid user and password login to download software. The second method downloads packages using SFTP from Fix Central. The previous method of downloading software upgrade packages from Fix Central over SFTP is still supported, but is deprecated on systems running 8.4.2 or later. The first syntax diagram shows downloading software from Fix Central using Cloud Call Home through esupport.ibm.com. The second syntax diagram shows downloading a software package from Fix Central using SFTP.

Using Cloud Call Home (new for 8.4.2)

Using SFTP from Fix Central (deprecated in 8.4.2)

Parameters

Using Cloud Call Home

-user ibm_id: (Mandatory) Specifies the IBMid of the person who is downloading the software.
-password ibm_password: (Mandatory) Specifies the IBMid password of the person who is downloading the software. The value must be an alphanumeric string that is 6 - 64 printable characters in length. You must enclose the password in single quotation marks.
-fixid fix_number: (Mandatory) Specifies the fix to be downloaded from the Fix Central server. The value should be any string containing printable characters such as StorageDisk-2077-8.2.1.2 or Storage_Disk-V5000E-8.3.1.2-ifix7.
Note: You can use either -fixid or -vrmf. Both parameters are mutually exclusive.
-vrmf vrmf: (Mandatory) Specifies the Version, Release, Modification, Fix of Spectrum Virtualize software to be downloaded from the Fix Central server. Four numeric values separated by three dots.
-accesskey access_key: (Optional) Specifies the access key needed when downloading an ifix from Fix Central. The value must be an alphanumeric string that is 6 - 64 printable characters in length.
Note: This parameter can be used only with fixid.
-panelname: (Optional) Specifies the node that is being serviced. The value must be an alphanumeric string.
Note: If not specified, this variable applies to the node on which the command is running.
-abort: (Optional) Specifies that the download is canceled.

Using SFTP from Fix Central (deprecated in 8.4.2)

-user user_name: (Optional) Specifies a temporary user that is created by the Fix Central server to download an existing code bundle. The value must be an alphanumeric string that is 6 - 64 printable characters in length.
-password password: (Optional) Specifies a temporary password that is created by the Fix Central server for the download that is being performed by the temporary user. The value must be an alphanumeric string that is 6 - 64 printable characters in length. You must enclose the password in single quotation marks.
-abort: (Optional) Specifies that the download is canceled.
panel_name: (Optional) Specifies the node that is being serviced. The value must be an alphanumeric string.
Note: If not specified, this variable applies to the node on which the command is running.
-templogin: (Mandatory) Indicates that the user and password parameters are generated by Fix Central in order to download a code bundle.
Note: This parameter is mandatory unless -abort parameter is used.

Description

This command downloads selected code bundles from the Fix Central server using either Cloud Call Home or SFTP. This command can also be used to abort an ongoing download.

Remember: Before you specify this command, you must:

Have internet access for all nodes
Configure service IP addresses on all nodes in your system.
Configure a DNS server on your system by specifying mkdnsserver to define a Domain Name System (DNS) server and lsdnsserver to display its values.
Depending on whether you are using an internal HTTP proxy or a firewall to manage remote access, additional network configuration might be required. For more information, see Configuring support assistance.
If you are using SFTP to download software packages from Fix Central, log on to the Fix Central server and configure the bundle that you wish to download for your product. Fix Central servers prepare your download bundle and create a temporary user name and password for you. These login credentials are valid for up to 72 hours (during this time you must finish downloading the bundle on to your node or system). As a part of the download bundle, the Fix Central server generates md5sum output for each file that this command validates the download against. If the md5sum output is not generated in any file, all files downloaded at that point are deleted and the download is aborted.

Various software packages might be available depending on your product. This includes new builds for upgrading or downgrading your system, upgrade checking software, remote support proxy server, ifixes, and other software packages.

Specify lscmdstatus to display detailed results. For example, specify sainfo lscmdstatus:

If you are using Cloud Call Home to download packages, the following results display:

last_command satask downloadsoftware -user ##### -password ##### -vrmf 8.3.1.2 
last_command_status CMMVC8044E Command completed successfully.
T3_status
T3_status_data
cpfiles_status
cpfiles_status_data
snap_status
snap_filename
installcanistersoftware_status
supportupload_status 
supportupload_status_data 
supportupload_progress_percent 0
supportupload_throughput_KBps 0
supportupload_filename 
downloadsoftware_status Active
downloadsoftware_status_data Downloading the bundle
downloadsoftware_progress_percent 38
downloadsoftware_throughput_KBps 321
downloadsoftware_size 467.6 MiB

If you are using SFTP through Fix Central to download packages, the following results display:

last_command satask downloadsoftware -user ##### -password ##### 
last_command_status CMMVC8044E Command completed successfully.
T3_status
T3_status_data
cpfiles_status
cpfiles_status_data
snap_status
snap_filename
installcanistersoftware_status
supportupload_status 
supportupload_status_data 
supportupload_progress_percent 0
supportupload_throughput_KBps 0
supportupload_filename 
downloadsoftware_status Active
downloadsoftware_status_data Downloading the bundle
downloadsoftware_progress_percent 38
downloadsoftware_throughput_KBps 321
downloadsoftware_size 467.6 MiB

An invocation example

The following example downloads software packages from Fix Central using Cloud Call Home with a -fixid and -accesskey specified.

satask downloadsoftware -user bob.example@ibm.com -password 'z9!rMxTf?g973=78' -accesskey 131315948042609040 -fixid StorageSoftware-2145-IBM_INSTALL_patch_assert_1.00

The resulting output:

No feedback (use sainfo lscmdstatus to display software download information)

An invocation example

The following example downloads software packages from Fix Central using Cloud Call Home with a -vrmf specified.

satask downloadsoftware -user bob.example@ibm.com -password 'z9!rMxTf?g973=78' -vrmf 8.3.1.2

The resulting output:

No feedback (use sainfo lscmdstatus to display software download information)

An invocation example

The following example shows downloading a software package from Fix Central using SFTP with temporary username and password.

satask downloadsoftware -user rOLrhyPf -password 'E4yrr6WZM' -templogin

The resulting output:

No feedback (use sainfo lscmdstatus to display software download information)