Under Construction

vios rmviosbk

Available: from 1.9.2.0 (V10R1M1010)

The command “vios rmviosbk” can be used to delete backups of virtual I/O servers on an HMC:

   vios [-h <hmc>] [-m <ms>] rmviosbk [-v] <vios> <backup_selections>

In addition to the virtual I/O server, exactly one backup of the virtual I/O server must be specified. In most cases, the name of the backup is unique and can be used for deletion. In dual-HMC configurations, it is possible that a backup name was used on both HMCs and is therefore not unique. However, this can always be resolved by using selections.

The following examples use the backups of the Virtual I/O server ms01-vio2, which can be viewed with “vios lsviosbk”:

$ vios lsviosbk ms01-vio2
NAME              TYPE          SIZE      HMC    LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.007     hmc01  05/10/2024 08:56:09
fullbackup.tar    vios          5130.459  hmc01  05/02/2024 06:01:47
cfgbackup.tar.gz  viosioconfig  0.007     hmc02  05/10/2024 10:06:14
$

To delete the backup fullbackup.tar, it is sufficient to specify the backup name, as this is unique:

$ vios rmviosbk ms01-vio2 fullbackup.tar
$

If one of the I/O configuration backups (type viosioconfig) is to be deleted, the name is not sufficient:

$ vios rmviosbk ms01-vio2 cfgbackup.tar.gz
USAGE:
   vios [-h <hmc>] [-m <ms>] rmviosbk [-v] <vios> <backup_selections>
ERROR: 'cfgbackup.tar.gz' matches more than one backup:
did you mean: name=cfgbackup.tar.gz,type=viosioconfig,hmc=hmc01
did you mean: name=cfgbackup.tar.gz,type=viosioconfig,hmc=hmc02
$

By additionally specifying one of the two HMCs, a backup to be deleted can be clearly selected:

$ vios rmviosbk ms01-vio2 cfgbackup.tar.gz,hmc02
$

Another way to delete backups from virtual I/O servers is the similar command “hmc rmviosbk”.