NetBackup102 AdminGuide BMR
NetBackup102 AdminGuide BMR
Restore™ Administrator's
Guide
Release 10.2
NetBackup™ Bare Metal Restore™ Administrator's
Guide
Last updated: 2023-03-17
Legal Notice
Copyright © 2023 Veritas Technologies LLC. All rights reserved.
Veritas, the Veritas Logo, Veritas Alta, and NetBackup are trademarks or registered trademarks
of Veritas Technologies LLC or its affiliates in the U.S. and other countries. Other names may
be trademarks of their respective owners.
This product may contain third-party software for which Veritas is required to provide attribution
to the third party (“Third-party Programs”). Some of the Third-party Programs are available
under open source or free software licenses. The License Agreement accompanying the
Software does not alter any rights or obligations you may have under those open source or
free software licenses. Refer to the Third-party Legal Notices document accompanying this
Veritas product or available at:
https://www.veritas.com/about/legal/license-agreements
The product described in this document is distributed under licenses restricting its use, copying,
distribution, and decompilation/reverse engineering. No part of this document may be
reproduced in any form by any means without prior written authorization of Veritas Technologies
LLC and its licensors, if any.
The Licensed Software and Documentation are deemed to be commercial computer software
as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19
"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, et seq.
"Commercial Computer Software and Commercial Computer Software Documentation," as
applicable, and any successor regulations, whether delivered by Veritas as on premises or
hosted services. Any use, modification, reproduction release, performance, display or disclosure
of the Licensed Software and Documentation by the U.S. Government shall be solely in
accordance with the terms of this Agreement.
Technical Support
Technical Support maintains support centers globally. All support services will be delivered
in accordance with your support agreement and the then-current enterprise technical support
policies. For information about our support offerings and how to contact Technical Support,
visit our website:
https://www.veritas.com/support
You can manage your Veritas account information at the following URL:
https://my.veritas.com
If you have questions regarding an existing support agreement, please email the support
agreement administration team for your region as follows:
Japan [email protected]
Documentation
Make sure that you have the current version of the documentation. Each document displays
the date of the last update on page 2. The latest documentation is available on the Veritas
website:
https://sort.veritas.com/documents
Documentation feedback
Your feedback is important to us. Suggest improvements or report errors or omissions to the
documentation. Include the document title, document version, chapter title, and section title
of the text on which you are reporting. Send feedback to:
You can also see documentation information or ask a question on the Veritas community site:
http://www.veritas.com/community/
https://sort.veritas.com/data/support/SORT_Data_Sheet.pdf
Contents
BMR backup and restore job details does not display on the NetBackup
web UI's activity monitor ........................................................ 215
Component Description
NetBackup and BMR master The NetBackup master server that manages backups and
server restores of the protected client systems. A NetBackup master
server also hosts the BMR master server then manages BMR
operations.
NetBackup media servers NetBackup media servers control storage devices on which
the client files are stored.
BMR boot servers Boot servers provide the environment that is required to
rebuild a protected client, including system recovery and
critical resources such as shared resource trees (SRTs).
Shared resource trees contain the software that is used to
rebuild the protected system so that NetBackup can restore
the original files. The software includes the operating system
software and the NetBackup client software.
For more illustration about downloading Microsoft ADK and creating SRT on an
offline boot server, refer Create SRT on online and offline boot server diagram.See
“Creating SRT on an offline boot server or host ” on page 43.
Red Hat Enterprise NetBackup BMR supports the GUID Partition Table (GPT) disk types
Linux 7.x, 8.x and the Dissimilar Disk Restore (DDR) functionality similar to the BIOS
clients. The supported BMR features on UEFI machine are Self-restore,
DDR, and Dissimilar System Recovery (DSR). Dissimilar System
Restore support is extended to UEFI clients. For details refer the tech
note.
https://www.veritas.com/support/en_US/article.000034868
The newly created Shared Resource Tree can be used to boot BIOS
as well as UEFI machines. In addition the VFAT file system is also
supported.
Note: The support for Linux multi-devices is limited and BMR may not
restore the exactly some configurations.
Windows ■ For UEFI, and Legacy BIOS booted machines, NetBackup BMR
supports self-restore, Dissimilar Disk Restore (DDR), and Dissimilar
System Recovery (DSR) for both Legacy MBR and GUID Partition
Table (GPT) disk types.
■ For UEFI systems and BIOS system having GPT disks, NetBackup
BMR doesn't support Direct virtual machine (VM) creation (Physical
to Virtual).
The newly created Shared Resource Tree can be used to boot BIOS
as well as UEFI machines. In addition the FAT32 file system is also
supported.
Chapter 2
Configuring BMR
This chapter includes the following topics:
After you have setup the BMR master server, you can configure backup policies
to collect BMR required information from NetBackup clients.
Note: You need to restart NetBackup services, after you run the bmrsetupmaster
command on the master server.
Note: The BMR master server needs to be configured on the NetBackup primary
server before the BMR boot server is configured.
Note: Before you configure a BMR Boot server on a NetBackup host, make sure
that the NetBackup host is configured with the NetBackup primary server. Refer to
the NetBackup Administrator's Guide for registering the NetBackup client with the
NetBackup primary server.
After you run the command, you can see the boot server name in the NetBackup
web UI: Bare Metal Restore > Hosts > Boot Servers. This command starts the
BMR Boot server daemon running.
/usr/openv/netbackup/bin/rc.bmrbd stop
■ When you create SRTs, choose a location on a file system on the shared disk.
■ If a boot server fails over and restore tasks are not completed, perform a new
prepare-to-restore operation for each incomplete restore task.
■ Install the BMR boot server software on each node. Switch the virtual address
to each node before you install the boot server software.
■ Create a cluster application resource that calls the start and stop script for the
boot server services:
■ When you create SRTs, choose a location on a file system on the shared disk.
■ If a boot server fails over with restore tasks to be done, perform a new
prepare-to-restore operation for each pending restore task.
Every NetBackup master server includes the NetBackup client software by default.
Therefore, you can run a BMR Boot server on either a NetBackup master server
or a client (if BMR supports that platform).
Configuring BMR 21
Deactivating BMR servers
3 The BMR Boot Server is registered. You can close the command prompt.
The following screen shot shows the registration of BMR Boot Server.
On UNIX/Linux run
\usr\openv\netbackup\bin\bmrsetupboot -deregister
On successful execution of the command, the boot server instance is not visible in
NetBackup web UI: NetBackup web UI > Bare Metal Restore > Hosts > Boot
servers. De-registering command stops the BMR Boot server daemon running.
Note: BMR Boot server deactivation does not remove SRTs hosted by the BMR
Boot server. The SRTs will exist in case they need to be imported by another BMR
Boot server or the same Boot server if enabled again in the future. On de-registering
BMR boot server on windows, BMR PXE and TFTP services will be removed along
with BMR boot server service.
Chapter 3
Protecting clients
This chapter includes the following topics:
Each protected client must be backed up regularly by at least one policy that
performs a full backup. The policy also can perform cumulative incremental or
differential incremental backups, but a full backup must occur.
The backup saves the files of the computer on a storage device that NetBackup
media server manages. The backup saves the configuration of the client on the
BMR master server.
After a client is backed up by a policy that is configured for BMR protection, the
client is registered with BMR as a protected client. It then appears in the Bare Metal
Restore > Hosts > Bare Metal Restore Clients view in the NetBackup web UI.
Note: Enabling the attribute 'Collect disaster recovery information for BMR"
automatically sets the "Collect true image restore information and with move
detection" attribute.
These attributes enable NetBackup to restore only those files present on the
system at the time of the backup. Move detection enables NetBackup to restore
the files correctly that were moved, renamed, or newly installed. These attributes
also ensure that all of the restored files fit in the volumes and the file systems
that BMR created during the recovery.
Note: User-initiated backups do not provide BMR protection because true image
restore information is not collected during a user-initiated backup.
Note: Similar option to enable the BMR backup is also available under the
Policy management tab, in the NetBackup web UI.
Protecting clients 25
Backing up BMR clients
■ For clustered clients, the most effective backup strategy uses multiple policies.
Each node should have its own policy that backs up local file systems. Shared
file systems should be backed up by the additional policies that back up the
node that currently owns the resources.
■ In case of multiple policies configured for the same client for different backup
selection, then scheduling all policies to run at the same time will help achieve
consistency post recovery.
■ NetBackup media servers can be protected as BMR clients. Media servers that
back up to their own storage devices (either SCSI-attached or SAN-attached)
require special procedures for restores. If you understand these procedures,
you can configure NetBackup to minimize the time and effort that the restores
require.
See “About restoring NetBackup media servers” on page 132.
For information about configuring backup policies, see the NetBackup Administrator’s
Guides.
Protecting clients 26
Backing up BMR clients
/usr/openv/netbackup/baremetal/client/data/ClientCustomFiles
Specify one custom file per line, using the full path name to the file. Use a pound
sign (#) as the first character of comment lines.
After custom files are saved (when the client is backed up), they are copied to the
SRT. They are available during the restore when you enable the SRT for exclusive
use. More information is available on how to enable the SRT.
See “Enabling or disabling SRT exclusive use” on page 74.
When you specify a custom file, it does not remove it from backups. Custom files
are also backed up by NetBackup and then restored when NetBackup restores the
client files. (They are backed up and restored if the files or their directories are
included in the backup directives of the policy.)
Protecting clients 28
Monitoring client backups
Note: It is advisable to keep the system disk under the control of Windows Disk
Manager and not SFW. This way you can recover the system using BMR fast
recovery method and then later get back the SFW volumes.
Note: BMR does not restore the disks that are marked as 'Restricted" and these
disks are maintained as is.
Chapter 4
Setting up restore
environments
This chapter includes the following topics:
■ Recovery steps
Recovery steps
Before you can restore a protected client, you must set up the restore environment
that is used during the restore process.
You can set up the environment at any time. However, if your recovery time objective
(RTO) is short, you may want all of the resources in place. Your time is used in
recovery rather than set up.
Note: Once BMR Media SRT is created, BMR bootserver is not required during
the recovery.
More information is available about boot media and procedures for creating boot
media. Refer chapter Managing boot media for details.
See “Managing boot media” on page 77.
Setting up restore environments 33
Preparing client for restoration
■ For Windows systems: A single SRT can restore all Windows versions of the
same architecture.
For UNIX and Linux systems, you create SRTs on boot servers of the same
operating system. The boot server must run the same version or a later version of
the operating system that is installed in the SRT. For example, a Solaris 11 SRT
must reside on a Solaris 11 or later boot server. For Windows systems, any version
of Windows can host the SRT.
For more information about supported operating systems for clients, SRTs, and
boot servers, see the NetBackup Release Notes.
During a restore, a client accesses the SRT from a boot server over a network, or
on a CD or DVD. Although SRTs reside on boot servers, you can copy an SRT to
CD media or DVD media, boot the client from that media, then access the SRT on
that media. If you are using a BMR Media, you do not require the boot server during
recovery.
Depending on the operating system for which an SRT is created, the SRT size
requirement can vary from 100 MB to 1 GB of disk space.
For more information about disk space requirements, see the NetBackup Release
Notes.
To create an SRT, you need the installation software or images for the following
items:
■ Operating system (UNIX and Linux only).
Shared resource trees 36
Creating a shared resource tree
■ For Linux SRTs, the Bare Metal Restore third-party products CD. This CD
contains the open source products that may not be included in the vendor Linux
distribution.
■ Place the installation program in a removable media drive of the boot server.
Then provide the path to that removable media drive.
■ Copy the contents of the installation program to a local directory. Then provide
the path to that local directory.
■ Copy the installation program contents to a remote directory, available to the
boot server through NFS or network share. Then provide the path to that remote
directory or share location.
The amount of time that is needed to create an SRT is between 5 minutes to 60
minutes. It depends on the speed of the system, the operating system of the SRT
being created, and other software being installed.
See “Creating an SRT for UNIX or Linux” on page 51.
See “Creating an SRT for Windows” on page 37.
Create an SRT
BMR SRT provides the resources that are needed to boot the client system and
begin the restore process. BMR Windows SRT uses Windows Pre-Installation
Environment (WinPE) as base recovery environment. In order to create this base
WinPE recovery environment, you need to install Microsoft Assessment and
Deployment Kit (ADK) version 10 on the host. Microsoft ADK installation is essential
while creating new SRT for the first time. There are different options available to
setup ADK on BMR boot server host as explained below:
■ BMR Shared Resource Tree administration wizard can install it using:
■ Automatic download of ADK and installation
■ Use remotely downloaded ADK installer for creating the SRT
Name The name of the SRT is also used for the directory that
contains it. Only alphanumeric characters and the
underscore (_) character are allowed.
Target Directory Enter the path or browse the location of target of SRT.
For installing the Microsoft ADK, following two options are available:
■ Automatic downloading and installing the ADK option
■ Using the already downloaded ADK on the remote site to install it on the current
host
Wait till all the prechecks are completed and then click Next.
SRT can be imported on any other registered boot server thereby eliminating the
need of ADK installation on those boot servers without internet connectivity. Refer
section Importing the SRT autimatically.
Shared resource trees 45
Creating a shared resource tree
Note: The duplicate SRTs (SRT created on master-less boot server whose name
already exists on master server’s database) will not get auto-imported.
Export SRT
This option enables you to export any SRT which is in ready state. Exporting an
SRT creates a compressed file of 1 GB size containing ADK executable, SRD files
(for both x86 and amd64) and SRT. wim file. This compressed file can be imported
at any other boot server.
Note: CD/ISO based SRTs export is not supported. Before exporting any SRT to
network location, make sure that network location is already authenticated and
accessible.
Edit an SRT
This panel lets you edit SRT parameters.
In certain scenarios, you may need to modify the SRT contents. For example, add
a new binary to the SRT as part of applying a new release update to the existing
BMR version. In such scenarios, you first need to mount the SRT and then modify
its contents.
The Explore SRT option automatically mounts the selected SRT and shows it in a
file explorer view where you can add any new binaries or even modify existing ones.
Shared resource trees 47
Creating a shared resource tree
This option is particularly useful when user would like to apply any engineering
binary within the SRT.
If you manually modify an SRT, it may not function properly. In this case, you need
to follow the guidelines that Veritas Support provides with the release update content.
Import an SRT
This option lets you import an existing SRT in a form of a compressed executable
file. The SRT to be imported from another host should be first exported from the
remote host. Refer section Exporting the SRT for the specific steps. After you export
an SRT, while importing the SRT to a new location, following operations are
observed on the boot server.
■ Extract cab contents on the boot server at the specified path.
■ Copy Mini-ADK (OSCDIMG.exe)
■ Copy SRD files (both x86 and amd64).
■ Copy SRT.wim file at specified path.
■ Add entry of SRT in master database.
■ Modify entry of SRT in local database.
Shared resource trees 49
Creating a shared resource tree
Copy an SRT
This option enables you to copy an existing SRT from one boot server to other.
Copy operation is always preferred over re-creating a new SRT as it is faster.
Perform the below steps in order to copy an SRT:
■ Select the SRT to copy.
■ Enter a name for the new SRT. The SRT name should not contain more than
eight alphanumeric characters.
■ Enter a description for the new SRT.
■ Enter a path to or browse to select the location to create the new the SRT.
Delete an SRT
Select the SRT to delete, then click OK in the confirmation dialog box.
Note: An SRT which is in the mounted state or opened for editing cannot be deleted.
Select an SRT
Select the shared resource tree that you want to turn into a bootable CD or DVD
image to be used for the restore.
An SRT must contain a NetBackup client image that is the same version as the
system(s) to be protected.
If the SRT already contains a NetBackup client image, it is replaced.
An SRT without a NetBackup client is in the Locked state. Ready state indicates
a NetBackup client image is installed.
service should be installed separately into SRT. If you use NetBackup Access
Management to administer access to your NetBackup environment, install the
NetBackup Security Services (VxSS) software for NetBackup client older version.
For more information about Access Management components and how to use
Access Management, see the NetBackup Security and Encryption Guide .
You would need to perform following steps to add NetBackup Security Services to
an SRT:
■ Select the shared resource tree to which you want to add the NetBackup Security
Services image.
■ Select the version of NetBackup security service.
■ Enter the path to the setup file (in .exe format) or browse to select the image.
/usr/openv/netbackup/bin
./bmrsrtadm
Shared resource trees 53
Creating a shared resource tree
3 When you are prompted, select the option to create a new SRT.
Shared resource trees 54
Creating a shared resource tree
Enter the name of the SRT to The name of the SRT that is also used for the
create directory that contains it.
Enter desired OS level of AIX Enter the levels you can create based on the
operating system version of the boot server.
Enter the directory in which The path to the directory in which to create
to place the new SRT the SRT. The root of the SRT (called the SRT
path) is the path name to the SRT location,
which includes the SRT name.
Source of AIX install images Enter the name of the device where the
operating system installation program is
inserted or enter the path to the installation
image.
Enter the source of the Enter the device name where the NetBackup
NetBackup install images. client software installation program is inserted
or enter the path to the installation image.
Specify a device name or an
NFS path (host:/path form), After you enter the device name or path, the
or a local directory NetBackup client installation procedure
installs the client software into the SRT.
Enter the name of the Enter any non-blank value. The server name
NetBackup server: is replaced at restore time with the correct
values for the BMR client being restored.
Would you like to use Accept the default or enter any non-blank
servername as the configured value. The client name is replaced at restore
name of the NetBackup client? time with the correct values for the BMR client
[y,n] (y) being restored.
After you install the AIX and NetBackup software, the bmrsrtadm command provides
options to install other software in the SRT. You can either add other software now
or quit (you can add software later). During step NetBackup client installation
into SRT you might get an error message if the operating system architecture type
and NetBackup client version are incompatible.
More information is available about how to add other software.
See “Adding software to a shared resource tree” on page 66.
/usr/openv/netbackup/bin
./bmrsrtadm
Shared resource trees 56
Creating a shared resource tree
3 When you are prompted, select the option to create a new SRT.
4 Complete the command prompts as indicated in following table.
Enter the name of the SRT to The name of the SRT also is used for the
create directory that contains it.
Enter the directory in which to The path to the directory in which to create
place the new SRT the SRT. The root of the SRT (called the
SRT path) is the path name to the SRT
location, which includes the SRT name.
■ Ignite-UX/BOOT-KERNEL/opt/ignite/data
■ Ignite-UX/BOOT-KERNEL/opt/ignite/boot
■ Ignite-UX/BOOT-KERNEL-PA/opt/ignite/data
■ Ignite-UX/BOOT-KERNEL-PA/opt/ignite/boot
If the BOSdatapath directory is not found,
BMR looks for a file named INSTCMDS
from the tar file supplied in one the
following directories: (Note that -PA
indicates Ignite version B41.)
■ Ignite-UX/BOOT-KERNEL/opt/ignite/data
■ Ignite-UX/BOOT-KERNEL-PA/opt/ignite/data
Enter the location (device or The variable x.x is the SRT operating
directory path) of the HP-UX x.x system version.
install media
These patches can be found on Note: To create SRT for HP-UX 11.11
an HPE support plus media, or PARISC, a new patch PHCO_36006 is
they can be downloaded from the required. This patch is available in HP-UX
HPE web site. 11.11 ‘Dec_2009_11i_GoldPack’ patch
bundle. You need to download this patch
Location (device or path) of the bundle and then install the patch
media that contains patch_list: PHCO_36006 by providing the location of
Dec_2009_11i_GoldPack.
Shared resource trees 58
Creating a shared resource tree
Location (device or path) of the Enter the name of the device where the
Veritas NetBackup install media NetBackup client software installation
media is inserted or enter the path to the
installation image.
Enter the name of the NetBackup Enter any non-blank value. The server
server: name is replaced at restore time with the
correct values for the BMR client being
restored.
Would you like to use servername Accept the default or enter any nonblank
as the configured name of the value. The client name is replaced at
NetBackup client? [y,n] (y) restore time with the correct values for the
BMR client being restored.
After you install the HP-UX and NetBackup software, the bmrsrtadm command
provides options to install other software in the SRT. You can either add other
software now or quit (you can add software later).
More information is available about how to add other software.
See “Adding software to a shared resource tree” on page 66.
/usr/openv/netbackup/bin
./bmrsrtadm
Shared resource trees 60
Creating a shared resource tree
3 When you are prompted, select the option to create a new SRT.
Shared resource trees 61
Creating a shared resource tree
Enter the name of the The name of the SRT also is used for the directory
SRT to create that contains it.
Enter desired level of Enter the levels you can create based on the operating
Solaris/SunOS system version of the boot server.
Enter the directory in The path to the directory in which to create the SRT.
which to place the new The root of the SRT (called the SRT path) is the path
SRT name to the SRT location, which includes the SRT
name.
Note: SRT creation requires developer studio 12.6 runtime patches in SRT. The
patches can be downloaded from https://www.oracle.com
Enter the local diretory path containing the patches extracted from
OracleDeveloperStudio12.6-solaris-<platform>-pkg.tar.bz2:
Make sure that the ISO path is provided when prompted and not the mounted location.
Follow the instructions mentioned in the article to the extract patch file (with tar.bz2
extension).
/<extractedPatchDir>/OracleDeveloperStudio12.6-solaris-<platform>-pkg/patches/system
folder
After you enter the device name or path, the operating system is installed into the SRT.
Shared resource trees 62
Creating a shared resource tree
Enter a [hostname:]/ Enter the name of the device in which the NetBackup
pathname containing software installation media is inserted or enter the path
NetBackup client to the installation program (named install).
software
After you enter the device name or path, the
NetBackup installation procedure installs the client
software into the SRT.
Enter the name of the Enter any nonblank value. The server name is replaced
NetBackup server: at restore time with the correct values for the BMR
client being restored.
Would you like to use Accept the default or enter any nonblank value. The
servername as the client name is replaced at restore time with the correct
configured name of the values for the BMR client being restored.
NetBackup client? [y,n]
(y)
After you install the Solaris and NetBackup software, the bmrsrtadm command
provides options to install other software in the SRT. You can either add other
software now or quit (you can always add software later).
More information is available about how to add other software.
See “Adding software to a shared resource tree” on page 66.
During this process, the bmrsrtadm command copies files from BMR third-party
installation program to the following directory:
/usr/openv/netbackup/baremetal/server/data/media
Each time thereafter that you create an SRT on that boot server, bmrsrtadm uses
those installation files. You do not have to enter the path to the third-party product
image again. If you want to be prompted for the installation program or image
location again, remove the media directory before running bmrsrtadm.
The BMR third-party products CD is distributed as an ISO file system image. You
can download the image and use it as the source image or write it to CD media.
To create a Linux SRT
1 On the boot server where you want to create the SRT, change to the following
directory:
/usr/openv/netbackup/bin
./bmrsrtadm
Shared resource trees 64
Creating a shared resource tree
3 When you are prompted, select the option to create a new SRT.
Shared resource trees 65
Creating a shared resource tree
Enter the name of the SRT to The name of the SRT also is used for the
create directory that contains it.
Enter the directory in which to The path to the directory in which to create
place the new SRT the SRT. The root of the SRT (called the
SRT path) is the pathname to the SRT
location, which includes the SRT name.
The following media is required: The Linux distribution (Red Hat or SUSE)
and the required disk.
Linux distribution - disk x of
x The bmrsrtadm command prompts you
for several of the Linux installation discs.
Please load the media now.
Some systems try to mount the media that
Load media from:
is loaded in the CD drive automatically
(such as the Red Hat magicdev process).
When you are prompted for media on those
systems, do the following: load the media
into the drive, close the drive tray, and wait
for the drive light to stop flashing before
pressing Enter.
The following media is required: Enter the name of the device in which the
BMR third-party products CD is inserted
BMR third-party products CD
or enter the path to the installation image.
(3PPCD)
This CD contains open source the
Please load the media now.
components that BMR uses on Linux
Load media from: systems.
Shared resource trees 66
Managing shared resource trees
The following media is required: Enter the name of the device in which the
NetBackup client software installation
NetBackup x.x Client
media is inserted or enter the path to the
Please load the media now. installation image.
Load media from: After you enter the device name or path,
the NetBackup client installation procedure
installs the client software into the SRT.
Enter the name of the NetBackup Enter any nonblank value. The server
server: name is replaced at restore time with the
correct values for the BMR client being
restored.
Would you like to use servername Accept the default or enter any nonblank
as the configured name of the value. The client name is replaced at
NetBackup client? [y,n] (y) restore time with the correct values for the
BMR client being restored.
After you install the Linux and NetBackup software, the bmrsrtadm command
provides options to install other software in the SRT. You can either add other
software now or quit (you can always add software later).
More information is available about how to add other software.
See “Adding software to a shared resource tree” on page 66.
Note: Use only the specific options from this list to add products to an SRT.
If you did not add required NetBackup software when you created the SRT, a prompt
appears to add it when you select the modify option.
After you add the NetBackup software when you create an SRT, the bmrsrtadm
command provides options to install other software in the SRT.
To add software to a UNIX or Linux SRT
1 On the BMR boot server where the SRT resides, change to the following
directory:
/usr/openv/netbackup/bin
2 Enter the following command:
./bmrsrtadm
3 When you are prompted, select the option to modify an existing shared resource
tree.
Shared resource trees 68
Managing shared resource trees
Enter the full path to the location of the installation program or image.
software to the copies. To copy an existing SRT usually is faster than to create an
SRT.
Identify any prerequisites that VxVM and VxFS require, such as operating system
patches. Install them in the appropriate order before you install VxVM and VxFS.
Warning: On Solaris systems, verify that any patches support the patchadd -C
flag. Only install patches that support the patchadd -C flag into the SRT. Most
patches for VxFS and VxVM do not support the patchadd -C flag. Test results
show that the clients that use patched versions of VxFS and VxVM can perform a
restore successfully. They perform restores successfully even when they use an
SRT that contains unpatched versions.
The Install Veritas Volume Manager and Veritas File System option in the
bmrsrtadm command prompts you to:
You do not have to untar and uncompress the packages before you install them in
an SRT. When you are prompted for the path to each component, enter a path to
the extracted packages. Or enter a path to the root directory of the installation
program (the directory that contains the file_system and volume_manager
directories).
For more information about operating system dependencies for VxVM and VxFS,
see OSCL matrix on https://www.veritas.com/support/en_US/article.100040093
When you install other software, you are prompted for the following: the location of
the installation program, image, package, patch, fileset, rpm, and so on (depending
on operating system).
See “About installing patches and packages into Solaris SRTs” on page 70.
See “Installing device drivers into Linux SRTs” on page 70.
Choose option 1 to add additional Linux kernel drivers (.o, .ko) files into the SRT.
This option can be used to add the drivers which are not present into the Linux
installation media by default and need to be loaded during BMR restoration.
Note: In NetBackup 7.6.1.2 and later versions, Windows Boot Servers do not support
importing SRTs of versions 6.X , 6.5.X, and 7.6.
Starting Windows 7.6.1.2, Windows Boot Servers do not support import of old
Legacy SRT.
/usr/openv/netbackup/bin
./bmrsrtadm
3 When you are prompted, select the option to copy an existing shared resource
tree.
4 When you are prompted, enter the required information, as follows:
■ The name of an existing SRT to copy
■ The name for the new SRT
■ The path on the boot server in which to create the SRT
■ The description of the SRT
■ (Linux only). The path to the device in which the BMR third-party options
CD is inserted or an installation image of the BMR third-party options CD
(Only if the SRT is copied to a Linux boot server where an SRT has not
been created.)
/usr/openv/netbackup/bin
./bmrsrtadm
3 When you are prompted, select the option to delete an existing shared resource
tree.
4 When you are prompted, type the name of the SRT and press Enter.
5 When you are asked if you want to delete the SRT, enter y to delete the SRT.
If the SRT is locked, this operation fails.
See “Breaking a stale shared resource tree lock” on page 76.
Note: If you enable an SRT for exclusive use before custom files are saved for that
client, the prepare-to-restore or prepare-to-discover process fails.
Shared resource trees 75
Managing shared resource trees
3 When you are prompted, select the option to modify an existing shared resource
tree.
4 When you are prompted, enter the name of the SRT to modify.
5 When you are prompted, select the option to change exclusive use of the SRT.
6 When you are prompted, do either of the following:
■ To enable exclusive use, enter a client name.
■ To disable exclusive use, press Enter without entering anything.
3 Enter the number of the option to modify an existing shared resource tree.
Shared resource trees 76
Managing shared resource trees
4 When you are asked for the name of an SRT, enter the name of the damaged
SRT.
5 When you are asked if you want to continue, enter y.
The bmrsrtadm program attempts to repair the SRT. The program guides you
through installation of any missing SRT components.
If repair is successful, the bmrsrtadm modify menu appears. When you quit
the program, the SRT is in a READY state.
3 When you are asked for a select, provide the number of the option to modify
the Shared Resource. The following appears:
Enter the name of an existing SRT :
Shared resource trees 77
Managing boot media
4 When you are asked for the name of an existing SRT, enter the name of the
locked SRT and press Enter.
Warning: Do not attempt to break an SRT lock unless you are positive that
the SRT is stale. If you break the lock of an SRT while it is in use, it may become
corrupted.
5 When you are asked if you are sure that you want to break the lock, enter y to
break the lock.
The stale lock is broken.
The bmrsrtadm command modify menu appears.
When you quit the program, the SRT is in a READY state.
■ BMR does not use the CD/DVD image file after it is created. Therefore, you can
move, rename, or delete the image file after you write the CD/DVD.
# eject
# /etc/init.d/volmgt stop
2 On the boot server on which the SRT resides, change to the following directory:
/usr/openv/netbackup/bin
Shared resource trees 80
Managing boot media
4 When you are prompted, select the option to create a new CD/DVD
image-based shared resource tree.
5 Continue by referring to the information about the operating system.
See “About boot media for AIX” on page 80.
See “About boot media for HP-UX” on page 80.
See “About boot media for Linux” on page 81.
See “About boot media for Solaris” on page 81.
Note: The Roxio Easy CD/DVD Creator recording program does not work for HP-UX
images.
Enter 1 or 2. Then enter the name of the disk group or the device file for the
raw partition. If you use a raw partition for temporary storage, you are prompted
to continue.
■ If Veritas Volume Manager (VxVM) is not installed on the BMR boot server, the
following appears:
Enter the name of the device file for the raw partition. Then respond to the next
prompt if you want to continue.
After the CD/DVD image is created, restart the vold process (/etc/init.d/volmgt
start) if you stopped it before running the command bmrsrtadm.
To restore to the same client and use the See “About restoring BMR clients using
most recent backup network boot” on page 93.
To restore a client in which the disks are See “About restoring to dissimilar disks”
different on page 122.
To restore a BMR boot server See “About restoring BMR boot servers”
on page 135.
To customize the restore process See “About external procedures” on page 135.
■ The client runs a temporary operating system environment that is known as the
restore environment. The restore environment starts from the shared resource
tree.
■ The client restore environment retrieves the restore script and configuration files
from the master server.
■ The client restore environment starts the customized restore process, which
configures disks.
■ The client restore environment performs an automated restore using the
NetBackup client software, which restores all required files and data from the
NetBackup server.
■ The client reboots, which starts the restored operating system and de-allocates
the boot server.
■ Dissimilar system restore tasks are completed (dissimilar system restore only).
Figure 6-1 shows a standard network restore.
1 2 3
UNIX Client
Boot server
Windows Client Accesses system files and client Restores files from the
software from the SRT on the boot NetBackup backup image
server
1 2 3
BMR Client
NetBackup media
server (backup image)
CD-based SRT or
DVD-based SRT
Boots from a BMR
prepared CD or DVD
5 Click OK.
Bare Metal Restore runs all the processes to prepare for a restore.
When you click Prepare to Restore, validation checks are performed pertaining
to the different parameters such as SRT version, configuration version, and
so on.
■ If the validation checks for prepare to restore are successful, then the client
is marked for automatic recovery. This automatic recovery is by default
valid for 48 hours. Master server authenticity is validated automatically and
a host-ID based certificate is automatically issued to this client during the
automatic recovery process.
Use the nbhostmgmt command to verify whether the client is marked for
automatic recovery.
For more information about the automatic recovery and the host-ID based
certificate, refer to the NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
https://www.veritas.com/support/en_US/article.DOC5332
■ If the validation checks fail, appropriate error messages are displayed.
Follow the instructions that are provided in the message.
For more information, See “Error messages for prepare to restore, prepare
to discover, and the bmrprep command with reference to secure
communication in BMR” on page 206.
6 After the processes finish, in the dialog box that appears, click OK.
The client is listed in the Bare Metal Restore Tasks in Queued state. The
Prepare-To-Restore step may take few minutes to complete.
To clean up the restore configuration
1 In the NetBackup web UI, click Bare Metal Restore > BMR Tasks.
2 In the details pane, right-click the client for which you want to clean up the
restore configuration.
3 Select Clean Up from the shortcut menu.
The resources that the task uses are unallocated, the State is set to Done,
and Status is set to 150, terminated by user.
■ To import a disk means that BMR tries to reuse the volumes on it (that is, mount
the file systems automatically after restore). BMR tries to reuse rather than
format the disk and restore files to it.
BMR always restores the system disk. For other disks, the following two options
on the Prepare to Restore Client dialog box control BMR behavior:
■ Restore system disks/volumes only.
■ On AIX and HP-UX, the root volume groups (rootvg and vg00) are restored.
■ On Solaris, all disks that have any of the root file systems (/, /swap, /var,
/usr) are restored.
■ New disks are attached to the system in previously unused locations and
used by any volume or any volume group. New disks are not in the original
configuration.
BMR also restricts some disks so they are not processed during a restore. For
example, BMR restricts shared disks in a cluster and unused VxVM disks on Solaris
systems. Additionally, you can restrict a disk manually so that BMR does not process
it.
■ System only is the Restore system disks/volumes only option for prepare
to restore
■ Import is the Make available volumes on non-restored disks after the system
is restored option for prepare to restore
To avoid conflicts with other cluster nodes that may use surviving shared disks
during a restore, shared disks should remain restricted or be unmapped or remapped
to alternate, non-shared restorable locations. Shared disks should only be
unrestricted and restored in-place if other cluster nodes do not hold the share
actively during the restore.
System only = Import Import No action Mark the restricted disk, remap to a Not
true and import = restorable disk, or remove the disk from imported
true the restore configuration
System only = Restore Import No action Mark the restricted disk, remap to a Not
false and import = restorable disk, or remove the disk from imported
true the restore configuration
System only = Restore Remove the disk No action Mark the restricted disk, remap to a No action
false and import = from the restore restorable disk, or remove the disk from
false configuration or the restore configuration
mark the disk
restricted
AIX logical volume manager Run importvg at restore time or during first boot.
Veritas Storage Foundation for Assign drive letter by MountedDevices, run vxdg import.
Windows
Use these procedures for a standard restore (also known as a self restore, which
is a restore to the same system and disks).
Use the bpnbat -ShowMachines command on the master server to view the name
of the added machine.
To restore using media boot requires that you Refer sections on creating boot media.
first create bootable media.
Before you do a standard restore, you must See “Preparing a client for restore”
run the prepare to restore operation using the on page 86.
current, saved configuration.
The procedure for restoring the client system See “Restoring an AIX client with network
depends on the manufacturer and mode. boot” on page 94.
Other information about restoring clients is See “About external procedures” on page 135.
available.
See “About performing complete backups”
on page 26.
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
An AIX boot (either network boot or media boot) may set the network interface
configuration, speed, and duplex mode to auto-negotiate or 10 half duplex. This
setting may cause the BMR restore to run much more slowly than expected. To
achieve normal restore performance, manually set the network interface configuration
through the firmware before a BMR restore.
AIX system restore requires certain information and resources.
The information to be configured in the firmware varies according to architecture,
but can include the following:
■ Network adapter type
■ BMR client IP address
■ BMR client subnet mask
■ BMR boot server IP address
■ BMR client gateway address
Here is sample screenshot showing the required entities configured in the target
hardware firmware so that it can be BMR restored automatically upon a network
boot.
Restoring clients 95
About restoring BMR clients using network boot
After you perform the network boot procedure, the remainder of the restore process
is automatic and requires no manual intervention. After the restore finishes and the
client reboots itself, it is completely restored.
You can network boot an AIX system that has AIX installed, which does the following:
■ Updates the NVRAM with the proper addresses for the BMR boot server, client,
and gateway address.
■ Boots by bootp from the BMR boot server. If the boot server does not answer
the bootp request, the computer boots from the hard drive.
The network boot only works when the BMR client is properly prepared for restore.
Warning: Do not perform this procedure unless you intend to do a restore. When
you prepare a client for restore, the process may result in a restore.
Restoring clients 97
About restoring BMR clients using network boot
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
Restoring clients 98
About restoring BMR clients using network boot
■ Subnet mask:
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
Restoring clients 101
About restoring BMR clients using network boot
■ DHCP
■ TFTP
■ NFS
During the prepare-to-restore operation all the information is gathered that is required
for a Linux network boot. For Linux client network based recovery, you need to
make sure above listed services are configured on the BMR boot server and are
running. You need to require to do any client specific settings in these services
configuration files. BMR handles the required network boot services configuration
for the selected client during prepare-to-restore operation. To know more on the
required network services configuration,
See “Network services configurations on BMR boot Server” on page 245.
After the prepare-to-restore, boot the client to start the restore.
To network boot a Linux client
1 Prepare to restore the client.
See “Preparing a client for restore” on page 86.
2 Ensure that no other DHCP service except the one running on BMR Boot server
is running in the same subnet. Otherwise the client DHCP boot request may
go to un-intended DHCP server and PXE network boot may fail.
Note: This is the limitation with PXE, DHCP boot protocols where first DHCP
reply failure stops network boot process. Hence recommendation is to keep
only Linux DHCP service on the boot server running.
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
5 When you are prompted, either press the Enter key or wait until the system
boots.
The system boots and the restore begins with no further user intervention
required.
6 Upon successful client recovery, BMR automatically cleans up any network
boot settings added for the client in DHCP configuration during
prepare-to-restore operation.
After a successful completion of restore, the host ID-based certificate is copied
on the client that is restored. The automatic recovery parameter is reset. For
more information about the automatic recovery, See “Preparing a client for
restore” on page 86.
Restoring clients 103
About restoring BMR clients using network boot
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
■ DHCP
■ TFTP
■ NFS
To know more on the required network services configuration,
See “Network services configurations on BMR boot Server” on page 245.
Solaris system restore requires the name of the network device that directs the
client to the correct BMR boot server.
After you perform the network boot procedure, the remainder of the restore process
is automatic and requires no manual intervention. After the restore finishes and the
client reboots itself, it is completely restored.
To restore a Solaris client with network boot
1 Prepare to restore the client.
See “Preparing a client for restore” on page 86.
2 Ensure that no other DHCP service except the one running on BMR Solaris
Boot server is running in the same subnet. Otherwise the client DHCP boot
request goes to un-intended DHCP server and network boot may fail.
Note: This is a limitation with DHCP, PXE boot protocols themselves where
first DHCP reply failure stops network boot process. Hence recommendation
is to keep only Solaris DHCP service on the boot server running.
Restoring clients 104
About restoring BMR clients using network boot
6 Start the network boot by entering the following command (net[id] is the device
that points to the BMR boot server):boot net[id] where id is 1,2,3 interface
cards.
Due to the automatic recovery parameter set during prepare to restore, the
restore operation attempts to retrieve the host-ID based certificate and validate
the Certificate Authority (CA) certificate. This recovery is time bound. For more
information about the automatic recovery during prepare to restore, See
“Preparing a client for restore” on page 86.
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
Restoring clients 105
About restoring BMR clients using network boot
Windows systems network boot uses the PXE protocol. The BMR boot server
provides and manages the PXE network services, but a DHCP service is required
in the environment. A DHCP service can exist on the same Boot server or anywhere
in the subnet.
To restore a Windows client with network boot
1 Prepare to restore the client.
See “Preparing a client for restore” on page 86.
2 Ensure that PXE and TFTP services configuration on BMR Boot server is done
once.
If BMR PXE configuration is not done ever on the boot server then run PXE
Service Configuration Wizard available in BMR Boot server assistant which
can be located in the Start menu on the Windows BMR boot server.
For this, click Programs >NetBackup web UI > Windows > Veritas netbackup
> BMR Boot Server Assistant. This BMR PXE service configuration needs
to be done only once for a Windows boot server. If the DHCP server location
changes later then this wizard needs to be run again.
Note: Any other non-BMR PXE or TFTP service running on the same BMR
Boot server cannot be used for BMR recovery. Make sure to stop these services
while client network boots for recovery. Otherwise the client PXE boot request
goes to un-intended server and PXE network boot may fail. This is a limitation
with PXE, DHCP boot protocols, Veritas recommendation is to keep only correct
PXE, DHCP, TFTP servers running while booting client for network based
recovery.
3 Make sure BMR PXE and TFTP services are up and running.
4 Boot the client to restore.
Restoring clients 106
About restoring BMR clients using media boot
5 PXE Boot the client according to the hardware vendor instructions. On some
systems, the BIOS displays a message that indicates that you can press a key
to force a PXE Boot . On others, you may have to modify the settings in the
BIOS to add the network card to the default boot order. Consult your hardware
documentation for details.
Due to the automatic recovery parameter set during prepare to restore, the
restore operation attempts to retrieve the host-ID based certificate and validate
the Certificate Authority (CA) certificate. This recovery is time bound. For more
information about the automatic recovery during prepare to restore, See
“Preparing a client for restore” on page 86.
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
6 When you are prompted, press the Function 12 key and the system boots and
the restore begins.
After a successful completion of restore, the host ID-based certificate is copied
on the client that is restored. The automatic recovery parameter is reset. For
more information about the automatic recovery, See “Preparing a client for
restore” on page 86.
Use these procedures for a standard restore (also known as a self restore, which
is a restore to the same system and disks).
Restoring clients 107
About restoring BMR clients using media boot
To restore using media boot requires that you first create Refer sections on creating
bootable media. boot media.
Before you do a standard restore, you must run the prepare See “Preparing a client for
to restore operation using the current, saved configuration. restore” on page 86.
The procedure for restoring the client system depends on See “Restoring an AIX client
the manufacturer and mode. with media boot” on page 107.
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
Restoring clients 108
About restoring BMR clients using media boot
An AIX boot (either network boot or media boot) may set the network interface
configuration, speed, and duplex mode to auto-negotiate or 10 half duplex. This
setting may cause the BMR restore to run much more slowly than expected. To
achieve normal restore performance, manually set the network interface configuration
through the firmware before a BMR restore.
To restore an AIX client with media boot
1 Prepare to restore the client using the SRT you created on the bootable media.
See “Preparing a client for restore” on page 86.
2 Boot the client from the boot media you created. For instructions on how to
boot from a CD or from a DVD, see the IBM hardware documentation.
3 Enter the required information at the following BMR process prompts:
■ Client name (for a discovery boot, enter the client’s name as it appears in
the Tasks view from the prepare-to-discover operation)
■ Client IP address
■ Network mask
■ Default gateway
Due to the automatic recovery parameter set during prepare to restore, the
restore operation attempts to retrieve the host-ID based certificate and validate
the Certificate Authority (CA) certificate. This recovery is time bound. For more
information about the automatic recovery during prepare to restore, See
“Preparing a client for restore” on page 86.
The restore begins.
Restoring clients 109
About restoring BMR clients using media boot
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR
table to know more about the supported master, boot server, client, and SRT
versions for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
■ IP address
■ Default gateway
■ Subnet mask
Restoring clients 111
About restoring BMR clients using media boot
Due to the automatic recovery parameter set during prepare to restore, the
restore operation attempts to retrieve the host-ID based certificate and validate
the Certificate Authority (CA) certificate. This recovery is time bound. For more
information about the automatic recovery during prepare to restore, See
“Preparing a client for restore” on page 86.
The restore begins.
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
Restoring clients 112
About restoring BMR clients using media boot
■ Network mask
■ Default gateway
Due to the automatic recovery parameter set during prepare to restore, the
restore operation attempts to retrieve the host-ID based certificate and validate
the Certificate Authority (CA) certificate. This recovery is time bound. For more
information about the automatic recovery during prepare to restore, See
“Preparing a client for restore” on page 86.
The restore begins.
Restoring clients 113
About restoring BMR clients using media boot
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR
table to know more about the supported master, boot server, client, and SRT
versions for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
boot cdrom
Due to the automatic recovery parameter set during prepare to restore, the
restore operation attempts to retrieve the host-ID based certificate and validate
the Certificate Authority (CA) certificate. This recovery is time bound. For more
information about the automatic recovery during prepare to restore, See
“Preparing a client for restore” on page 86.
After you enter the required information, the restore begins.
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Note: Review the secure communication compatibility support matrix for BMR table
to know more about the supported master, boot server, client, and SRT versions
for Linux, Windows, Solaris, AIX, and HP-UX environments. See “Secure
communication compatibility matrices for BMR for NetBackup 8.1.1 and later
releases” on page 259.
Use the bpnbat -ShowMachines command on the master server to view the name
of the added machine.
Note: If you abort the restore operation or if the restore operation fails, either
run the prepare to restore operation again to restart the automatic recovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the
NetBackup Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
5 The system boots and the restore begins with no further intervention required.
After a successful completion of restore, the host ID-based certificate is copied
on the client that is restored. The automatic recovery parameter is reset. For
more information about the automatic recovery, See “Preparing a client for
restore” on page 86.
■ Netmask
■ Gateway
6 From the client configuration drop-down list, select the client configuration that
you want to restore and click Restore Client.
Note: The list displays configurations of only that particular client with which
the provided reissue token is associated.
Select Show all configurations if you want to view a list of all the configurations
that are associated with the client for which you have provided reissue token.
■ Netmask
Restoring clients 119
About restoring to a specific point in time
■ Gateway
6 Click Contact Master Server, after you have entered all the details mentioned
in Step 5.
7 (Conditional to Step 5 and 6)Validate and confirm if the selected primary server
with which the client intends to establish a communication is a trusted server.
Click Yes, if you trust the primary server.
For more information on how to validate the Certificate Authority (CA) hash
certificate, refer to the Finding and communicating the fingerprint of a CA
certificate section in the NetBackup Security and Encryption Guide
http://www.veritas.com/docs/DOC5332
8 (Conditional to step 5 and 6) Click on the left Host mappings > Hosts > Menu
button > Generate reissue token and then click OK
Use the Certificate Management node on NetBackup web UI to generate
click on the left Host mappings > Hosts > Menu button > Generate reissue
token.
For more information on how to generate a reissue type of authorization token,
refer to the Creating a reissue token section in the NetBackup web UI Help or
the NetBackup Security and Encryption Guide.
https://www.veritas.com/support/en_US/article.DOC5332
9 Click OK. Discovery completes with no further user intervention required.
After a successful discovery, the discovered configuration is listed under Bare
Metal Restore > Resources > Discovered configurationsBare Metal Restore
> Resources > Discovered configurations on the NetBackup web UI.
3 In the New Configuration dialog box, enter a name for the new configuration.
Below is a sample screenshot showing creation of Point-In-Time configuration
for recovery.
6 Click OK.
The new configuration appears in the list of the client's configurations. The
configuration is now ready for the prepare-to-restore operation.
7 Restore the client.
See “About restoring BMR clients using network boot” on page 93.
See “About restoring BMR clients using media boot” on page 106.
■ During the restore: You perform a standard restore and BMR detects that the
disks are different. BMR enters DDR mode and creates an editable restore
configuration so you can map the disks.
■ For UNIX and Linux clients, use the BMR disk mapping utility in the
NetBackup web UI on the master server.
■ For Windows clients, you can map on the client during recovery or on the
master server using the BMR disk mapping utility in the NetBackup web UI.
Restoring clients 123
About restoring to dissimilar disks
Warning: Changes in disk locations may prevent a clustered resource from going
online after a restore. BMR does not attempt to adjust clustered resource attributes
to account for a dissimilar disk restore.
Step 4 Initialize the restore configuration with the See “About Volumes
disk information from the discovered properties” on page 172.
configuration and then map the original
volume configuration to the new disks.
Step 5 After you finish mapping, perform the DDR See “Restoring a client to
restore procedure. dissimilar disks”
on page 124.
Step 2 Begin the restore by booting the client If you use a configuration
using either network boot or media boot. where the protected
system’s volume
configuration is already
mapped to the new disks,
the restore proceeds as a
standard restore. No
intervention is required.
Current
configuration name
for restore is
'current'. Please
enter the name for a
new editable
configuration:
Restoring clients 126
About restoring to dissimilar disks
See “Modifying a
configuration” on page 158.
Step 7 Prepare to restore and then restore the See “Preparing a client for
client, using the edited restore restore” on page 86.
configuration.
See “About restoring BMR
clients using network boot”
on page 93.
Step 4 Add NIC drivers and the MSD See “About adding NIC and MSD
drivers to the restore configuration drivers” on page 129.
system.
Step 5 Change the network interfaces and See “About changing network
network identities in the restore interfaces” on page 130.
configuration.
Restoring clients 128
Restoring to a dissimilar system
Step 6 Map disks in the restore See “About mapping disks in the
configuration. restore configuration” on page 131.
Step 9 Complete the DSR changes at the See “Logging on for the first time
first logon to the restored system. after system restore” on page 132.
■ The target system has different TCP/IP settings than the protected system has.
(Only TCP/IP properties are restored. Other networking properties, such as
Internetwork Packet Exchange (IPX), are not restored and must be configured
after the restore.)
Note: Only TCP/IP properties are restored. Other networking properties, such as
Internetwork Packet Exchange (IPX), are not restored and must be configured after
the restore.
Note: Do not reboot the system until the bmrcleanup status box completes.
All backup and restore requests (not only BMR restores) are directed to the alternate
media servers.
More information is available.
See “Overriding the original media server manually” on page 134.
See “Enabling automatic media server failover to an alternate server” on page 133.
More detailed information about how to configure NetBackup to use an alternate
media server is available.
See the NetBackup Administrator’s Guide for UNIX, Windows and Linux, Volume
I.
Step 3 After you create and modify the See “About restoring BMR clients
restore configuration, perform a using network boot” on page 93.
standard restore.
See “About restoring BMR clients
using media boot” on page 106.
that are available with a complete operating system are not available in the restore
environment.
UNIX external procedures execute as root. Windows external procedures execute
as administrator.
External procedures are stored in the BMR database on the NetBackup master
server. Use the bmrepadm command on the master server to manage external
procedures.
first boot After the restore is complete and at the first boot of a restored client.
On Windows systems, the first boot external procedure operates as
the first user to log on after a client is restored.
An external procedure point name is used as part of the name of each external
procedure script that you create. The naming convention for client-specific external
procedures is different than for operating system-specific external procedures.
Note: Do not add a .cmd extension for the external procedures that are intended
for Microsoft Windows systems. BMR adds the appropriate file name extension
when it generates the scripts during the prepare-to-restore process.
Restoring clients 137
About external procedures
clientname_externalprocedure
externalprocedure.ostype
■ aix
AIX
■ hp
HP-UX systems
■ linux
Linux systems
■ sol
Solaris systems
■ win
Windows systems
The bmrepadm command does not validate client names (that is, you can add an
external procedure for a nonexistent client).
For another example, to add an external procedure auxiliary file named
ListStorageGroups.vbs, use the following command:
For more information about the bmrepadm command, see the NetBackup Commands
Reference Guide.
The following is an example of using the bmrc command to transfer a file from the
master server to the client:
When you start the bmrc command in an external procedure, specify the full path
in the restore environment, as follows:
■ On UNIX and Linux clients: /usr/openv/NetBackup/bin
■ On Microsoft Windows clients: %SystemDrive%\BMR\NBU\bin
At the first boot external procedure point, the path to the bmrc command is
install_path\NetBackup\bin on Microsoft Windows clients.
For more information about the bmrc command, see the NetBackup Commands
Reference Guide.
You can also use redirection to send output to the screen from an external
procedure by redirecting output to the special device. To do so, use
/dev/console (as in echo "Hello World" >> /dev/console).
On UNIX and Linux systems, the bmrShell is not available during first boot.
Windows systems You can enter commands and interact with an external procedure during
restore time. To do so, start the Windows command interpreter cmd from
within the external procedure script.
On Windows systems, the limited restore environment may not contain DLLs
or the same version of DLLs that were used with the original client system.
Use bmrc to transfer these DLLs during the restore to the
C:\BMR\WINNT\SYSTEM32 directory. Alternatively, add the location of that
DLL to the path environment variable.
/usr/openv/netbackup/logs/bmrrst/client_name/log.mmddyy (UNIX)
install_path\NetBackup\logs\bmrrst\client_name\log.mmddyy (Windows)
Restoring clients 140
About external procedures
On UNIX and Linux systems, the BMR restore process writes external procedure
begin and end messages to the logs. (On Windows systems, the BMR restore
process does not perform begin and end logging.) You can use the bmrc command
in your external procedure scripts to write messages to the logs also.
External procedures write messages when they start and finish. A message includes
the date and time that the procedure began, the client name, and a description that
includes the external procedure name. See the following examples:
You can use the bmrc command to write messages to the restore log. The following
is an example of a bmrc command that writes a message during a restore of client
sol123:
Alternatively, you can pipe data to the bmrc command, as in the following example:
echo "Hello World" | bmrc -operation create -resource log -client sol123
When you start the bmrc command in an external procedure, specify the full path
in the restore environment, as follows:
■ On UNIX and Linux clients: /usr/openv/netbackup/bin
■ On Microsoft Windows clients: %SystemDrive%\BMR\NBU\bin
At the first boot external procedure point, the path to the bmrc command is
install_path\NetBackup\bin on Microsoft Windows clients.
For more information about the bmrc command, see the NetBackup Commands
Reference Guide.
First Boot External Procedure An external procedure runs during the first
boot phase.
If you retry, a prompt asks if you want to transfer the external procedure again from
the BMR server before you run it. The prompt lets you edit the external procedure
on the master server before you run it again.
Note: When a UNIX first boot external procedure is started with no terminal defined
and the procedure returns non-zero, the Bare Metal Restore process ends.
For Windows restores, a dialog box appears with the following choices:
■ Cancel halts the restore.
Restoring clients 142
About external procedures
Variable Description
Variable Description
0=cancel
1=prompt
2=ignore
The following exported operating system environment variables are set at restore:
$BIDATA $HOME
$LIBPATH $NIM_HOSTNAME
$NIM_HOSTS $NIM_NAME
Restoring clients 144
About external procedures
$NSORDER $ODMDIR
$PATH $PWD
$SHOWLED $SPOT
$SYSCFG_PHASE
$DEFAULT_RELEASE_DIR $EDITOR
$ENV $ERRNO
$FCEDIT $HISTFILE
$HOME $IFS
$INST_CLIENT_DIR $INST_CUR_PRIMARY_PATH
$INST_IS_BOOTP_SYSTEM $INST_LOG_FILE
$INST_NOT_TEST_MODE $LINENO
$MAILCHECK $OPTARG
$OPTIND $PATH
$PPID $PS1
$PS2 $PS3
$PS4 $PWD
$RANDOM $SECONDS
$SHELL $SOURCE
$SOURCE_LIF_FILE $SOURCE_NET_DIR
$SOURCE_TYPE $TMOUT
$IFS $MAILCHECK
$OPTIND $PATH
$PS1 $PS2
$PWD $TZ
$_DVFS_RECONFIG
%ALLUSERSPROFILE% %APPDATA%
%CommonProgramFiles% %COMPUTERNAME%
%ComSpec% %HOMEDRIVE%
Note: During BMR recovery, user can either avail BMR DDR (dissimilar disk restore)
support where user may want to restore operating system on the same SAN LUNs
to make the machine SAN bootable again or the user can move operating system
volumes on local disk so that machine is bootable from the local disk. Same logic
is applicable while restoring machine having local disk-based systems. Using DDR,
user can map operating system volumes to SAN LUN and can make restored
machine SAN bootable.
See “Restoring Solaris SAN-attached volumes if they are left unmapped” on page 145.
See “About SANs and dissimilar system restores on Windows clients” on page 146.
Note: Systems with multiple network interfaces are also known as multihomed
systems. BMR fully support multihomed clients.
Figure 6-4 illustrates a configuration that can occur with multihomed clients. For
this configuration, specify the network interface for Network 1 when you network
boot the client.
Restoring clients 147
About multiple network interface support
Network 1
BMR boot server 1.1.1.0
BMR client
Network 2
2.2.2.0
Gateway Description
Default Gateway Defines the default network gateway for the client during the restore.
Master Server Gateway Defines the gateway from the client to the NetBackup master server.
Media Server Gateway Defines the gateway from the client to the NetBackup media server
used to restore the files.
You may not have to specify all gateways. If the client can communicate with all
hosts through the default gateway, you only have to specify the default gateway.
For network boots, specify the following:
■ The gateways for the NetBackup master and media servers in the Hosts dialog
box of the restore configuration
■ The default gateway in the Network Routes dialog box
For media boots, you are prompted for these values when you create the boot
media or during the restore.
Restoring clients 148
Port usage during restores
Figure 6-5 shows how gateways can be used during a BMR client restore.
NetBackup
master server
(network 3)
G2
Master server gateway
BMR client
(network 1)
G1 G3
Media server gateway
Default gateway
(network 2)
(network 4)
The client in this diagram cannot communicate with all of the servers it needs to by
using only the default gateway. For such a configuration, you should specify the
default gateway as G1, the master server gateway as G2, and the media server
gateway as G3.
bootp/DHCP 67, 68 X X X
Restoring clients 149
Port usage during restores
ping X
lockd Unreserved X X
mountd Unreserved X X
nfsd 2049 X X
portmapper 111 X X
rpcbind X (for
bootpararm on
Solaris only)
statd Unreserved X X
tftp 69 X X X
vnetd 13724 X X X
bpcd 13782 X X X
Note: You can add only NIC and MSD drivers. All other types of drivers (audio,
video, modem, and so on) must be installed on the system after the restore is
complete.
See “Finding the correct driver if Windows is already installed” on page 151.
To add a driver package by using the Driver Package Wizard
1 On the Start menu on any Windows boot server, click Programs > Veritas
NetBackup > Bare Metal Restore Boot Server Assistant.
2 In the Bare Metal Restore Boot Server Assistant, click Driver Package Wizard.
3 In the Driver Package Wizard, step through the prompts as follows to add the
software package:
■ Path to the installation files for the package
■ Description of the package
■ Version of Windows that the package can be used with
■ The specific driver from the package installation files (installation files may
include more than one driver)
The devices should be documented in the materials that come with the computer.
If not, contact the manufacturer for the driver option.
Alternatively, use the following procedure to determine the correct name for the
driver if Windows is installed.
To find the correct driver if Windows is already installed
1 On the computer that contains the mass storage device adapter, open the
Windows device manager.
2 Expand the category for the adapter (for example, network adapters).
3 Note the device name that appears here. The option name in the .inf file
should be the same or similar to this device name.
Warning: Do not delete any drivers that are required for a restore.
■ Copying a configuration
■ Discovering a configuration
■ Modifying a configuration
■ Deleting a configuration
■ Deleting a client
■ Drivers
■ Other system software components.
Most BMR operations are performed on configurations.
When a BMR protected client is backed up, the configuration of the client is saved
and named current. Every time a client is backed up, the new saved configuration
replaces the previously saved configuration.
The saved, current configuration is read-only. Use the current configuration to
restore the original protected system to its state at the most recent backup (a
standard or a self restore).
To restore to a different point in time, to different disks, or to a different system,
create a restore configuration by copying a current configuration. Then modify the
restore configuration.
Copying a configuration
Copy a configuration so that you can do the following:
■ Restore a client to a state that was saved in a backup before the last backup.
See “About restoring to a specific point in time” on page 119.
■ Restore a client in which the disks have changed.
See “About restoring to dissimilar disks” on page 122.
■ Restore a Windows client to a different system.
See “Restoring to a dissimilar system” on page 127.
■ Restore a client to the same hardware but with different network properties.
A copied configuration that is used for a restore is called a restore configuration.
After you create the restore configuration, modify it so it matches the target hardware
properties.
To copy a configuration
1 In the NetBackup web UI, click Bare Metal Restore > Hosts > Bare Metal
Restore Clients.
2 In the All Bare Metal Restore Clients tree pane, expand the view of the client
that contains the configuration you want to copy.
3 Right-click the configuration you want to copy.
Managing clients and configurations 155
Discovering a configuration
5 On the New Configuration for Bare Metal Restore Client dialog box, complete
the fields.
6 Click OK.
7 If necessary, modify the configuration.
See “Modifying a configuration” on page 158.
Discovering a configuration
Review the secure communication compatibility matrix for BMR before you proceed
with the prepare-to-discover operation.
See “Secure communication compatibility matrices for BMR for NetBackup 8.1.1
and later releases” on page 259.
You can discover the configuration of a new system; the system does not have to
be a NetBackup client. A discovered configuration contains the hardware and the
software information of a host.
Hardware discovery is mainly required when you recover a client to a different target
system than the original. The target system differs from the original in the hardware
details like the NIC (network interface card) and disk details. BMR needs to
understand those details before restore begins. Therefore user needs to perform
hardware discovery of target hardware using BMR prepare-to-discover operation
and map original client configuration with the discovered configuration.
Managing clients and configurations 156
Discovering a configuration
■ Windows clients display a pop-up box stating that the discovery is finished and
that you can click OK to restart the system.
For more information regarding on commands, refer to the NetBackup Command
Reference Guide
https://www.veritas.com/support/en_US/article.DOC5332
For more information about the automatic recovery or discovery and the host-ID
based certificate, refer to the NetBackup Security and Encryption Guide.
To discover a configuration using the bmrprep command
1 Logon as an administrator.
2 Run the bpnbat command.
3 Run the bmrprep command to initiate a prepare-to-discover operation.
When you run the bmrprep command, validation checks are performed. These
checks pertain to the different parameters such as SRT version, configuration
version, etc.
■ If the validation checks for prepare to discover are successful, then the
client is marked for automatic discovery. This automatic discovery is by
default valid for 48 hours. The primary server authenticity is validated
automatically; a host-ID based certificate is automatically issued to this
client during the automatic discovery process.
Use the nbhostmgmt command to verify whether the client is marked for
automatic discovery.
■ If the validation checks fail, appropriate error messages are displayed.
Follow the instructions that are provided in the message.
For more information, See “Error messages for prepare to restore, prepare
to discover, and the bmrprep command with reference to secure
communication in BMR” on page 206.
Note: If a client is the target of a dissimilar disk restore (DDR) and VxVM
manages the protected client’s disks, specify an SRT with VxVM installed.
3 Click OK.
When you click Prepare to Discover, validation checks are performed. These
checks pertain to the different parameters such as SRT version, configuration
version, etc.
■ If the validation checks are successful, then the client is marked for
automatic discovery. This automatic discovery is by default valid for 48
hours. The primary server authenticity is validated automatically; a host-ID
based certificate is automatically issued to this client during the automatic
discovery process.
The client is ready for discovery.
Use the nbhostmgmt command to verify whether the client is marked for
automatic discovery.
For more information about the automatic recovery or discovery and the
host-ID based certificate, refer to the NetBackup Security and Encryption
Guide
■ If the validation checks fail, appropriate error messages are displayed.
Follow the instructions that are provided in the message.
For more information, See “Error messages for prepare to restore, prepare
to discover, and the bmrprep command with reference to secure
communication in BMR” on page 206.
Note: If you stop the discovery operation or if the discovery operation fails, either
run the prepare-to-discover operation again to restart the automatic discovery or
manually set the Security > Host mappings > Hosts > Menu button > Allow
auto reissue certificate option using the NetBackup web UI or command-line
interface.
For more information about manually setting the Allow Auto Reissue Certificate
option, see Allowing automatic reissue of a certificate section within the NetBackup
Security and Encryption Guide
https://www.veritas.com/support/en_US/article.DOC5332
Modifying a configuration
Modify a configuration so you can do the following:
■ Restore a client to a state that was saved in a backup before the last backup.
See “About restoring to a specific point in time” on page 119.
■ Restore a client in which the disks have changed.
See “About restoring to dissimilar disks” on page 122.
■ Restore a Windows client to a different system.
See “Restoring to a dissimilar system” on page 127.
■ Restore a client to the same hardware but different network properties.
■ Restore a client by skipping intended non-OS data volumes or disks.
■ Make client SAN bootable by mapping its OS volumes onto SAN LUNs.
You cannot modify the configuration named current; you must create a configuration
you can edit.
See “Copying a configuration” on page 154.
To modify a configuration
1 In the NetBackup web UI, click Bare Metal Restore > Hosts > Bare Metal
Restore Clients.
2 In the All Bare Metal Restore Clients pane, expand the view of the client that
contains the configuration you want to modify.
3 Right-click the configuration you want to modify.
4 On the shortcut menu, select Change.
5 In the Change Configuration dialog box, modify properties as needed.
See “Client configuration properties” on page 160.
Managing clients and configurations 159
Deleting a configuration
Deleting a configuration
You cannot delete a current configuration as it is read-only. Only custom created
configurations can be deleted.
To delete a configuration
1 In the NetBackup web UI, click Bare Metal Restore > Hosts > Bare Metal
Restore Clients.
2 In the All Bare Metal Restore Clients pane, expand the view of the client that
contains the configuration you want to delete.
3 Right-click the configuration you want to delete.
4 Click Delete > Yes.
Managing clients and configurations 160
Deleting a client
Deleting a client
When you delete a client, it removes only the client and its BMR configurations from
the BMR database. It does not remove the NetBackup software on the client, nor
remove it from NetBackup, nor delete the backups of the client.
You can delete a client but not remove it from the NetBackup policy that backs it
up. If you do, the client is reregistered with BMR the next time it is backed up and
appears in the Bare Metal Restore Clients view. (The NetBackup policy that backs
it up is the policy that collects BMR information.)
To delete a client
1 In the NetBackup web UI, click Bare Metal Restore > Hosts > Bare Metal
Restore clients.
2 Right-click the client you want to delete.
3 On the shortcut menu, select Delete.
4 In the confirmation dialog box, click Yes.
■ Change a license key for software on the protected system that requires a license
key.
■ Determine the components of the restore configuration so you can select a
shared resource tree that has the appropriate software for the restore.
Table 8-1 describes the actions you can initiate regarding license keys.
Action Description
Add License Key Opens a dialog box in which you can add the license key for the
selected software.
Change License Key Opens a dialog box in which you can change the license key for
the selected software.
Table 8-2 describes the client fields that are displayed in the dialog box.
Field Description
Service pack (Windows clients only.) The service pack version on the client.
Architecture (UNIX and Linux clients only.) The architecture of the client.
Table 8-3 describes the configuration fields that are displayed in the dialog box.
Field Description
Last modification The date and time when the configuration was last modified.
■ Automatically select the correct mass storage device (MSD) drivers and network
interface card (NIC) drivers for the listed devices.
■ Manually add MSD and NIC drivers to the configuration.
You can also specify whether to use only BMR discovered drivers.
Table 8-4 describes the options available and the actions they initiate.
Option Action
Initialize Devices... Prompts you for another configuration from which to import the
devices. You may select a discovered configuration or one from
another client. The initialize operation updates the Drivers packages
to be used during restore window to include the necessary drivers
for this hardware.
Managing clients and configurations 164
Client configuration properties
Option Action
Add Moves the selected driver from the Available driver packages
window to the Driver packages to be used during restore window.
Remove Moves the selected driver from Driver packages to be used during
restore window to the Available driver packages window.
Change Lets you change the following attributes of the selected driver:
Hosts properties
Use the Hosts property sheet of the Change Configuration dialog box to add,
remove, or change the attributes of any host that has a role in the restore process.
You can change attributes so you can restore on a network with a different
configuration, such as at a disaster recovery site.
Table 8-5 describes the actions you can initiate from the property sheet.
Managing clients and configurations 166
Client configuration properties
Action Description
Add Opens a dialog box in which you can add a new host, specify its role,
and enter its IP address and gateway.
Change Opens a dialog box in which you can change properties for the selected
host.
Remove Removes the selected host. If you don’t want to remove the host, click
Cancel to exit the Change Configuration dialog box without applying
the changes.
Table 8-6 describes the Client Information fields in the Hosts property sheet.
Field Description
Client Name The name by which NetBackup knows the client. The specified client
name must match the client name in the NetBackup policy that backs
up the client.
IP address The IP address of the client. All IP addresses defined in the network
interfaces are in the drop-down list.
Action Description
Initialize Opens a dialog box from which you can select a configuration to import.
Only the hardware information from the configuration is imported, not
the network identity. The interfaces from the imported configuration
replace the interfaces in the New Network Information window.
Managing clients and configurations 168
Client configuration properties
Action Description
Unmap All Unmaps all mapped interfaces in the New Network Information window
and changes all interfaces in the Original Network Information window
to Unmapped.
Note: In case target hardware is booted using different network Interface for recovery
than the one shown as Bootable in BMR client configuration, then recovery may
fail
You may need to add a route if an existing route in the configuration is not sufficient
to reach the NetBackup or BMR servers. This situation can occur during disaster
recovery at a different location when you move servers from one subnet to another.
It also can occur when any routers that intervene are changed.
For example, client 10.10.5.12 and NetBackup master server 10.10.6.23 have a
router (10.10.5.254) between them because they are on different subnets. When
you prepare to restore, the restore process configures the route to the NetBackup
master server as 10.10.5.254, and the restore is successful. However, if the IP
address of the router between them changes, the client may not be able to reach
the master server. The client cannot reach the server because the configuration
does not include the correct route to it. Therefore, you must add a network route
to the master server before you perform the prepare-to-restore operation.
BMR attempts to reach hosts in the following order:
■ Host routes (specified on the Hosts property sheet)
■ Network routes that are specified on this property sheet
Managing clients and configurations 172
Client configuration properties
Action Description
Add Opens a dialog box in which you can enter the properties for a new
network route.
Change Opens a dialog box in which you can change the properties for the
selected route.
You can perform the following operations for mapping volumes and for changing
configurations:
■ Change the disks that make up a disk group.
■ Control the file systems that are restored.
■ Control the logical volumes that are created.
■ Change the attributes of either a file system, a logical volume, or a disk.
■ Restrict a disk to prevent it from being used as a target for mapping.
■ Make a discovered disk available for mapping (remove restriction).
Given enough space on the target disk, you can map all the logical volumes and
their file systems. Or you can map specific logical volumes and file systems. You
do not have to restore all your logical volumes and file systems.
Primary partitions and simple volumes require only one disk. Striped, mirror, and
RAID-5 volumes require multiple disks.
Managing clients and configurations 174
Client configuration properties
You can map the Solaris Native disk resource by using the disk mapping wizard.
To map a disk using the mapping wizard, right-click a volume in the list and click
map. The following is an example of Disk Mapping Wizard.
Managing clients and configurations 175
Client configuration properties
A Partition node appears under the Native Disks node. The following example
shows the information regarding the partition name, partition state, partition length
(size).
You can map the partition by using the mapping wizard. Right-click the Volume to
launch the mapping wizard. You can map the source partition to destination disk
and specify the percentage space of the destination disk to use for creating the
partition.
Managing clients and configurations 176
Client configuration properties
Initialize Opens a dialog box where you can select a configuration to import into
the New Volume Layout window. Only the disk information from the
configuration is imported. Use this option to initialize the configuration
with the layout of the new disks so you can begin mapping.
Unmap All Removes all mapped elements in the New Volume Layout and changes
all elements in the Original Volume Layout window to Unmapped.
Note: The mapping wizards do not let you reduce the size of a volume or partition
to less than the required space to restore files.
Action Description
Initialize Opens a dialog box from which you can select a configuration to
import into the New Volume Layout window. Only the disk
information from the configuration is imported.
Fast Map Evaluates the original configuration and maps source disks to disks
in the target configuration that have the necessary attributes.
Unmap All Removes all mapped elements in the target configuration and
changes all elements in the original configuration to Unmapped.
Managing clients and configurations 178
Client configuration properties
Action Description
Map Volume Right-click a volume in the Disk View of the Original Volume
Layout window and select Map Volume from the shortcut menu.
The mapping wizard starts for the selected element.
Map Volume Group Right-click a volume group in the Disk View of the Original Volume
Layout window and select Map Volume Group from the shortcut
menu. The mapping wizard starts for the selected element.
Map Disk Right-click a disk in the Disk View of the Original Volume Layout
window and select Map Disk from the shortcut menu. The mapping
wizard starts for the selected element.
Map Disk Group Right-click a disk group in the Disk View of the Original Volume
Layout window and select Map Disk Group from the shortcut
menu. The mapping wizard starts for the selected element.
Remove Restriction (Veritas Cluster Server only. ) Right-click an element in the New
Volume Layout window and select Restrict from the shortcut menu
to map the disk.
Mapping volumes
Use the following procedures to map volumes from the protected client to the restore
configuration.
To initiate mapping for individual elements
1 In the Table View or Disk View, right-click the element in the Original Volume
Layout window.
2 Choose the appropriate map option on the shortcut menu (the map options
are context-sensitive ).
The Mapping Wizard starts with one of the following contexts, as appropriate:
Managing clients and configurations 179
Client configuration properties
Map The Mapping Wizard starts for the selected element (except
main element disk groups, disks, volumes, volume groups,
and so on).
Then all the volumes and the file systems are populated
into the target disk. The mapped state is set for both source
elements and target elements (disks, volumes, and file
systems)
To unmap an element
1 In the Table View or Disk View, right-click the element you want to unmap in
the New Volume Layout window.
2 Click the unmap option on the shortcut menu. The unmap options are
context-sensitive and include Unmap, Unmap Disk, Unmap Volume, and
others.
The element is unmapped, and the values of used and free space change
accordingly.
To change the system volume size on Windows
1 In the Table View or Disk View, right-click the volume in the New Volume
Layout window.
2 Click Change Size on the shortcut menu.
3 In the Windows System Volume Size Change dialog box, change the size
of the volume.
4 Change the size of the volume.
Managing clients and configurations 180
Client configuration properties
Volumes views
The tree view (the left pane) shows the elements that are part of the disk layout.
The elements in the tree change depending on the operating system of the client
and the volume managers that are enabled. The tree view filters the details pane
on the right. Select an element to display its attributes in the right pane and to filter
other elements so they do not appear in the details pane.
The following indicators show an element’s state throughout the mapping process:
Volumes All the volumes that are Disks that contain volumes,
defined in the system, both regardless of which volume
managed or unmanaged. manager created them.
One specific volume Disks that the volume Disks that the volume spans.
spans.
Table 8-12 lists details about the selected Veritas Volume Manager elements.
Table 8-12 Veritas Volume Manager and Storage Foundation for Windows
elements
Disk groups Disk groups in the configuration. Disks that are part of any disk
group.
A specific disk group Disks that are part of that disk Disks that are part of that disk
group. group.
Volumes All the volumes that Volume Disks that contain Volume
Manager manages. Manager volumes (ordered by
disk group)
A specific volume Disks that contain that volume. Disks that contain that volume.
Note: BMR can also restore Solaris 10 clients that have ZFS storage pool attached.
ZFS pools Not applicable Details of File systems and Details of disks associated with
Volumes on each ZFS Pool each ZFS Pool
Managing clients and configurations 183
Client configuration properties
Table 8-14 lists details about the selected Solaris Volume Manager elements.
Disk sets All named (nonlocal) sets. Disks that are part of a named
(nonlocal) set (ordered by disk
set).
A specific disk set Disks that are part of that disk Disks that are part of that disk
set. set.
A specific volume Disks that include that volume. Disks that include that volume.
Table 8-15 lists details about the selected non-managed Solaris elements.
Disks All disks that VxVM does not All disks that VxVM does not
manage and all disks that are not manage and all disks that are not
in an SVM disk set. in an SVM disk set.
Slices All slices that are not managed All disks that contain
and not used as SVM meta nonmanaged slices.
devices.
Managing clients and configurations 184
Client configuration properties
Table 8-16 lists details about the selected empty disks elements.
Empty disks Disks that are not used. Disks that are not used.
Table 8-17 lists details about the AIX and HP-UX logical volume manager elements.
Volume groups Volume groups in the Disks that are part of any volume
configuration. group (ordered by volume
group).
A specific volume Disks that are part of that volume Disks that are part of that volume
group group. group.
Volumes All the volumes that the LVM Disks that have LVM volumes.
manages.
A specific volume Disks that contain that volume. Disks that contain that volume.
Chapter 9
Managing BMR boot
servers
This chapter includes the following topics:
General boot server You must have a boot server for each type of client that
you want to protect. For example, a Solaris client requires
a Solaris boot server, a Windows client requires a
Windows boot server, and so on.
AIX boot server AIX boot servers do not have any special requirements.
An AIX boot server can reside on the same subnet as
the subnet of the client, or on a different subnet. However,
AIX boot servers at a specific operating system version
can only host SRTs of the same or earlier operating
system version. For example, a 5.3.0.10 boot server can
only host 5.1.x.x, 5.2.x.x, 5.3.0.0, and 5.3.0.10 SRTs, but
not 5.3.0.20 SRTs. Likewise, a 5.2.x.x boot server cannot
host 5.3.x.x SRTs.
HP-UX boot server Each network segment with HP-UX clients must have an
HP-UX boot server that can support the clients.
Linux boot server Each network segment that has Linux clients must have
a Linux boot server.
■ The VM takes long time for booting after BMR Physical backup conversion to
virtual machine is performed on 32-bit architecture Windows OS
■ Many services on Solaris 11 and newer print warning messages during a system
boot and during BMR first boot
■ Solaris Zone recovery on Solaris 11 and newer takes time to reconfigure after
a BMR restore during first boot
■ A Solaris BMR restore operation fails if the text-installer package is not present
in the customized AI ISO
■ Multiple error messages might be displayed during the first boot after the
restoration of a client with ZFS storage pools
■ Specifying the short name of the client to protect with Auto Image Replication
and BMR
■ A restore task may remain in a finalized state in the disaster recovery domain
even after the client restores successfully
■ PTR or PTD failure because of boot server version mismatch after upgrade
■ Error messages for prepare to restore, prepare to discover, and the bmrprep
command with reference to secure communication in BMR
■ Media restore of Solaris x86 11.2 or later clients may prompt for maintenance
mode user name and password
■ Discovery task may remain in Finalizing state after client PTD task completes
successfully
■ BMR restore task may remain in Finalizing state after the client is restored
successfully
■ Shared Resource Tree (SRT) creation fails with an error after BMR restore if a
backup operation was initiated on the boot server and client while the SRT
creation was in progress
■ BMR backup and restore job details does not display on the NetBackup web
UI's activity monitor
■ If the CD or DVD contents consist of a single file, the CD or DVD was written
as a data CD or DVD instead of an ISO-9660 CD or DVD image. Repeat the
burning procedure but use the options that are required to burn an ISO image
file.
■ If the CD or DVD is blank or unreadable, remove it from the drive and examine
it closely to determine if it has been written to. Some CD or DVD burning software
by default simulates the burning of a CD or DVD to test the capabilities of the
CD or DVD burning hardware. It does not burn the CD or DVD until the test-only
option is turned off. Repeat the burning procedure with the test-only option
disabled.
■ If the boot was partially successful, or if it appears that some files are not present
or some are corrupted, then one of the following occurred:
■ The burning process failed. A partially burned CD may be bootable but may
not contain significant portions of its content. Lower the CD writing speed to
allow a successful burn. Use the test after writing or use the option to verify
that some CD writing software offers may help detect unsuccessful CD writes.
■ The file transfer from the BMR boot server to the computer with the CD writer
failed.
A common cause of corruption occurs when the file is transferred with FTP
in ASCII transfer mode rather than binary mode.
■ If the CD boots successfully on another similar computer, the drive on the restore
system may be damaged or dirty. Similarly, the CD itself may be easily damaged
or made unreadable by surface contamination after writing. Examine the physical
media and the environment in which it is read.
■ Verify that you use the correct procedures to boot the client computer from CD.
■ Try booting the client from the installation media to ensure that the computer
does not have a hardware problem when it boots from the CD.
/etc/ethers file
/etc/bootparams
■ Unplug the booting client from the network until the media boot configures the
network parameters for the restore.
For more information about the bmrs command, see NetBackup Commands.
Troubleshooting 195
First boot after BMR restore fails on UNIX platforms
■ Look in the bmrrst log on the master server to see the progress of the
restore. To determine the root cause on the restoring client:
2 Cancel and exit from the restore wizard. This should place you in the main
menu.
3 Move the mouse to a location in the upper left-hand corner of the main screen,
near the gear shaped icon. When the mouse pointer changes from an arrow
to a hand, right-click the mouse. This opens a command-line window.
4 Change directory to X:\BMR\NBU\bin.
5 Execute the command,
bpclimagelist -client $CLNT_NAME -T echo %ERRORLEVEL%
The 'echo' command displays the return code of the command. The
bpclimagelist command will fail to gather catalog backup image information
for the following reasons:
■ Could not contact the master server (rc=25). This happens if the client has
connected on the wrong interface port or has an invalid or incomplete host
name and ip-address information for the master server. The fact that the
client could initially access the client configuration is not relevant. At the
time of the failure, the client network interfaces were modified to match
what was in the restore configuration specified for the restore. The values
entered on the first input page have been modified to match the configuration
values.
■ The master server could not respond back to the client port (rc=23). Possible
causes are missing client reverse lookup information, either in the Server's
DNS entries or hosts file or invalid routing back to the client
■ The master server does not see the restoring client as a valid client (rc=131,
133, 135). The ip-address used by the client resolved to a different name
than in the configuration, or the client does not have permission to perform
list/restore requests. One way to resolve this is to place a temporary entry
in the 'hosts' file of the master server and media server. This entry must
match the data information found'Network Interfaces' section of the restore
configuration used for the restore. Also check the Host properties > Client
attributes > select the Allow client restore of the NetBackup web UI to
ensure that the client has permissions to perform list and restore operations
■ The NetBackup primary server does not have a valid backup image (rc=227).
As a general rule, all BMR restores should make use of fixed ip-address information
and not make use of DHCP or DNS during the restore. This can be reset after the
BMR restore has completed, if so desired.
Troubleshooting 198
The VM takes long time for booting after BMR Physical backup conversion to virtual machine is performed
on 32-bit architecture Windows OS
■ If you are not able to view the datastores or resource pool/vApp or folder of
hypervisor, check the connectivity of the Hypervisor as mentioned earlier in this
section. If connectivity exists, but you are still not able to get the entries, refer
the bpVMutil and bpVMreq logs with verbose level 6. Refer Table 10-1 for logs
location.
Troubleshooting 200
Many services on Solaris 11 and newer print warning messages during a system boot and during BMR first
boot
Table 10-1
Component Log directory Resides on
sendmail/filesys_update failed
These messages are also seen during normal operating system installation on the
system and therefore can be ignored.
Another set of messages that is seen on the console during BMR first boot are
related to zpool and the Solaris Zones reconfiguration. All of these messages are
harmless and have no effect on System Restore, and the zpools and the zones
coming to the correct state
Troubleshooting 201
Solaris Zone recovery on Solaris 11 and newer takes time to reconfigure after a BMR restore during first boot
These messages come from SMF services and have no effect on system recovery.
For each disk in the computer you may see the error message. However, when
you log on and run the zpool status -x command, you see the following message:
That is because of the ZFS import operation that is done during the first boot
sequence. Bare Metal Restore (BMR) restores storage pools and contents in the
BMR restoration environment and later imports to the client environment during
first boot. That can cause an error message or a warning message during the first
boot operation.
These messages only occur during the first boot operation and you can safely ignore
them.
/etc/resolv.conf
/etc/sysconfig/network-scripts/ifcfg-eth*
■ Windows:
See the following URLs to modify the domain name in Windows:
■ http://windows.microsoft.com/en-US/windows7/Connect-your-computer-to-a-domain
■ http://support.microsoft.com/kb/295017
After the restore process is complete, you can see some error message displayed.
For more information, refer
https://www.veritas.com/support/en_US/article.TECH73586
Communication between the master server and the client may fail
even if the client has a valid host ID-based certificate
This issue is observed primarily in the Dissimilar System Restore (DSR) on Windows
platform.
This issue may occur due to a failure in the Network Settings during the cleanup
operation in the first boot.
The issue may persist even after you have corrected or updated the Network
Settings communication manually.
Workaround: To resolve this issue, perform the following steps:
1. Navigate to the path on your target client system which has NetBackup installed.
For Example:
c:\program files\veritas\netbackup\bin
Note: Refer to the HP EFI manuals for more details on how to handle the EFI shell.
Once the client computer comes up, log on to the computer as root and run the
following command to enable auto-booting.
setboot -p <hardware_path_of_boot_harddrive>
nbcertcmd -getCertificate
For more details on the commands, see the NetBackup Commands Reference
Guide.
http://www.veritas.com/docs/DOC5332
Add an appropriate host entry or host To restore BMR configurations of NetBackup 8.1.1
mapping for <Name of the host> and and later, a valid host ID to host name mapping for
retry the operation. the selected host name must be present.
https://www.veritas.com/support/en_US/article.DOC5332
Reset the host attributes for <Name To restore BMR configurations of NetBackup 8.0 for
of the host> and retry the operation. a host that is known to the master as communicating
securely (For Example: NetBackup 8.1 and above
hosts), you must reset the host for a successful
communication.
https://www.veritas.com/support/en_US/article.DOC5332
Reset host attributes for all hosts with A host name may be associated with multiple host
the mapping name <Mapping Name> IDs.
and retry the operation.
For example: In a clustered environment.
https://www.veritas.com/support/en_US/article.DOC5332
Set the 'autoreissue' parameter for A host name may be associated with multiple host
one of the host IDs of <Name of the IDs.
host> and retry the operation.
For example: In a clustered environment.
https://www.veritas.com/support/en_US/article.DOC5332
https://www.veritas.com/support/en_US/article.DOC5332
https://www.veritas.com/support/en_US/article.DOC5332
BMR client <Name of the client> is To restore BMR configurations of NetBackup 8.1.1
ready to be restored. This operation and later, you are provided with a limited period of
is valid for a limited period of time. The time. The default is 48 hours.
default is 48 hours. Boot the client to
You can edit or update the default validity of 48 hours
proceed.
to the desired value using web.conf file.
https://www.veritas.com/support/en_US/article.DOC5332
Note: This is not a requirement to restore BMR
configurations of NetBackup 8.0.
Troubleshooting 210
Media restore of Solaris x86 11.2 or later clients may prompt for maintenance mode user name and password
BMR client <Name of the client> is To discover BMR configurations of NetBackup 8.1.1
ready to be discovered. This operation and later, you are provided with a limited period of
is valid for a limited period of time. The time. The default is 48 hours.
default is 48 hours. Boot the client to
You can edit or update the default validity of 48 hours
proceed.
to the desired value using web.conf file.
https://www.veritas.com/support/en_US/article.DOC5332
Note: This is not a requirement to restore BMR
configurations of NetBackup 8.0 and earlier versions.
The specified IP address <IP If the IP address that you have specified during
address> is not associated with the Prepare to Discover (PTD) operation for a particular
host name <Name of the host>. BMR client is not associated with that client, the PTD
Specify an appropriate IP address for operation fails. You must ensure that you have
successful Prepare To Discover entered the appropriate IP address.
operation.
The Prepare To Discover operation is If the IP address that you have specified during
not successful, because the specified Prepare to Discover (PTD) operation cannot be
IP address cannot be resolved. resolved, the PTD operation fails. You must ensure
that you have entered the appropriate IP address.
At the same time, BMR prompts you to enter the network adapter name:
Enter the network adapter (LINK) name from the above list
corresponding to MAC Address:
Troubleshooting 211
Discovery task may remain in Finalizing state after client PTD task completes successfully
If you enter the network adapter name, it is received as user name for system
maintenance and system may further prompt you to enter the password. For
example, if you have entered the network adapter name as net0, system shows
the following prompt:
This issue is observed because one of the Solaris services which is non-critical for
restore has fallen into the maintenance mode.
Workaround: To resolve this issue, enter Ctrl+d and proceed with BMR restore.
3 Run the following command by providing the correct client host name for
<clientName>:
C:\>dism /Get-MountedWimInfo
Mounted images:
Troubleshooting 213
Shared Resource Tree (SRT) creation fails with an error after BMR restore if a backup operation was initiated
on the boot server and client while the SRT creation was in progress
1. To create a new SRT, you must remove or clean the directory <NetBackup
Install Path>/BareMetal/Server/Data/BaseSrd.
If you try to remove the dir / files which reside on this path, an error
message is displayed.
Error messages
■ 01.12.2021 10:58:30 - Error bpbrm (pid=1761542) BMRERR: Received BMR
error: Failed to import Config file. (27)
■ 01.12.2021 10:58:31 - Error bpbrm (pid=1761542) BMRERR: Received BMR
error: Unable to parse client information. (6)
■ 01.12.2021 10:58:31 - Error bpbrm (pid=1761542) BMRERR: Received BMR
error: Failed sending the discovery. (21)
■ 01.12.2021 10:58:31 - Error bpbrm (pid=1761542) BMRERR: Received BMR
error: BMR information discovery failed. (35)
■ 01.12.2021 10:58:31 - Info bmrsavecfg (pid=0) done. status: 1: the requested
operation was partially successful.
bmrsaveconfig -infoonly fails for the client
[root@gf0vsxas024l logs]# /usr/openv/netbackup/bin/bmrsavecfg -infoonly
sh: /bin/netstat: No such file or directory
sh: /sbin/ifconfig: No such file or directory
Troubleshooting 215
BMR backup and restore job details does not display on the NetBackup web UI's activity monitor
Cause
Identification of the failure in the logs reveals that the issue is related to the use of
ifconfig and netstat - these commands are deprecated in RedHat 8.3 and RedHat
8.4 - these can be used if the net-tools package is installed - but they are not present
by default - they have been replaced by IP and SS respectively
The common executables netstat and ifconfig are not installed on the Red
Hat 8.4 client.
The BMR option in the policy calls bmrsavecfg to run on the client and this calls
the executables and they are not found.
Solution
Follow the steps to receive BMR information during backup operation without error:
■ Install the net-tools package
■ Install the executables manually from the operating system.
■ Then run the backup job again.
Note: The incremental data restore is not currently supported, however, fresh VM
creation from an incremental backup is possible.
Master server: NetBackup primary server that takes BMR enabled backup of client.
Note: Refer following sections and for more details on configuring BMR master
server and enabling BMR client protection.
Note: You do not need extra hardware for VIC host. VIC host can be optionally
configured over a virtual machine.
VIC can also be configured over primary or media server if server OS is of same
OS family as that of client being converted. Though it is not recommended to set
up VIC on NetBackup primary or media server as VM creation process consumes
resources and it can slow down NetBackup server Performance. For details on
currently supported Hypervisor servers for virtual machine conversion operation
See “BMR support for virtual environment” on page 252.
First, you need to enable the BMR server on your NetBackup primary server.
For details on how to enable BMR server, See “Configuring BMR Master Server”
on page 17.
■ Client's BMR enabled backup
Configure NetBackup policy for BMR. Enable the check box for BMR for the
Collect disaster recovery information option in backup policy attributes. For
details, See “Configuring policies to back up BMR clients” on page 24.
■ BMR backup policy requires at least OS volumes added as part of backup
selection. In case of Windows, Boot, System Volume, and System State need
to be added under backup selection list.
NetBackup recovery This is NetBackup client host-name which to be used as VIC (Virtual
host: Instance Converter). or recovery host. This host prepares VM on
intended VMWare server.
Note: VIC OS has a rule that if client that is being converted to VM
has Windows-based family, then you Must set Windows-based VIC
. VIC can be set on physical or virtual machine if this OS rule is
satisfied. However, it is not recommended to set up VIC on
NetBackup primary or media server as Virtual Machine creation
process consumes resources and it can slow down NetBackup server
Performance.
VMWare Tools ISO Enter the absolute path where the VMWare .iso file is located on VIC
files: host that is entered earlier in this dialog box.
VMWare Folder: The folder where the destination virtual machine to be created.
Display Name: Enter a display name for the virtual machine to be created.
Resource Pool: Select the intended resource pool name from the drop-down menu.
Datastore/Datastore These are storages connected to ESX server. If you select option
Cluster: Use the same datastore/datastore cluster for all VMDKs then all
V-disks belonging to the VM will be created on the same datastore
or datastore cluster. If this option is not selected, then later screen
of this wizard will provide option to map individual V-disk to the
datastore.
Over-write existing VM: Select this option to enable deletion of existing virtual
machine in case of duplication of display name. If a virtual
machine with the same display name exists at the
destination, that virtual machine will be automatically
deleted before the restore begins; otherwise, the restore
fails. If you do not select this option, you need to manually
delete the duplicate VM name.
Remove network interfaces: If this option is selected then original client network
interfaces will not be configured on the destination. If this
option is not selected, then same number of network
interfaces and their details existing on source client
configuration will be configured on the VM.
Creating virtual machine from client backup 227
Virtual machine creation from backup
Power-on virtual machine after Select this option to have the recovered virtual machine
recovery: automatically turned on when the recovery is complete.
Restore System disks and Select this option to restores the OS disk volumes only in
volumes only: case where only OS needs to be recovered on VM.
Thin Provisioning: Select this option to configure the restored virtual disks
in thin format. Thin provisioning saves disk space through
dynamic growth of the vmdk file. The vmdk files are no
larger than the space that the data on the virtual machine
requires. The virtual disks automatically increase in size
as needed.
Thick Provisioning: Select this option to configure the restored virtual disks
in thick format. It creates virtual disk length that is
equivalent to physical disk length on the VM. Creation of
the virtual disks may take more time with this option.
the individual disks where recovery process creates equivalent VMDK file on the
correspondent datastore.
Note: In case you have checked the option Use the same datastore/datastore
cluster for all VMDKs in the Conversion to VM wizard, then the storage destination
is already selected.
3 Run the following command on the non-master host and enter the token when
prompted:
nbcertcmd -getCertificate -token
4 To verify that the certificate is deployed on the host, run the following command:
nbcertcmd -listCertDetails
Note: Make sure that you are not restricting OS disk/s. Otherwise created VM
will not boot.
■ Point-in-time (PIT) VM creation from PIT backup: You can retrieve PIT
configuration for a backup image.You can also retrieve the PIT configuration
and copy it from the NetBackup web UI.
Creating virtual machine from client backup 233
Virtual machine creation from backup
Creating virtual machine from client backup 234
Virtual Machine Creation CLIs
resourcepool= [optional]"/TestFolderAboveDC/Public
Datacenter/host/bmrvmw1.vxindia.veritas.com/Resources"
harddisk=0:"B2V_4TB"
harddisk=1:"storage1 (2)"
harddisk=2:"storage2 (1)"
■ BMR logs
2 To display details about a task, right-click a task in the Details pane and then
select Properties.
You also can select one of the following other options to manage tasks:
Clean Up The resources that are used by the task are unallocated, the State
is set to Done, and Status is set to 150 (terminated by user).
You can clean up the tasks that are in an Active or Waiting state.
Delete You can delete the tasks that are in a Done state.
Monitoring Bare Metal Restore Activity 239
Monitoring backup jobs
Investigate nonzero status of a backup job and resolve problems so backups occur
and the agent collects and sends the configuration to the master server.
Note: In case BMR configuration backup job fails (normally, the job with the lowest
job ID), the file system data backup completes successfully. In this case, after
successful file system data backup, BMR configuration backup job is marked as
Partially Completed highlighted in yellow.
Following table shows different task status codes related to VM conversion, with
description.
BMR logs
You can monitor BMR activity by viewing the messages that are generated by BMR.
BMR activity log files are stored in the following directories on the master server:
■ /usr/openv/logs directory (UNIX and Linux)
■ install_path\NetBackup\logs folder (Windows)
BMR uses a standardized naming format for log files.
The following is an example log file name:
51216-119-3892578826-050225-0000000000.log
The following are the components of this example log file name:
■ 51216 is the product ID for NetBackup.
■ 119 is the originator ID of the process that wrote the log (bmrd or bmrbd, the
Bare Metal Restore master or boot server service).
■ 3892578826 is a decimal ID for the host that created this log.
■ 050225 is the date in YYMMDD format.
■ 0000000000 is the rotation number indicating the instance of this log file. If the
file reaches maximum size and a new log file is created for this originator, the
file rotation number increases by 1.
The following types of messages can appear in unified logging files:
■ Application log messages. These include informational, warning, and error
messages.
■ Diagnostic log messages. The amount of information that is logged depends on
the logging level.
■ Debug log messages. These are primarily for Veritas support and engineering.
The amount of debug information that is logged depends on the logging level
that is specified for the NetBackup master server.
Monitoring Bare Metal Restore Activity 243
BMR logs
119 bmrd and bmrbd. Bare Metal Restore master and boot server services. The
bmrbd boot server process runs on a BMR boot server.
121 bmrsavecfg. Bare Metal Restore the agent that runs on client systems, collects
the client configuration, and saves the client configuration to the master server.
122 bmrc. Bare Metal Restore the utility that clients use to communicate with the
BMR master server during a restore. Runs on the restoring client.
123 bmrs. The Bare Metal Restore command-line interface for the various activities
that are performed by the GUIs.
125 bmrsrtadm. Bare Metal Restore utility that creates and manages shared
resource trees and creates bootable CD media or DVD media for restores. Runs
on a BMR boot server.
126 bmrprep. Bare Metal Restore utility that prepares BMR for a client restore or
discovery. Runs on the master server.
129 bmrconfig. Bare Metal Restore utility that modifies a client's configuration.
130 bmrcreatepkg.exe. Bare Metal Restore utility to add Windows drivers, service
packs, and hotfixes to the BMR master server so they can be used in a restore.
Runs on Windows boot servers.
131 bmrrst.exe and bmrmap.exe (Windows systems only). Utilities that restore
Windows Bare Metal Restore clients. Run on the restoring client.
142 bmrepadm. A utility that manages Bare Metal Restore the external procedures
that are used during restores. Runs on the master server.
152 bmrovradm. A utility that manages custom override functions for Bare Metal
Restore.
248 bmrlauncher. A utility that prompts for IP information in the new Windows
Fast Restore environment.
434 bmrb2vrst. A utility that does VM creation on VIC (NetBackup recovery) host.
Monitoring Bare Metal Restore Activity 244
BMR logs
vxlogview Use this command to view the logs that are created by unified logging.
vxlogmgr Use this command to manage unified logging files (for example, to
move or delete log files).
/usr/openv/netbackup/logs/bmrrst/client_name/log.mmddyy (UNIX)
install_path\NetBackup\logs\bmrrst\client_name\log.mmddyy (Windows)
On UNIX and Linux systems, the messages include external procedure begin and
end messages (begin and end logging is not performed by the BMR restore process
running on Windows systems).
Unlike BMR activity logs, the restore log files are text files.
Appendix A
NetBackup BMR related
appendices
This appendix includes the following topics:
■ BMR client recovery to other NetBackup Domain using Auto Image Replication
■ Secure communication compatibility matrices for BMR for NetBackup 8.1.1 and
later releases
would need to be done for network boot recovery depending on the type of OS.
Following sections provide the details for specific platforms.
■ tftp-server
■ dhcp
log-facility local7;
ddns-update-style none;
ignore unknown-clients;
subnet 10.10.5.0 netmask 255.255.255.0 {
default-lease-time 600;
max-lease-time 7200;
option domain-name "example.com";
option broadcast-address 10.10.5.255;
option domain-name-servers 10.10.1.4,10.88.24.5;
NetBackup BMR related appendices 247
Network services configurations on BMR boot Server
To verify the /etc/dhcpd.conf file syntax, restart the daemon and ensure that
it starts successfully by running the following command:
/etc/init.d/dhcpd restart
■ dhcp-base
■ dhcp-server
■ inetd
■ tftp
■ Modify the /etc/dhcpd.conf file to define the networks it serves. You do not
have to define host information; hosts are added and removed as needed by
the Bare Metal Restore software. The following is an example configuration:
log-facility local7;
ddns-update-style none;
ignore unknown-clients;
subnet 10.10.5.0 netmask 255.255.255.0 {
default-lease-time 600;
max-lease-time 7200;
option domain-name "example.com";
option broadcast-address 10.10.5.255;
option domain-name-servers 10.10.1.4,10.88.24.5;
option routers 10.10.5.1;
}
To verify the /etc/dhcpd.conffile syntax, restart the daemon and ensure that it
starts successfully by running:
/etc/init.d/dhcpd restart
NetBackup BMR related appendices 248
Network services configurations on BMR boot Server
Note: DHCP server needs to be configured on Linux BMR boot server. Any existing
DHCP server in the network cannot be used for Linux BMR network-based boot
recovery. It is recommended to shut down any other DHCP server while Linux client
is network booting over BMR boot server. If the client DHCP boot request goes to
the other DHCP server, then network boot recovery fails. This is not a BMR limitation
and instead the way this boot protocol works.
mkdir /tftpboot
■ If the TFTP entry is not present in file /etc/inetd.conf file, add the following line.
tftp dgram udp6 wait root /usr/sbin/in.tftpd in.tftpd -s /tftpboot
■ Restart TFTP.
svcs network/tftp/udp6 svcadm restart network/tftp/udp6
Note: For Solaris, BMR does not support Solaris WAN-based boot protocol. Though
in case of cross subnet network-based boot recovery is intended then Relay Boot
server can be used.
Note: Do not use dhcpconfig command-line utility to set up DHCP server in case
of Solaris 11.0 and later versions. IP lease time-line related issues have been
observed with command-line usage.
DHCP service requirements: DHCP server can exist on the same Boot Server host
or somewhere on the network.
BMR PXE and TFTP service requirement and configuration:
■ Make sure that there is no other PXE server running in the same subnet while
BMR NW boot is happening.
This restriction is more due to the way this network protocol works. In case client
NW boot request goes to un-intended PXE server then client NW boot fails. It
does not re-direct the request to other valid PXE server in the network. Hence
recommendation is to keep only valid BMR PXE service running while NW
booting your client for BMR recovery.
■ Post BMR boot server registration, navigate to BMR PXE Configuration Wizard
available on Windows boot server.
This wizard can be located in Start > Programs > NetBackup. This wizard
prompts user for DHCP server location. Depending upon your DHCP server
location (either same boot server computer or any other computer in the network),
the wizard prompts to run netsh command-lines on your DHCP server.
■ Finish the wizard for successful PXE, TFTP, and DHCP server configuration.
If the Windows boot server is to be installed on an Active Directory Server, let the
legacy restore method to share SRTs with restoring clients. Set the following security
settings:
Microsoft network server
Digitally signed communications (always) – Disabled
For details about general BMR support for multipath environment, See “BMR support
for multi-pathing environment” on page 251.
and restore only operating system then post BMR recovery if the multi-pathed disks
are attached to the target host then file systems on top of them may come online
automatically. Refer tables Actions for nonsystem disks and Import Actions for more
details.
If the client setup has operating system volumes based on multi-pathing environment,
then BMR cannot recover this system.
Note: All above features are supported on Solaris SPARC and Solaris x86_64
architectures.
BMR does not support Solaris clients with the following configurations:
NetBackup BMR related appendices 254
Solaris zone recovery support
To automate BMR zone restoration, Add entries to the global zone /etc/vfstab
that cause BMR to restore them (unless unmapped by DDR), as follows:
■ For FS entries, the global zone devices are used as special and raw values with
a mount point that appears under the root of the non-global zone. The entry to
add to the global zone's /etc/vfstab should use the global zone's device paths
with the full path to the non-global zone mount point, including the zone path.
For example, if the zone looks like:
zonepath=/export/zone1
fs:
dir=/export
NetBackup BMR related appendices 256
Solaris zone recovery support
special=/dev/dsk/c0t9d0s6
raw=/dev/rdsk/c0t9d0s6
type=ufs
■ For device entries mounted by the non-global zone, the following issues must
be dealt with when you configure for BMR restoration:
■ The dynamic mount that is used involves the imported device path under
the zone path. For a device that is mounted by /etc/vfstab inside a
non-global zone, there are one or more device entries in the zone, such as
the following:
zonepath=/export/zone2
device:
match=/dev/*dsk/c0t0d0s4
The devices that are listed are in the non-global zone's /etc/vfstab as
follows:
(If you use the device paths relative to the zone path, BMR only recreates
the mount point instead of restoring the whole file system.)
■ The device match should not use wildcards to allow BMR to edit if DDR is
used. When the device specification involves a wildcard, if DDR mapping is
done that affects the zone (for example, if you unmap or move a file system
from one disk to another), BMR is not able to edit the entry. The affected
zone's /etc/vfstab is edited, but the device match entries are edited only
if the match does not include a wildcard.
For example, change the following entry:
NetBackup BMR related appendices 257
BMR client recovery to other NetBackup Domain using Auto Image Replication
match=/dev/*dsk/c0t0d0s4
match=/dev/dsk/c0t0d0s4
match=/dev/rdsk/c0t0d0s4
If the entries are changed as the example shows, BMR DDR correctly updates
the zone definitions and vfstab file.
Note: While you restore BMR configurations in a BMR A.I.R. setup, you may come
across the following error: Add an appropriate host entry or host mapping
for Name of the host and retry the operation.
To resolve the issue, you need to add a host in the host database of the DR domain.
See “Adding a host in the host database of the DR domain” on page 258.
Without any manual backup import or configuration change, client can be completely
recovered at DR domain using BMR network or media based recovery procedure.
You can also create client VM onto DR domain Virtual Environment Server using
the Direct VM creation from backup feature.
Refer to the Creating virtual machine from client backup chapter.
Note: Make sure BMR master server on DR domain is enabled; otherwise BMR
configuration import at DR site fails.
Note: Veritas does not recommend adding a host manually except for specific
scenarios, such as in a BMR A.I.R. setup. Before adding a host, you must ensure
that the host entry that you want to add does not already exist in the host database.
NetBackup BMR related appendices 259
Secure communication compatibility matrices for BMR for NetBackup 8.1.1 and later releases
NetBackup 8.1.1 and NetBackup 8.1.1 and NetBackup 8.1.1 and Supported
later* later* later*
NetBackup 8.1.1 and NetBackup 8.1.1 and NetBackup 8.0 Not Supported
later* later*
NetBackup 8.1.1 and NetBackup 8.0 NetBackup 8.1.1 and Not Supported
later* later*
NetBackup 8.0 NetBackup 8.1.1 and NetBackup 8.1.1 and Not Supported
later* later*
*NetBackup 8.1.2 release onwards BMR operations are supported on AIX and
HP-UX platforms.