smcwebserver(1M) System Administration Commands smcwebserver(1M)NAMEsmcwebserver - 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 con‐
sole server is running.
The smcwebserver service is managed by the service management 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 Administra‐
tor role.
The configuration properties of this service can be modified with svc‐
cfg(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.
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 subcommand the webserver
can be started/stopped only when the administrator exe‐
cutes 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 sys‐
tem 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 username
The user identity to run the server as. Once the server has suc‐
cessfuly started under the specified identity, all subsequent
starts will automatically be done under that identity until you
change it via this option, or by changing the com.sun.web.con‐
sole.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
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 variable, your PATH is
searched for a suitable java. Otherwise, depending on the OS, the
following 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 │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Stable │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsmreg(1M), svcadm(1M), svccfg(1M), attributes(5), environ(5), smf(5)SunOS 5.10 1 Aug 2006 smcwebserver(1M)