smcwebserver(1M)					  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 systems, devices and services from the console.

       When the console webserver is running, you can view the console 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.

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  smcweb-
		       server  enable  subcommand  the	webserver  can be started/stopped only when the administrator executes the script manually
		       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 webserver.

		       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 usernamThe user identity to run the server as. Once the server has successfuly started under the  specified  iden-
				       tity,  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 property 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 statement:

       % 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

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 variable, your PATH is searched for a suitable java. Otherwise, depending on the OS, the follow-
	   ing 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWmcon			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       smreg(1M), attributes(5), environ(5)

SunOS 5.10							    27 May 2004 						  smcwebserver(1M)