sysadm(1M) SYSTEM ADMINISTRATION COMMANDS 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 system_setup menu. To change a password
after it is assigned, use the password command. The follow-
ing twelve menus, which appear on the main sysadm menu, are
available on a computer running UNIX System V Release 4:
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 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 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 ver-
sions 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 Administra-
tion will appear on your main menu. The rest of this sec-
tion describes each menu listed on the main menu.
⊕ 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
1
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
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 ter-
minal, 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 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
2
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
probably no damage. If a number of errors are
reported, there is damage and you should call for ser-
vice. 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, moni-
toring 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 par-
ticular 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.
3
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
⊕⊕ make (Create a File System)
This task lets you create a new file system on a remov-
able 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.)
⊕⊕ floppy key (Creates a Floppy Key Removable Diskette)
This task lets you create a software ``key'' to your
system on floppy diskette. This key enables you to
obtain access to the system even if you have forgotten
the firmware password, by allowing you to enter
firmware mode. Thus the ``floppy key'' is just that: a
key to your system. Be sure to protect it as such.
4
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
⊕⊕ 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.
⊕⊕ reboot (Stops All Running Programs and Reboots Machine)
This task lets you reboot the computer after all run-
ning 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 net-
works.
⊕⊕ basic_networking (Basic Networking Utilities Management)
This menu allows you to set up administrative files for
UUCP utilities.
⊕⊕ remote_files (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.
⊕⊕ name_to_address (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.
⊕⊕ port_monitors (Port Monitor Management)
This menu provides functions for managing port monitors
under the Service Access Facility. Specifically, it
5
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
allows you to add, disable, enable, list, modify,
remove, start, and stop port monitors.
⊕⊕ port_services (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.
⊕⊕ tty_settings (Terminal Line Setting Management)
This menu provides functions for managing tty line set-
tings. 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 exist-
ing 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 neces-
sary, stop and start it; add new printers to your sys-
tem, 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 pro-
cessing.
⊕⊕ 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 opera-
tions 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
6
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
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.
⊕⊕ 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 infor-
mation pertaining to software packages. They include
the ability to install and remove packages, and to
check the accuracy of package installation. In addi-
tion, 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
7
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
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 prob-
lem.
⊕⊕ 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 ins-
tallation problems.
⊕⊕ interact (Stores Interactions with Package)
This task allows you to interact with the software ins-
tallation process.
⊕⊕ list (Displays Information about Packages)
This task shows you the software packages that are
installed on your system and tells you the name, loca-
tion, and category of each.
⊕⊕ read_in (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 ser-
vices.
⊕⊕ 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,
8
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
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 com-
munications 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 ini-
tial 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 exist-
ing logins; it affects only those added subsequently.
9
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
⊕⊕ 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.
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 place-
holder 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
Add-on system packages that have not been updated to SVR4
may still need functionality that existed with the pre-SVR4
sysadm but is not available with SVR4 sysadm. If so, when
the package is added, those old sysadm tasks are added under
a menu titled old_sysadm. The old_sysadm 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).
10
sysadm(1M) SYSTEM ADMINISTRATION COMMANDS sysadm(1M)
11