VMware
2 Replies Last post: Jan 5, 2005 10:04 AM by vjb1  

VMSNAP/VMRES User Guide posted: Dec 31, 2004 6:39 AM

Click to view tatung70's profile Enthusiast 182 posts since
Dec 27, 2003
Anyone have a guide on this as the man pages are missing?

Re: VMSNAP/VMRES User Guide

1. Dec 31, 2004 9:06 AM in response to: tatung70
Click to view bittenbt's profile Novice 13 posts since
Dec 30, 2004
Have you checked the MAN pages. I viewed the readme.txt file but not aware of a user guide.

vmsnap.pl :
This program will perform a virtual snapshot of VMs on an ESX Server.
These virtual snapshots include the virtual disks, configuration file,
nvram file and log files related to the VM. This script will operate on
running VMs only. The backups are stored in vmdk format and are transferred
to an Archive Server or Hot Standby Server.

Limitations :
1. This script can take backup of VM powered on only.
2. The Non-RDM persistent disks are only backed.

Refer to manpage for more details.

vmres.pl :
This program will perform a restore of a VM, backed up with the vmsnap
script, on an ESX Server. The backups are restored from vmdk form to
dsk format after transfer from the Archive Server or Hot Standby
Server.

Limitations :
1. Only Disks backed up by vmsnap are restored by this script.

Refer to manpage for more details.

vmsnap_all :
This program takes backup of all the registered powered on vms.

install.sh :
Installs the scripts at the right places.

You must be root the run to any of the scripts.

Re: VMSNAP/VMRES User Guide

2. Jan 5, 2005 10:04 AM in response to: tatung70
Click to view vjb1's profile Lurker 2 posts since
Dec 31, 2004
I had to manually copy the man files over. The install script didn't do this for me. There is a file called copymans in the tar file. you can use that to find the files to copy and where to put them.
Anyway here is the man page for vmsnap...
By the way I haven't had much success with it.

NAME
vmsnap - VMSnap Utility

SYNOPSIS
vmsnap OPTIONS

COPYRIGHT
VMware ESX Server is Copyright 2000 VMware, Inc. All rights reserved.

DESCRIPTION
This program will perform a virtual snapshot of VMs on an ESX Server.
These virtual snapshots include the virtual disks, configuration file,
nvram file and log files related to the VM. This script will operate on
running VMs only. The backups are stored in vmdk format and are trans-
ferred to an Archive Server or Hot Standby Server.

This tool must be run as the 'root' user or as the owner of the VM(s) to
be backed up. This tool enables a hot backup of a VM's virtual disk
through the use of REDO logs as the snapshots(disk persistent mode).

For maximum flexibility, the .dsk file is converted to .vmdk files. These
.vmdk files are copied to the Archive Server and stored in /vmim-
ages/archivebackup/$guest or user specified location where $guest is the
name of the virtual machine.

The associated .cfg file (ESX Server 1.5.x) or .vmx file (ESX Server 2.x)
is copied to the Archive Server.

Usage : vmsnap [-a server_name] [-c config_file] [-d local_dir] [-R
remote_dir] [-g] [-h] [-l] [-m] [-r]

Limitations : Do NOT rename the vmdk files. This will break restoration
of the VM. VMDKs created under 2.x cannot be used under 1.5.2.

We only backup the persistent disks. In some rare cases, vm might get
stuck when we do not have enough space for the redo log.

OPTIONS
-a server_name
Specify an archive server

-c config_file
Specify a VM configuration file to use for vmsnap

-d local_dir
Specify the local directory for backup.

-R
Specify the remote directory for backup on the archive server.

-g
List all available guest VMs for backup

List all available guest VMs for backup

COPYRIGHT
VMware ESX Server is Copyright 2000 VMware, Inc. All rights reserved.

DESCRIPTION
This program will perform a virtual snapshot of VMs on an ESX Server.
These virtual snapshots include the virtual disks, configuration file,
nvram file and log files related to the VM. This script will operate on
running VMs only. The backups are stored in vmdk format and are trans-
ferred to an Archive Server or Hot Standby Server.

This tool must be run as the 'root' user or as the owner of the VM(s) to
be backed up. This tool enables a hot backup of a VM's virtual disk
through the use of REDO logs as the snapshots(disk persistent mode).

For maximum flexibility, the .dsk file is converted to .vmdk files. These
.vmdk files are copied to the Archive Server and stored in /vmim-
ages/archivebackup/$guest or user specified location where $guest is the
name of the virtual machine.

The associated .cfg file (ESX Server 1.5.x) or .vmx file (ESX Server 2.x)
is copied to the Archive Server.

Usage : vmsnap [-a server_name] [-c config_file] [-d local_dir] [-R
remote_dir] [-g] [-h] [-l] [-m] [-r]

Limitations : Do NOT rename the vmdk files. This will break restoration
of the VM. VMDKs created under 2.x cannot be used under 1.5.2.

We only backup the persistent disks. In some rare cases, vm might get
stuck when we do not have enough space for the redo log.

OPTIONS
-a server_name
Specify an archive server

-c config_file
Specify a VM configuration file to use for vmsnap

-d local_dir
Specify the local directory for backup.

-R
Specify the remote directory for backup on the archive server.

-g
List all available guest VMs for backup

-h
Help

-V
Version

-l
Perform local backup only

-m
Generate the man page for this program

-r
Commit the redo logs in case they are already present

EXAMPLES
vmsnap -a test1 -c /root/vmware/linux/linux1 -d /dir1 -R /dir2

Takes the backup of /root/vmware/linux/linux1 to the archive server
test1 with local directory as /dir1 to the remote directory /dir2
on the archive server.

VMnix December 01, 2004 VMnix

vmres(1) System General Commands Manual vmres(1)

NAME
vmres - VMRes Utility Perform restore of VM backed up with the vmsnap
script

SYNOPSIS
vmres OPTIONS

COPYRIGHT
VMware ESX Server is Copyright 2000 VMware, Inc. All rights reserved.

DESCRIPTION
This program will perform a restore of a VM, backed up with the vmsnap
script, on an ESX Server. The backups are restored from vmdk form to dsk
format after transfer from the Archive Server or Hot Standby Server.

This tool must be run as the 'root' user. This tool enables a restore of
a hot backup of a VM.

By default, the local staging area on the recovery server is /vmim-
ages/localrestore. or user can specify the location of staging.

:

VMware Developer

SDKs, APIs, Videos, Learn and much more in the Developer community.

Learn More

Developer Sample Code

Increase your developer productivity with VMware API sample code.

Learn More

VMworld Sessions & Labs

Online access to the latest VMworld Sessions & Labs and online services.

Learn more

Purchase PSO Credits Online

Purchase credits to redeem training and consulting services online.

Buy Now

Community Hardware Software

View reported configurations or report your own.

Learn More

VMware vSphere

Come witness the next giant leap in virtualization.

Register Today

Communities