Restoring Files from Full Backup

For file-level restore from full backups created with Veeam Agent for IBM AIX 1.0, the product offers the ubax utility. To restore a file or directory, you must complete the following steps:  

  1. Prepare the restore script or choose the media library entry.
  2. Restore files and/or directories specified in the backup script or media library entry.

Preparing Restore Script

To restore data from a full backup created with Veeam Agent for IBM AIX 1.0, you must specify directories and/or files that you want to restore in the restore script. The restore script format is the same as the backup script format. The difference is that the restore script contains paths to one or more directories and/or files that you want to restore.

You can create a restore script based on the default backup script (/etc/veeam/scripts/veeam.scp) or a custom backup script that you used for data backup with Veeam Agent for IBM AIX 1.0.

The following example displays the restore script to restore a directory with files from a full backup.

: restore script
LogFile = /var/log/veeam/myrestore.log
SNumber = 1
/home/user2/* /SubDirs
/home/user2/tmp/* /Xclude
Redirections =
SRC=/home/user2/public
DST=/public
END

 

Choosing Media Library Entry

To restore data from a full backup created with Veeam Agent for IBM AIX 1.0, instead of using a restore script, you can use the media library. The media library comprises a number of entries that contain information about files and directories in the VTD file. Each media library entry contains an index of files and directories that were stored to a VTD file during a full backup session.

Technically, a media library entry is a file in the .lml format. The name of the file identifies the time when the full backup session was performed, for example: Wed Sep 19 12:02:15 2019.lml. By default, Veeam Agent for IBM AIX 1.0 creates media library entries in the /etc/veeam/media/ directory.

To restore data from a full backup using the media library, you must specify the necessary media library entry in the command used to perform restore. To learn more, see Performing Restore.

To view a list of media library entries, on the machine that runs Veeam Agent for IBM AIX 1.0 use the following command:

ls /etc/veeam/media/

 

Performing Restore

To restore a file or directory from a full backup created with Veeam Agent for IBM AIX 1.0, use the following command:

ubax --restore [restore options] [encryption options] [logging options] <path/to/script>

where </path/to/script> is a path to the restore script.

Data Restore Options

To perform restore with the ubax command, you can use the following options:

Option

Required

Description

--restore

Yes

Instructs ubax to perform restore.

--restore_all

No

Defines that all data from the backup file residing in the default backup location must be restored. Without this option specified, you must specify a path to the restore script that contains a list of files and/directories to restore.

--acl=<n>

No

Defines whether to use POSIX Access Control Lists (ACLs) during restore. Possible values:

  • 0 — Not to use ACLs
  • 1 — Use ACLs

The default value is 1.

--device=<device>

No

Specifies the name of the backup location where the backup file resides. The backup location must be defined in a configuration file.

--device_file=<file>

No

Specifies the configuration file where backup location settings are defined. The default file with information about backup locations is /etc/veeam/devices.ini.

--ini_file=<file.ini>

No

Specifies the configuration file where settings for the ubax utility are defined. The default configuration file is /etc/veeam/ubax.ini.

--mlfile=<file>

No

Specifies a path to the media library entry file that you want to use for data restore. If no file is specified, the latest media library entry will be used for data restore.

--overwrite=<n>

No

Defines whether to overwrite the existing files and directories during restore. Possible values:

  • 0 — Not to overwrite
  • 1 — Overwrite

The default value is 0.

--path_prefix

No

Specifies the path prefix that will be added to all restored paths.

--read_ml=<n>

No

Defines whether to use the backup script or media library for data restore. Possible values:

  • 0 — Backup script
  • 1 — Media library

The default value is 0.

--set_owner=<n>

No

Defines whether to preserve original file ownership during restore. Possible values:

  • 0 — Not to preserve
  • 1 — Preserve

The default value is 1.

--set_perms=<n>

No

Defines whether to preserve original file permissions during restore. Possible values:

  • 0 — Not to preserve
  • 1 — Preserve

The default value is 1.

--set_time=<n>

No

Defines whether to preserve original file time during restore. Possible values:

  • 0 — Not to preserve
  • 1 — Preserve

The default value is 1.

--snumber=<n>

No

Specifies the number of the dataset from which to restore data.

Encryption Options

No

You can specify data encryption options for the restore process. To learn more, see Data Encryption Options.

Logging Options

No

You can specify logging options for the ubax utility. To learn more, see Logging Options.

 

Data Encryption Options

You can use the following options of the ubax command to specify data encryption settings:

Option

Required

Description

--encryption_key=<key>

No

Specifies the encryption key used for backup. ASK should be used if the key is to be entered interactively, or SESSION if a session key is to be automatically generated.

--encryption_ref=<keyname>

No

Specifies the encryption key used for backup by reference to the key repository file.

--encryption_type=<n>

No

Specifies the encryption type. Possible values:

  • 0 — No encryption
  • 1 — AES256
  • 2 — Blowfish

The default value is 0.

--generate_key=<keyname>

No

Generates a new key with the name <keyname>.

--key_repository=<file>

No

Specifies the path to the encryption key repository file.

--passphrase_hash_type=<n>

No

Specifies the type of hashing used to generate an encryption key from a passphrase. Possible values:

  • 0 — No hashing
  • 1 — SHA256
  • 2 — SHA512
  • 3 — WHIRLPOOL

 

Logging Options

You can use the following options of the ubax command to specify logging settings:

Option

Required

Description

--append_log

No

Specifies whether to overwrite or append the log file. Possible values:

  • 0 — Overwrite
  • 1 — Append

The default value is 0.

--errfile=<file>

No

Specifies the error file. Note that this option does not use the --logdir option to form a path to the error file.

--err_level=<n>

No

Specifies the error file output level (the default value is 4). Note that the error level should be equal to or less than the logging level. For details, see the description of the log_level option below.

--logdir=<dir>

No

Specifies the path to the directory where the backup.log log file will be created. The default path is /var/log/veeam.

--logfile=<file>

No

Specifies the log file name. Note that this option does not use the --logdir option to form a path to the log file.

--log_level=<n>

No

Specifies the log file and screen output level. The following values are available:

  • 0 — Level 0 (NONE): no logging.
  • 1 — Level 1 (FATAL): only fatal errors are logged.
  • 2 — Level 2 (ERROR): only errors are logged.
  • 3 — Level 3 (WARNING): errors and warnings are logged.
  • 4 — Level 4 (INFO): errors, warnings and volume/area headers are logged.
  • 5 — Level 5 (PATH): all file and directory names are logged.
  • 6 — Level 6 (DEBUG): debugging information is logged.

The default value is 5.

--show_skipped=<n>

No

Defines whether to show skipped files and directories. Possible values:

  • 0 — Not to show
  • 1 — Show

The default value is 0.

--syslog=<n>

No

Defines whether to use syslog to record fatal events. Possible values:

  • 0 — Not to use syslog
  • 1 — Use syslog

The default value is 0.

 

Examples

The following example displays a simple command to perform file-level restore from a full backup using a restore script.

ubax --restore /etc/veeam/scripts/restore.scp

 

The following example displays a command to restore data from a specific dataset. Veeam Agent for IBM AIX is set to overwrite existing files during restore.

ubax --overwrite=1 --snumber=2 --restore /etc/veeam/scripts/veeam.scp

The following example displays a command to restore data using a media library entry.

ubax --overwrite=1 --restore --read_ml=1 --mlfile="Wed Sep 19 12:02:15 2018.lml"

 

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.