3    System and Network Management Documentation

This chapter describes the Tru64 UNIX system and network management documentation, which provides information on topics such as configuring systems and networks, maintaining disks, and using system administration tools. The books in this category are generally geared toward advanced users. Each document is individually described.

Books that are printed can be purchased from HP in the documentation kits described in Section 1.5.

Except for a few externally published manuals, the documentation described here was produced by HP writers working closely with the developers of the Tru64 UNIX operating system.

Books identified as revised, were updated with the Version 5.1B release.

3.1    Printed and Online Documentation

The documentation described in this section is provided on the Tru64 UNIX Documentation CD-ROM and in the optional printed documentation kits. For more information on the printed documentation set, see Section 1.5.

3.1.1    AdvFS Administration (revised)

The AdvFS Administration manual provides task-based information and instruction on using, configuring, troubleshooting, tuning, and administering Advanced File Systems (AdvFS) base and utilities functions.

AdvFS is the default file system for the Tru64 UNIX operating system. It provides rapid crash recovery and a flexible structure that allows you to manage your file system while it is on line.

The AdvFS Utilities, which are available as a layered product, extend the file system capabilities by including utilities to add volumes, create clones, stripe files, and balance file domains.

3.1.2    Cluster Administration (revised)

The Cluster Administration manual describes how to perform tasks related to the day-to-day management of a TruCluster Server system.

This manual is intended for the person who will configure and manage the TruCluster Server system. Instructions in this manual assume the user is an experienced UNIX administrator who can configure and maintain hardware, operating systems, and networks. The following topics are discussed:

• The differences between managing a standalone Tru64 UNIX system and a TruCluster Server cluster

• The graphic user interfaces and command-line tools for managing clusters

• How to use cluster aliases to provide network applications with a single-system view of the cluster

• How to manage quorum and votes to maintain cluster availability

• How to configure, manage, and remove cluster members

• How to configure and administer member and client networks in a cluster

• How to configure mail, printing, and other services in a cluster. Methods for providing highly available network services are provided

• Day-to-day tasks involved in managing highly available applications

• How to manage the cluster file system and the device request dispatcher, how to add and remove storage devices, and how to load-balance disk servers

• The differences in LSM commands and behavior between a standalone system and a cluster

• How to investigate and resolve common TruCluster Server problems

3.1.3    Cluster Hardware Configuration (revised)

The Cluster Hardware Configuration manual describes how to set up the systems that will become cluster members and how to configure cluster shared storage.

This manual is intended for the person who will configure and manage the TruCluster Server system. The instructions in this manual are for experienced UNIX administrators who can configure and maintain hardware, operating systems, and networks. The following topics are discussed:

• Hardware requirements and restrictions

• SCSI bus requirements, how to set up a shared SCSI bus, and how to connect storage to a shared SCSI bus using the latest UltraSCSI products (DS-DWZZH UltraSCSI hubs, and HSZ80 RAID array controllers)

• How to prepare systems for a TruCluster Server configuration and how to connect host bus adapters to shared storage for use with the DS-DWZZH UltraSCSI hubs and the HSZ80 RAID array controller)

• How to set up and upgrade Memory Channel cluster interconnects

• An overview of Fibre Channel and how to set up Fibre Channel hardware to allow Tru64 UNIX and TruCluster Server installation on Fibre Channel disks using the HSG80 or Enterprise Virtual Array RAID Array controllers

• The use of AlphaServer GS80, GS160, or GS320 hardware partitions in a TruCluster Server configuration

• How to configure a shared SCSI bus for tape drive, tape loader, or tape library usage

• Requirements for a shared SCSI bus using externally terminated configurations and radial configurations using non-UltraSCSI RAID array controllers

• How to prepare systems and host bus adapters for TruCluster Server configurations using externally terminated configurations and radial configurations using non-UltraSCSI RAID array controllers

3.1.4    Cluster Highly Available Applications (revised)

The Cluster Highly Available Applications manual describes how to move applications from a TruCluster Available Server or TruCluster Production Server to a TruCluster Server environment, and how to use TruCluster Server functionality to make applications highly available.

A tutorial is provided on how to use the cluster application availability (CAA) subsystem to track the state of members and resources in a cluster and restart or relocate them to another member if a failure in an application is detected.

