smlog(1M) System Administration Commands smlog(1M)NAMEsmlog - 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 com‐
mand then creates a new log file and makes this log file the cur‐
rent 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
Console connection might time out, so you might need to retry the com‐
mand.
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 authentication 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 connects to the default port,
898. If you do not specify host_name:port, the Solaris Management
Console connects 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 environment variable,
which affects the execution of the smlog command. 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 mes‐
sage displays.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWmga │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsmc(1M), attributes(5), environ(5)SunOS 5.10 16 Feb 2001 smlog(1M)