Examining Log Files

The bosserver process and most of the server processes it monitors generate log files. The log files record execution messages and error messages generated by the server processes as they execute. By default, the processes write the files to the dcelocal/var/dfs/adm directory, although some server processes can be instructed to write their log files to a different directory. A list of the log files and the processes that write them follows:

· The BakLog file is generated by the Backup Server process on each Backup Database machine.

· The BosLog file is generated by the BOS Server process on each server machine.

· The DfsgwLog file is generated by the Gateway Server process on each Gateway Server machine.

· The FlLog file is generated by the Fileset Location Server process on each Fileset Database machine.

· The FtLog file is generated by the Fileset Server process on each File Server machine.

· The RepLog file is generated by the Replication Server process on each server machine.

· The UpLog file is generated by the upserver process on each server machine that is running the server portion of the Update Server.

The bos getlog command can be used to examine any of these log files, including the .old versions created by the associated server processes. By default, the command looks in the dcelocal/var/dfs/adm directory for the log file that it is to display. It is not necessary to specify the full pathname of a log file if it resides in the default directory. However, if the file resides elsewhere, the full pathname of the log file must be provided.

In addition, no privilege is necessary to view a log file that resides in the default directory. If the file resides in a different directory, the issuer of the command must be listed in the admin.bos file on the machine on which the file is located, which is specified by the -server option.

$ bos getlog -server machine -file log_file

The -file log_file option specifies the log file that is to be displayed. A simple filename is sufficient for a log file that resides in the dcelocal/var/dfs/adm directory. A full pathname is required for a log file that resides in a different directory.