tw_restore

The tw_restore utility enables you to restore a BMC Discovery backup from a local directory on the appliance, an SSH enabled remote system, or a Windows share. The utility can be used on an appliance where the UI cannot be started. To use the utility, type the following command:

tw_restore [options]

where:

options are any of the options described in the following table and the common command line options described in Using-command-line-utilities.

Restoring backed up system data when a baseline run is in progress results in critical baseline alerts

Baseline is run periodically by the BMC Discovery system. Should baseline be running when a restore is started critical baseline alerts may be reported. The restore is unaffected by these alerts. The automatic baseline check schedule can be modified using the tw_cron_update. In order to minimize the chance of alerts no new periodic baseline checks are performed during the restore.

Common password options are described in this table

Common password options are described in this table to make it clear whether the password referred to is for the local or remote system.

Restore encrypted backups by using the UI

You cannot use tw_restore to restore encrypted backups. Rather, you should use the backup and restore page in the BMC Discovery UI.

User examples

In the following examples, the local username is system and the password is not specified on the command line. The remote SSH username is tideway and the password is password. The remote Windows share is called remshare, the corresponding username is remdom/tideway and the password is password.

The utility prompts for the local password after you enter the command. Type the commands on a single line; line breaks are provided in the examples to make them easier to read.

Verifying a local backup

$TIDEWAY/bin/tw_restore --verify-only --backup-local --username system

Verifying a remote backup on an SSH server

$TIDEWAY/bin/tw_restore --verify-only --backup-ssh --backup-dir=/usr/tideway/var/backup
--remote-user=tideway --remote-password=password --host=de-32.bmc.com
--username system

Verifying a remote backup on a Windows share

$TIDEWAY/bin/tw_restore --verify-only --backup-smb --share=remshare
--backup-dir=2012-10-08_115740_addm_backup --remote-user=remdom\/tideway
--remote-password=password --host=192.168.1.101 --username system

You must escape / characters as shown in the Windows share examples.

Performing a restore from a local backup

$TIDEWAY/bin/tw_restore --stop-services --backup-local --username system

Performing a restore from an SSH server

$TIDEWAY/bin/tw_restore --stop-services --backup-ssh --backup-dir=/usr/tideway/var/backup
--remote-user=tideway --remote-password=password --host=de-32.bmc.com --username system

Performing a restore from a Windows share

$TIDEWAY/bin/tw_restore --stop-services --backup-smb --share=remshare
--backup-dir=2012-10-08_115740_addm_backup --remote-user=remdom\/tideway
--remote-password=password --host=192.168.1.101 --username system