bmrconfig

bmrconfig — change configuration settings

SYNOPSIS

<nbu_dir_path>bmrconfig -operation verify -client clientName -configuration configName

<nbu_dir_path>bmrconfig -operation initialize -resource disk | network | all -client clientName -configuration configName -sourceconfiguration source_configName

<nbu_dir_path>bmrconfig -operation initialize -resource disk | network | all -client clientName -configuration configName -sourceclient source_clientName -sourceconfiguration source_configName

On Windows systems, <nbu_dir_path> is <install_path>\NetBackup\bin\

DESCRIPTION

The bmrconfig command changes a configuration's system, network, volume, driver, and NetBackup settings. The read-only current configuration and discovered configuration cannot be changed. Use the bmrs command to create a copy of a configuration that you can change.

OPTIONS

-attributes: Attributes of the resource are specified as name-value pairs. The name is always an alphanumeric string. The value is free form but must be double quoted. To determine the specific set of attributes that apply to a resource, use bmrconfig -operation list -resource resourceType.

-client clientName: The NetBackup client name.

-configuration configName: The configuration to operate on.

-force: Forces the removal of a resource and all of its dependent resources.

-manager

The volume manager that controls the resource. Volume managers are as follows:

ldm - Windows Logical Disk Manager

lvm - AIX or HP-UX Logical Volume Manager

native - the volume manager native to the operating system

sfw - Veritas Storage Foundation for Windows

svm - Solaris Volume Manager

vxvm - Veritas Volume Manager

-name resourceName: The name of the resource to act on. The various volume managers determine the valid characters in a resource name.

-operation operation_name

The operation to perform. Operations are as follows:

add - adds a resource to the configuration

change - changes specific attributes of a resource

clearly - removes all resources except disks from a disk group

delete - removes a resource from the configuration

display - prints high-level information about the resource

help - prints the required resources and the optional attributes and values

initialize - initializes a configuration's hardware from a discovered configuration

list - prints all the instances of the specified resource type

map - maps a resource that includes dependent resources, from the original configuration to the working configuration

verify - checks that a config has sufficient data for a restore to succeed

-resource resourceType

The type of the resource on which the operation is performed. Resource types are as follows:

all - all resources

accesspath - a Windows access path

disk - a physical storage device

diskgroup - a logical grouping of disks

diskset - a Solaris Volume Manager disk set

driveletter - a Windows drive letter

esm - backup client identity

filesystem - a file system for UNIX, Linux, and Windows

gateway - a network gateway

host - a network server

hotfix - a Windows hotfix

hotsparepool - a set of the slices that are used for SVM failover

ip - network identity

license - a product license key

logicaldrive - a Windows extended partition; first one implicitly adds container

logicalvolume - an AIX or HP-UX logical volume

metadb - an SVM database replica slice

mountpoint - a path that serves as an access point to a volume

msd - a mass storage driver

multidevice - a Linux multidevice

nativedisk - Solaris Native disk resource

nativepart - Solaris Native partition resource

network - a sub network

nic - a network interface card

nicpkg - a network interface card driver

partition - Windows primary partition

physical volume - an AIX or HP-UX physical volume

slice - a Solaris slice; equivalent to volume

softpart - an SVM soft partition

volume - a logical division of a disk or a disk group

volumegroup - an AIX or HP-UX volume group

-sourceconfiguration source_configName: The configuration that is the source in an initialized configuration operation.

-sourceclient source_clientName: The client that serves as the source in an initialized configuration operation. If a source client is not specified, the configuration comes from the list of discovered configurations.

EXAMPLES

EXAMPLE 1

List the physical volumes in a configuration for client aixp31:

# bmrconfig -operation list -resource physical volume -configuration 
current -client aixp31

EXAMPLE 2

Map Native partitions on Solaris:

# bmrconfig -op map -re nativepart -name /dev/dsk/c1t0d0p1 -client
client1 -config config1 -attributes disk=/dev/dsk/c1t1d0p0
percent=50 partid=191 active=true

EXAMPLE 3

List the volume groups in a configuration for client aixp31:

# bmrconfig -operation list -resource volume group -configuration 
current -client aixp31

EXAMPLE 4

Display the attributes of a volume group for client aixp31:

# bmrconfig -operation display -resource volume group -configuration 
current -client aixp31 -name rootvg

EXAMPLE 5

Initialize the new configuration with the discovered hardware for client aixp31:

# bmrconfig -operation initialize -resource config -configuration 
mynew -client aixp31 -sourceconfiguration discover

EXAMPLE 6

Add a volume group to a configuration for client aixp31:

# bmrconfig -operation add -configuration mynew -client aixp31 
-resource volume group -name rootvg -attributes physical 
volume=hdisk1

EXAMPLE 7

Add a disk to a volume group for client aixp31 (requires a full list of physical volumes to be specified):

# bmrconfig -operation modify -configuration my new -client aixp31 
-resource volume group -name rootvg -attributes physical 
volume=hdisk1 physical volume=hdisk0

EXAMPLE 8

Remove a physical volume from a volume group for client aixp31:

# bmrconfig -operation modify -configuration my new -client aixp31 
-resource volume group -name rootvg -attributes physical 
volume=hdisk0

EXAMPLE 9

Map a volume group from the original configuration for client aixp31:

# bmrconfig -operation map -configuration my new -client aixp31 
-resource volume group -name rootvg

NOTES

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