Under Construction

Listing Virtual I/O Server Backups

The virtual I/O server backups stored on an HMC can be displayed using the command “hmc lsviosbk“:

LPAR-Tool
$ hmc lsviosbk hmc01
NAME              TYPE          SIZE      SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     ms03  ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007     ms03  ms03-vio2  05/10/2024 08:57:41
cfgbackup.tar.gz  viosioconfig  0.007     ms04  ms04-vio2  05/10/2024 08:58:19
cfgbackup.tar.gz  viosioconfig  0.007     ms04  ms04-vio1  05/10/2024 08:58:00
cfgbackup.tar.gz  viosioconfig  0.006     ms05  ms05-vio2  05/10/2024 08:58:41
cfgbackup.tar.gz  viosioconfig  0.007     ms05  ms05-vio1  05/10/2024 08:58:30
fullbackup.tar    vios          3558.838  ms03  ms03-vio1  04/30/2024 12:05:00
fullbackup.tar    vios          6255.049  ms03  ms03-vio2  05/10/2024 08:56:55
fullbackup.tar    vios          5728.691  ms04  ms04-vio2  05/02/2024 09:47:55
fullbackup.tar    vios          5615.410  ms04  ms04-vio1  05/10/2024 09:47:14
fullbackup.tar    vios          5428.936  ms05  ms05-vio2  05/02/2024 06:54:57
fullbackup.tar    vios          5418.809  ms05  ms05-vio1  05/02/2024 06:40:53
$
HMC-CLI
hscroot@hmc01:~> lsviosbk
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 08:57:24,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=3AB26116-0B88-41D-B1BF-9C9EFE69187E,last_modified=05/10/2024 08:57:41,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio2,vios_id=2,vios_uuid=732059D9-846B-4BD-97A9-47D929F0E4A0,last_modified=05/10/2024 08:58:19,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4FC-BD11-70028FBED1C0,last_modified=05/10/2024 08:58:00,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio2,vios_id=2,vios_uuid=54EE2359-4C3D-4D0-A87B-7999DDDC63AC,last_modified=05/10/2024 08:58:41,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio1,vios_id=1,vios_uuid=52CC6470-71A-4313-A27F-2A8F3EACDC7D,last_modified=05/10/2024 08:58:30,size=0.007
name=fullbackup.tar,type=vios,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4F6C-D11-70028FBED1C0,last_modified=05/02/2024 09:47:14,size=6255.049
name=fullbackup.tar,type=vios,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=732059D9-846B-4BCD-7A9-47D929F0E4A0,last_modified=05/10/2024 08:56:55,size=3558.838
name=fullbackup.tar,type=vios,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio2,vios_id=2,vios_uuid=732059D9-846B-4BCD-7A9-47D929F0E4A0,last_modified=05/02/2024 09:47:55,size=5728.691
name=fullbackup.tar,type=vios,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4F6C-D11-70028FBED1C0,last_modified=05/10/2024 09:47:14,size=5615.410
name=fullbackup.tar,type=vios,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio2,vios_id=2,vios_uuid=54EE2359-4C3D-4D10-87B-7999DDDC63AC,last_modified=05/02/2024 06:54:57,size=5428.936
ame=fullbackup.tar,type=vios,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio1,vios_id=1,vios_uuid=52CC6470-F71A-4313-A27F-2A8F3EACDC7D,last_modified=05/02/2024 06:40:53,size=5418.809
hscroot@hmc01:~>

In larger environments with multiple managed systems per HMC, the output can be a little longer. In many cases, however, you are only interested in certain backups. To display only these, you can use selections to limit the output to the backups of interest.

For example, if you only want to display backups of type viosioconfig, you can do this by specifying “viosioconfig” as an additional argument:

