System Management Services 1.2 man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

showlogs(1m)

DESCRIPTION
OPTIONS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
FILES
ATTRIBUTES
SEE ALSO

SYNOPSIS

showlogs [-F] [-f filename] [-d domain_id|domain_tag] [-p m|c|s] [-v ]

showlogs -h

showlogs(1M) displays platform or domain log files. The default is the platform message log. You must have platform group privileges to run the default, otherwise you will receive an error message. Depending on your privileges, you can display the message logs, console logs, or syslog for the platform or a specified domain.

OPTIONS

The following options are supported.

-F

Outputs only lines which have been appended to the log file since the showlogs command was executed. Similar to the 'tail -f' command. Output will continue until interrupted by Control -C.

-d domain_id|domain_tag

Outputs the message log file for the specified domain instead of the platform log. You must have domain privileges to use this option.

-f filename

Places the output of the showlogs command into a specified file.

-h

Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.

-p m|c|s

Specifies display of either the platform (m)essage log or domain (c)onsole log or domain (s)yslog.

m -- Displaying the platform message log requires platform group privileges. This is the showlogs default.

c -- Displaying the domain console log requires the -d option and domain privileges for that domain.

s -- Displaying the domain syslog requires domain privileges for that domain. Syslogs forwarded to the system controller (SC) from non-domain systems are stored in /var/opt/SUNWSMS/adm/anonymous.

-v

Verbose. Displays all available command information.

EXTENDED DESCRIPTION

Group Privileges Required

If you have platform administrator, operator, or service privileges, you can display the platform messages log file.

If you have domain administrator/configurator privileges, you can display only those log files for domains for which you have privileges.

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

Example 1. Output Platform Message Log to Standard Out

sc0:sms-user:> showlogs  
Aug 24 14:30:53 2000 xc8-sc0 hwad[104609]: [0 5751139758216 ERR SCCSR.cc 1347] getCrt - Client: 104621.14 has locked - 167 
Aug 24 14:30:53 2000 xc8-sc0 hwad[104609]: [0 5751170721148 ERR SCCSR.cc 1362] getCrt - Client: 104621.14 about to unlock - 167.....

Example 2. Output Domain A Message Log to Standard Out

sc0:sms-user:> showlogs -d A  
Aug 15 14:28:05 2000 xc8-sc0 dsmd[106850]-A(): [0 8500962546702 INFO Observers.cc 125]  DOMAIN_UP A event has been sent to SYMON, rc = 0. 
Aug 15 14:28:05 2000 xc8-sc0 dsmd[106850]-A(): [0 8500963756755 INFO DomainMon.cc 183]  Start monitoring domain A every 5 second....

Example 3. Output Newly Appended Lines to Domain A Message Log to Standard Out

sc0:sms-user:> showlogs -d A -F  
Aug 25 14:28:05 2000 xc8-sc0 dsmd[106850]-A(): [0 8500960648900 INFO Observers.c c 193] DOMAIN_UP A event has been sent to DXS, rc = 0.....

Example 4. Output Domain A Console Log to Standard Out

sc0:sms-user:> showlogs -d A -p c 
** Domain Server Shutting Down - disconnecting 
** Domain Server Shutting Down - disconnecting 
Sun Fire 15K system, using IOSRAM based Console OpenBoot 4.0, 2048 MB memory installed, Serial #10000000. Ethernet address 8:0:20:b8:2d:b1, Host ID: 80a3e446.

Example 5. Output Domain sms2 Syslog to Standard Out

sc0:sms-user:> showlogs -d sms2  -p s  
Sep  7 13:51:49 sms2 agent[6629]: [ID 240586 daemon.alert] syslog 
Sep 07 13:51:49 agent   {received software termination signal)
Sep  7 13:51:49 sms2 agent[6629]: [ID 985882 daemon.alert] syslog 
Sep 07 13:51:49 agent  *** terminating execution *** 
Sep  7 13:51:50 sms2 platform[22481]: [ID 345917 daemon.alert] syslog 
Sep 07 13:51:50 platform      *** terminating execution *** 
Sep  7 14:49:07 sms2 platform[4309]: [ID 745356 daemon.alert] syslog 
Sep 07 14:49:07 platform    general parsing error 
Sep  7 14:49:07 sms2 platform[4309]: [ID 334248 daemon.alert] syslog 
Sep 07 14:49:07 platform    file://localhost/scmonitor-d.x;flags=ro 
Sep  7 14:49:07 sms2 platform[4309]: [ID 449452 daemon.alert] syslog 
Sep 07 14:49:07 platform    couldn't load file  ...

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

FILES

The following files are used:

/var/opt/SUNWSMS/adm/platform/messages: Platform message file..
/var/opt/SUNWSMS/adm/domain_id/messages: Domain message file..
/var/opt/SUNWSMS/adm/domain_id/console: Domain console file..
/var/opt/SUNWSMS/adm/domain_id/syslog: Domain syslog file..

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

Attribute Types	Attribute Values
Availability	SUNWSMSop