sysadm(1M) sysadm(1M)
NAME
sysadm - visual interface to perform system administration
SYNOPSIS
sysadm [ menu name | task name ]
DESCRIPTION
This command, when invoked without an argument, presents a set of
menus that help you do administrative work. If you specify a menu or
task on the command line, one of two things happens: if the
requested menu or task is unique, it is immediately displayed; if the
menu or task is not unique, a menu of choices is displayed.
The sysadm command may be given a password. To assign a password,
use the password task under the systemsetup menu. To change a
password after it is assigned, use the password command.
The following twelve menus, which appear on the main sysadm menu, are
available on a computer running UNIX System V Release 4.0:
Backup Scheduling, Setup and Control
Diagnosing System Errors
File System Creation, Checking and Mounting
Machine Configuration, Display and Powerdown
Network Services Administration
Port Access Services and Monitors
Printer Configuration and Services
Restore From Backup Data
Software Installation and Removal
Storage Device Operations and Definitions
System Name, Date/Time and Initial Password Setup
User Login and Group Administration
If you add software packages other than those delivered with UNIX
System V Release 4.0 to your system, you will also see a menu entry
called Administration for Available Applications on which those
packages are listed.
Also, software packages that have not been updated to reflect UNIX
System V Release 4.0 may require functionality provided with the
pre-Release 4 sysadm menus that is not available with the Release 4
menus. To make this functionality available, the pre-Release 4
versions of the sysadm menus are installed along with any software
packages that require their use. If you have such packages
installed, the entry Pre-SVR4.0 System Administration will appear on
your main menu.
The rest of this section describes each menu listed on the main menu.
7/91 Page 1
sysadm(1M) sysadm(1M)
⊕ Backup Service Management
This menu lists seven areas of administrative support for the
backup services.
⊕⊕ backup (Start Backup Jobs)
This task starts the backup scheduled for the current day based
on the default backup control table or the specified backup
control table.
⊕⊕ history (Backup History Management)
This task lets you display reports of backup operations that
have completed successfully.
⊕⊕ reminder (Schedule Backup Reminder)
This menu lets you schedule messages that will be sent to you
to remind you to perform backups.
⊕⊕ respond (Respond to Backup Job Prompts)
This task lets you reply to operator prompts from backup jobs.
⊕⊕ schedule (Schedule Automatic Backups)
This menu lets you schedule backups so that they will run
automatically. Because the backups are scheduled to run
automatically and are not associated with a terminal, you must
choose to run them in either automatic or background mode.
⊕⊕ setup (Backup Control Table Management)
This menu lets you modify or display backup registers.
⊕⊕ status (Backup Status Management)
This menu lets you manage backup requests that are in progress.
⊕ Diagnosing System Errors
This menu provides two tasks, diskreport and diskrepair, which
allow you to look for and sometimes repair problems in the
system.
⊕⊕ diskrepair (Advises on Disk Error Repairs)
This task advises you on how to repair errors that occur on a
hard disk.
WARNING: Because this is a repair function, it should be
performed only by qualified service personnel.
NOTE: Disk errors often cause files to be lost and/or data to
be damaged. Be sure to restore a repaired disk from backup
copies.
⊕⊕ diskreport (Reports Disk Errors)
This task shows you if the system has collected any information
indicating that there have been errors while reading the hard
disk. You can request either summary or full reports. A
Page 2 7/91
sysadm(1M) sysadm(1M)
summary report provides sufficient information about disk
errors to determine if a repair should be attempted. If the
message no errors logged is part of the report, then there is
probably no damage. If a number of errors are reported, there
is damage and you should call for service. The full report
gives additional details for qualified service personnel who
are trouble shooting complicated problems.
⊕ Manage File Systems
This menu provides eleven tasks that are part of file system
management. These tasks include checking for and repairing
errors on a specific file system, monitoring disk usage for all
file systems, tracking files based on age or size, listing all
file systems currently mounted on your system, creating a new
file system, and mounting and unmounting file systems.
⊕⊕ check (Check a File System)
This task lets you check a file system for errors and fix them,
either interactively or automatically.
⊕⊕ defaults (Manage Defaults)
This task identifies the percentage of hard disks currently
occupied by files.
⊕⊕ diskuse (Display Disk Usage)
This task identifies the percentage of hard disks currently
occupied by files. The information is presented as a list,
organized by file system name.
⊕⊕ display (Display Installed Types)
This task displays a list of the file system types installed on
your system.
⊕⊕ fileage (List Files by Age)
This task lets you print the names of old files in the
directory you specify. If you do not specify an age, files
older than 90 days are listed.
⊕⊕ filesize (List Files by Size)
This task lets you print the names of the largest files in a
specific directory. If you do not request a particular number
of files, the ten largest files are listed.
⊕⊕ identify (Identify File System Type)
This task tries to determine the type of any unmounted file
system without damaging the data or the medium of the file
system.
7/91 Page 3
sysadm(1M) sysadm(1M)
⊕⊕ list (List Mounted File Systems)
This task lets you list all file systems mounted on your
computer.
⊕⊕ make (Create a File System)
This task lets you create a new file system on a removable
medium which can then store data you do not want to keep on
hard disk. When mounted, the file system has all the
properties of a file kept on hard disk.
⊕⊕ mount (Mount a File System)
This task lets you mount a file system located on a removable
medium and make it available to users on your system. The file
system may be unmounted using the unmount task.
WARNING: The medium must not be removed while the file system
is still mounted.
⊕⊕ unmount (Unmount a File System)
This task lets you unmount a file system and thus lets you
remove the medium on which it resides. Both / and /usr are
excluded because unmounting these file systems would cause a
system crash. Once a file system has been unmounted, you may
remove the medium on which it resided.
⊕ Machine Configuration Display and Powerdown
This menu provides seven tasks for functions such as turning
off the computer, rebooting it, and changing to firmware mode.
⊕⊕ boot defaults (Assigns Boot Device Program)
This task lets you specify the default manual program to boot
from firmware and/or the device to be used when automatically
rebooting.
⊕⊕ configuration (System Configuration Display)
This task allows you to check the current configuration of the
system.
⊕⊕ firmware (Stop All Running Programs and Enter Firmware Mode)
This task lets you stop all running programs, close any open
files, write out information to the disk (such as directory
information), and then cause the machine to enter the firmware
mode. (Machine diagnostics and other special functions that
are not available on the UNIX system are available in firmware
mode.)
⊕⊕ powerdown (Stops All Running Programs and Turns Off Machine)
This task lets you stop all running programs, close any open
files, write out information (such as directory information) to
disk, and then turn off the power in the machine.
Page 4 7/91
sysadm(1M) sysadm(1M)
⊕⊕ reboot (Stops All Running Programs and Reboots Machine)
This task lets you reboot the computer after all running
programs have been stopped, any open files have been closed,
and any necessary information (such as directory information)
has been written out to disk, This procedure can be used to
resolve some types of system trouble, such as a process that
cannot be killed.
⊕⊕ whos on (Displays List of Users Logged onto Machine)
This task prints the login ID, terminal device number, and
sign-on time of all users who are currently using the computer.
⊕ Network Services Management
This menu provides four functions for managing networks.
⊕⊕ basicnetworking (Basic Networking Utilities Management)
This menu allows you to set up administrative files for UUCP
utilities.
⊕⊕ remotefiles (Distributed File System Management)
This menu allows you to set up administrative files for the
Remote File Sharing (RFS) Utilities or the Network File Sharing
(NFS) Utilities.
⊕⊕ selection (Network Selection Management)
This menu allows you to set up administrative files for Network
Selection; that is, for dynamically selecting a transport
protocol.
⊕⊕ nametoaddress (Machine and Service Address Management)
This menu allows you to define machine addresses and service
port information for the protocols that exist on the machine.
⊕ Service Access Management
This menu provides functions for managing service access to the
system.
⊕⊕ portmonitors (Port Monitor Management)
This menu provides functions for managing port monitors under
the Service Access Facility. Specifically, it allows you to
add, disable, enable, list, modify, remove, start, and stop
port monitors.
⊕⊕ portservices (Port Service Management)
This menu provides functions for managing port services
provides by port monitors. Specifically, it allows you to add,
disable, enable, list, modify, and remove port services.
7/91 Page 5
sysadm(1M) sysadm(1M)
⊕⊕ ttysettings (Terminal Line Setting Management)
This menu provides functions for managing tty line settings.
Specifically, it allows you to create new tty settings and hunt
sequences, and to display (on your screen) and remove those
settings. To modify an existing tty line setting, remove the
entry for it and then recreate it, including the modifications.
⊕ Line Printer Services Configuration and Operation
This menu provides functions for managing the printers and
print services you can make available to your users through the
LP print service. Specifically, this menu can help you do the
following: set up and control the LP print service; start and
stop the print service, check the status of the print service
and, if necessary, stop and start it; add new printers to your
system, and change the configuration of existing printers; add,
change, and mount forms, add, change, and change filters, and
monitor users' print requests.
⊕⊕ classes (Manage Classes of Related Printers)
This menu allows you to add new classes and to display a list
of the current classes.
⊕⊕ filters (Manage Filters for Special Processing)
This menu allows you to manage filters for special processing.
⊕⊕ forms (Manage Pre-Printed Forms)
This menu allows you to manage pre-printed forms.
⊕⊕ operations (Perform Daily Printer Service Operations)
This menu allows you to perform daily printer operations such
as enabling printers, starting the print service, and mounting
forms.
⊕⊕ printers (Configure Printers for the Printer Service)
This menu allows you to configure printers for the LP print
service.
⊕⊕ priorities (Assign Print Queue Priorities to Users)
This menu allows you to assign priority in the queue for print
requests.
⊕⊕ requests (Manage Active Print Requests)
This menu allows you to hold and release pending print
requests, to move print requests to new destinations, and to
cancel print requests.
⊕⊕ status (Display Status of Printer Service)
This menu allows you to display the current status of the LP
print service.
Page 6 7/91
sysadm(1M) sysadm(1M)
⊕⊕ systems (Configure Connections to Remote Systems)
This menu allows you to configure the connections between your
LP print service system and any other LP print service.
⊕ Restore Service Management
This menu provides tasks for restoring directories, files, file
systems, and data partitions from archive volumes.
⊕⊕ operator (Set/Display the Restore Operator)
This task lets you set up and display the restore operator.
⊕⊕ respond (Respond to Restore Job Prompts)
This task lets you respond to restore job prompts.
⊕⊕ restore (Restore from Backup Archives)
This task lets you request the restoration of files,
directories, file systems, and data partitions from an archived
version.
⊕⊕ status (Modify/Report Pending Restore Request Status)
This menu lets you display and change the status of pending
restore requests.
⊕ Software Installation and Information Management
The tasks in this menu provide functions for software package
installation, removal, and management of information pertaining
to software packages. They include the ability to install and
remove packages, and to check the accuracy of package
installation. In addition, they include the ability to set
installation defaults, store interactions with a particular
package, store a package without actually installing it, and to
list all installed packages.
⊕⊕ check (Checks Accuracy of Installation)
This task lets you check installed software packages for
consistency, correct for inconsistencies, check for hidden
files, and check the contents of files which are likely to have
changed.
⊕⊕ defaults (Sets Installation Defaults)
This task allows you to decide, ahead of time, the way that the
system should respond to an installation problem.
⊕⊕ install (Installs Software Packages)
This task lets you install software packages onto a spool, a
hard disk, or a floppy diskette, and select the method that the
system will use to respond to installation problems.
7/91 Page 7
sysadm(1M) sysadm(1M)
⊕⊕ interact (Stores Interactions with Package)
This task allows you to interact with the software installation
process.
⊕⊕ list (Displays Information about Packages)
This task shows you the software packages that are installed on
your system and tells you the name, location, and category of
each.
⊕⊕ readin (Stores Packages Without Installing)
This task lets you read in software packages without installing
them.
⊕⊕ remove (Removes Packages)
This task lets you remove installed software packages.
⊕ Storage Device Operations and Definitions
This menu contains tasks for getting descriptions of device
aliases and attributes and for assigning device groups.
⊕⊕ descriptions (Device Alias and Attribute Management)
This menu contains tasks for listing, adding, removing, and
modifying device descriptions and attributes. This menu also
provides access to device reservation services.
⊕⊕ groups (Device Group Management)
This menu provides access to tasks that let you list and
administer device groups and their membership lists.
⊕ System Name, Date Time and Initial Password Setup
This menu lets you set up your machine. The tasks in this menu
include setting the system date and time, setting the node name
of your system, doing initial system setup, and assigning
passwords to administrative logins on the system.
⊕⊕ datetime (System Date and Time Information)
This task lets you tell the computer the date, time, time zone,
and whether you observe Daylight Savings Time (DST). It is
normally run once when the machine is first set up. If you
observe DST, the computer automatically starts to observe it in
the spring and returns to standard time in the fall. The
machine must be turned off and turned back on again to
guarantee that ALL times are reported correctly. Most times
are correct the next time a user logs in.
⊕⊕ nodename (System Name and Network Node Name of the Machine)
This task lets you change the node name and system name of this
machine. These names are used by various communications
networks to identify this machine.
Page 8 7/91
sysadm(1M) sysadm(1M)
⊕⊕ password (Assigns Administrative Login Passwords)
This task lets you assign passwords to administrative logins.
⊕⊕ setup (Sets up System Information for First Time)
This task lets you define the first login, set the initial
passwords on administration logins, and set the time zone for
your location.
⊕ User Login and Group Administration
This menu lets you manage the user IDs and groups on your
machine. Tasks include the ability to add, modify, and delete
users or groups defined on your machine. You can place users
in groups so that they can share access to files belonging to
members of the group but protect these files from access by
members of other groups. In addition, you can set defaults
that are used for subsequent user definitions on your machine,
and you can define or redefine user password information.
⊕⊕ add (Adds Users or Groups)
This task lets you define either a new user or a new group on
your system.
⊕⊕ defaults (Defines Defaults for Adding Users)
This task lets you change some of the default values used when
the add user task creates a new login. Changing the default
values does not affect any existing logins; it affects only
those added subsequently.
⊕⊕ list (Lists Users or Groups)
This task lets you examine the attributes of the users and
groups on your system.
⊕⊕ modify (Modifies Attributes of Users or Groups)
This task lets you modify either a user definition or a group
definition on your system.
⊕⊕ password ((Re-)defines User Password Information)
This task lets you define or change a user's password.
⊕⊕ remove (Removes Users or Groups)
This task lets you remove a user from your system.
ALTERNATE KEYSTROKES
For terminals that do not support function keys, the Form and Menu
Language Interpreter provides alternate keystrokes to perform these
functions, as described in the following table. These keystrokes
perform different functions depending upon whether you are working
within a text, a form, or a menu. For more detailed descriptions of
these functions, refer to Chapter 1, ``Introduction to FMLI,'' and
Appendix B, ``Named Keys and Alternate Keystrokes,'' of the
7/91 Page 9
sysadm(1M) sysadm(1M)
Programmer's Guide: Character User Interface.
______________________________________________________________________
| FMLI Alternate Keystrokes |
|_____________|__________________|_____________________|______________|
|_____________|__________________|_____________________|______________|
| Name | Keystroke | Name | Keystroke |
|_____________|__________________|_____________________|______________|
|_____________|__________________|_____________________|______________|
| BACKSPACE | CTRL-h | LEFT-ARROW | CTRL-i |
|_____________|__________________|_____________________|______________|
| BACKTAB | CTRL-t | MARK | CTRL-f m |
|_____________|__________________|_____________________|______________|
| BEG | CTRL-b | NEXT | CTRL-n |
|_____________|__________________|_____________________|______________|
| CLEAR | CTRL-y | PAGE-DOWN | CTRL-w |
|_____________|__________________|_____________________|______________|
| CLEAR-LINE | CTRL-y | PAGE-UP | CTRL-v |
|_____________|__________________|_____________________|______________|
| CLEAR-EOL | CTRL-f y | PREV | CTRL-p |
|_____________|__________________|_____________________|______________|
| COMMAND LINE| CTRL-j, CTRL-f c| RESET | CTRL-f r |
|_____________|__________________|_____________________|______________|
| DEL | CTRL-x | RETURN | CTRL-m |
|_____________|__________________|_____________________|______________|
| DELETE-CHAR | CTRL-x | RIGHT-ARROW | CTRL-r |
|_____________|__________________|_____________________|______________|
| DELETE-LINE | CTRL-k | SCREEN-LABELED KEYS| CTRL-f [1-8]|
|_____________|__________________|_____________________|______________|
| DOWN-ARROW | CTRL-d | SCROLL-DOWN | CTRL-f d |
|_____________|__________________|_____________________|______________|
| END | CTRL-e | SCROLL-UP | CTRL-f u |
|_____________|__________________|_____________________|______________|
| HOME | CTRL-f b | SPACEBAR | none |
|_____________|__________________|_____________________|______________|
| HOME-DOWN | CTRL-f e | TAB | CTRL-i |
|_____________|__________________|_____________________|______________|
| INSERT-CHAR | CTRL-a | UP-ARROW | CTRL-u |
|_____________|__________________|_____________________|______________|
| INSERT-LINE | CTRL-o | | |
|_____________|__________________|_____________________|______________|
DIAGNOSTICS
The sysadm command exits with one of the following values:
0 Normal exit.
2 Invalid command syntax. Usage message of the sysadm command is
displayed.
4 The menu or task name given as an argument does not exist.
5 The menu name given as an argument is an empty placeholder
menu, and therefore not available for use.
Page 10 7/91
sysadm(1M) sysadm(1M)
7 The sysadm command is not available because it cannot invoke
fmli. (The FMLI package may be corrupt or it may not have been
installed.)
BUGS
The sysadm function assumes the terminal being used has function keys
that generate code like those of an AT&T 3B2.
EXAMPLES
sysadm nodename
NOTES
Add-on system packages that have not been updated to System V Release
4.0 may still need functionality that existed with versions prior to
System V Release 4.0 sysadm but is not available with System V
Release 4.0 sysadm. If so, when the package is added, those old
sysadm tasks are added under a menu titled oldsysadm. The
oldsysadm menu appears on the main menu.
SEE ALSO
backup(1M), bkexcept(1M), bkhistory(1M), bkoper(1M), bkreg(1M),
bkstatus(1M), checkfsys(1M), delsysadm(1M), edsysadm(1M),
groupadd(1M), groupdel(1M), groupmod(1M), makefsys(1M),
mountfsys(1M), password(1M), powerdown(1M), restore(1M),
rsnotify(1M), rsoper(1M), rsstatus(1M), setup(1M), urestore(1M),
ursstatus(1M), useradd(1M), userdel(1M), usermod(1M).
7/91 Page 11