About This Document

Table of Contents

This manual describes how to use the HP Internet Express for Tru64™ UNIX Administration utility to configure and manage Internet software components supplied with the product kit. Information on managing components that are not configured through the Administration utility is also included in this document, as well as information on managing user accounts.

For more information on configuring Internet software, see the documentation for the particular Internet component and the documentation for the UNIX shell command environment. For more information on HP Tru64™ UNIX system management, see the Tru64 UNIX operating system documentation.

Intended Audience

This manual is intended for the system administrator who will manage an AlphaServer™ system running Internet Express for Tru64 UNIX.

Document Organization

This manual consists of the following:

Chapter 1 describes how to access and use the Administration utility.
Chapter 2 provides pointers to Web sites where you can get more information on Internet Express, Open Source software, and Web authorities and standards organizations.
Chapter 3 explains how to manage user accounts using the Administration utility.
Chapter 4 explains how to manage user authentication with the LDAP Module for System Authentication.
Chapter 5 describes how to manage the mail delivery components: the Sendmail server, Majordomo, Mailman, and Bogofilter.
Chapter 6 describes how to manage the mail access components: POP, IMAP, and IMP Webmail.
Chapter 7 explains how to configure and manage Web services, which includes the Secure Web Server for Tru64 UNIX powered by Apache and the ht://Dig search tool.
Chapter 8 describes how to manage the XML components.
Chapter 9 explains how to manage the network security administration tools that include TCP Wrapper security modifications, and to set up firewall protection, Snort intrusion detection, and FreeRADIUS user authentication.
Chapter 10 explains how to configure and manage the proxy services, which include the Dante SOCKS Server and the Squid Proxy/Caching Server.
Chapter 11 describes how to set up and manage the LDAP Directory servers.
Chapter 12 describes how to configure and manage OpenSLP.
Chapter 13 describes how to configure the FTP Server.
Chapter 14 explains how to configure and manage the Samba File and Print Server.
Chapter 15 explains how to set up and use InterNetNews (INN).
Chapter 16 explains how to manage Internet Relay Chat (IRC).
Chapter 17 describes how to administer the PostgreSQL account and use related commands and also how to administer MySQL.
Chapter 18 describes how to enable BIND and start the BIND server.
Appendix A describes how to create a certificate of authority, and also includes a sample mail filter.
The Glossary contains a glossary of terms used in this manual.

This manual also contains an index.

Typographic Conventions

This document uses the following typographical conventions:

`%`, `$`, or `#`		A percent sign represents the C shell system prompt. A dollar sign represents the system prompt for the Bourne, Korn, and POSIX shells. A number sign represents the superuser prompt.
audit(5)		A manpage. The manpage name is audit, and it is located in Section 5.
Command		A command name or qualified command phrase.
`Computer output`		Text displayed by the computer.
Ctrl+x		A key sequence. A sequence such as Ctrl+x indicates that you must hold down the key labeled Ctrl while you press another key or mouse button.
`ENVIRONMENT VARIABLE`
		The name of an environment variable, for example, `PATH`.
ERROR NAME		The name of an error, usually returned in the `errno` variable.
Key		The name of a keyboard key. Return and Enter both refer to the same key.
Term		The defined use of an important word or phrase.
User input		Commands and other text that you type.
`Variable`		The name of a placeholder in a command, function, or other syntax display that you replace with an actual value.
[]		The contents are optional in syntax. If the contents are a list separated by \|, you must choose one of the items.
{}		The contents are required in syntax. If the contents are a list separated by \|, you must choose one of the items.
...		The preceding element can be repeated an arbitrary number of times.
⋮		Indicates the continuation of a code example.
\|		Separates items in a list of choices.
WARNING		A warning calls attention to important information that if not understood or followed will result in personal injury or nonrecoverable system problems.
CAUTION		A caution calls attention to important information that if not understood or followed will result in data loss, data corruption, or damage to hardware or software.
IMPORTANT		This alert provides essential information to explain a concept or to complete a task
NOTE		A note contains additional information to emphasize or supplement important points of the main text.

Related Information

The Internet Express Documentation Bookshelf provides access to the following documents:

Release Notes — This manual includes release notes for Internet Express.
Read This First — This manual describes the contents of the kit.
Installation Guide — This document describes how to install the administration software and Open Source Internet software provided on the Internet Express for Tru64 UNIX Installation and Documentation CD–ROM. When you run the installation procedure in a Web browser, the Installation Guide (in HTML format) is linked to the procedure to provide online help.
Administration Guide — This manual.
Secure Web Server Administration Guide — This manual describes how to use the Secure Web Server Administration utility.
Internet Services User's Guide — This manual explains how to get started with e-mail, the TIN news reader, and a Web browser using a character-cell terminal.
Internet Monitor Administrator's Guide — This manual describes how to install, configure, and use the Internet Monitor software.
QuickSpecs — This document is a specification of the Internet Express product.
Software Description and Licensing Terms — This document describes the terms and conditions for software packaged with the current version of Internet Express.
Best Practices documents for Internet Express — These documents provide you with recommended methods for performing specific tasks, rather than presenting all options.
Additional Best Practices are available at the Tru64 UNIX Publications Web site:
http://h30097.www3.hp.com/docs/best_practices/
Internet Express Reference Pages — These reference pages are supplied with components that can be installed and managed using Internet Express.

