DOCUMENTATION: How to use the "nbemmcmd -addhost" command to add a media server to a VERITAS NetBackup (tm) 6.0 environment.

Article:TECH43686  |  Created: 2008-01-31  |  Updated: 2014-11-04  |  Article URL http://www.symantec.com/docs/TECH43686
Article Type
Technical Solution


Environment

Subject

Issue



DOCUMENTATION: How to use the "nbemmcmd -addhost" command to add a media server to a VERITAS NetBackup (tm) 6.0 environment.


Solution



Manual:  VERITAS NetBackup (tm) 6.0 System Administrator's Guide for UNIX, Volume I
Page(s):  439
Modification Type:  Addition

Modification:
The NetBackup System Administrator's Guide for UNIX, Volume I, lists the following note when adding media servers to a NetBackup environment:

When adding a media server to an existing master server, run nbemmcmd -addhost to add the host to the enterprise media manager (EMM) database.

Starting with NetBackup 6.0, the process for adding a new media server to an existing NetBackup environment requires the following additional step:

After adding an entry for the media server to the /usr/openv/netbackup/bp.conf file or Windows registry, the nbemmcmd -addhost command must also be run. This command will add the media server to the enterprise media manager (EMM) server configuration.  Once this is complete, media and devices can be configured on the media server.  

It is recommended to add any known media servers when prompted during the installation of NetBackup 6.0. This will automatically add the media servers to the EMM server configuration during the installation. Any media servers created after the installation will require running nbemmcmd -addhost manually, in addition to the other steps needed to add a Media Server to an existing NetBackup 6.0 environment.

The nbemmcmd -addhost command must be run to add a media server to an existing NetBackup 6.0 environment.

For UNIX Media servers:
 
# cd /usr/openv/netbackup/bin/admincmd
 
# nbemmcmd -addhost -machinename <hostname> -machinetype <type> -masterserver <master_hostname> -operatingsystem <os> -netbackupversion <version>
 

 

 
For Windows Media Servers:
 
% cd <install_path>\VERITAS\NetBackup\bin\admincmd
 
% nbemmcmd -addhost -machinename <hostname> -machinetype <type> -masterserver <master_hostname> -operatingsystem <os> -netbackupversion <version>
 

 

 
A breakdown of the command line options is shown in Figure 1.

Figure 1
 
Option: Value Description
-addhost none This indicates a hostname will be added to the EMM server configuration.
-machinename media server hostname The hostname of the server to add to the EMM server configuration.
-machinetype api , cluster , master , media , ndmp The type of server to be added to the EMM server configuration.
-masterserver master server hostname The hostname of the Master server.
-operatingsystem hpux , linux , netware , rs6000 , solaris , tru64 , windows The type of operating system running on the server to be added.
-netbackupversion level.Major_levelMinor_level The NetBackup version running on the server to be added. Example: For NetBackup 5.1 MP3 use 5 or use 5.13



Examples:
A Windows media server named media1 is running NetBackup 6.0.
The master server named is nbumaster.
 

 
# nbemmcmd -addhost -machinename media1 -machinetype media -masterserver nbumaster -operatingsystem windows -netbackupversion 6
 

A Solaris media server named media2 is running NetBackup 5.0 Maintenance Pack 4.
The master server is named nbumaster.
 

 
# nbemmcmd -addhost -machinename media2 -machinetype media -masterserver nbumaster -operatingsystem solaris -netbackupversion 5
 

 
Note: Additional steps are required in order to add a NetBackup 5.x media server to a NetBackup 6.0 master server.  This includes running the nbpushdata -modify_5x_hosts command from the EMM server.  The nbpushdata command handles migrating the 5.x media server database (volDB, globDB, mediaDB, etc) information to the EMM server.  Additional information on adding servers and using the nbpushdata command can be found in the NetBackup (tm) 6.0 Installation Guide for UNIX and NetBackup (tm) 6.0 Installation Guide for Windows (both can be found below in the "Related Documents" section).
 

 
For information and examples on configuring a failover Media server in a clustered environment, consult Appendix C in the NetBackup (tm) 6.0 High Availability System Administrators Guide.  This contains information and examples for configuring a NetBackup Media server in a clustered environment.  The NetBackup (tm) 6.0 High Availability System Administrators Guide can be found below in the "Related Documents" section.
 



Legacy ID



279049


Article URL http://www.symantec.com/docs/TECH43686


Terms of use for this information are found in Legal Notices