|
|
<admin_dir_path>nbemmcmd [-addhost] [-changesetting] [-deletehost] [-errorsdb] [-getemmserver] [-help] [-listhosts] [-listmedia] [-listsettings] [-machinealias] [-renamehost] [-servercontrol] [-setemmserver] [-updatehost]
<admin_dir_path>nbemmcmd -addhost [-activenodename string] [-brief] [-clustername string] [-displayname string] [-machinedescription string] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp [-masterserver string] [-netbackupversion level[.major_level[minor_level]]] [-operatingsystem hpux | linux | rs6000 | solaris | windows] [-scanability unsigned_integer]
<admin_dir_path>nbemmcmd -changesetting -machinename string [-ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA 0|1|no|yes] [-AUDIT DISABLED | ENABLED] [-AUDIT_ RETENTION_PERIOD number_of_days] [-COMMON_SERVER_FOR_DUP default | preferred | required] [-DISABLE_AUTOMATIC_HOST_NAME_ADD 0|1|no|yes] [-DISABLE_BACKUPS_SPANNING_DISK 0|1|no|yes] [-DISABLE_DISK_STU_JOB_THROTTLING 0|1|no|yes] [-DISABLE_STANDALONE_DRIVE_EXTENSIONS 0|1|no|yes] [-DISALLOW_NONNDMP_ON_NDMP_DRIVE 0|1|no|yes] [-DO_NOT_EJECT_STANDALONE 0|1|no|yes] [-DONT_USE_SLAVE 0|1|no|yes] [-DRIVE_ERROR_THRESHOLD unsigned_integer] [-DRIVE_NAME_SEED 0|1|no|yes] [-emmname string] [-emmport unsigned_integer] [-MAX_REALLOC_TRIES unsigned_integer] [-MEDIA_ERROR_THRESHOLD unsigned_integer] [-MEDIA_REQUEST_DELAY unsigned_integer] [-MPMS_DISABLE_EVENTS 0|1|no|yes] [-MPMS_DISABLE_RANK unsigned_integer] [-MUST_USE_LOCAL_DRIVE 0|1|no|yes] [-NBUFS_DESTINATION_DSU string] [-NBUFS_DUP_TSU_TO_DSU 0|1|no|yes] [-NBUFS_RETENTION_LEVEL unsigned_integer] [-NON_ROBOTIC_MEDIA_ID_PREFIX string] [-PREFER_NDMP_PATH_FOR_RESTORE 0|1|no|yes] [-RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL 0|1|no|yes] [-SCSI_PROTECTION NONE | SPR | SR] [-SHAREDISK_MOUNT_POINT string] [-TIME_WINDOW unsigned_integer] [-UNRESTRICTED_SHARING 0|1|no|yes] [-VALIDATE_HOST_NAME 0|1|no|yes] [-VAULT_CLEAR_MEDIA_DESC 0|1|no|yes]
<admin_dir_path>nbemmcmd -deletehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp | master | media | ndmp-mediaid string
<admin_dir_path>nbemmcmd -errorsdb [-brief] [-prune [-days no_of_days] [-hours no_of_hours] [-minutes no_of_minutes]]
<admin_dir_path>nbemmcmd -listhosts [-brief] [-verbose] [-parsable] [-list_snap_vault_filers -machinename string] [-list_snap_vault_media_servers -masterserver string] [-list_sts_hosts -machinename string] [-list_sts_media_servers -masterserver string] [-list_app_clusters -masterserver string] [-servers_in_emm_cluster -clustername string] [-servers_in_app_cluster -clustername string] [-nbservers [-masterserver string]] [-display_server -machinename string -machinetype string] [-netbackupversion level[.major_level[minor_level]]]
<admin_dir_path>nbemmcmd -listmedia [-allrecords] [-mediaid string] [-mediatype unsigned_integer] [-poolname string] [-robotnumber unsigned integer] [-vaultcontainer string]
<admin_dir_path>nbemmcmd -listsettings -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]
<admin_dir_path>nbemmcmd -machinealias [-addalias -alias string -machinename string] [-deletealias -alias string] [-deleteallaliases -machinename string] [-getaliases -machinename string] -machinetype api | app_cluster | cluster | master | media | ndmp
<admin_dir_path>nbemmcmd -releasecache -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]
<admin_dir_path>nbemmcmd -renamehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp -newmachinename string
<admin_dir_path>nbemmcmd -setemmserver [-brief] -emmservername string [-masterserver string] -newemmservername string [-timeout unsigned_integer]
<admin_dir_path>nbemmcmd -updatehost [-activenodename string] [-add_server_to_app_cluster] [-brief] [-clustername string] [-delete_server_from_app_cluster] [-displayname string] [-machinedescription string] -machinename string [-machinestateop clr_admin_pause | clr_admin_pause_and_set_active | clr_disk_active | clr_ltid_restart | clr_master_server_connectivity | clr_tape_active | reset_all | set_admin_pause | set_disk_active | set_master_server_connectivity | set_tape_active] [-machinetype pi | app_cluster | cluster | master | media | ndmp] [-masterserver string] [-netbackupversion level[.major_level[minor_level]]] [-operatingsystem hpux | linux | rs6000 | solaris | windows]
The nbemmcmd command enables users to update a limited set of EMM database information. In addition, this command enables you to manage host entries, configuration options, and other miscellaneous items in the EMM database.
The following commands contain a variety of options that enable you to manage the EMM database. The names of the options are purposely long to provide the user with a better understanding of how the options are to be used. Because of the option name length, you need only type the first letter or letters of the command that make it a unique option. For example, to use the -changesetting option, type -c because no other command option starts with the letter c.
This option adds the specified host to the EMM database. The following entries can be adjusted by using this command option:
Specifies the version that the added host is running. The level variable has a range of 0-99. The major_level and minor_level variables are optional single-digit fields. No spaces are allowed between the major_level and minor_level variables.
For example, enter the following information to specify NetBackup 6.0:
-netbackupversion 6.0 or -netbackupversion 6
This option applies only to NetBackup Enterprise Servers that use the Shared Storage Option (SSO) feature.
A scan ability factor can range from zero to 9, with a default value of 5. This factor allows the assignment of scan hosts to be prioritized if a drive's scan host changes. Scan hosts with higher scan ability factors are chosen first.
The decision to use a scan_factor of zero for a server reduces the level of resiliency in your SSO configuration. Be aware of the servers that can be a scan host for a drive. If a drive loses a scan host, it makes the drive unavailable to any server.
Changes the configuration setting for a specified host and adds the settings that did not previously exist.
Change these configuration options by using the -changesetting command with the option name followed by the enable designator ("1" or "yes") or the disable designator ("0" or "no"). For example, the following command disables the ability of EMM to add a host name automatically:
# nbemmcmd -changesetting -DISABLE_AUTOMATIC_HOST_NAME_ADD no
Allows NetBackup to mix retention levels on media. The default condition is that each volume can contain backups of only a single retention level.
Enables and disables NetBackup auditing. An audit trail is a record of user-initiated actions in a NetBackup environment. Auditing gathers and records the information to help answer who changed what and when they changed it.
Specifies the number of days that user actions are to be retained for the audit report. If no retention period is indicated, the default audit retention period is 365 days. A value of 0 (zero) indicates that the records are never purged.
Determines how NetBackup finds the desired media server(s) to duplicate the data.
The media server used to read the image is the 'read media server'. The media server used to write the image is the 'write media server'. By default, when the source image is on a tape device, the read media server is the one that writes the backup image. Also, when the source image is on a disk pool with multiple media servers, any of those media servers may be used as the read media server. The choice for the write media server is limited to those that have access to the storage unit or storage unit group specified as the destination of the duplication.
The following are the possible settings of this option:
Default. NetBackup does not perform an exhaustive search for possible common servers (same read and write media server). If the common media servers are busy or unavailable, NetBackup uses a different write media server than the read media server. Use this option when you don't want an exhaustive search to impact the performance of the Resource Broker. This scenario can occur when a large job queue with duplication jobs wait for resources to become available.
Preferred. Look for a common media server to use. If one or more common media servers are found, but their resources (e.g., DSUs or tape drives and tapes) are busy, run the duplication job anyway by using two separate media servers (sending images over the network).
Required. NetBackup makes an exhaustive search to find a common server. If the common media servers are busy, NetBackup queues the resource request and waits for the resources to become available. If no common servers are in the NetBackup domain, or if a common server exists but is down, NetBackup runs the job with two separate media servers, sending the images over the network.
Disables the ability of EMM to add a host name automatically if it appears to be valid. An example of an invalid host name is a name that duplicates another host.
Disables the ability of a backup operation to disk to continue when a file system full condition occurs on a disk storage unit volume. It disables by using image fragments on multiple storage unit volumes.
Disables the disk storage unit job throttle action that occurs when disk storage units approach their high-water mark. Disk storage unit throttling limits the number of jobs that are started simultaneously to approach the high-water mark more accurately. Default: Throttle disk storage units that approach their high-water mark.
Disables non-robotic drive operations. During a backup, NetBackup does not automatically try to use whatever labeled or unlabeled media it finds in a non-robotic drive. Default condition is that stand-alone drive extensions are enabled.
The MDS logic on the EMM server reads this option. NetBackup tries to use an available drive that is based on the type of request as follows:
For a non-NDMP request of any kind, NetBackup tries to find an available non-NDMP drive. If a non-NDMP drive is not available and an NDMP drive is available, the slower NDMP drive is used. Non-NDMP requests include all type of requests apart from storage unit related requests (backups and write side of duplicates) and NDMP image restores.
If this entry is enabled, tapes in standalone drives are not ejected when a backup has completed on that host. (Tapes are ejected if end-of-media is reached during a backup.) Use when you want to keep a stand-alone drive ready after successful backups are performed.
Deselects the use of drive name rules to assign names to drives automatically.
Changes the threshold or number of drive errors that can occur before NetBackup changes the drive state to DOWN. Default: 2.
Selects the use of drive name rules to assign names to drives automatically.
Specifies the name of the EMM database server. This server contains the database that stores the media and device configuration information.
Specifies the maximum number of tries that NetBackup attempts to reallocate the media for future backups.
Changes the threshold or number of media errors that can occur before the media is frozen. Default: 2.
Specifies the number of seconds that NetBackup waits for a drive to become ready. Applies only to non-robotic drives. Default: 0 seconds. For example, assume that the delay is 150 seconds:
Add this information to
the bp.conf file on NetBackup servers
or enter a value for Media Request Delay in the Media host
properties.
If the client is also a master server and this option is active, backups for this client must occur on a local drive. If the client is not a master server, this entry has no effect.
Add this option to the
bp.conf file on master servers. Or
check the Must Use Local Drive setting in the General Server host
properties dialog box.
Specifies the media ID prefix that is used for creating non-robotic media. It applies to the host that the -machinename option specifies. The media ID prefix is an alphanumeric string of characters from one to three characters in length.
This EMM global option applies to every host that uses the EMM server. It is not a host option.
YES: The Media Manager automatically returns expired and unassigned media (originally from the same scratch pool) to the scratch volume pool.
NO: Disables the automatic behavior of returning media to the scratch pool. Use one of the Media Manager administration interfaces to move media.
Allows exclusive access protection for tape drives. With access protection, other host bus adaptors cannot issue commands to control the drives during the reservation. The three possible settings for this option are:
Enables you to set a value that is equal to the amount of time in which errors can be tracked. You can use this value with an error threshold (for example, media_error_threshold) to monitor the number of media errors that occur within the time window. The default setting is 12 hours.
Enables host name character validation according to NetBackup standard. If this option is disabled, you can use a name like "_host1", which does not follow the standard.
This option is an EMM global option that applies to every host that uses the EMM server. It is not a host option. When NetBackup media is returned from the off-site vault during a typical tape rotation, it is expired and is ready for reuse by new backups. To avoid confusion, it may be helpful to clear the old media description information when an expired tape is returned to the robot. If this entry is specified, the media description field is cleared when other Vault information is cleared from the Media Manager volume database.
Deletes an EMM machine record by using the required machine name and machine type.
Displays the information on all the hosts in a particular EMM domain. Use this command to ensure a level of consistency in a newly installed domain or modified domain.
Displays usage information for the specified command by entering the following:
nbemmcmd -help command
This option dumps the table structure for each known host.
Displays only the specified machine by the machine name and machine type.
Lists all of the application clusters of the specified master server.
Lists all of the SnapVault filers of the specified machine name See the -machinename option description that follows.
Lists all of the SnapVault media servers of the specified master server.
Lists all OpenStorage hosts connected to the specified machine name.
Lists all OpenStorage media servers that are connected to the specified master server.
Displays only the media servers and master servers. The default for -listhosts is to display all servers.
Specifies the machine version. The level variable has a range of 0-99. The major_level and minor_level variables are optional single-digit fields. There should be no spaces between major_level and minor_level.
For example, enter the following information to specify NetBackup 7.0:
-netbackupversion 7.0 or -netbackupversion 7
Lists all of the application cluster servers of the specified cluster.
Controls how host information is displayed. Multiple lines of output are printed, one for each parameter of a host.
Queries the volumes by media type.
Valid media types for NetBackup Enterprise Server are:
4mm, 8mm, 8mm2, 8mm3, dlt, dlt2, dlt3, dtf, hcart, hcart2, hcart3, qcart, 4mm_clean, 8mm_clean, 8mm2_clean, 8mm3_clean, dlt_clean, dlt2_clean, dlt3_clean, dtf_clean, hcart_clean, hcart2_clean, hcart3_clean.
Valid media types for a NetBackup server are:
4mm, 8mm, dlt, hcart, qcart, 4mm_clean, 8mm_clean, dlt_clean, hcart_clean.
Queries the volumes by pool number, an index into the volume pool. Use vmpool -listall to determine the index for a given pool name.
Queries the volumes by robot number. A robot number is a unique, logical identification number for the robot where the volume is located.
Lists the volumes that are stored in the container. The string variable is the vault_container_id, a string of up to 29 alphanumeric characters.
Specifies the host name of the pertinent EMM
server. If -emmname is not specified,
the default name is located in the bp.conf file.
Specifies the port number of the EMM server to
where calls are made. If -emmport is
not specified, the default port is specified in the bp.conf file.
The following parameters are used to maintain the alias list for a particular machine. Use them to view current aliases, add new aliases, or delete current aliases for an identified machine.
Adds an alias name to a machine. Identify the machine name that is to receive the alias as well as the machine type.
For example, to create a media server with the alias name blue, use the following command:
machinealias -machinename 10.80.91.83 -machinetype media -addalias -alias blue
Deletes an alias name from the database. This operation requires that you identify the alias to be deleted by using the -alias string command and machine type with this option.
Deletes all aliases for a particular machine. To perform this operation you must identify the machine name and the machine type.
Retrieves all aliases for a particular machine. To perform this operation you must identify the machine name and the machine type.
Specifies the string that identifies the alias name of a machine.
Release cache memory that the EMM server has used.
Specifies the host name of the pertinent EMM
server. If -emmname is not specified,
the default name is located in the bp.conf file.
Specifies the port number of the EMM server to
where calls are made. If -emmport is
not specified, the default port is specified in the bp.conf file.
This command, with the required machine name and new machine name options, renames the current machine name to a new machine name.
This command suspends and resumes control of a specified server. You can perform database maintenance without the corruption of existing data because a job began to run during this time.
This command changes the EMM server name for certain hosts in the domain whose name matches the old EMM server name. This command has the following options:
Specifies the new, or replacement, value for the EMM server.
Specifies a name of a master server for an EMM domain. If you omit this option when you use this command, the current machine is assumed.
Specifies a temporary timeout value in seconds to use for the duration of this command.
This command, when used with the following options, enables you to change a machine record that was specified by using the required -machinename option.
This option designates that the machine should be added to the application cluster that is specified in the -clustername option.
Designates that the machine should be removed from the application cluster that is specified in the -clustername option.
Displays the assigned name of a machine that is equivalent to the numbered identifier for that machine.
Adds a host and specifies the version it is running. The level variable as a range of 0-99. The major_level and minor_level variables are optional single-digit fields. There should be no spaces between the major_level and minor_level variables.
For example, enter the following to specify NetBackup 7.0: -netbackupversion 7.0
This option enables you to update the operating system of the machine.
# nbemmcmd -getemmserver These hosts were found in this domain: throttle, upwords Checking with host: throttle... Checking with host: upwords... Server Type Host Version Host Name EMM Server MEDIA UNKNOWN RELEASE (0) throttle throttle MASTER 6.0Alpha upwords upwords One or more hosts had mismatched EMM Servers. Run-time failure: The consistency check either failed or was incomplete. Command did not complete successfully.
# nbemmcmd -setemmserver -emmservername throttle -newemm upwords These hosts were found in this domain: throttle, upwords Checking with host: throttle... Checking with host: upwords... Server Type Host Version Host Name EMM Server MEDIA UNKNOWN RELEASE (0) throttle throttle EMM server name was changed. MASTER 6.0Alpha upwords upwords One media hosts had EMM Server name changed. Command was completed successfully.
orbitervm1 # ./nbemmcmd -listsettings -machinename orbitervm1 NBEMMCMD, Version:7.0 The following configuration settings were found: ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA="no" DISABLE_DISK_STU_JOB_THROTTLING="no" DISABLE_STANDALONE_DRIVE_EXTENSIONS="no" MEDIA_REQUEST_DELAY="0" MUST_USE_LOCAL_DRIVE="no" NON_ROBOTIC_MEDIA_ID_PREFIX="A" MAX_REALLOC_TRIES="1000" DISABLE_BACKUPS_SPANNING_DISK="no" DISALLOW_NONNDMP_ON_NDMP_DRIVE="no" DO_NOT_EJECT_STANDALONE="no" PREFER_NDMP_PATH_FOR_RESTORE="yes" DONT_USE_SLAVE="no" DRIVE_ERROR_THRESHOLD="2" MEDIA_ERROR_THRESHOLD="2" TIME_WINDOW="12" SCSI_PROTECTION="SR" NBUFS_DUP_TSU_TO_DSU="no" NBUFS_DESTINATION_DSU="NONE" NBUFS_RETENTION_LEVEL="0" MPMS_DISABLE_RANK="0" MPMS_DISABLE_EVENTS="no" UNRESTRICTED_SHARING="no" FATPIPE_USAGE_PREFERENCE="Preferred" FATPIPE_WAIT_PERIOD="15" FATPIPE_RESTORE_WAIT_PERIOD="5" FT_MAX_CLIENT_PORTS_PER_SERVER="2" FT_MAX_CLIENTS_PER_PORT="2" SHAREDDISK_MOUNT_POINT="/nbushareddisk" RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL="yes" VAULT_CLEAR_MEDIA_DESC="no" SCSI_PERSISTENT_RESERVE="0" Command completed successfully.