This manual also describes how to use TruCluster Server application programming interfaces (APIs) to take advantage of cluster technologies such as the distributed lock manager (DLM), cluster alias, and Memory Channel.

3.1.5    Cluster Installation (revised)

The Cluster Installation manual describes the following installation procedures:

• Installing TruCluster Server software on the Tru64 UNIX operating system and creating a new cluster

• Adding members to a cluster

• Reinstalling cluster members

• Performing a rolling upgrade from the previous version of the base operating system and cluster software to the current version

• Upgrading to TruCluster Server software from TruCluster Production Server software or TruCluster Available Server software Version 1.5 or Version 1.6

3.1.6    Guide to Prestoserve

Prestoserve speeds up synchronous disk writes, including Network File System (NFS) server access, by reducing the amount of disk I/O.

The Guide to Prestoserve describes how to manage and maintain a Tru64 UNIX system that includes the optional Prestoserve hardware and software.

3.1.7    Hardware Management (new)

The Hardware Management manual describes the tasks you perform to administer hardware components such as PCI bus option cards and storage devices that are controlled by the Tru64 UNIX operating system on an AlphaServer system. Much of the information in this book was previously included in the System Administration manual.

The Hardware Management manual begins with an overview of the hardware management model and descriptions of the resources that are available to you. It then presents the following topics:

• Using the SysMan Menu and SysMan Station to assist you in administering the system hardware on single systems and on clustered systems.

• Using the hwmgr utility, which provides your greatest control for managing hardware. Other interfaces, such as SysMan, provide only a limited subset of the features provided by the hwmgr utility's command-line interface.

• Using the ddr_config command to manage the Dynamic Device Recognition (DDR) database for your system. Although most device management is automatic, you might need to manually configure the device and its drivers in the kernel using ddr_config.

• Using device commands and utilities that are targeted at a particular kind of device and perform a specific task.

• Using the parallel scanning feature to enable systems that have large storage configurations to boot faster.

• Managing the operating system features that are designed to support specific models and classes of AlphaServer processors.

• Managing specific device types, such as storage arrays graphics adapters.

• Adding and configuring certain legacy hardware devices or options, such as the CalComp graphics tablet, the Computer Interconnect (CI) bus, and Hierarchical Storage Controllers (HSC).

This manual is for system administrators responsible for managing the operating system. The reader should be knowledgeable about operating system concepts and commands, as well as supported hardware and software configurations.

Administrators should know the operational aspects of UNIX system administration and be familiar with all the procedures necessary to maintain a UNIX system for high availability. This manual is not intended to train administrators or to plan the installation of a UNIX system.

3.1.8    Installation Guide (revised)

The Installation Guide describes how to install the Tru64 UNIX Version 5.1B operating system on all supported systems. Topics include preparing your system for an installation, booting the system from the distribution media, and performing the Full and Update Installation procedures on all supported processors.

Other topics include the following:

• The system management applications to use in setting up services following a Full Installation

• An overview of ways to manage software

• An overview of the Tru64 UNIX mandatory and optional subsets

• The Tru64 UNIX device-naming conventions

• An overview of the processes for installing associated products

• An overview of the installation log files, which capture the screen output and processing of Full, Update, and Cloned installations

This manual is intended for anyone who is installing or updating the operating system software or the Worldwide Language Support (WLS) software.

3.1.9    Installation Guide — Advanced Topics (revised)

The Installation Guide — Advanced Topics manual describes advanced installation procedures for the Tru64 UNIX operating system. Topics include the following:

• Performing an Update or Full Installation from a Remote Installation Services (RIS) server

• Adding support for additional languages (Worldwide Language Support software subsets) after the base operating system is installed

• Using the UNIX shell to perform disk and file system maintenance before or during a Full Installation

• Using the built-in disk planning features of the Full Installation process

• Installing and updating product kits

• Customizing the installation process

• Duplicating the installation and configuration characteristics of a running system onto one or more systems using the Installation Cloning and Configuration Cloning processes

This manual is intended for experienced installers who want to take advantage of the wide range of advanced installation features.

3.1.10    Kernel Debugging (revised)

