smlog(1M)
NAME
smlog - manage and view WBEM log files
SYNOPSIS
/usr/sadm/bin/smlog subcommand [auth_args] --
[subcommand_args]
DESCRIPTION
The smlog command manages WBEM log files and allows a user
to view WBEM log file records.
Subcommands
The smlog command supports the following subcommands:
backup
Backs up the entries in the current WBEM log file. The
backup command then creates a new log file and makes
this log file the current log file.
delete
Deletes an existing (backed up) WBEM log file.
list Lists the names of all the WBEM log files available
for viewing.
view Allows the user to view the contents of the specified
WBEM log file.
OPTIONS
The smlog authentication arguments, auth_args, are derived
from the smc(1M) arg set and are the same regardless of
which subcommand you use. The smlog command requires the
Solaris Management Console to be initialized for the command
to succeed (see smc(1M)). After rebooting the Solaris
Management Console server, the first Solaris Management Con-
sole connection might time out, so you might need to retry
the command.
The subcommand-specific options, subcommand_args, must come
after the auth_args and must be separated from them by the
-- option.
auth_args
The valid auth_args are -D, -H, -l, -p, -r, and -u; they are
all optional. If no auth_args are specified, certain
defaults will be assumed and the user may be prompted for
additional information, such as a password for authentica-
tion purposes. These letter options can also be specified by
their equivalent option words preceded by a double dash. For
example, you can use either -D or --domain with the domain
argument.
-D | --domain domain
Specifies the default domain that you want to manage.
smlog accepts only file for this option. file is also
the default value.
The file default domain means that changes are local
to the server. Toolboxes can change the domain on a
tool-by-tool basis; this option specifies the domain
for all other tools.
-H | --hostname host_name:port
Specifies the host_name and port to which you want to
connect. If you do not specify a port, the system con-
nects to the default port, 898. If you do not specify
host_name:port, the Solaris Management Console con-
nects to the local host on port 898. You may still
have to choose a toolbox to load into the console. To
override this behavior, use the smc -B option (see
smc(1M)), or set your console preferences to load a
"home toolbox" by default.
-l | --rolepassword role_password
Specifies the password for the role_name. If you
specify a role_name but do not specify a
role_password, the system prompts you to supply a
role_password. Passwords specified on the command line
can be seen by any user on the system, hence this
option is considered insecure.
-p | --password password
Specifies the password for the user_name. If you do
not specify a password, the system prompts you for
one. Passwords specified on the command line can be
seen by any user on the system, hence this option is
considered insecure.
-r | --rolename role_name
Specifies a role name for authentication. If you do
not specify this option, no role is assumed.
-u | --username user_name
Specifies the user name for authentication. If you do
not specify this option, the user identity running the
console process is assumed.
-- This option is required and must always follow the
preceding options. If you do not enter the preceding
options, you must still enter the -- option.
subcommand_args
Descriptions and other arg options that contain white spaces
must be enclosed in double quotes.
The backup subcommand supports the following
subcommand_args:
-h Displays the command's usage statement.
This subcommand_arg is optional.
The delete subcommand supports the following subcommand_args
-h Displays the command's usage statement.
This subcommand_arg is optional.
-n name
Specifies the name of the log file you want to delete.
The list subcommand supports the following subcommand_args:
-h Displays the command's usage statement.
This subcommand_arg is optional.
The view subcommand supports the following subcommand_args:
-h Displays the command's usage statement.
This subcommand_arg is optional.
-n name
Specifies the name of the log file you want to view.
-v Displays the data in verbose format.
This subcommand_arg is optional.
EXAMPLES
Example 1: Listing WBEM Log Files
The following command lists all available WBEM log files:
./smlog list -H myhost -p mypasswd -u root --
Log.01/03/2001.14:38:29
Log.01/04/2001.16:34:59
Log.01/08/2001.14:13:33
Log.01/11/2001.18:39:53
Log.01/12/2001.10:31:31
Log.12/21/2000.17:41:11
Example 2: Displaying a WBEM Log File
The following command displays the contents of a log file:
./smlog view -H myhost -p mypasswd -u root -- -n Log.01/04/2001.16:34:59
Date and Time Client User Source Severity Cate
gory Summary
1/5/01 5:22:47 PM hostname1 root Solaris_OsService Informational Appl
ication log No services found.
1/5/01 5:21:46 PM hostname1 root Solaris_OsService Informational Appl
ication log No services found.
The smlog output wraps when it exceeds 80 characters.
ENVIRONMENT VARIABLES
See environ(5) for a description of the JAVA_HOME environ-
ment variable, which affects the execution of the smlog com-
mand. If this environment variable is not specified, the
/usr/java1.2 location is used. See smc(1M).
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 Invalid command syntax. A usage message displays.
2 An error occurred while executing the command. An
error message displays.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWmga |
|_____________________________|_____________________________|
SEE ALSO
smc(1M), attributes(5), environ(5)
Man(1) output converted with
man2html