External procedure logging examples
The following logs are created on the BMR master server during the restore process:
/usr/openv/netbackup/logs/bmrrst/client_name/log.mmddyy (UNIX) install_path\NetBackup\logs\bmrrst\client_name\log.mmddyy (Windows)
On UNIX and Linux systems, the BMR restore process writes external procedure begin and end messages to the logs. (On Windows systems, the BMR restore process does not perform begin and end logging.) You can use the bmrc command in your external procedure scripts to write messages to the logs also.
External procedures write messages when they start and finish. A message includes the date and time that the procedure began, the client name, and a description that includes the external procedure name. See the following examples:
2005/08/02 12:10:38.180 w2k200,sol157 INFO: Executing External Procedure: sol123,sol123_prerestore. 2005/08/02 12:10:38.350 w2k200,sol157 INFO: Completed executing External Procedure: sol123,sol123_prerestore.
You can use the bmrc command to write messages to the restore log. The following is an example of a bmrc command that writes a message during a restore of client sol123:
bmrc -operation create -resource message -client sol123 -msg " message text to log"
Alternatively, you can pipe data to the bmrc command, as in the following example:
echo "Hello World" | bmrc -operation create -resource log -client sol123
The following is the log entry from the previous command:
Restoration log start time: 2005/03/28 10:59:27 Hello World. Restoration log end time: 2005/03/28 10:59:27
When you start the bmrc command in an external procedure, specify the full path in the restore environment, as follows:
On UNIX and Linux clients:
/usr/openv/netbackup/binOn Microsoft Windows clients:
%SystemDrive%\BMR\NBU\binAt the first boot external procedure point, the path to the bmrc command is
install_path\NetBackup\binon Microsoft Windows clients.
For more information about the bmrc command, see the NetBackup Commands Reference Guide.