The Kernel Debugging manual describes using the dbx, kdbx, and kdebug debuggers to diagnose problems in kernel code. It also describes how to write a kdbx utility extension and how to create and analyze a crash dump file.

This manual is for system programmers who write programs that are built as part of the kernel and that reference kernel data structures. It is also intended for system administrators who are responsible for managing the operating system. To understand and use the information in this manual, system programmers and administrators should have in-depth knowledge of operating system concepts, commands, and utilities.

3.1.11    Logical Storage Manager (revised)

The Logical Storage Manager (LSM) software provides high data availability, better performance, and greater storage management flexibility through online support for disk storage devices on Alpha systems.

The Logical Storage Manager manual explains LSM concepts and how to install and administer the LSM software.

The following topics are among those discussed:

• Encapsulating and mirroring the boot disk

• Creating and configuring LSM volumes and disks

• Using LSM commands to manage LSM objects such as disks, disk groups, volumes, plexes, and subdisks

• LSM-related preventative maintenance procedures that enable administrators to restore the LSM configuration if a disk or system fails

• Troubleshooting the LSM software

• Using the Storage Administrator graphical interface to manage LSM objects such as disks, disk groups, volumes, plexes, and subdisks

This manual is intended for system administrators who need to configure and maintain disk storage under the control of the LSM software. The reader should have a working knowledge of the operating system, a basic understanding of system administration, and a basic understanding of disk structures.

3.1.12    Managing Online Addition and Removal (revised)

The Managing Online Addition and Removal manual describes the Tru64 UNIX Online Addition and Removal (OLAR) features. It provides guidelines for their use and provides configuration and management techniques.

Although some tasks described in this manual are geared toward systems that have OLAR capabilities, many can be performed on systems without such capabilities.

The following topics are among those discussed:

• An overview of OLAR hardware components and the operating system features related to OLAR used to increase a system's availability

• High-level considerations — such as environment factors and power requirements — to take into account in order to properly set up and configure system hardware

• Component "indictment and deallocation," which refers to the methodology of identifying system components that have a likelihood of serious failure (indictment) and then automatically taking them off line (deallocation)

• Step-by-step procedures for adding and removing components in a system while keeping the operating system and associated applications running

• How to use various service applications to manage and monitor operating system services and user-defined services, including Web-Based Enterprise Service (WEBES), SysMan, Compaq Analyze, Compaq Crash Analysis Tool (CCAT), Revision and Configuration Management (RCM), sys_check, and collect

• How to prevent and correct operating system and application memory errors using memory trolling

This manual is written for system administrators, service technicians, and system operators who have extensive knowledge of their system's applications and hardware configurations and are responsible for managing and configuring a Tru64 UNIX system

3.1.13    Network Administration: Connections (revised)

The Network Administration: Connections manual, written for experienced system or network administrators, describes the procedures for configuring your system to operate in a network, for configuring the network services, and for day-to-day management of the network, network interfaces, and network services. This manual also includes information for solving problems that might arise while using the network and network services.

Topics discussed include the following:

• Configuring basic Tru64 UNIX network environments including Ethernet, Token Ring, Fiber Distributed Data Interfaces (FDDI), automatic network adapter failover (NetRAIN), and link aggregation groups

• Configuring an Internet Protocol Version 6 (IPv6) network

• The Asynchronous Transfer Mode (ATM) environment and how to configure and manage ATM networks

• Configuring and managing the Dynamic Host Configuration Protocol (DHCP)

• Configuring point-to-point connections using the Serial Line Internet Protocol (SLIP) and the Point-to-Point Protocol (PPP)

• The Local Area Transport (LAT) protocol and how to configure and maintain a LAT environment

• Troubleshooting networks and network services using flowcharts and other problem-solving tools

See also the Network Administration: Services manual.

3.1.14    Network Administration: Services (revised)

The Network Administration: Services manual, written for experienced system or network administrators, describes the tasks for configuring your system to operate in a network, for configuring the network services, and for day-to-day management of the network, network interfaces, and network services. This manual also includes information for solving problems that might arise while using the network and network services.

The topics discussed include the following:

• The Domain Name System (DNS) environment and how to configure and manage DNS servers and clients

