Available: from 1.9.2.0 (V10R1M1010)

With the command “vios cpviosbk” backups of virtual I/O servers can be imported to an HMC as well as exported to a remote server.

To import to an HMC, the following form of “vios ​​cpviosbk” can be used:

vios [-h <hmc>] [-m <ms>] cpviosbk [-k <private_key_file>] [-o <mount_options>] [-t <type>] [-v] <vios> <location> [<target_hmc>]
   -k : path to SSH private key file for SFTP
   -o : mount options for NFS
   -t : the type of the backup (vios, viosioconfig or ssp)

For example, if a full backup (type vios) is saved on the remote server with the IP address 10.255.255.57 in the directory /export/vios/ms03-vio1 under the name fullbackup.tar, then this backup can be saved on the HMC hmc01 using the following command:

$ vios cpviosbk ms03-vio1 nfs://10.255.255.57//export/vios/ms03-vio1/fullbackup.tar hmc01
$

In the example, NFS was used to access the backup. If SFTP is to be used instead, this works in the same way. However, at least the user name to be used for SFTP must also be specified:

$ vios cpviosbk ms03-vio1 sftp://user01@10.255.255.57//export/vios/ms03-vio1/fullbackup.tar hmc01
Enter the current password for user user01: XXXXXXXX
$

In both cases, the HMC hmc01 was specified as the target. If no target HMC is specified, then in dual-HMC configurations one of the two HMCs is automatically selected by the LPAR tool (usually this is the first HMC).

The remote location can be specified in one of the following ways:

   sftp://user[:password]@host/[directory/]filename - SFTP server
   nfs://host/[directory/]filename - NFS filesystem
   nfs3://host/[directory/]filename - NFSv3 filesystem
   nfs4://host/[directory/]filename - NFSv4 filesystem
   user[:password]@host:[directory/]filename - SFTP server
   host:[directory/]filename - NFS filesystem

If you want to import an I/O configuration backup or an SSP backup, you must use the “-t” option to specify the type of backup. If no type is specified, “vios” is automatically assumed as the type.

Virtual I/O server backups on the HMC can also be exported to a remote server using the “vios cpviosbk” command:

vios [-h <hmc>] [-m <ms>] cpviosbk [-k <private_key_file>] [-o <mount_options>] [-v] <vios> <backup_selections> <location>
   -k : path to SSH private key file for SFTP
   -o : mount options for NFS

Backups that have been saved on an HMC can be copied (exported) to a remote system via SFTP or NFS. To do this, the desired backup must be specified as an argument after the virtual I/O server. Selections can be used, whereby the following attributes can be specified directly without a preceding attribute name:

   name - name of the backup file
   hmc - name of the HMC
   type - vios (mksysb), viosioconfig or ssp

The backup specification must match exactly one of the backups of the Virtual I/O Server. If there is more than one backup that matches the specified argument, an error message is displayed.

The remote location where the backup should be stored can be specified using one of the following options:

   sftp://user[:password]@host/directory - SFTP server
   nfs://host/directory - NFS filesystem
   nfs3://host/directory - NFSv3 filesystem
   nfs4://host/directory - NFSv4 filesystem
   user[:password]@host:directory - SFTP server
   host:directory - NFS filesystem

For example, if the backup with the name fullbackup.tar of the virtual I/O server ms03-vio1 of HMC hmc02 is to be saved using NFS on the remote server with the IP address 10.255.255.57 in the directory /export/vios/ms03-vio1, this can be done with the following command:

$ vios cpviosbk ms03-vio1 fullbackup.tar,hmc02 nfs://10.255.255.57//export/vios/ms03-vio1
$

If there is only one backup with the name fullbackup.tar, then you can just specify the name of the backup instead of “fullbackup.tar,hmc02”.

If the backup is to be copied using SFTP instead of NFS, the user name to be used for SFTP must also be specified:

$ vios cpviosbk ms03-vio1 fullbackup.tar,hmc02 user01@10.255.255.57:/export/vios/ms03-vio1
Enter the current password for user user01: XXXXXXXX
Shared connection to hmc02 closed.
$

Note: Since no password was specified on the command line, the password is requested interactively.

Virtual I/O server backups can be displayed using the commands “vios lsviosbk” or “hmc lsviosbk”.