---

HMC Manual Reference Pages  - SAVEUPGDATA (1)

---

saveupgdata - save upgrade data

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

saveupgdata -r {disk | diskusb | diskftp | disksftp}
[-h host-name -u user-ID [--passwd password] [-k SSH-private-key]]
[-d remote-directory] [--migrate] [-i additional-data] [--force]
[--help]

saveupgdata saves the current partition profile data, Hardware Management Console (HMC) user data, and HMC configuration data in a portion of the HMC hard drive that the HMC upgrade process cannot erase. The HMC automatically recovers the data after the upgrade process completes.

Optionally this command can also save the upgrade data to a USB data storage device or on a remote FTP or secure FTP (SFTP) server. The rstupgdata command can be used to restore the saved upgrade data manually after upgrading the HMC.

This command should be run immediately prior to performing an HMC upgrade. If the HMC is restarted without performing an upgrade after running this command, this command must be run again.

This command in conjunction with the rstupgdata command can be used to facilitate migration from one HMC to another. Both commands must be run with the --migrate option.

-r	If disk is specified, upgrade data will only be saved on the HMC hard drive. If diskusb is specified, in addition to storing the upgrade data on the HMC hard drive, this command will copy the same upgrade data onto a USB data storage device. The USB device must be inserted into a USB port on the HMC before running this command. If diskftp is specified, in addition to storing the upgrade data on the HMC hard drive, this command will copy the same upgrade data to an FTP server. If disksftp is specified, in addition to storing the upgrade data on the HMC hard drive, this command will copy the same upgrade data to a secure FTP server.
-h	The host name or IP address of the remote server where the upgrade data will be saved. This option is required when the upgrade data is to be saved on a remote server. Otherwise, this option is not valid.
-u	The user ID to use to log in to the remote server. This option is required when the upgrade data is to be saved on a remote server. Otherwise, this option is not valid.
--passwd	The password to use to log in to the remote server. If this option is omitted and the upgrade data is to be saved on a remote FTP server, you will be prompted to enter the password. If both this option and the -k option are omitted and the upgrade data is to be saved on a remote SFTP server, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. This option is only valid when the upgrade data is to be saved on a remote server.
-k	The name of the file that contains the SSH private key. If the file name is not fully qualified, the file must exist in the user’s home directory on the HMC. Use the ssh-keygen command to generate the public and private SSH key pair. The ssh-keygen command is not allowed to write to the .ssh directory in the user’s home directory on the HMC, so when you run the command on the HMC, you must specify both the directory and the file name for the private key. If you generate a key with a passphrase, you will be prompted to enter the passphrase when you run any HMC command that uses the key. If both this option and the --passwd option are omitted and the upgrade data is to be saved on a remote SFTP server, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. This option is only valid when the upgrade data is to be saved on a remote SFTP server.
-d	The directory on the remote server where the upgrade data is to be saved. This option is only valid when the upgrade data is to be saved on a remote server.
--migrate	Specify this option to include data for migrating this HMC to another HMC.
-i	Additional data to be included in the migration data. Valid values are netcfg to include network configuration data, and perfmon to include performance monitoring data.
--force	Specify this option to force migration data to be included for an HMC managing a Power enterprise pool.
--help	Display the help text for this command and exit.

Save upgrade data to the HMC hard drive:

saveupgdata -r disk

Save upgrade data to the HMC hard drive and to a USB flash drive:

saveupgdata -r diskusb

Save upgrade data to the HMC hard drive and to a remote FTP server (you will be prompted to enter the user’s password):

saveupgdata -r diskftp -h ftpserver -u ftpuser
-d /home/ftpuser/saveupgdata

Save upgrade data to the HMC hard drive and to a remote SFTP server and use SSH keys for authentication:

saveupgdata -r disksftp -h 9.3.123.25 -u sftpuser
-k /home/hmcuser/keys/id_rsa -d /home/sftpuser/saveupgdata

Save upgrade data, including network configuration data, to be used to migrate from an x86 HMC to a Power HMC:

saveupgdata -r diskusb --migrate -i netcfg

None

None

IBM Austin

rstupgdata