NAME
kcweb — starts the HP-UX kernel configuration tool (a Web interface)
SYNOPSIS
kcweb
[
-F
]
[
-b
]
kcweb
-t
DESCRIPTION
The HP-UX Kernel Configuration tool
(kcweb)
is used to manage kernel tunables, modules and alarms.
The HP-UX Kernel Configuration tool provides both Web-based and terminal
user interface.
The Web-based interface is launched through the HP System Management Homepage.
Superuser privileges are required to access the HP-UX Kernel Configuration tool.
A user who does not have superuser privileges has read-only access to the
Tunables, Modules and Alarms area in the HP-UX Kernel Configuration tool
and cannot modify kernel tunables, modules, alarms or reboot the system.
An attempt will be made to connect to a Mozilla/Netscape Web browser
running on the X server defined by the
DISPLAY
environment variable.
If a running Mozilla/Netscape client is found, it will be used, otherwise a
new Mozilla/Netscape session will be initiated.
This will only happen if the Mozilla/Netscape process is running in the
same system as that referenced by the
DISPLAY
variable, unless the
-F
option is used.
Note: By default, the HP-UX kernel configuration tool
(kcweb)
invokes the Mozilla Web browser.
If you want to support any other browser (for example, Netscape), set the
BROWSER
environment variable as shown below:
export BROWSER=/opt/netscape/netscape
The terminal user interface is invoked if any of the following conditions
are true:
The command
/usr/sbin/kcweb
is invoked with the
-t
option.
The
DISPLAY
environment variable is not set.
The Web-based interface is launched if all the following conditions are
true:
The command
/usr/sbin/kcweb
is invoked with
-F
option.
The
DISPLAY
environment variable is set.
The command
/opt/hpsmh/lbin/samweb
is available on the system.
If the Web-based interface cannot be launched,
kcweb
invokes the terminal user interface.
Options
kcweb
recognizes the following options:
- -F
Forces a client browser to be used in less secure ways.
The
-F
option forces the client browser to be used or
started, even when the X-traffic between the X-server and
the Mozilla browser is not secure.
Use this option only when you are sure the network
traffic between the host where Mozilla is running and
the host in the
DISPLAY
variable is secure.
If
kcweb
cannot start the Web browser, the terminal
interface is started.
When the HP-UX Kernel Configuration Web interface is invoked
by SAM, the
-F
option is used.
- -b
If a privileged user (root) executes the
kcweb
command with
the
-b
option, a temporary login bypass key is generated.
The bypass key enables the user to access
the Web interface without having to provide login information again.
When the HP-UX Kernel Configuration Web interface is invoked by SAM, the
-b
option is used.
- -t
Opens the terminal interface for managing kernel tunables, modules and
alarms regardless of the current setting of the
DISPLAY
environment variable.
Note:
You can also start the HP-UX Kernel Configuration tool using one of
the following methods:
Invoke
/usr/sbin/sam
and select the Kernel Configuration (character mode) functional area to
launch the terminal user interface and the Kernel Configuration
(Web-based Interface) to launch the Web-based tool.
Invoke the HP-UX Kernel Configuration tool Web interface by typing
the URL:
http://hostname:2301/kc/kc.cgi
in the address bar of your browser, where
hostname
is the name of the server.
Launch the HP-UX Systems Insight Manager on the server and select the
Kernel Configuration tool from the
Configure -> HP-UX Configuration
menu.
Online Help
After the HP-UX Kernel Configuration tool is started, the online help
provides details on how to use the tool.
RETURN VALUES
Upon completion,
kcweb
returns one of the following values:
- 0
Successful
- 1
An error occurred.
AUTHOR
kcweb
was developed by Hewlett-Packard.