| -t | The type of VIOS backup files to copy. Valid values are viosioconfig for VIOS I/O configuration backup files, vios for full VIOS backup files, and ssp for Shared Storage Pool configuration backup files. |
| -m | The name of the managed system which has the VIOS for which to copy the backup files. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name. |
| -p |
The name of the VIOS for which to copy the backup files.
You can either use this option to specify the name of the VIOS, the --id option to specify the ID of the VIOS, or the --uuid option to specify the UUID of the VIOS. The -p, --id, and --uuid options are mutually exclusive. |
| --id |
The ID of the VIOS for which to copy the backup files.
You can either use this option to specify the ID of the VIOS, the -p option to specify the name of the VIOS, or the --uuid option to specify the UUID of the VIOS. The --id, -p, and --uuid options are mutually exclusive. |
| --uuid |
The UUID of the VIOS for which to copy the backup files.
You can either use this option to specify the UUID of the VIOS, the -p option to specify the name of the VIOS, or the --id option to specify the ID of the VIOS. The --uuid, -p, and --id options are mutually exclusive. |
| -o | The operation to perform. Valid values are import to copy the VIOS backup files from a remote location to the HMC, and export to copy the VIOS backup files from the HMC to a remote location. |
| -f | The name of one or more VIOS backup files to copy. Multiple file names must be comma separated. |
| -r | The remote location where the VIOS backup files will be copied to or from. Valid values are nfs to copy the VIOS backup files to or from an NFS file system, and sftp to copy the VIOS backup files to or from a secure FTP (SFTP) server. |
| -h | The host name or IP address of the remote server. |
| -u |
The user ID to use to log in to the remote SFTP server.
This option is required when copying VIOS backup files to or from a remote SFTP server. Otherwise, this option is not valid. |
| --passwd |
The password to use to log in to the remote SFTP server.
If both this option and the -k option are omitted when copying VIOS backup files to or from a remote SFTP server, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. |
| -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 when copying VIOS backup files to or from a remote SFTP server, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. |
| -l |
The mount location defined on the NFS server where the VIOS backup files will be copied to or from.
This option is required when copying VIOS backup files to or from an NFS file system. Otherwise, this option is not valid. |
| --options |
Options to be passed to the mount command used to mount the NFS file system where the VIOS backup files will be copied to or from. The options must be enclosed in double quotes.
The HMC supports NFS versions 3 and 4, and this command uses version 3 by default. To use version 4, include the option vers=4. This option is only valid when copying VIOS backup files to or from an NFS file system. |
| -d | The name of the directory on the remote server where the VIOS backup files will be copied to or from. If this option is not specified when copying the VIOS backup files to or from a SFTP server, the files will be copied to or from the user’s home directory. If this option is not specified when copying the VIOS backup files to or from an NFS file system, the files will be copied to or from the mount-location on the NFS server. |
| --help | Display the help text for this command and exit. |
cpviosbk -t ssp -m sys1 -p vios1 -o export -f vios1_ssp_backup -r sftp
-h sftpserver -u sftpuser -k /home/hmcuser/keys/id_rsa
Copy full VIOS backup files from an NFS file system using NFS version 4 to the HMC:
cpviosbk -t vios -m sys1 --uuid 2B809AD7-2019-442F-98F2-1C4D4ACB06E7
-o import -f vios1_backup_march,vios1_backup_april
-r nfs -h 9.3.145.52 -l /hmcdata --options "vers=4" -d /backups/vios
| None | |
| None | |
| Linux | CPVIOSBK (1) | September 2021 |