Installing the Java Web Console Software

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.

Note

If you want to save the installation output to a log file, use the technique shown in Example 3–8

  1. 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 .

  2. 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 Version version ...
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.

Note

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.

  1. 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 .

  2. If you are running at least the Solaris Express 5/06 release, disable the console server in SMF.

    # svcadm disable system/webconsole:console
    
  3. Change to a non-console directory.

    # cd /
    
  4. 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 Version version ...
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.