pdweb(1M) pdweb(1M)
NAME [Toc] [Back]
pdweb - start the HP-UX peripheral device tool (a Web interface)
SYNOPSIS [Toc] [Back]
Path: /usr/sbin
pdweb [-h hostname] [-F]
pdweb -c
pdweb -s {stop|startssl|status|restart}
DESCRIPTION [Toc] [Back]
The HP-UX Peripheral Device tool (pdweb) can be used to manage hot
pluggable PCI slots on systems that support adding and replacing cards
without rebooting. On all HP-UX systems, pdweb will display the
devices and can be used to (re)create device files for a selected
device.
The pdweb command starts the user interface. Once started the help
facility of pdweb is available and can be used to learn more about
pdweb.
The HP-UX Peripheral Device tool user interface uses a Web browser.
Executing the pdweb command without any options performs the following
tasks:
+ create server certificates if needed
+ start the management Web server if it is not running
+ start a Web client (browser)
An attempt will be made to connect to a Netscape Web browser running
on the X server defined by the DISPLAY environment variable. If a
running Netscape client is found, it will be used, otherwise a new
Netscape session will be initiated. This will only happen if the
Netscape process is running the same system as that referenced by the
DISPLAY variable, unless the -F option is used.
If pdweb is executed without any options, the server will stop
automatically after a period of inactivity. If the server is started
explicitly using pdweb -s startssl, it will run until the system is
rebooted or the server is stopped with pdweb -s stop.
Options [Toc] [Back]
The pdweb recognizes the following options:
-h hostname Configure a remote system ( hostname), using a client
on the local system. The pdweb server on the remote
system must already be running.
Hewlett-Packard Company - 1 - Formatted: January 24, 2005
pdweb(1M) pdweb(1M)
-F Forces a client browser to be used in less secure ways.
Two security features are overridden by the -F option.
The -F option forces the client browser to be used or
started, even if the X-traffic between the X-server and
the Netscape browser is not secure.
If pdweb is executed by root with the -F option, a
temporary login bypass key will be generated. The
bypass key allows the user to access the Web interface
without having to provide login information again.
Only use this option if you are sure the network
traffic between the host where Netscape is running, and
the host in the DISPLAY variable is secure.
When pdweb is invoked by SAM, the -F option is used.
-c Forces the creation of new server certificates. This
can be performed if the server's certificates expire,
or if the security of the certificates has been
compromised. When new certificates are created, the
pdweb command will also restart the pdweb Web server.
The -c option is only available to the user root,
because it requires creation of an SSL certificate.
-s {stop|startssl|status|restart}
The -s option is only available to the user root.
stop stops the running pdweb Web server.
startssl starts the pdweb Web server, if started
this way, it will run until rebooted or
until stopped with pdweb -s stop.
status displays the status of the pdweb Web
server.
restart stops and then starts ( startssl) the
pdweb Web server.
Security Certificates [Toc] [Back]
pdweb will generate an SSL certificate authority and use that to sign
a generated SSL certificate. Because this certificate is self signed,
your web browser will probably prompt you to see if you want to accept
this certificate before it connects to the HP-UX peripheral device
application.
It is possible to accept these certificates each time, just for the
session, or you can accept the certificates on a permanent basis (10
Hewlett-Packard Company - 2 - Formatted: January 24, 2005
pdweb(1M) pdweb(1M)
years), and not have to accept them again later.
pdweb regenerates the certificates when they are not there, if the
hostname is changed on the system, or when the -c option is used.
Online Help [Toc] [Back]
Once the HP-UX peripheral device tool is started, the online help
provides details on how to use the tool.
RETURN VALUES [Toc] [Back]
Upon completion, pdweb returns one of the following values:
0 Successful.
1 An error occurred.
WARNINGS [Toc] [Back]
Accepting a certificate saves an identifier for the certificate in a
file where the browser is running. If you reinstall the pdweb gui,
the certificate will be altered, and some browsers report the change
in id as a potential security violation.
When this happens, you have to instruct your browser to delete the
saved certificate. On Netscape 4.7x this is done by selecting the
Communicator:Tools:Security Info menu pick. On the resulting dialog
box, select the " Certificates:Web Sites area and delete any
certificates for machine associated with the security violation.
AUTHORS [Toc] [Back]
pdweb was developed by Hewlett-Packard
SEE ALSO [Toc] [Back]
olrad(1M), ioscan(1M), insf(1M)
Hewlett-Packard Company - 3 - Formatted: January 24, 2005 [ Back ] |