• The Network Information Service (NIS, formerly Yellow Pages) environment and how to configure and manage NIS servers and clients

• The Network File System (NFS) environment and how to configure and manage NFS servers and clients

• The UNIX-to-UNIX Copy Program (UUCP) and how to configure and manage it

• The components of the Network Time Protocol (NTP) and how to configure and manage NTP clients and servers

• The components of the Tru64 UNIX mail system and information such as:

  • How to configure mail (the sendmail utility) on a standalone system or across an enterprise

  • How to configure POP and IMAP mail

  • How to administer mail on server and client systems

• The Simple Network Management Protocol (SNMP) implementation on a Tru64 UNIX system

• Troubleshooting networks and network services using flowcharts and other problem-solving tools

See also the Network Administration: Connections manual.

3.1.15    Security Administration (new)

When the enhanced security subset is installed and configured, the system is referred to as a trusted system. The enhanced security features result in a system that can be configured to meet the C2 and F-C2 security classes.

The Security Administration manual describes Tru64 UNIX security concepts and administration. Topics include the following:

• Configuring the system to use Password, Secure Shell, and Kerberos for authentication

• Configuring the system to use Tru64 UNIX permissions and access control lists (ACLs) to control access to resources

• Configuring the audit subsystem to monitor system activity

3.1.16    Sharing Software on a Local Area Network (revised)

The Sharing Software on a Local Area Network manual describes Remote Installation Services (RIS) and Dataless Management Services (DMS).

The RIS utility is used for installing software across a network, instead of using locally mounted media. RIS topics discussed in this manual include the following:

• Preparing and configuring a RIS server

• Booting a RIS client

• Managing RIS clients and environments

• Managing a RIS profile set

• Troubleshooting a RIS system

DMS allows a server system to maintain the root, /usr, and /var file systems for client systems. Each client computer has its own root file system on the server, but clients share the /usr and /var file systems. DMS topics discussed in this manual include the following:

• Setting up and configuring a DMS environment

• Managing DMS clients and environments

• Troubleshooting DMS

3.1.17    Software License Management

The Software License Management manual describes how to use the License Management Facility (LMF) to manage software licenses from HP.

Although intended primarily for system administrators responsible for managing software licenses on Tru64 UNIX systems, this manual also provides information for anyone who uses licensed software on Tru64 UNIX systems.

The LMF software can be used by companies other than HP. Those companies can issue Product Authorization Keys (PAKs) or have HP issue them on their behalf. Additionally, other companies can include license-checking functions in their software. However, the Software License Management manual addresses only software that is supplied and produced by HP.

3.1.18    System Administration (revised)

The System Administration manual describes how to configure, use, and maintain the Tru64 UNIX operating system. It includes information on general day-to-day activities and tasks, changing system configurations, and locating and eliminating sources of trouble.

System administrators are provided with overviews of administrative concepts, as well as step-by-step instructions to perform necessary tasks using either the SysMan graphical interface or the command-line tools.

The topics discussed include the following:

• System administration methods and utilities

• Shutting down and starting up a system

• Customizing the system environment

• Configuring the kernel

• Administering disks

• Administering file systems

• Administering user accounts and groups

• Administering the print services

• Administering the archiving services

• Administering the system accounting services

• Monitoring and testing the system

• Monitoring and administrating system events, including a chapter on using Event Manager

• Administering crash dumps

Additionally, an appendix to this manual lists and describes the various utilities and commands that are available for administering Tru64 UNIX systems.

The information in this manual is system administrators who are responsible for managing the operating system. The reader should be knowledgeable about operating system concepts and commands, as well as supported hardware and software configurations.

Administrators should know the operational aspects of UNIX system administration and be familiar with all the procedures necessary to maintain a UNIX system for high availability. This manual is not intended to train administrators or to plan the installation of a UNIX system.

For information about managing the hardware associated with Tru64 UNIX systems, see the Hardware Management manual.

3.1.19    System Configuration and Tuning (revised)

The System Configuration and Tuning manual describes how to plan, set up, and tune high-performance and high-availability systems running the Tru64 UNIX operating system. It can help system administrators to accomplish many system tasks, including the following:

• Monitoring systems and diagnosing performance problems

