Name
bmrconfig — change configuration settings
SYNOPSIS
-help [-resource resourceType [-platform win | hp | aix | solaris | linux] [-manager ldm | lvm | native | sfw | svm | vxvm | zfs] [-operation add | change | clearALL | delete | display | list | map]]
-operation verify -client clientName -configuration configName
-operation initialize -resource disk | network | device | all -client clientName -configuration configName -sourceconfiguration discovered_configName
-operation initialize -resource disk | network | device | all -client clientName -configuration configName -sourceclient source_clientName -sourceconfiguration source_configName
-operation initialize -resource driver -client clientName -configuration configName
-operation add | change | clearALL | delete | display | list | map -resource resourceType [-name resourceName] [-manager ldm | lvm | native | sfw | svm | vxvm] -client clientName -configuration configName [-attributes "key=value" ["key=value" ...]]
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 bmrconfig command changes the configuration of the 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 if it contains white space or a shell-interpreted characters. To determine the specific set of attributes that apply to a resource, use bmrconfig -operation list -resource resourceType.
The following are some attributes specific to Solaris ZFS:
-cache device - Cache device if used.
-copies number of copies - applies only to the mirror layout
-devtype - The possible device types are the following:
concat - concatenation layout
mirror - mirror layout
raidz1 - raidz1 layout
raidz2 - raidz2 layout
raidz3 - raidz3 layout
-disk disk name - Disk name to be used. Provide a disk name for every disk used.
-log device - Log device if used.
-slice slice name - Slice name to be used. Provide a slice name for every slice used.
-spare - spare device if used.
-storagepool ZFS storage pool name - Provides a ZFS storage pool name during ZFS and volume operations.
- -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.
- -initialize
Initializes BMR configuration on a specified client.
- -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
zfs - ZFS 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
clearALL - 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
- -platform win | hp | aix | solaris | linux
The platform of the specified resource. Used with -help only.
- -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 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
zfsfilesystem - ZFS file system
zfsstoragepool - ZFS storage pool
zfsvolume - ZFS volume
- -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
Example 10 - On UNIX, map a ZFS storage pool set up in a mirrored layout that provides three copies:
# bmrconfig -operation map -resource zfsstoragepool -client solbox -config solconfig -namedatapool -attributes devtype=mirror copies=3 spare=/dev/dsk/c1t1d0 cache=/dev/dsk/c1t1d1 log=/dev/dsk/c1t1d2 disk=/dev/dsk/c1t1d3 disk=/dev/dsk/c1t1d4
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.
SEE ALSO
See bmrs.