Manual Pages for UNIX Operating System command usage for man smcwebserver

System Administration Commands                   smcwebserver(1M)



NAME
     smcwebserver - manage the server for the Sun Web Console

SYNOPSIS
     /usr/sbin/smcwebserver subcommand options


DESCRIPTION
     The smcwebserver utility manages the Sun Web Console server.
     Sun  Web  Console is a browser-based interface that performs
     systems management. System administrators  can  manage  sys-
     tems, devices and services from the console.


     When the console webserver is running, you can view the con-
     sole by opening a browser and pointing to:

       https://host:6789




     host is the machine where the console has been installed and
     the console server is running.


     The smcwebserver service is managed by the  service  manage-
     ment facility (SMF) (see smf(5)), under the fault management
     resource identifier (FMRI):

       svc:/system/webconsole




     Administrative actions on this service,  such  as  enabling,
     disabling,  or  requesting  restart,  can be performed using
     svcadm(1M).  smcwebserver  can  only  be  started   by   the
     superuser or someone in the Primary Administrator role.


     The configuration properties of this service can be modified
     with svccfg(1M).


     smcwebserver supports an SMF property that  controls  remote
     access  to  the  Sun  Web  Console  server.   The  property,
     options/tcp_listen, has a  default  value  of  false,  which
     disallows  remote  access.  The  value  true  allows  remote
     access. See EXAMPLES.





SunOS 5.11           Last change: 1 Aug 2006                    1






System Administration Commands                   smcwebserver(1M)



SUBCOMMANDS
     The following subcommands are supported:

     disable    Disable automatic start  or  stop  during  system
                boot  or shutdown. Until the administrator reruns
                the script with the smcwebserver  enable  subcom-
                mand  the  webserver  can be started/stopped only
                when the administrator executes the script  manu-
                ally using the following command:

                  # /usr/sbin/smcwebserver [start | stop]




     enable     Enable the  webserver  to  startup  automatically
                during subsequent system boot and gracefully stop
                during system shutdown.


     restart    Stop and  subsequently  start  the  console  web-
                server.

                The format of the restart subcommand is:

                restart [-U username]


     start      Start the console webserver.

                The format of the start subcommand is:

                start [-U username]


     stop       Stop the console webserver.


     status     Display status of the console webserver.

                The format of the status subcommand is:

                status [-p]


OPTIONS
     The following options are supported:

     -U username | --username username

         The user identity to run the server as. Once the  server
         has  successfuly  started  under the specified identity,



SunOS 5.11           Last change: 1 Aug 2006                    2






System Administration Commands                   smcwebserver(1M)



         all subsequent starts will automatically be  done  under
         that identity until you change it via this option, or by
         changing the com.sun.web.console.user configuration pro-
         perty  via  the smreg(1M) command. The default is to run
         the server under the noaccess identity.


     -p | --parseable

         Display non-localized output suitable  for  programmatic
         parsing. If the server is running, the output will be:

             running=yes

         If the server is not running, the output will be:

             running=no


     -h | --help | -?

         Display the usage statement.


     -V | --version

         Display console version information.


EXAMPLES
     Example 1 Displaying the Usage Statement


     The following command displays the smcwebserver usage state-
     ment:


       % smcwebserver --help



     Example 2 Determining if the Server is Running


     The following shell command will start the server if  it  is
     not already running.


       ans=`smcwebserver -p | grep running | cut -d"=" -f2`
       if [ "$ans" = "no" ]; then
           smcwebserver start
       fi



SunOS 5.11           Last change: 1 Aug 2006                    3






System Administration Commands                   smcwebserver(1M)



     Example 3 Using SMF Property to Allow Remote Access


     The following sequence of commands allows remote  access  to
     the Sun Web Console server.


       # svccfg -s svc:/system/webconsole \
           setprop options/tcp_listen = true
       # svcadm refresh svc:/system/webconsole



ENVIRONMENT VARIABLES
     See environ(5) for descriptions of the following environment
     variables that affect the execution of smcwebserver:

     JAVA_HOME    If you do not specify  this  environment  vari-
                  able,  your  PATH  is  searched  for a suitable
                  java. Otherwise, depending on the OS, the  fol-
                  lowing default locations are used:

                  Solaris: /usr/j2se

                  Linux: /usr/java/j2sdk1.4*


EXIT STATUS
     The following exit values are returned:

     0    Successful completion.


     1    An error occurred.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:
















SunOS 5.11           Last change: 1 Aug 2006                    4






System Administration Commands                   smcwebserver(1M)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWmcon                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     smreg(1M),    svcadm(1M),     svccfg(1M),     attributes(5),
     environ(5), smf(5)











































SunOS 5.11           Last change: 1 Aug 2006                    5