3 bos getlog - Prints a server process's log file
7 B<bos getlog> B<-server> <I<machine name>> B<-file> <I<log file to examine>>
8 [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
10 B<bos getl> B<-s> <I<machine name>> B<-f> <I<log file to examine>>
11 [B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
15 The B<bos getlog> command displays on the standard output stream the
16 specified log file from the machine named by the B<-server> argument. The
17 BOS Server fetches the log file from the F</usr/afs/logs> directory unless
18 an alternate pathname is provided as part of the B<-file> argument.
22 Log files can grow quite large, especially for the database server
23 processes. To keep them to a manageable size, periodically either use the
24 UNIX B<rm> command to truncate each log file, or use the B<bos restart>
25 command to restart each process.
27 It can take up to five minutes after the file is removed or process
28 restarted for the space occupied by a log file to become available.
34 =item B<-server> <I<machine name>>
36 Indicates the server machine from which to retrieve the log file.
37 Identify the machine by IP address or its host name (either
38 fully-qualified or abbreviated unambiguously). For details, see L<bos(8)>.
40 =item B<-file> <I<log file to examine>>
42 Names the log file to display. If a filename only is provided, the BOS
43 Server fetches the log file from the F</usr/afs/logs> directory; the
50 The Authentication Server (B<kaserver>) log file.
54 The Backup Server (B<buserver>) log file.
58 The BOS Server (B<bosserver>) log file.
62 The File Server (B<fileserver>) log file.
66 The Salvager (B<salvager>) log file.
70 The Volume Location (VL) Server (B<vlserver>) log file.
74 The Volume Server (B<volserver>) log file.
78 If a pathname and filename are provided, the log file is retrieved from
79 the indicated directory. Partial pathnames are interpreted relative to the
80 F</usr/afs/logs> directory.
82 =item B<-cell> <I<cell name>>
84 Names the cell in which to run the command. Do not combine this argument
85 with the B<-localauth> flag. For more details, see L<bos(8)>.
89 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
90 combine this flag with the B<-localauth> flag. For more details, see
95 Constructs a server ticket using a key from the local
96 F</usr/afs/etc/KeyFile> file. The B<bos> command interpreter presents the
97 ticket to the BOS Server during mutual authentication. Do not combine this
98 flag with the B<-cell> or B<-noauth> options. For more details, see
103 Prints the online help for this command. All other valid options are
110 The output is preceded by the line
112 Fetching log file '<filename>'...
114 The remainder of the output depends on the particular log file.
118 The following example displays the FileLog file from the machine
121 % bos getlog -server fs3.abc.com -file FileLog
122 Fetching log file 'FileLog'...
123 Sun Nov 8 04:00:34 1998 File server starting
124 Sun Nov 8 04:00:39 1998 Partition /vicepa: attached 21 volumes;
125 0 volumes not attached
126 Sun Nov 8 04:00:40 1998 File Server started Sun Nov 8 04:00:40
128 Mon Nov 9 21:45:06 1998 CB: RCallBack (zero fid probe in host.c)
129 failed for host 28cf37c0.22811
131 =head1 PRIVILEGE REQUIRED
133 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
134 machine named by the B<-server> argument, or must be logged onto a server
135 machine as the local superuser C<root> if the B<-localauth> flag is
144 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
146 This documentation is covered by the IBM Public License Version 1.0. It was
147 converted from HTML to POD by software written by Chas Williams and Russ
148 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.