Manual Pages for UNIX Operating System command usage for man smlog

System Administration Commands                          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  avail-
               able for viewing.


     view      Allows the user to view the contents of the speci-
               fied 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



SunOS 5.11          Last change: 16 Feb 2001                    1






System Administration Commands                          smlog(1M)



     their equivalent option words preceded by a double dash. For
     example, you can use either -D or --domain with  the  domain
     argument.

     -D | --domain   13;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   13;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 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   13;role_password

         Specifies the password for the role_name. If you specify
         a role_name but do not specify a role_password, the sys-
         tem 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   13;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   13;role_name

         Specifies a role name for authentication. If you do  not
         specify this option, no role is assumed.




SunOS 5.11          Last change: 16 Feb 2001                    2






System Administration Commands                          smlog(1M)



     -u | --username   13;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.




SunOS 5.11          Last change: 16 Feb 2001                    3






System Administration Commands                          smlog(1M)



                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.






SunOS 5.11          Last change: 16 Feb 2001                    4






System Administration Commands                          smlog(1M)



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)





















SunOS 5.11          Last change: 16 Feb 2001                    5