See Chapter 2 for a list Web sites and other information sources for Internet Express products and services as well as commercial and nonprofit organizations that might be of interest.

Reading the Documentation

This section describes the different methods for accessing the Internet Express documentation.

Reading Documentation Using the Administration Utility

After installation of the Secure Web Server subset (IAEAPCH), the Internet Express Documentation subset (IAEDOC), and the Internet Express Administration Utility subset (IAEADM), access the Administration utility for Internet Express main menu (see Section ) at:

http://hostname.domain:8081

where hostname.domain is the host name and domain of the system running Internet Express. Follow the documentation link from this page to read the Internet Express documentation.

Reading Documentation Using the Public Web Server

You can also read the documentation without the Administration utility by using the public Web server (if you chose to configure one) to access the documentation index page at http://hostname.domain/documents/bookshelf.html. If this URL does not work, verify that the Web server configuration file, /usr/internet/httpd/admin/conf/httpd.conf, contains the following line:

Alias /documents/ "/usr/internet/docs/IASS/"

The Internet Express documentation files are installed in the /usr/internet/docs/IASS directory.

You can access the Documentation Bookshelf installed on your system by entering the following URL (substituting the name of your system for hostname) in your browser:
http://hostname/documents/bookshelf.html
You can also read the installed documentation directly from the file system using a Web browser running on the same system by using the file URL:
file:/usr/internet/docs/IASS/bookshelf.html

Reading Documentation from the Internet Express CD–ROM

You can also access the Documentation Bookshelf on the Internet Express Installation and Documentation CD–ROM from your Tru64 UNIX System or a PC. The documentation is available in the following formats:

HTML
Portable Document Format (PDF)

On a Tru64 UNIX System

To read the documentation from the Internet Express Installation and Documentation CD–ROM on an AlphaServer system, follow these steps:

Log in to your system as root.
Insert and mount the CD–ROM, replacing drive with the name of your CD–ROM drive:
# mount /dev/drive /mnt
Usually this will be:
# mount /dev/disk/cdrom0c /mnt
In a Web browser, open the Documentation Bookshelf file by entering the following URL:
file:/mnt/index.htm
Click on the book you want to open.

On a PC

To read the documentation from the Internet Express Installation and Documentation CD–ROM on a PC, follow these steps:

Insert the CD–ROM into your PC's CD–ROM drive.
The Bookshelf page is automatically displayed in your browser.
If the Bookshelf does not appear, open the following URL, replacing drive with the letter of your CD–ROM drive:
file:drive:\index.htm
Click on the book you want to open.

Reading Reference Pages for Internet Express Components

Reference pages for Internet Express components are available in HTML format from the Internet Express Reference Pages index page. These HTML reference pages can be viewed using a Web browser.

Alternatively, you can view these reference pages from a command line in a terminal window if you modify the search path for the man command.

The man command's search path needs to include the following directories for Internet Express component reference pages:

/usr/share/man

/usr/local/man

/usr/internet/pgsql/man

/usr/internet/openldap/man

/usr/news/man

/usr/local/samba/man

/usr/internet/httpd/man

/usr/opt/hpapache2/man

You can specify an alternative search path when entering the man command by using the M or P option; for example:

# man -M /usr/news/man active.5

You can also define the man command's MANPATH environment variable on the command line or in a file, such as your .profile file or .login file.

For example, suppose your MANPATH environment variable was defined to be the following:

/usr/share/man:/usr/dt/share/man:/usr/local/man

If you are using the sh or ksh shell, you could modify the MANPATH to add to the search path by adding the following:

# set MANPATH $MANPATH:/usr/internet/pgsql/man:/usr/internet/openldap/man:/usr/news/man: \
/usr/local/samba/man:/usr/internet/httpd/man:/usr/opt/hpapache2/man

# export MANPATH

If you are using the csh shell, you would use a command line like the following:

# setenv MANPATH $MANPATH:/usr/internet/pgsql/man:/usr/internet/openldap/man: \
/usr/news/man:/usr/local/samba/man:/usr/internet/httpd/man:/usr/opt/hpapache2/man

For details about defining reference page search paths, see man(1).

Reading the Open Source Software Component Documentation

The product kit also provides documentation (in ASCII text and HTML) for software components included with Internet Express. This documentation is located in the /usr/internet/docs directory on the system where Internet Express is installed.

Reader's Comments

HP welcomes any comments and suggestions you have on this and other Tru64 UNIX manuals.

You can send your comments in the following ways:

Fax: 603–884–0120. Attn: USPG Publications, ZKO3–3/Y32
Internet electronic mail: readers_comment@zk3.dec.com
A Reader's Comment form is located on your system in the following location:
/usr/doc/readers_comment.txt
Mail:
Hewlett-Packard Company USD Publications Manager ZKO3-3/Y32 110 Spit Brook Road Nashua, NH 03063-2698

Please include the following information along with your comments:

The full title of the document
The section numbers and page numbers of the information on which you are commenting
The version of Tru64 UNIX and Internet Express that you are using
If known, the type of processor that is running Tru64 UNIX

The Tru64 UNIX Publications Group cannot respond to system problems or technical support inquiries. Please address technical questions to your local system vendor or to the appropriate HP technical support office. Information provided with the software media explains how to send problem reports to HP.