Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. NetBackup™ Commands Reference Guide
  3. Appendix A. NetBackup Commands
  4. bmrprep
NetBackup™ Commands Reference Guide

Name

bmrprep — prepare a client for restore or discovery

SYNOPSIS

bmrprep -restore -client clientName -config configurationName -srt srtName [-policy policyName] [-logging] [-runep] [-systemonly] [-import] [-enddate enddate] [-quickformat] [-cloud -amiid amiId -credname credname | {-keyname keyName -keyfilepath keyFilePath} [-useorigip]]

bmrprep -discover -newconfig configurationName -srt srtName [-client clientName -config configurationName] -address clientAddress -default defaultGateway -netmask netmask -mac clientMacAddress -server nbuServerAddress -console consoleDeviceName -architecture architectureName [-gateway serverGateway] [-logging] [-runep]

 

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/

On Windows systems, the directory path to this command is install_path\NetBackup\bin\

DESCRIPTION

The bmrprep command prepares a Bare Metal Restore client for a restore or for a hardware discovery process. This command only runs on the Bare Metal Restore master server.

OPTIONS

-address clientAddress

(UNIX clients only.) IP address of the client, in dotted decimal notation. Required only for a -discover operation; optional if -client and -config options are specified.

-amiid amiId

The Amazon Machine Image (AMI) ID. This option is only used with RHEL Linux clients and with the -cloud option. This option is only necessary for the -restore operation. Use this option with RHEL Linux and Windows clients.

-architecture architectureName

(UNIX clients only.) Architecture of the client to be discovered. Required only for a -discover operation; optional if -client and -config options are specified.

-client clientName

Name of the client to restore.

-cloud

This option is only used to with RHEL Linux clients to restore Amazon Web Services virtual machines. This option is only necessary for the -restore operation. Use this option with RHEL Linux and Windows clients.

-config configurationName

Name of the configuration to use.

-console consoleDeviceName

(UNIX clients only.) Name of the console device to use during discovery. Required only for a -discover operation; optional if you specify the -client and -config options or use media boot.

-credname credName

The name of credential object of Instance access key category that contains keyname and sshkey. This option is used to specify a stored credential for accessing the Amazon Web Services virtual machine.

Use the option with the -cloud option and is only necessary for a -restore operation. Use this option with RHEL Linux and Windows clients.

Use of the -credname option is recommended as it offers better security than directly specifying -keyname and -keyfilepath.

You cannot use -credname with the -keyname and the -keyfilepath options.

-default defaultGateway

(UNIX clients only.) Default gateway address, in dotted decimal notation. Required only for a -discover operation; optional if you specify the -client and -config options or use media boot.

-discover

(UNIX clients only.) Perform a hardware discovery. Cannot be used with -restore.

-enddate enddate

Date for point-in-time restores.

The required date and time values format in NetBackup commands varies according to your locale. The /usr/openv/msg/.conf file (UNIX) and the install_path\msg\LC.CONF file (Windows) contain information such as the date-time formats for each supported locale. The files contain specific instructions on how to add or modify the list of supported locales and formats.

For more information about the locale of your system, see the NetBackup Administrator's Guide, Volume II.

-gateway serverGateway

(UNIX clients only.) Gateway to a NetBackup server, in dotted decimal notation. Required only for a -discover operation.

-import

Import non-system volume groups.

For more information about how to use this flag, see the Bare Metal Restore Administrator's Guide.

-keyfilepath keyFilePath

The path of the .pem file that has the key-pair that is used to create the Amazon Web Services virtual machine. This option is only used with the -cloud option. It's for RHEL Linux clients only and is only necessary for a -restore operation. You cannot use -keyfilepath with the -credname option.

-keyname keyName

The key name that is used to create the Amazon Web Services virtual machine. This option is only used with the -cloud option. It's for RHEL Linux clients only and is only necessary for a -restore operation. You cannot use -keyname with the -credname option.

-logging

Enable logging.

-mac clientMacAddress

(UNIX clients only.) MAC address of the client. Required only for a -discover operation. (Exception: Optional if the IP address is configured during initial program load (IPL)); optional if you specify the -client and -config options or use media boot.

-netmask netmask

(UNIX clients only.) Netmask of the client, in dotted decimal notation. Required only for a -discover operation; optional if -client and -config options are specified.

-newconfig configurationName

(UNIX clients only.) Name to be given to the discovered configuration.

-policy policyName

Name of the policy to be used.

-quickformat

(Windows clients only.) Quickly formats Windows partitions.

-restore

Performs a normal restore. Cannot be used with -discover.

-runep

Runs external procedures.

-server nbuServerAddress

(UNIX clients only.) A NetBackup server address, in dotted decimal notation. Required only for a -discover operation; optional if -client and -config options are specified.

-srt srtName

Name of the shared resource tree to use.

-systemonly

Restores system volume groups only.

For more information about how to use this option, see "Prepare to Restore Client dialog box" in the Bare Metal Restore Administrator's Guide.

-useorigip

Instructs the restore to use the same TCP/IP address from the backup system during the restore. You must make sure that the original instance is terminated and that the original TCP/IP address is available. This option is only used with the -cloud option. It's for RHEL Linux clients only and is only necessary for a -restore operation. Use this option with RHEL Linux and Windows clients.

NOTES

If you use NetBackup Access Management and your user credentials and the computer credentials expire, renew them before you perform prepare-to-restore operations. Use the bpnbat -Login command to renew your user credentials and the bpnbat -LoginMachine command to renew the computer credentials.

You can specify -? to display the command usage statement when it is the only option on the command line.

Feedback

Was this page helpful?
Previous

bmrepadm

Next

bmrs

Feedback

Was this page helpful?