The operating system provides a number of methods and utilities you can use to perform administration tasks from initial configuration (setup) to ongoing maintenance and customizing your system environment. The following sections are included in this chapter:
Section 1.1 provides an overview of administrative methods and utilities.
Section 1.2 provides pointers to other documentation available for the administrative utilities, such as online and Web-based help.
Section 1.3 explains the system setup utilities that are automatically displayed during the first root login to a system (after a full installation).
Section 1.4 introduces the different administrative methods and utilities.
Section 1.5 describes the administrative utilities that you launch from the Common Desktop. Environment (CDE)
Section 1.6 explains how to use the SysMan Menu.
Section 1.7 explains how to use the SysMan Menu command-line interface.
Section 1.8 explains how to use the SysMan Station.
Section 1.9 introduces Compaq Insight Manager, which you can use to view system status, and launch the SysMan Menu and the SysMan Station from a Web browser.
Section 1.10 explains how to configure the SysMan Menu and the SysMan Station clients so that you can launch them directly from Windows on a PC.
Section 1.11 explains how to set up a serial line console to access a remote system using a modem line.
1.1 Overview of the SysMan Menu and Other Utilities
SysMan Menu utilities are independent of the user environments:
X-compliant user environments, such as CDE.
Microsoft Windows user environments running on an IBM-compatible Personal Computer (PC), such as Windows 98 and Windows NT
Web-based management using a Web browser, such as Internet Explorer, and Compaq Insight Manager.
A terminal, or terminal window running under any of the above user environments. In this case, terminal curses mode is used to display and use SysMan utilities.
For example, you can perform administrative tasks on a remote UNIX system from a personal computer running Microsoft Windows NT using the SysMan Menu and SysMan Station clients running as Java applications. The utilities are consistent in appearance no matter what user environment is used.
Although you can use different methods to perform the same tasks, there might be minor differences in the options provided, depending which administrative utilities you use and how you invoke them. For example, many SysMan Menu utilities are designed to run in different user environments, and therefore contain no graphical elements such as icons. The X11-based utilities, designed to run in a windowing environment such as CDE, often contain graphical elements and support windowing features such as drag-and-drop. Examples of these are:
Account Manager, (dxaccounts
), used to
administer user accounts and groups.
Kernel Tuner (dxkerneltuner
), used to customize
your UNIX kernel.
File Sharing (dxfileshare
), used to share
local directories and mount remote shares.
Other legacy utilities, retained for backwards compatibility, are designed
for use in character-cell terminals only.
However, when invoked from the SysMan Menu,
these utilities also run in any of the supported user environments.
An example
is the NIS configuration utility,
nissetup
, which appears
on the SysMan Menu as
Configure Network Information Services(NIS)
In contrast to the X11-compliant utilities, the SysMan Menu utilities are not as highly functional and graphical. They enable you to perform the basic administrative tasks, independent of user environment. They also offer a greater breadth of administrative functions. The following usage constraints apply:
There might also be minor differences in the appearance and layout of the SysMan Menu utilities, depending what user environment you are using. For example, invoking "Shutdown the system" when in the X11 CDE user environment displays the shutdown delay selection as a slider bar. You use the mouse button to click on this bar and drag it to select a longer time. When the same utility is invoked in a character-cell terminal, the slider bar is replaced by a field in which you type a number representing the shutdown delay time.
There are also functional differences between administrative
utilities.
Some SysMan Menu utilities do not offer all the options available
in the analogous command-line (or X11-compliant) utility.
For example, when
managing user accounts, you can use the
useradd
command
to set default characteristics that all newly created accounts inherit.
You
cannot set these characteristics from the SysMan Menu Accounts utilities.
As a general rule, the SysMan Menu utilities provide the most frequently
used options, while the command line interface (CLI) provides all options.
The advantage for the system administrator is that the SysMan Menu
and SysMan Station provide a single consistent presentation format for
administrative utilities, no matter where the administrator is located and
what user environment is available.
For example, you can log on to a remote
UNIX system from your local PC and use the same familiar utilities to perform
administrative tasks.
You can also connect to any system using Compaq Insight Manager across
the Web to view the system status and launch the SysMan Menu and the SysMan Station
to perform tasks on the remote system.
1.2 Related Documentation
This guide does not document how to invoke and complete all fields in a given administration utility, but describes how you use the utility to perform administrative tasks. It includes examples of use, but not for all user environments or options. This section provides pointers to more detailed information on invoking and using administration utilities and methods. Documentation for the various options is provided in the following formats:
Reference pages - Each utility has its own reference
page that describes how to invoke the utility, and its available options.
For example, the
sysman_cli
(8)
describes how you invoke the command-line version
of the SysMan Menu data.
Reference pages also document the user environment options for a particular utility. You might be able to invoke an administrative utility in several different user environments, or you might only be able to invoke it in one.
Online help - Each utility provides an online help volume that describes how you use it and gives a detailed description of the available option in a utility. Online help also identifies valid data that the user must supply, and provides reference information and definitions of terminology. The online help is accessed from a button on the first window of a utility, or from the CDE help library by invoking the library icon on the CDE front panel. System Management is the first help volume available.
In some graphical user environments, context-sensitive help is provided
for the options and fields.
As you move the pointer over the screen, a brief
description of the screen fields or option buttons is displayed in a message
field.
In a
curses
user environment, a help message is
displayed as you move between fields and options with the Arrow keys or Tab
key.
See
curses
(3)
for more information on
curses
.
Command-line utilities have help that describes the command syntax.
This is usually invoked with the
-h
or
-help
flag, or simply by entering the command without any arguments and parameters
and pressing the Return key.
Web browser-based help - When you configure and invoke
the Netscape viewer as described in the
Installation Guide
the home page defaults
to
file:/user/doc/netscape/Digital_UNIX.html
.
This page
contains links to the following information:
Documentation - The online documentation for the operating system.
System Management - A link to
file:/user/doc/netscape/SYSMAN/index.html
, the Compaq Insight Manager Web-based Management page.
The following information
on administering the operating system is available from this page:
Using SysMan Menu and the SysMan Station.
Using an X-capable user environment such as CDE.
Using a personal computer (PC) running Microsoft Windows. This section provides links to the client software that you must download to your PC.
Note
The SysMan Menu is running in Web/Java mode if it was launched from a web browser or from the SysMan Station. The SysMan tasks are running in web/java mode if they were launched from a web browser, SysMan Station, or from an instance of the SysMan Menu running in web/java mode.
To view online help for the SysMan Menu or any of the Menu tasks when running in web/java mode (such as from a PC), the Compaq Insight Manager daemon must be running on the server to which you are connecting. To start the daemon, run the following command on the server as root:
# /sbin/init.d/insightd start
You can find out which system is the server by looking at the title bar of the window from which you launched the help command.
The SysMan Station also requires the
insightd
daemon to display online help.
Links to product information on the World Wide Web.
When Compaq Insight Manager is configured, you can also connect to the Web agents of any system in the local network domain that is running the Compaq Insight Manager agents. For example, to connect to the local host on a UNIX system, invoke Netscape and specify the following URL in the Location field:
http://<host>:2301
Where
<host>
is either the fully qualified
network name of the system, such as
bender.fut.ram.ma
,
or the TCP/IP address, such as
111.22.333.11
.
The port
is always
:2301
.
See
Section 1.9
for
more information on configuring Compaq Insight Manager.
Choose Compaq Insight Management Agents and then click on "Summary?" to access the Compaq Insight Manager Web-based user guide.
Note that there are restrictions on using Compaq Insight Manager, depending on your user environment. See Section 1.9 for information.
The initial configuration of your system (setup) is usually performed as a post-installation task and System Setup is invoked automatically at first root (superuser) login after an installation. During installation, you might have already used some of the utilities documented in this chapter. You use the same utilities for initial setup as you do for ongoing maintenance and custom configuration of your system.
The System Setup utility is presented as a graphical user interface
(the clipboard) if your system has a graphics board and you are running an
X11 user environment such as the default CDE.
If you first log in at a character-cell
terminal, System Setup is presented as a text interface.
Figure 1-1
shows the System Setup in graphical format.
Figure 1-1: System Setup Graphical Interface
You can invoke System Setup at any time to modify the existing system
configuration, simply by typing
setup
at the command line,
or by invoking the System Setup icon in the CDE Application Manager -
System Admin folder.
The following options are provided:
Quick
Setup - Enables you to complete basic configuration of system services
such as networking, mail, and printers.
This option is useful if you want
to get a system up and running quickly, leaving advanced configuration options
for later.
Figure 1-2
shows the initial quick setup window.
Figure 1-2: Quick Setup
Custom
Setup - Enables you to run a wide range of system configuration utilities
to perform all the Quick Setup tasks and run additional setup options such
as custom disk configuration or set up the point-to-point protocol.
Figure 1-3
shows part of the Custom Setup graphical interface.
Figure 1-3: Custom Setup
Cloning
Information - This options provides a link to information on the SysMan Menu
option to clone your system configuration so that you can apply it to other
systems.
See the
Installation Guide -- Advanced Topics
and
sysman_clone
(8).
Refer to
Section 1.5.2
for more information and
see
setup
(8).
1.4 Administrative Methods
You can accomplish most of the tasks described in this guide by using one or more methods. Because of its versatility in different user environments, SysMan is the recommended method of performing system administration tasks.
The SysMan Menu
The SysMan Menu integrates most available system administration utilities in a single menu that enables you to run the utilities as follows:
From any local or remote character-cell terminal
From any X11-compliant windowing environment, such as CDE
From Microsoft Windows on a personal computer (PC)
From the Web browser using Compaq Insight Manager
More information is provided in Section 1.6.
The SysMan Station
The SysMan Station is a graphical representation of a system (or
cluster) that enables you monitor system status from the CPU down to the level
of individual system components such as disks.
You can also view and monitor
logical groups such as file systems or AdvFS domains and create customized
views.
When viewing any system component, you can obtained detailed information
on its properties or launch utilities that enable you to perform administrative
tasks on the component.
Unlike the SysMan Menu, the SysMan Station
requires a graphics capability and cannot be run from the character-cell or
curses
user environments.
More information is provided in Section 1.8.
Graphical user interfaces in the CDE Application Manager - System_Admin
A set of X11-compliant graphical user interfaces (GUIs) that run under
CDE or other X11-compliant windowing environments.
Use of the GUIs requires
a graphics (windowing) terminal or workstation, and the installation of the
windowing software subsets.
These graphical utilities support features of
the windowing environment, such as using cut-and-paste to create duplicated
versions of user accounts in
dxaccounts
.
More information is provided in Section 1.5.
Command-line scripts
For compatibility reasons, older administrative utilities are preserved
in most cases.
Some command-line utilities have migrated to become the new
command-line options.
For example, the
adduser
script is
still available, but it is superseded by the following utilities:
The SysMan Menu Accounts utilities, which provide tasks enabling you to manage users and groups in local and NIS environments.
The
useradd
command-line utility, which
you run from a character-cell terminal.
The Account Manager graphical user interface, available from
Application Manager - DailyAdmin in the CDE environment, or by invoking
dxaccounts
from a terminal window.
(The interface runs in other
X-compliant windowing environments)
The Accounts option on the SysMan Menu, available from
Application Manager - System_Admin in the CDE environment, or by invoking
sysman
from a terminal window.
You should migrate your system administration processes from the older
command-line scripts to the appropriate SysMan Menu method.
These command-line
utilities are moved to optional
OSFRETIREDxxx
subsets.
Refer to the
Installation Guide
for information on installing the retired command
subsets.
Serial line console
In addition to networked methods of administration, the serial line console provides a dial-up facility that enables you to connect to remote systems via a modem. See Section 1.11.
Manual file changes by editing system files (not recommended)
Traditionally, experienced UNIX administrators have used a combination
of individual shell commands, scripts.
and utilities, or simply edited the
system files.
Most sections of this book describe the various system files
that are updated or modified when you perform an administrative task, and
you might still want to make manual changes.
The use of system utilities maintains
the integrity and consistency of system files such as
/etc/sysconfigtab
.
It is strongly recommended that you use the appropriate utilities
to update system files so that the structure of these files is preserved.
Important considerations are:
CDSLs - context-dependent symbolic links
Many system files are now special symbolic links, created to facilitate
clusters.
If these links are broken, the system cannot be joined to a cluster
in future without recreating the links.
See
Chapter 6
and
hier
(5).
Binary databases, configuration definitions
Many system components write data both to text and binary files, and their administrative utilities often re-create the binaries. Other system data is preserved. When you update your system the data is recovered and used again, saving you time and effort on administering the system.
Latent support for clusters
Individual systems are capable of being joined into clusters and many
UNIX system files provide latent support for clusters.
For example, the
rc.config
file now has two related files,
rc.config.common
and
rc.config.site
which can store run-time
configuration variables.
Using the
rcmgr
utility ensures
the integrity and consistency of these files.
Update installation - preserved customized files
During an update installation, the installation process merges changed
information into existing system files.
The
.new..*
and
.proto..*
files might be important in this process.
Refer to the
Installation Guide -- Advanced Topics
for more information.
1.5 Administrative Utilities Under CDE
The Common Desktop Environment (CDE) is the default X11 windowing user environment, although the utilities described in this section run on other X11-compliant user environments. When you complete the full installation, the System Setup graphical interface is displayed to guide you through the process of configuring the system for initial use. From System Setup, you invoke the same graphical user interfaces (GUIs) that you use regularly to administer and customize the system. System Setup is described in Section 1.5.2.
Many of the administrative utilities that you invoke from within CDE start a SysMan Menu task option. However, some of the utilities are graphical, and either have no analogous SysMan Menu option, or offer features that can only be used under CDE. Examples are:
CDE Setup, used to configure the CDE environment.
Disk Configuration (diskconfig
), an application
that you use to configure disk partitions.
Archiver (dxarchiver
), an application used
to create
tar
,
pax
, or
cpio
archives.
You can use drag-and-drop to easily add folders to an
archive.
Under CDE, The GUIs are located in the Application Manager, which
is the tool drawer option on the CDE front panel, as shown in
Figure 1-4.
The icon next to the tool drawer only appears on the CDE front panel for the
root login and is used to invoke the SysMan Station as described in
Section 1.8.
Figure 1-4: CDE Tool Drawer and SysMan Station Icons
If you are using an X11-compliant user environment other than CDE, invoke the individual GUIs from the command line as shown in the following examples:
# /usr/sbin/X11/dxaccounts # /usr/sbin/X11/dxarchiver
1.5.1 Accessing SysMan Under CDE
In CDE, certain SysMan Menu utilities are available in the Application Manager folder, which you can access as follows:
From the CDE Front Panel by clicking on the arrow for the
SysMan Applications panel.
You can see this arrow above the icon for the SysMan Station,
shown in
Figure 1-4.
When you click on this arrow, the
panel appears as shown in
Figure 1-5.
Figure 1-5: SysMan Applications Panel
From this panel you can select one of the following icons, to launch a utility or open a folder containing more administration utilities:
Launch the SysMan Station, which is described in Section 1.8. In a root login to CDE, this icon appears on the front panel as shown in Figure 1-4.
Click on a folder icon, such as Configuration to open the applications folders, which contain utilities described in Appendix A.
Launch the SysMan Menu.
From the CDE Front Panel by clicking on its tool-drawer icon,
shown in
Figure 1-4.
When the top-level folder is displayed,
double click on the
System_Admin
group to access
System Setup
, the
Welcome to SysMan
online help
volume, and the five utility groups.
See
Section 1.5.2.
Online help is available for the SysMan Menu utilities without actually
running any utility.
Click on the
Help Manager
icon on
the CDE front panel to display the online help browser.
The browser includes
help families for CDE, the CDE Desktop, and System Management.
You can also
customize your CDE workspace with the
Create Action
utility
in the
Desktop_Apps
folder.
Customized icons enable you
to start SysMan applications directly from the workspace.
See the
CDE Companion
guide for more information.
In other X-Windows environments, you can invoke the SysMan utilities
from the command line.
See
sysman_intro
(8)
for a list of the utilities.
This
reference page also describes how to display the online help browser in graphical
environments other than CDE.
The SysMan Station icon is also located on
the CDE Front Panel on the root user display.
Additional information is available as follows:
sysman
(8)
- describes the SysMan Menu and explains
how to invoke it for various environments.
See also
Section 1.6.
sysman_station
(8)
- describes the SysMan Station
and explains how to invoke it.
See also
Section 1.8.
sysman_cli
(8)
- describes the command-line option for SysMan Menu,
and defines the command options.
See also
Section 1.7.
System Setup guides you through the process of configuring the system for initial use. System Setup is a graphical representation of a clipboard that contains an icon for each configuration application. After the initial root login following a full installation, System Setup is displayed automatically, prompting you to complete system configuration tasks. The initial window contains two options:
Quick Setup - This option provides a step-by-step guide (or wizard) that navigates you through a typical system configuration. Use the quick setup to perform a basic configuration (which might be all that is required for some systems). You can perform any advanced or site-specific configuration tasks at a later time using the Custom Setup.
The Quick Setup wizard guides you through the following tasks:
Entering your software licenses (PAKs)
Configuring the network interface card (NIC)
Configuring static network routing
Specifying the following networking services and naming servers:
Domain Name Service (DNS, formerly BIND)
Network Time Protocol (NTP)
Network Information Service (NIS, formerly YP or Yellow Pages)
Network File System (NFS)
Electronic mail server
Configuring a default local or remote printer and server
You can skip any options that you do not require, details of which are provided later in this section.
Custom Setup - This option invokes a version of System Setup that contains an icon for each configuration application. You can select only the options you require for your site-specific configuration or custom configuration, for example configuring a system as a server.
Not all configuration applications are available on all systems.
The
file
/etc/checklist.desc
contains a list of configuration
applications.
After you select an icon, the appropriate SysMan Menu utility,
X11-based GUI, or character-cell script is invoked.
You do not need to use all the options presented on System Setup, and you can opt to defer any option to a later time. If you choose to defer any configuration options and exit from System Setup, you must invoke System Setup manually from the Application Manager - System Admin folder, from the SysMan Menu, or from the command line as follows:
# /usr/sbin/sysman # /usr/sbin/checklist # /usr/sbin/setup
SysMan integrates most system administration utilities and makes them available under several different user environments. You can access utilities from the SysMan Menu, a hierarchical, task-oriented menu interface.
You can perform all the tasks in the SysMan Menu by using an X11-capable display, a personal computer running Microsoft Windows, or a character cell terminal. There are several ways to start the SysMan Menu:
To start the SysMan Menu from a CDE desktop:
Log in as root and choose the SysMan Menu icon from the CDE front panel's SysMan Applications panel.
Choose the SysMan Menu icon from the System Management group in the Application Manager.
To start the SysMan Menu from a command prompt in a terminal window, enter the following command:
# /usr/sbin/sysman
To start the SysMan Menu from the SysMan Station, select the system icon in a view window and then choose SysMan_Menu from the SysMan Station Tools menu.
You can start a specific task directly from the command line
using its name in the menu or its accelerator, which is a unique keyword for
each option in the sysman menu.
For example, to run the task that invokes
the menu option
Configure Division of Privileges (DOP)
use
its accelerator
dopconfig
and enter the following command
at the system prompt:
# /usr/sbin/sysman dopconfig
Use the following command to obtain a complete listing of the available tasks and their accelerators.
# /usr/sbin/sysman -list
The SysMan Menu contains a text list of options organized in a hierarchy
(or tree).
Each option appears as a branch on the tree.
Each branch provides
more options that might be further branches or might end in a task.
You can
collapse or expand each option if suboptions are available, as indicated by
a character preceding each menu item.
The plus sign (+
)
indicate s that further menu items are available while the minus sign (-
) indicates that the branch is fully expanded.
Tasks at the end of a branch are preceded by a vertical bar (|
) indicating that no further expansion of the branch is possible
and you can only select a task to invoke an administrative utility.
Figure 1-6
Shows the SysMan Menu invoked in the CDE user
environment.
The contents of this menu might be different on your system:
Figure 1-6: The SysMan Menu
As shown in
Figure 1-6,
the
Software
branch (label 1) is fully expanded, showing
Installation
branch and the
Register license data
task.
The
Installation
branch (label 2) contains several
tasks such as
Install software
and
List installed
software
.
After you select a task, the appropriate utility is invoked.
How you move through and select menu items or invoke tasks is dependent
on the user environment that you are using such as a
curses
terminal or a windowing environment.
When using a terminal, you use the arrow
keys or Tab key to move around the menu, highlighting options and buttons
as you move.
Use the Enter key to select an item, which expands a branch or
selects a task to invoke the associated utility.
When using a mouse in a windows
environment, you can move the pointer to a branch or task and double-click
MB1 to expand a branch or select a task and invoke the associated utility.
Refer to the online help for detailed instructions on navigating through the
utilities.
The following option buttons appear on the SysMan Menu:
Select - chooses the highlighted item. Selecting a branch expands or contracts it. Selecting a task invokes its associated utility.
Find... - Invokes the search window, enabling you to search on a keyword and find associated tasks.
Help On Item - Invokes context-sensitive help on any branch or task.
Exit - Closes the SysMan Menu window.
Options... - Provides options for configuring the SysMan Menu display, such as displaying the accelerators.
Help - invokes general help on the SysMan Menu.
Context-sensitive help is also displayed in the pane located
between the two rows of buttons.
This help describes the content of the window
as you move the mouse pointer or use the Tab key to move to an item.
Selecting
a task invoke its associated utility in a format that is most appropriate
for your current user environment.
For example, the task is invoked in the
X11-compliant windowing environment if you are using CDE, or in
curses
format if you are using a character-cell terminal.
See
sysman
(8)
the online help.
Refer to the tables in
Appendix A
for information on related utilities.
1.7 Using the SysMan Command Line
The
sysman -cli
utility is a command-line alternative
to the SysMan Menu, which enables you to implement SysMan Menu tasks
from the command line, view SysMan data, or write scripts to customize
your configuration tasks.
When you set up different parts of the system,
such as configuring the network using SysMan Menu tasks, you are manipulating
system configuration files such as
/etc/rc.config.common
or
/etc/hosts
.
The
sysman -cli
utility
enables you to view and manipulate entries in these files directly from the
command line or from within a shell script.
You must have root privileges to use
sysman -cli
options, although unprivileged users can use it to view system setup data.
Refer to the
Security
guide for information on using the division
of privileges (dop) utilities to enable nonroot users to become privileged
users of SysMan tasks.
This section provides only a brief introduction to the many features
of the
sysman -cli
utility.
See
sysman_cli
(8)
for a complete
list of options.
A set of shell script examples are provided in
/usr/examples/systems_management/sysman_cli
.
Some command line examples
follow.
You can use the
sysman -cli
command to display all
the manageable components in the Menu.
For example, the following command
is used to list the main components in the SysMan Menu hierarchy:
# sysman -cli -list components Component(s): account_management atm auditconfig bindconfig bttape ciconfig clsschl doprc . . . networkedSystems . . .
The following command displays the groups included
in the
networkedSystems
component:
# sysman -cli -list group -comp networkedSystems Component: networkedSystems Group(s): hostEquivalencies hostEquivFileText hostFileText hostMappings joinMappingService componentid digitalmanagementmodes
The following command
displays the current data values in the
hostMappings
group
of the component
networkedSystems
.
This data is the content
of the
/etc/hosts
file.
# sysman -cli -list values -group hostMappings / -comp networkedSystems Component: networkedSystems Group: hostMappings {} {} 127.0.0.1 localhost argnot {local host} 16.140.112.139 argnot.xxx.yyy.com jason server 16.140.112.3 jason.xxx.yyy.com fleece {backup server} 16.140.112.28 fleece.xxx.yyy.com {} {} 150.2.3.4 newshst.pubs.com
For every option
in the SysMan Menu, the
sysman -cli
command gives you
the ability to view and manipulate system data without invoking the utilities.
For example, the following command shows how you can remove a host from the
/etc/hosts
file:
# sysman -cli -delete row -group hostMappings / -comp networkedSystems Please enter key 1 [systemName]: newshst.pubs.com Please enter key 2 [networkAddress]: 150.2.3.4
Note that you are prompted to enter
key data that enables the utility to identify the correct entry in the
/etc/hosts
file.
Because the SysMan Menu options sometimes work
on data that is stored in tables, you need to identify the correct row in
the table to delete or modify.
Every row has some unique identifiers, called
keys, which you must specify with the
sysman -cli
command
option.
If you do not supply the keys, you are prompted to enter them.
The
following command shows how you determine the keys for a particular table:
# sysman -cli -list keys -group hostMappings -comp / networkedSystems Component: networkedSystems Group: hostMappings Keys: systemName,networkAddress
You can also use
sysman -cli
commands to add or remove
user data entries from the system data files that are updated by the SysMan Menu.
For example, the following command adds a mail user interactively:
# sysman -cli -add row -comp mailusradm -group mailusers Attribute Name: user_name (key attribute) Attribute Description: user name Attribute Type: STRING(8), Default Value: Enter Attribute Value: davisB Attribute Name: nis Attribute Description: NIS User Attribute Type: INTEGER, Default Value: 0 Enter Attribute Value ( to use default): 1 Attribute Name: mail_type (key attribute) Attribute Description: mail user type Attribute Type: INTEGER ENUM / { 0=Local/pop, 1=Secure Pop, 2=IMAP, 3=Secure IMAP }, / Default Value: 0 Enter Attribute Value ( to use default): 2 Attribute Name: acl Attribute Description: acl list Attribute Type: INTEGER ENUM / { 0=all, 1=read, 2=post, 3=append }, Default Value: 0 Enter Attribute Value ( to use default): 0 Attribute Name: quota Attribute Description: user name Attribute Type: STRING(8), Default Value: Enter Attribute Value: Attribute Name: passwd Attribute Description: password Attribute Type: STRING(20), Default Value: Enter Attribute Value: change_me Attribute Name: orig_mailtype Attribute Description: original mail user type Attribute Type: INTEGER ENUM / { 0=Local/pop, 1=Secure Pop, 2=IMAP, 3=Secure IMAP }, / Default Value: 0 Enter Attribute Value ( to use default): #:
You can also enter the command as a single line, specifying all attribute values as follows:
# sysman -cli -add row -comp mailusradm -group mailusers / -data "{davisB} {1} {2} {0} {0} {pls_chg} {1}"
The SysMan Station enables you to monitor a system, group of systems, or an entire cluster and administer system resources. You can also launch the SysMan Menu or invoke utilities directly from the Tools menu, or by selecting the icon representing a system component, and pressing MB3 to display a menu of options that apply to the selected device. Unlike the SysMan Menu, the SysMan Station is a highly graphical interface, and can only run in a windowing user environment such as CDE or Microsoft Windows.
Note
You can only connect between compatible server and client versions of the SysMan Station. If you attempt a connection to an incompatible server, it displays an error message or dialog similar to the following:
System Management Server on host host name running version N, This client running incompatible version N
Upgrade your client software to the appropriate version by downloading it from the server.
This section provides a brief introduction to the main features of the SysMan Station, including customized views. For more information, refer to the online help.
Use the following procedure to start the SysMan Station from CDE:
Log in as root and use the SysMan Station icon from the CDE Front Panel or from the SysMan Applications sub-panel. (This assumes the default CDE configuration, where the SysMan Station icon appears on the Front Panel under the SysMan Applications sub-panel.)
Choose the SysMan Station icon from the System Management group in the Application Manager.
To start SysMan Station from the command prompt, enter:
#sysman -station
After invoking SysMan Station, you are connected to the local host.
The main SysMan Station window appears similar to the example shown in
Figure 1-7, except that the default display shows the Filesystems...,
Network..., and Storage...
options that you can monitor.
These options are
referred to as attention groups.
Figure 1-7: SysMan Station Main Window
You can obtain event data for any of these groups by moving the pointer to an attention group, and pressing MB1. A window displaying a list of events is displayed.
The SysMan Station is a graphical representation of the system, in a hierarchical (tree) structure. For example, in the Storage option, you can view all disks on all buses for all processors on the system. You can select a specific device to monitor, and invoke utilities to administer that device. You can also display many details (properties) of individual devices. SysMan Station also enables you to create a customized view of a system or an attention group such as storage devices. You can quickly launch your custom views and check on device status.
The main window of SysMan Station provides the following features:
The Status pane, in which you monitor attention groups. Status options are described in Section 1.8.1
The Views pane, from which you select a particular view of system components. View options are described in Section 1.8.2. This pane also displays any customized views that you create with SysMan Station.
Menu options for changing views or selecting tasks. These options are described in Section 1.8.3. That section also contains brief instructions on saving customized views.
1.8.1 Using SysMan Station Status Options
When you invoke the SysMan Station, the Status pane displays a large checkmark icon if the status of the attention group is normal. If the status degrades, the icon changes color, becoming a cross (X) on a red background to indicate a serious problem. These icons also enable you to instantly display any system events posted by any component in the attention group.
The default attention groups that you can monitor are:
File systems - Any UFS file systems or AdvFS domains.
Network - The network and devices connected to the local
host, such as
tu0
.
Storage - Storage devices connected to buses and device
interfaces, such as
floppy
, the floppy drive unit that
is connected to an
fdi
interface such as
fdi0
.
1.8.2 Using SysMan Station Views
In the Views pane, a list of attention groups is displayed. You can select any item in the list to display a window showing the hierarchical structure of the group. The options are:
AdvFS_Filesystems - A view of all AdvFS domains.
Figure 1-8
shows a typical AdvFS domains view on a small
single-disk system.
Figure 1-8: AdvFS_Filesystems View
Hardware - a view of all devices, from the CPU down
to individual disks.
Figure 1-9
shows a typical hardware
view on a small single-processor system.
Figure 1-9: Hardware View
In this example, you can see the system
buses, and the various devices attached to a bus, such as the CD-ROM reader
cdrom0
Mounted_Filesystems - A view of file systems that are currently mounted, in a similar format to the AdvFS_Filesystems view.
Physical_Filesystems - A view of all (UFS, AdvFS) file systems available, in a similar format to the AdvFS_Filesystems view.
You can customize views and save them so that you only monitor those parts of the system that are most important to you, or run applications to administer the components displayed in a view. When you customize a view, you have the opportunity to save it, and assign it an icon as described in Section 1.8.3.
In any of the system component screens, you can click MB1 on any component to select individual system components and expand or collapse sections of the display hierarchy. On selecting a component, MB3 displays a menu that contains one or more of the following options (depending on whether an option applies to the object that is selected):
Display hierarchy functions:
Expand and Contract - These options display or remove the subcomponents under a component. For example, click on the Expand option when selecting a SCSI bus, and all its attached devices are displayed. Click on Contract to remove the displayed devices.
Hide and Unhide Children - Allows you to prevent some
components and their subcomponents from being displayed, or to reveal hidden
components.
For example, click on the Hide option when selecting a PCI bus
such as
pci0
and all its attached devices are hidden.
This
means that you cannot display the devices by double-clicking MB1 on the bus
or by selecting the Expand menu option.
Click on Unhide Children to enable display of the PCI bus devices.
Available SysMan Menu utilities - This option displays any administration or configuration utilities that you can launch for a component. For example, you can select a disk device, and launch the disk configuration utility.
Properties - Additional detail about the characteristics and current configuration settings for the selected device.
Options are grayed out when not available.
1.8.3 Using SysMan Station Menu Options
The main window of the SysMan Station offers the following pull down menus and options, provided to enable keyboard selection rather than using a mouse:
File - This menu contains options to close the SysMan Station and exit, or to connect to another system
Monitoring - This menu enables you to customize the Status view by removing an entire attention group, such as the Filesystems... attention group
Options - This option enables you to further customize SysMan Station by selecting the initial window
Windows - This menu enables you to cycle between the different displayed views
You are prompted to save your custom view before you exit SysMan Station. You can then assign a name and an icon to the custom view. When you next invoke SysMan Station, your custom view is added to the Views pane.
The component views provide pull-down menus of the following options:
File - Options to print the current screen, create a new connection, close the current window and to exit from SysMan Station.
Action - Options to change the grouping of components and the default appearance of displays, such as the Expand and Hide options.
Tools - Provides a launch point for any SysMan Menu utilities that are applicable to the selected component. The content of this window varies, depending on the type of component or device that is selected. The menu is blank if no utilities are applicable to the component, or if you select nothing.
View - Allows you to control the current system view, and switch or cycle between views.
Options - Allows you to control the appearance of the views, such as the icon size.
Windows - Allows you to invoke other windows, such as the main window.
You are prompted to save you custom view before you exit SysMan Station. You can then assign a name and an icon to the custom view. When you next invoke SysMan Station, your custom view is added to the Views pane.
For information on installing the SysMan Station under Microsoft
Windows, refer to
Section 1.10.
1.9 Compaq Insight Manager
Compaq Insight Manager is a Web-based management utility, independent of operating environments. At present, some features are fully implemented in some operating environments, but are not yet implemented in others. This means that you can use all features on Windows NT systems, but you cannot use certain features on UNIX.
In its present implementation, Compaq Insight Manager provides a consistent wrapper for SysMan and other UNIX-based utilities, enabling you to manage supported systems from a Web browser. On a PC or server running Windows NT, you can view details of devices and invoke administrative tasks. On a UNIX system, you can use Compaq Insight Manager to view details of devices, but you must invoke the UNIX SysMan Menu or SysMan Station to perform administrative tasks.
At present, the WBEM protocols (agents) are able to communicate between the following operating environments in addition to UNIX:
Compaq OpenVMS
IBM OS/2
Microsoft Windows 2000, Microsoft Windows NT, Microsoft Windows 98, and Microsoft Windows 95
Novell NetWare
SCO OpenServer Release 5 and SCO UnixWare 7
Microsoft Windows on PC platforms is the only method considered in this guide, to give you an idea of the restrictions as they apply in an environment where UNIX systems serve PC clients. In future, all administrative tasks will be fully integrated and provide seamless Web-based enterprise management (WBEM) regardless of hardware platform or operating environment.
The main server component of Compaq Insight Manager is Compaq Insight Manager XE, which provides full administrative services for Windows NT. The XE server communicates with any device in the local area network or domain that is running the agent. In the context of WBEM, a device is any entity connected to the network, such as a computer system with all its peripheral devices, a networked printer, or a router. Any network entity that has an address and can run the agents can communicate with the XE server, although some devices might require additional hardware.
A device must have an operating environment that is recognized by Compaq Insight Manager so that you can manage it using WBEM. Such an operating environment must be able to communicate device information to the WBEM network, and to receive and execute instructions sent from other (authorized) devices in the WBEM network. The operating environments must be able to run the agents that communicate with each other using a standard protocol.
Devices, and their operating environments, provide information about hardware and software status using a data model, such as the Common Information Model (CIM), or a Management Information Base (MIB) and Simple Network Management Protocol (SNMP). You can think of these as a database of objects, with attributes and values, representing the manageable components of a device. There are industry standard MIBs and proprietary MIBs. Compaq Insight Manager uses its standard protocol to poll a device for such data, and present it to the user in a consistent format, no matter how different the database. It is this standard protocol that puts a consistent wrapper around the device data that you can obtain (or manipulate).
In an environment consisting of client PCs and UNIX or Windows NT servers, you can use Compaq Insight Manager as your common interface to administrative tasks. For example, as an authorized (root) user working at your PC, you can invoke Compaq Insight Manager to view the general system status of an AlphaServer running UNIX, then invoke the SysMan Station to check the specific status of a peripheral, such as the status of file systems on a disk. You can also launch a SysMan Menu task to perform operations on that file system.
From the same browser page, you can respond to a status warning from a Windows NT server and (if the XE agent is running at your site) perform troubleshooting operations. For example, in a heterogeneous computing environment, devices might run different operating systems with different disk and file management systems, such as AdvFS on UNIX and the FAT or NTFS file system on Windows NT. You might need to know how much space is available on disks, so that you can extend file systems before they run out of storage space. Compaq Insight Manager enables you to monitor such data at a single point, and (in some cases) you can use it to initiate corrective actions.
You use Compaq Insight Manager by connecting your Web browser to a port on any system
in the local area network that is running the agents.
For example, if your
UNIX system has the host name and address of
trout.cu.da.com
,
enter the following URL in the Location (or address) field of the browser:
http://trout.cu.da.com:2301
You can also specify the TCP/IP
address, such as
20.111.333.10
in place of the host name
and address.
Once you connect to a system, you can view the local system,
status, or select other hosts on the local network.
You can also connect to
another host by selecting its address from the list of local devices.
Two devices have special status on a WBEM network:
The Windows NT server that is running the
XE agent.
This system must be configured with the Compaq Insight Manager XE software to enable
many of the remote administrative services on other Windows NT systems.
The
XE server has a port address of
:280
, to which you connect
from your browser by specifying the URL as follows:
HTTP://chubb.cu.da.com:280
An XE server is not necessary for peer-to-peer administration of UNIX systems. You can view system status and perform administrative tasks on UNIX systems using the SysMan Menu and the SysMan Station.
The master device, which polls all other available devices for their status and data, stores it in a master record, and makes the master record available to any other device. This device always has the lowest local TCP/IP network address (in the format 110.222.333.110). It is important that you assign this number to a system that is capable of handling the WBEM traffic. If the device with the lowest TCP/IP address becomes unavailable for any reason, the device with the next lowest TCP/IP address becomes the master. All other devices are slaves.
Compaq Insight Manager has an auto-discovery feature that allows an agent to discover any other agent in the local network domain. You can configure a system so that it does not participate as a master or participate in auto-discovery.
A summary of the requirements for UNIX systems in a WBEM environment is as follows:
The Compaq Insight Manager agent must be installed and configured on the UNIX system. From the UNIX system, you must use the Netscape browser.
Note
Launching the SysMan Menu or the SysMan Station from the Compaq Insight Manager Web page is currently not supported. You must launch the SysMan Menu and the SysMan Station as described in Section 1.6 and Section 1.8.
A local network of systems is optional. You can run Compaq Insight Manager on a single UNIX system, and connect via the Internet from your home PC to perform administrative tasks. The agent does not have to be installed on your connecting PC.
A Windows NT server running the XE agent is optional and only required if you plan to remotely manage PC clients that are running Windows NT, or other systems that support an agent.
Client systems, such as PCs running Windows NT, must have
the agent installed if you want to remotely manage such systems.
Connect to
http://www.compaq.com/products/servers/management/
to download agents
for supported systems.
You can also reach this URL from the default home page
on your UNIX system.
PCs must be running the Internet Explorer Web browser. Netscape does not work.
A designated master system must have the lowest TCP/IP address in the local network domain.
For information on configuring and using the WBEM agents, see
insight_manager
(5)
the online documentation that is accessible from the Compaq Insight Manager
home page.
1.10 Using SysMan on a Personal Computer
In addition to using java applets as described
in
insight_manager
(5), you can also install SysMan clients on a PC and launch
them from the Windows Start Menu.
This feature supports Microsoft Windows,
MacOS, and Linux.
Full information on this feature, together an address from
which you can download the required software, is provided in a Web page available
from the UNIX system.
This page is located at
http://<host>:2301/sysman/index.html
, where
<host>
is the host name and address
or the TCP/IP address.
The procedure is as follows:
On the UNIX system, use the Netscape Web browser to launch
the
.../sysman/index.html
page.
A link to this page is
provided on the default UNIX home page, under the heading System Management.
Scroll down to the section titled
"Managing UNIX from a PC".
Check the requirements and restrictions, noting any requirements for your client system, and download the requisite software. For example, you must be using the Internet Explorer Web browser on the client system.
If it is not already installed on your client system, select the Web page options to download the software kits for the Java run-time environment and the SysMan Station client.
You are prompted to either save the kits to a location on your client system, or run them directly. The latter option begins installation and configuration of the software, using the typical Windows installation process. For example, you are prompted for a location for the installed software.
When the installation process is complete, click on the Start button and select Programs. The SysMan Station and SysMan Menu are listed as Java applications on the Programs menu. Select either icon to launch the required application.
When you launch either application, a dialog box is displayed, giving you the following connect options:
Host name - Enter the name and address or TCP/IP number for the host that you want to work on. The local host is displayed by default.
Login as... - Select whether you want to log in as yourself, or as a new user. For example, if you are logged in to your client system as yourself, you might need to connect as new user root in order to perform privileged tasks on the host.
Set X/Motif display - Check this box and specify a display address if you want to redirect the output display.
When you press OK, the application window opens (the time to start up depends on the current network speed and traffic). You can then use the SysMan Station or SysMan Menu as described in preceding sections.
1.11 Setting Up a Serial Line Console
You can manage remote systems through a modem connection.
A serial
line console enables you to connect a local terminal to the remote system
console through modems attached to your local system and to the communications
port
COMM1
of the remote system.
The local system is any
terminal or terminal emulation device that enables a modem connection such
as a dumb terminal, an X terminal window, or a personal computer (PC).
To
perform administrative tasks, you must be able to log in as root (or an account
with administration privileges).
This connection is referred to as the console port. The terminal connection supports a limited set of communication rates up to 57,600, depending on the console firmware supported by your processor. Currently, this feature is only available on systems that support modems as console devices, such as the AlphaServer 1000A. Consult your system hardware documentation to find out if your system has such capabilities.
The console port enables you to do the following:
Connect to a remote system using a utility such as
tip
,
telnet
, or a PC terminal emulation utility
Remotely boot or shut down a system and observe all the boot messages
Start the kernel debugger and observe debugging messages
Perform any system administration tasks using commands and utilities
Running the
Environment Configuration Utility (ECU) on the remote system causes the modem
to disconnect.
For this reason, you should use the ECU to complete any environment
configuration before setting up and using a modem as a console device.
1.11.1 Setting Up a Console Port
The following sections provide an overview of the steps required
to set up a serial line console port and set up the remote modem for dial-in.
It is assumed that your local (dial-out) modem is already installed and configured
for use.
1.11.1.1 Connecting the Modem to COMM1
The
CONSOLE
environment variable on the remote
system should be set to
serial
.
Refer the hardware documents supplied with your modem for connecting
the modem to your system.
See
modem
(7)
to obtain the correct modem settings
and for instructions on how to create the appropriate system file entries.
In particular, the
cons
entry in
/etc/inittab
file should be modified so that the
getty
or
uugetty
process sets up the COMM port correctly.
This line is similar
to the following example:
cons:1234:respawn:/usr/sbin/getty console console vt100
This line should be changed as follows if you are using a modem set to run at a baud rate of 38,400 as a console device:
cons:1234:respawn:/usr/sbin/getty console M38400 vt100
1.11.1.2 Setting the Configurable DCD Timer Value
You can configure the Carrier Detect (DCD) timeout value. The default value for this timer is 2 seconds, which is in accordance with the DEC STD-052 standard and is acceptable for most modems. This timer is used to determine how long the driver must wait when the DCD signal drops, before declaring the line disconnected and dropping the DTR and RTS signals. Some modems expect DTR to drop in a shorter time interval, so refer to your modem documentation to verify the interval.
Modify the timer by using
the
sysconfig
command to set the timer to 0 (no timeout
period), 1, or 2 seconds.
To set the timer via the
/etc/sysconfigtab
file, edit the file and include the following:
ace: dcd_timer=n
Where
the value of
n
is
0
,
1
, or
2
.
The syntax for modifying the timer via the
sysconfig
command is as follows:
# sysconfig -r ace dcd_timer=n
Where n = 0, 1, or 2
Note that by modifying the value with the
sysconfig
command, the setting is lost when the system is rebooted.
To preserve the
setting across reboots, edit the
/etc/sysconfigtab
file.
1.11.1.3 Setting the Console Environment Variables
The
COM1_MODEM
,
COM1_FLOW
,
and
COM1_BAUD
console environment variable settings must
be equivalent to the
getty
or
uugetty
settings used when you created your system file entries for the modem.
Consult your hardware documentation for information on how to set the console environment variables. Typically, the variables are set when the system is shut down and in console mode, as shown in the following example:
>>> set COM1_MODEM ON >>> set COM1_FLOW SOFTWARE >>> set COM1_BAUD 9600
Valid settings are as follows:
COM1_MODEM
: ON or OFF
COM1_FLOW
: NONE, HARDWARE, SOFTWARE, BOTH
COM1_BAUD
: Consult your system hardware
documentation.
If you change the baud rate, flow control, or modem setting (for example,
using the
getty
command), the change is propagated down
to the console level and the environment variables change automatically.
1.11.1.4 Verifying the Modem Setup
Dial the remote system and obtain a login prompt or console prompt,
if the system is not booted.
Log out or disconnect and ensure that the line
hangs up correctly.
Dial in again to ensure that you can reconnect.
1.11.2 Initiating a Console Port Connection
Using a terminal or X-terminal window, you can initiate a connection
between the local and remote systems by using a command such as a
tip
,
kermit
, or
cu
.
Alternatively,
you can use a PC-based terminal emulator.
For example, use the
tip
command as follows:
# tip [telephone number] # tip cons
Where
telephone_number
is the telephone number of the remote system, including
any prefixes for outside lines and long-distance codes.
The second line is
an example of an entry in the
/etc/remote
file, which you
can use to specify details of remote systems and tip settings.
Once you have initiated the dial-out command, and the two modems have
established a connection, the word
connect
is displayed
on your local terminal window.
Press the Return key and the console prompt
(>>>
) or the
login:
prompt is displayed.
See
tip
(1)
for more information.
1.11.2.1 Using the Console Port
Once you have access to the system and are logged in to a privileged account, you can perform any of the administration tasks described in this volume that do not require access to a graphical user interface, such as using commands and running utilities. The following features might be useful for remote administration:
The UNIX-to-UNIX system copy utility,
uucp
for copying scripts and files to the remote system.
See
uucp
(1).
You can invoke the
ikdebug
kernel
debugger and use it remotely.
See
ikdebug
(8).
You might need to change an entry
in the
/etc/remote
file to correct the baud rate.
For example
you might need to change the baud rate from 9600 baud in the following lines:
# access line for kernel debugger kdebug:dv=/dev/tty00:br#9600:pa=none:
See the Kernel Debugging manual for additional information.
1.11.2.1.1 Turning Off Console Log Messages
The
syslogd
daemon now has an internal
switch to disable and enable messages to the console.
This feature is invoked
by the
-s
flag on the
syslogd
command
line, or by running the following command:
# /usr/sbin/syslog
See
syslog
(1).
1.11.2.1.2 Shutting Down the Remote System
When you shut down the remote system, the modem connection is dropped. To avoid this, use the following command before you shut down the system:
# stty -hupcl
See
stty
(1).
When the shutdown is complete, you have access to the console prompt.
1.11.2.1.3 Ending a Remote Session
To end a remote session from the
operating system shell prompt, type
[Ctrl/d]
to log out and
terminate the remote session.
Otherwise, type
[+++]
to put
the modem into local command level, and type
[ATH]
followed
by the Return key to hang up the connection.
1.11.2.2 Troubleshooting the Modem Connection
If you have problems setting up your systems and connecting, check the set up as follows:
The local modem does not dial out.
Check the cables and connections and ensure that the telephone lines are plugged into the correct sockets, and that you have a dial tone.
The remote modem fails to answer.
Ensure that the remote modem is set to auto-answer,
ATS0=n
, where
n
is the number of rings before the modem
answers.
See
modem
(7)
and verify the settings for dial-in access.
The remote modem answers and then disconnects.
This is most likely to be due to incorrect settings for dial-in access.
See
modem
(7)
and verify the settings for dial-in access.
The remote modem answers but only random characters are printed.
This problem is usually caused by a mismatch between the baud rate of
the COMM port and that of the modem.
See
modem
(7)
and verify the settings
for dial-in access.
The connection is dropped when the remote system is shut down
via the
shutdown
command.
The
stty
attribute
hupcl
is at
the default setting.
To prevent the line from disconnecting during a shut
down, use the following command:
# stty -hupcl