3 bos getlog - Prints a server process's log file
7 B<bos getlog -server> <I<machine name>> -file <I<log file to examine>>
8 [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
10 B<bos getl -s> <I<machine name>> B<-f> <I<log file to examine>> [-c <I<cell name>>]
11 [B<-n>] [B<-l>] [B<-h>]
15 The bos getlog command displays on the standard output stream
16 the specified log file from the machine named by the B<-server>
17 argument. The BOS Server fetches the log file from the
18 B</usr/afs/logs> directory unless an alternate pathname is provided as
19 part of the B<-file> argument.
23 Log files can grow quite large, especially for the database server
24 processes. To keep them to a manageable size, periodically either use
25 the UNIX B<rm> command to truncate each log file, or use the B<bos
26 restart> command to restart each process.
28 It can take up to five minutes after the file is removed or process
29 restarted for the space occupied by a log file to become available.
38 Indicates the server machine from which to retrieve the log file.
39 Identify the machine by IP address or its host name (either fully-qualified or
40 abbreviated unambiguously). For details, see the introductory reference
41 page for the B<bos> command suite.
46 Names the log file to display. If a filename only is provided, the
47 BOS Server fetches the log file from the B</usr/afs/logs>
48 directory; the standard values are:
55 The Authentication Server (kaserver) log file
60 The Backup Server (buserver) log file
65 The BOS Server (bosserver) log file
70 The File Server (fileserver) log file
75 The Salvager (salvager) log file
80 The Volume Location (VL) Server (vlserver) log file
85 The Volume Server (volserver) log file
89 If a pathname and filename are provided, the log file is retrieved from the
90 indicated directory. Partial pathnames are interpreted relative to the
91 B</usr/afs/logs> directory.
96 Names the cell in which to run the command. Do not combine this
97 argument with the B<-localauth> flag. For more details, see the
98 introductory B<bos> reference page.
103 Assigns the unprivileged identity anonymous to the
104 issuer. Do not combine this flag with the B<-localauth>
105 flag. For more details, see the introductory B<bos> reference
111 Constructs a server ticket using a key from the local
112 B</usr/afs/etc/KeyFile> file. The B<bos> command
113 interpreter presents the ticket to the BOS Server during mutual
114 authentication. Do not combine this flag with the B<-cell> or
115 B<-noauth> options. For more details, see the introductory
116 B<bos> reference page.
120 Prints the online help for this command. All other valid options
127 The output is preceded by the line
129 Fetching log file 'I<filename>'...
131 The remainder of the output depends on the particular log file.
135 The following example displays the FileLog file from the machine
138 % bos getlog -server fs3.abc.com -file FileLog
139 Fetching log file 'FileLog'...
140 Sun Nov 8 04:00:34 1998 File server starting
141 Sun Nov 8 04:00:39 1998 Partition /vicepa: attached 21 volumes;
142 0 volumes not attached
143 Sun Nov 8 04:00:40 1998 File Server started Sun Nov 8 04:00:40
145 Mon Nov 9 21:45:06 1998 CB: RCallBack (zero fid probe in host.c)
146 failed for host 28cf37c0.22811
148 =head1 PRIVILEGE REQUIRED
150 The issuer must be listed in the /usr/afs/etc/UserList file on
151 the machine named by the B<-server> argument, or must be logged onto a
152 server machine as the local superuser B<root> if the
153 B<-localauth> flag is included.
161 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
163 This documentation is covered by the IBM Public License Version 1.0. It was
164 converted from HTML to POD by software written by Chas Williams and Russ
165 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.