sysadm(1M) UNIX System V(Essential Utilities) 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.
When you invoke sysadm on a computer running UNIX System V Release 4, the
main menu (a collection of twelve menus) appears as follows:
UNIX System V Administration
backupservice - Backup Scheduling, Setup, and Control
diagnostics - Diagnosing System Errors
filesystems - File System Creation, Checking and Mounting
machine - Machine Configuration, Display and Powerdown
networkservices - Network Services Administration
ports - Port Access Services and Monitors
printers - Printer Configuration and Services
restoreservice - Restore From Backup Data
software - Software Installation and Removal
storagedevices - Storage Device Operations and Definitions
systemsetup - System Name, Date/Time and Initial Password Setup
users - User Login and Group Administration
If you install software packages other than those delivered with UNIX
System V Release 4, you will also see a menu entry called Administration
for Available Applications (or applications) under which those packages
are found.
All menu items for pre-Release 4 optional add-on packages other than
those listed on the main menu under packagmgmt now appear under
oldsysadm on the main menu. (The entry oldsysadm will appear on the
main menu only if pre-Release 4 packages have been installed.)
The rest of this section describes each menu listed on the main menu.
⊕ Backup Service Management
This menu lists seven areas of administrative support for the
backup services.
10/89 Page 1
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
⊕⊕ 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.
⊕ 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.
Page 2 10/89
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
⊕⊕ 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.
⊕⊕ 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: (1) mount does not prevent you from mounting a file system
on a directory that's not empty. (2) Do not remove the medium
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.
⊕⊕ configuration (System Configuration Display)
This task allows you to check the current configuration of the
system.
10/89 Page 3
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
⊕⊕ shutdown (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 bring the system down.
⊕⊕ 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.
⊕ Peripheral Setup
This menu allows you to setup peripherals that were supported in
pre-SVR4.0
⊕ 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.
Page 4 10/89
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
⊕⊕ 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.
⊕⊕ quick-terminal
(Quick terminal Setup) This menu allows a user to easily setup a
terminal and its speed.
⊕⊕ 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
10/89 Page 5
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
requests.
⊕⊕ status (Display Status of Printer Service)
This menu allows you to display the current status of the LP print
service.
⊕⊕ 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.
⊕ Schedule Automatic Task
This menu permits users to modify the cron file. The cron file
allows users to request jobs to be run at specific times.
⊕⊕ add
Allows a user to add a cron job.
⊕⊕ change
Allows a user to change an existion cron job.
⊕⊕ delete
Allows a user to delete cron job.
⊕⊕ display
Allows a user to display cron jobs.
⊕ 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,
Page 6 10/89
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
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.
⊕⊕ 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.
10/89 Page 7
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
⊕⊕ 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.
⊕⊕ 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.
Page 8 10/89
sysadm(1M) UNIX System V(Essential Utilities) sysadm(1M)
⊕⊕ 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.
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.
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.)
EXAMPLES
sysadm nodename
NOTES
The Release 3 version of the sysadm command scrolled menus down the
terminal screen. The Release 4 version of sysadm, however, displays
menus in ``pop-up'' windows.
Pre-Release 4 add-on packages other than those listed under packagmgmt
are listed under oldsysadm.
SEE ALSO
checkfsys(1M), delsysadm(1M), edsysadm(1M), makefsys(1M), mountfsys(1M),
powerdown(1M), setup(1M), umountfsys(1M).
10/89 Page 9