• Configuring and tuning a system that will meet current and future needs

• Tuning system resource limits (such as the size of system tables and the virtual address space) that were set at boot time

• Understanding how hardware, operating system subsystems, and layered products interact to affect system performance

• Managing the performance of memory, the CPU, disk storage, file systems, and networks

3.1.20    System Configuration Supplement: OEM Platforms

The System Configuration Supplement: OEM Platforms manual provides information needed to set up OEM platforms running the Tru64 UNIX operating system. It helps system and network administrators configure Alpha VME single-board computers (SBCs), PCI/ISA modular SBCs, and VMEbus backplane networks in which SBCs operate as Ethernet nodes.

This manual is for experienced system and network administrators who are thoroughly familiar with their platform's I/O bus and with the operating system concepts, commands, and configurations.

3.1.21    X Window System Environment (revised)

The X Window System Environment manual describes various aspects of the X Window System environment as it is implemented on Tru64 UNIX. It provides information on how to perform system administration tasks for the Tru64 UNIX X Window System environment, and describes how to customize X Window System resources and key mappings. It also provides information about programming within the Tru64 UNIX X Window System environment.

3.2    Printed-Only Documentation

The documentation described in this section is provided only in printed books. This documentation is included in the Tru64 UNIX documentation kits.

3.2.1    Full Installation Quick Start (revised)

The Full Installation Quick Start card describes the basic steps for performing a Full Installation of the Tru64 UNIX operating system from the installation CD-ROM. It walks you through the process of performing preinstallation tasks, installing the operating system, and setting up services.

Users of this card should have a working knowledge of the Tru64 UNIX operating system and to have previously performed a Full Installation. First-time installers are urged to follow the more detailed instructions provided in the Installation Guide.

3.2.2    Update Installation Quick Reference Card (revised)

The Update Installation Quick Reference Card describes the basic steps for upgrading your Tru64 UNIX operating system to Version 5.1B from the installation CD-ROM or from a Remote Installation Services (RIS) server. Update installations preserve disk partitions, file systems, and file customizations.

Users of this card should have a working knowledge of the Tru64 UNIX operating system and to have previously performed an Update Installation. Users who are performing their first Update Installation are urged to follow the more detailed instructions provided in the Installation Guide.

3.3    Online-Only Documentation

Except where noted, the documentation described in this section is provided on the Documentation CD-ROM and the on the Web.

3.3.1    Advanced File System Quick Reference

The Advanced File System Quick Reference provides hands-on, task-oriented information for planning, setting up, maintaining, and troubleshooting an Advanced File System. Additional documentation, often including detailed examples, is referenced at the end of most sections. This document is available only from the Web and is revised as needed.

3.3.2    BIND Configuration File Guide

The BIND Configuration File Guide describes the Berkeley Internet Name Domain (BIND) Version 8 and its implementation as an Internet name server for BSD-derived operating systems.

Version 8 is more configurable than previous releases of BIND, with new areas of configuration such as access control lists (ACLs) and categorized logging. Also, you can now selectively use many options that previously applied to all zones.

3.3.3    DECevent Translation and Reporting Utility

DECevent provides an interface between a system user and the operating system's event logger. DECevent can help system administrators to troubleshoot Tru64 UNIX system problems.

The DECevent Translation and Reporting Utility manual describes the DECevent command features related to the translation and reporting of events on Tru64 UNIX operating systems. It contains an overview of the utility, information on how to obtain help for the utility, and information about all the commands necessary to translate event logs on Tru64 UNIX operating systems.

3.3.4    sendmail Installation and Operation Guide

The sendmail Installation and Operation Guide describes the configuration file for Version 8.11 of the sendmail utility, which implements a general-purpose internetwork mail routing facility under the Tru64 UNIX operating system.

The sendmail utility is not tied to any one transport protocol — its function can be likened to a crossbar switch, relaying messages from one domain into another. In the process, it can do a limited amount of message header editing to put the message into a format that is appropriate for the receiving domain. All of this is done under the control of a configuration file.

3.3.5    System Event Reference (new)

The System Event Reference manual lists and describes all of the Event Manager events in Version 5.1B of the HP Tru64 UNIX operating system.