LPAR-Tool
$ hmc lsviosbk hmc01 viosioconfig
NAME              TYPE          SIZE      SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     ms03  ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007     ms03  ms03-vio2  05/10/2024 08:57:41
cfgbackup.tar.gz  viosioconfig  0.007     ms04  ms04-vio2  05/10/2024 08:58:19
cfgbackup.tar.gz  viosioconfig  0.007     ms04  ms04-vio1  05/10/2024 08:58:00
cfgbackup.tar.gz  viosioconfig  0.006     ms05  ms05-vio2  05/10/2024 08:58:41
cfgbackup.tar.gz  viosioconfig  0.007     ms05  ms05-vio1  05/10/2024 08:58:30
$
HMC-CLI
hscroot@hmc01:~> lsviosbk --filter types=viosioconfig
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 08:57:24,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=3AB26116-0B88-41D-B1BF-9C9EFE69187E,last_modified=05/10/2024 08:57:41,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio2,vios_id=2,vios_uuid=732059D9-846B-4BD-97A9-47D929F0E4A0,last_modified=05/10/2024 08:58:19,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4FC-BD11-70028FBED1C0,last_modified=05/10/2024 08:58:00,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio2,vios_id=2,vios_uuid=54EE2359-4C3D-4D0-A87B-7999DDDC63AC,last_modified=05/10/2024 08:58:41,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio1,vios_id=1,vios_uuid=52CC6470-71A-4313-A27F-2A8F3EACDC7D,last_modified=05/10/2024 08:58:30,size=0.007
hscroot@hmc01:~>

The managed system, the virtual I/O server, or the backup name can also be specified (see “hmc help lsviosbk”). For example, all backups of virtual I/O servers on the managed system ms03:

LPAR-Tool
$ hmc lsviosbk hmc01 ms03
NAME              TYPE          SIZE      SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     ms03  ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007     ms03  ms03-vio2  05/10/2024 08:57:41
fullbackup.tar    vios          3558.838  ms03  ms03-vio1  04/30/2024 12:05:00
fullbackup.tar    vios          6255.049  ms03  ms03-vio2  05/10/2024 08:56:55
$
HMC-CLI
hscroot@hmc01:~> lsviosbk --filter sys_names=ms03
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 08:57:24,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=3AB26116-0B88-41D-B1BF-9C9EFE69187E,last_modified=05/10/2024 08:57:41,size=0.007
name=fullbackup.tar,type=vios,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4F6C-D11-70028FBED1C0,last_modified=05/02/2024 09:47:14,size=6255.049
name=fullbackup.tar,type=vios,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=732059D9-846B-4BCD-7A9-47D929F0E4A0,last_modified=05/10/2024 08:56:55,size=3558.838
hscroot@hmc01:~>

Or using regular expressions, only the backups made on May 10, 2024 can be listed:

LPAR-Tool
$ hmc lsviosbk hmc01 last_modified~05/10/2024
NAME              TYPE          SIZE      SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     ms03  ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007     ms03  ms03-vio2  05/10/2024 08:57:41
cfgbackup.tar.gz  viosioconfig  0.007     ms04  ms04-vio2  05/10/2024 08:58:19
cfgbackup.tar.gz  viosioconfig  0.007     ms04  ms04-vio1  05/10/2024 08:58:00
cfgbackup.tar.gz  viosioconfig  0.006     ms05  ms05-vio2  05/10/2024 08:58:41
cfgbackup.tar.gz  viosioconfig  0.007     ms05  ms05-vio1  05/10/2024 08:58:30
fullbackup.tar    vios          6255.049  ms03  ms03-vio2  05/10/2024 08:56:55
fullbackup.tar    vios          5615.410  ms04  ms04-vio1  05/10/2024 09:47:14
$
HMC-CLI
hscroot@hmc01:~> lsviosbk | grep 05/10/2024
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 08:57:24,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=3AB26116-0B88-41D-B1BF-9C9EFE69187E,last_modified=05/10/2024 08:57:41,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio2,vios_id=2,vios_uuid=732059D9-846B-4BD-97A9-47D929F0E4A0,last_modified=05/10/2024 08:58:19,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4FC-BD11-70028FBED1C0,last_modified=05/10/2024 08:58:00,size=0.007
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio2,vios_id=2,vios_uuid=54EE2359-4C3D-4D0-A87B-7999DDDC63AC,last_modified=05/10/2024 08:58:41,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms05,mtms=9009-22G*89EA9C0,vios_name=ms05-vio1,vios_id=1,vios_uuid=52CC6470-71A-4313-A27F-2A8F3EACDC7D,last_modified=05/10/2024 08:58:30,size=0.007
name=fullbackup.tar,type=vios,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=732059D9-846B-4BCD-7A9-47D929F0E4A0,last_modified=05/10/2024 08:56:55,size=3558.838
name=fullbackup.tar,type=vios,sys_name=ms04,mtms=9009-22A*895D9F0,vios_name=ms04-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4F6C-D11-70028FBED1C0,last_modified=05/10/2024 09:47:14,size=5615.410
hscroot@hmc01:~>

