Examines the log file for a server process
Synopsis
bos getlog -server machine -file log_file [{-noauth | -localauth}] [-help]
Options
-server machine
Names the server machine from which to retrieve the log file. The BOS Server on this machine executes the command. To run this command using a
privileged identity, specify the full DCE path name of the machine. To run this command using the unprivileged identity nobody (the equivalent of running the command with the
-noauth option), specify the machine's host name or IP address.
-file log_file
Names the log file to display. If a simple file name is provided, with no slashes, the file is assumed to reside in
dcelocal/var/dfs/adm; the standard choices from that directory are BakLog, BosLog, DfsgwLog, FlLog, FtLog, RepLog, and
UpLog.
Path names are interpreted relative to dcelocal/var/dfs/adm; absolute path names are also allowed. In cases where a / (slash) appears in the specified file name, the issuer's username must appear in the admin.bos file on the machine specified by the -server option.
-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. If the file name specified by -file
contains a / (slash), the command fails if you use this option and DFS authorization checking is not disabled on the machine specified by -server. If you use this option, do not use the
-localauth option.
-localauth
Directs bos to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bos getlog command displays the contents of the log file specified by -file that resides on the machine specified by -server. It can
be used to view any of the following log files:
BakLog
Generated by the Backup Server process on each Backup Database machine
BosLog
Generated by the BOS Server process on each server machine
DfsgwLog
Generated by the Gateway Server process on each Gateway Server machine
FlLog
Generated by the Fileset Location Server process on each Fileset Database machine
FtLog
Generated by the Fileset Server process on each File Server machine
RepLog
Generated by the Replication Server process on each server machine
UpLog
Generated by the upserver process on each server machine running the server portion of the Update Server
By default, the command looks in the dcelocal/var/dfs/adm directory for the log file it is to display. It is not necessary to specify the full path name of a log file if it resides in the default directory. However, if the file resides elsewhere, the full path name of the log file must be provided. (The command can also be used to view the .old version of a log file created by the associated server process.)
Privilege Required
No privilege is required if the file name specified by -file does not contain a / (slash). If the name contains a / (slash), the issuer must be
listed in the admin.bos file on the machine specified by -server.
Examples
The following example displays the contents of the BosLog file located in the default directory (dcelocal/var/dfs/adm) on the server machine
named fs1:
$ bos getl /.../abc.com/hosts/fs1 BosLog
Related Information
Files: BakLog(4dfs)