Chapter3 Sun^TM Web Console

The Sun 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 Sun Web Console provides the following:

• Common authentication and authorization

• Common logging

• A single entry point for all system management applications though the same HTTPS-based port

• A common look and feel

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

System Requirements

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

Client

• Netscape^TM 4.7x, 6.2x, and 7.x on Solaris^TM 8 or higher

• Netscape 4.7x, 6.2x, and 7.x on Windows 98, 98 SE, ME, 2000, and XP

• Internet Explorer 5.x and 6.x on Windows 98, 98 SE, ME, 2000, and XP

• Mozilla on Linux and on Solaris

Server

• Solaris 8 or higher

• Red Hat 8 or higher, Red Hat Enterprise Linux 2.1

• SuSE Linux 2.1 or higher

• J2SE^TM Version 1.4.1_03 or higher

  If J2SE 1.4.1 or earlier is detected on your server, the setup program prompts you to upgrade the installation using the J2SE version from the Java Desktop System Management Tools CD.

• Tomcat: 4.0.3 or higher

  Tomcat is included on the Java Desktop System Management Tools CD

Installing the Sun Web Console

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

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

To install the Sun Web Console

Steps

1. On the Java Desktop System Management Tools CD, change to the Sun Web Console directory that corresponds to the operating system where you want to install the console.

   On Linux systems, change to /linux/swc and for Solaris SPARC, change to /solsparc/swc.

2. Type ./setup

   By default, the Sun 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 Sun Web Console, see AppendixA, Sun Web Console Packages.

   ---

3. If you want to localize the Sun 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 Sun Web Console server when you want to register a new application.

Before you start the Sun Web Console for the first time, ensure that the Configuration Manager installation is completed.

• To start the Sun Web Console, type smcwebserver start.

• To stop the Sun Web Console, type smcwebserver stop.

• To access the Sun Web Console, enter the following URL in your browser: https://hostname>.domainname>:6789

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

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 Sun Web Console, see the smcwebserver and smreg man pages.

Uninstalling the Sun Web Console

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

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

Sun Web Console Port Information

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

• 8005 to shut down the service, and

• 6789 for https access.

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