Java Desktop System Configuration Manager Release 1.1 Installation Guide

Chapter 3 JavaTM Web Console

The Java Web Console is designed to produce a common, web-based system management solution for Sun Microsystems. It serves as one location where users can access system management applications, all of which provide a consistent user interface.

The console is based on a web model for many reasons. However, the primary reason is to enable system administrators to use a web browser to access their system management applications.

The Java Web Console provides the following:

A major advantage of the console is that the administrator can log in once and use any application inside the console.

System Requirements

The Java Web Console supports multiple client and server operating systems as well as several browsers.

Client

Server

Installing the Java Web Console

Before you install the Java Web Console, read the package summary and known issues sections in Appendix A, Java Web Console Packages of this guide.

The installation binaries for the Java Web Console for Solaris SPARC (version 8 or higher) and Linux operating systems are available on the Java Desktop System Management Tools CD.

ProcedureTo install the Java Web Console

Steps
  1. On the Java Desktop System Management Tools CD, change to the Java Web Console directory (“swc”) that corresponds to the operating system where you want to install the console.

  2. Type ./setup

    By default, the Java Web Console does not create an installation log file. To create an installation log with the name "logfile," type ./setup | tee logfile.


    Note –

    Most of the installation and the configuration of the web console is automatically performed when you run setup. For more detailed information on the setup application for the Java Web Console, see Appendix A, Java Web Console Packages.


  3. If you want to localize the Java Web Console, you need to install two additional packages for each language. Use the table below to determine the package names for the language, and do one of the following:

    • On Solaris, type pkgadd -d path/pkgname.pkg pkgname, where pkgname is the name of the language package that you want to add.

    • On Linux, type rpm -i path/pkgname<...>.rpm, where pkgname is the name of the package that you want to add.

    Package Name 

    Description 

    SUNWcmcon, SUNWcmctg 

    Simplified Chinese SunTM Web Console 2.0

    SUNWdmcon, SUNWdmctg 

    German SunTM Web Console 2.0

    SUNWemcon, SUNWemctg 

    Spanish SunTM Web Console 2.0

    SUNWfmcon, SUNWfmctg 

    French SunTM Web Console 2.0

    SUNWhmcon, SUNWhmctg 

    Traditional Chinese SunTM Web Console 2.0

    SUNWimcon, SUNWimctg 

    Italian SunTM Web Console 2.0

    SUNWjmcon, SUNWjmctg 

    Japanese SunTM Web Console 2.0

    SUNWkmcon, SUNWkmctg 

    Korean SunTM Web Console 2.0

    SUNWsmcon, SUNWsmctg 

    Swedish SunTM Web Console 2.0

Running the Console

You typically only need to stop and to restart the Java Web Console server when you want to register a new application.


Caution – Caution –

Before you start the Java Web Console for the first time, ensure that the Configuration Manager installation is completed. The Java Web Console will not run successfully until you have deployed at least one application in the console.


Out of the box, the Java Web Console supports Unix-based authentication and Role-Based Access Control (RBAC). However, you can also configure other authentication mechanisms, such as LDAP authentication.


Note –

The default session time-out is 15 minutes. You can configure the time-out length with the smreg command. For example, to set the time-out length to 5 minutes, type smreg add -p -c session.timeout.value=5.


For more information on commands for the Java Web Console, see the smcwebserver and smreg man pages.

Uninstalling the Java Web Console

To uninstall the Java Web Console, run /usr/lib/webconsole/setup -u.


Note –

Do not run this command if you are in the /usr/lib/webconsole directory or any of the related subdirectories, otherwise pkgrm fails.


Java Web Console Port Information

The Configuration Manager uses the ports of the Java Web Console:

The two ports can be changed in /etc/opt/webconsole/server.xml. After changing the ports, restart the Java Web Console with /usr/sbin/smcwebserver restart.