The Java Web Console is automatically installed as part of the Solaris software installation. The following information is provided if you need to manually install or uninstall the web console.
How to Install the Java Web Console Software
You install the Java Web Console software by running the setup script.
The web console packages are installed into a directory layout that is based
on the J2EE web application structure. For the Solaris software, the default
installation is located at /usr/share/webconsole
, which
contains files for the console framework and services. The webapps/console
subdirectory
contains files that are relevant to the web console application, which is
the user-visible part of the product. The setup command
is located in the directory where the software was extracted.
If you want to save the installation output to a log file, use the technique shown in Example 3–8
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
Install the Java Web Console software.
# /extracted-software-location
/setup [-h] [-n] [-u] [-G] [-f]
h
Specifies to print a usage statement.
n
Specifies to not start the server at the end of installation. Note that when you do not start the server at the end of installation, the server configuration is not completed. Configuration will automatically be completed the next time the server starts.
u
Specifies to uninstall the Java Web Console software.
G
(Starting with the Solaris Express
7/06 release)Specifies to install in the global zone only. When used in
the global zone, the software is installed to the global zone only and is
not propagated to any existing or yet-to-be-created non-global zone. When setup is used in a non-global zone, the software is always installed
to the non-global zone only. This parameter is identical to the
G
option
of the pkgadd command. When the
G
option
is not used when the software is installed into the global zone, the software
is propagated to non-global zones.
f
When
used with the
u
option to uninstall the Java Web Console
software, specifies
to uninstall the Java and JavaHelp ™ software forcibly, if the software
was installed by using the setup command. By default you are prompted to
confirm removal of each of these packages..
When used without
the
u
option, the
f
option does a silent
install. You are not prompted to confirm upgrade from an earlier version,
and not prompted to confirm upgrade of the Java software if it does not satisfy
the minimum requirements. By default, you are prompted to confirm all upgrades.
Example 3.8. Installing the Java Web Console Software
This example shows you how to install the console software
from a directory where the console
software was extracted. The output from the setup script
is directed to a log file.
#/usr/new-console/setup | tee console_install_log
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Installation of <SUNWmctag> was successful. . . . . Installation of <SUNWmcosx> was successful. Installing man pages ... Installation complete. Starting Sun Java(TM) Web Console Versionversion
... The console is running.
How to Remove the Java Web Console Software
You must not be in any of the following directories or their subdirectories when you uninstall the Java Web Console software:
/usr/lib/webconsole
(If you are not running
at least the Solaris Express 5/06 release.))
/usr/share/webconsole
/etc/webconsole
(Starting with the Solaris Express 5/06 release)
/var/webconsole
(Starting
with the Solaris Express 5/06 release)
/var/opt/webconsole
/var/log/webconsole
If you do not take this precaution, the software is not completely removed.
If you are running a system that implements Solaris zones, you must disable the console server in the Service Management Facility in all zones before you remove the console software.
Become superuser or assume an equivalent role.
Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services .
If you are running at least the Solaris Express 5/06 release, disable the console server in SMF.
# svcadm disable system/webconsole:console
Change to a non-console directory.
# cd /
Remove the Java Web Console software.
Solaris Express 5/06:
#
/usr/share/webconsole/bin/setup -u
If you are not running at least the Solaris Express 5/06 release, use this command:
# /usr/lib/webconsole/setup -u
Example 3.9. Removing the Java Web Console Software
This example shows how to remove the Java Web Console software, starting with the Solaris Express 5/06 release.
#svcadm disable system/webconsole:console
#cd /
#/usr/share/webconsole/bin/setup -u
Shutting down Sun Java(TM) Web Console Versionversion
... The console is stopped. Removing "console" console instance... Removing SUNWmcosx ... Removal of <SUNWmcosx> was successful. Removing SUNWmcos ... Removal of <SUNWmcos> was successful. Removing SUNWmcon ... Removal of <SUNWmcon> was successful. Removing SUNWmconr ... Removal of <SUNWmconr> was successful. Removing SUNWmctag ... Removal of <SUNWmctag> was successful. Uninstallation complete.