Several criteria can also be combined. To display, for example, the backups of type “viosioconfig” that were made on May 10, 2024 for virtual I/O servers on the managed system ms03:

LPAR-Tool
$ hmc lsviosbk hmc01 viosioconfig,last_modified~05/10/2024,ms03
NAME              TYPE          SIZE   SYS_NAME  VIOS_NAME  LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006  ms03  ms03-vio1  05/10/2024 08:57:24
cfgbackup.tar.gz  viosioconfig  0.007  ms03  ms03-vio2  05/10/2024 08:57:41
$
HMC-CLI
hscroot@hmc01:~> lsviosbk --filter types=viosioconfig,sys_names=ms03 | grep 05/10/2024
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 08:57:24,size=0.006
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio2,vios_id=2,vios_uuid=3AB26116-0B88-41D-B1BF-9C9EFE69187E,last_modified=05/10/2024 08:57:41,size=0.007
hscroot@hmc01:~>

In all examples, only backups on the specified HMC were displayed. When it comes to a specific virtual I/O server, you are usually interested in all backups of this virtual I/O server. In dual-HMC configurations, these backups can possibly be found on both HMCs. Instead of calling the “hmc lsviosbk” command for each of the two HMCs, you can call the analogous “vios ​​lsviosbk” command for the relevant virtual I/O server:

LPAR-Tool
$ vios lsviosbk ms03-vio1
NAME              TYPE          SIZE      HMC    LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     hmc01  05/10/2024 08:57:24
fullbackup.tar    vios          3558.838  hmc01  04/30/2024 12:05:00
cfgbackup.tar.gz  viosioconfig  0.006     hmc02  05/10/2024 10:07:29
$
HMC-CLI
hscroot@hmc01:~> lsviosbk --filter vios_names=ms03-vio1
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 08:57:24,size=0.006
name=fullbackup.tar,type=vios,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=34FCEECC-215E-4F6C-D11-70028FBED1C0,last_modified=05/02/2024 09:47:14,size=6255.049
hscroot@hmc01:~>
hscroot@hmc02:~> lsviosbk --filter vios_names=ms03-vio1
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 10:07:29,size=0.006
hscroot@hmc02:~>

The options for limiting the backups to be displayed using selections are essentially the same:

LPAR-Tool
$ vios lsviosbk ms03-vio1 name~cfg,hmc02
NAME              TYPE          SIZE      HMC    LAST_MODIFIED
cfgbackup.tar.gz  viosioconfig  0.006     hmc02  05/10/2024 10:07:29
$
HMC-CLI
hscroot@hmc02:~> lsviosbk --filter vios_names=ms03-vio1 | grep cfg
name=cfgbackup.tar.gz,type=viosioconfig,sys_name=ms03,mtms=9009-22A*895D9E0,vios_name=ms03-vio1,vios_id=1,vios_uuid=4D87E316-8E74-4A3-915E-28FC43F4B0E2,last_modified=05/10/2024 10:07:29,size=0.006
hscroot@hmc02:~>