sysadm(1M) sysadm(1M)
NAME
sysadm - visual interface for 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 passwd
command.
When you invoke sysadm on a computer running UNIX SVR4.2 MP
the main menu appears as follows:
UnixWare 2.0 Operations, Administration and Maintenance
applications - Administration for Available Applications
backup_service - Backup Scheduling, Setup, and Control
file_systems - File System Creation, Checking and Mounting
machine - Machine Configuration, Display and Shutdown
network_services - Network Services Administration
ports - Port Access Services and Monitors
restore_service - Restore From Backup Data
schedule_task - Schedule Automatic Task
software - Software Installation and Removal
storage_devices - Storage Device Operations and Definitions
system_setup - System Name, Date/Time and Initial Password Setup
users - User Login and Group Administration
If, when you type sysadm, the main menu does not appear, or if
you cannot access a particular task, one or more of the Menu.*
forms may have been corrupted, removed (accidentally), or not
installed properly. If this happens, you can rebuild all the
Menu.* forms that make up the administration menus by entering
the following command:
/usr/sadm/install/bin/ie_build
Copyright 1994 Novell, Inc. Page 1
sysadm(1M) sysadm(1M)
The following subsections describe the menus and tasks listed
on the main menu.
Backup Service Management
This menu lists the levels of administrative support available
for backup services.
basic (Basic Backup Service)
Use this menu to view backup history, or to make a
floppy disk or cartridge tape copy of the files on
your computer's hard disk.
Manage File Systems
This menu lists tasks that are part of file system management,
including: 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 checks a file system for errors and fixes
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 lists the file system types installed on
your system.
fileage (List Files by Age)
This task lists the names of old files in a specific
directory. If you do not specify an age, files older
than 90 days are listed.
filesize (List Files by Size)
This task prints 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
Copyright 1994 Novell, Inc. Page 2
sysadm(1M) sysadm(1M)
listed.
identify (Identify File System Type)
This task tries to determine the type for any
unmounted file system without damaging the data or
the medium of the file system.
list (List Mounted File Systems)
This task lists all file systems mounted on your
computer.
make (Create a File System)
This task creates a new file system on a removable
medium. This allows you to 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 mounts a file system located on a removable
medium and makes it available to users on your
system. To unmount the file system, use the unmount
task.
CAUTION: (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 unmounts a file system and then removes 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 Shutdown
This menu lists tasks for turning off the computer, rebooting
it, and changing to firmware mode.
configuration (System Configuration Display)
This task displays the current configuration of the
system.
Copyright 1994 Novell, Inc. Page 3
sysadm(1M) sysadm(1M)
shutdown (Stops All Running Programs and Halts Machine)
This task performs a system shutdown. It stops all
running programs, closes any open files, writes
information (such as directory information) to disk,
and then brings the system down.
reboot (Stops All Running Programs and Reboots Machine)
This task reboots 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 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 currently using
the computer.
Network Services Management
This menu lists tasks for managing networks.
remote_files (Distributed File System Management)
Use this task to set up administrative files for the
Network File Sharing (NFS) Utilities.
name_to_address (Machine and Service Address Management)
Use this task to define machine addresses and service
port information for the protocols that exist on the
machine.
Service Access Management
This menu lists tasks for managing service access to the
system.
port_monitors (Port Monitor Management)
This task manages port monitors under the Service
Access Facility. Use this task to add, disable,
enable, list, change, remove, start, and stop port
monitors.
port_services (Port Service Management)
This task manages port services provided by port
monitors. Use this task to add, disable, enable,
list, change, and remove port services.
Copyright 1994 Novell, Inc. Page 4
sysadm(1M) sysadm(1M)
quick_terminal (Quick Terminal Setup)
This task adds and removes a terminal to and from a
port.
tty_settings (Terminal Line Setting Management)
This task manages tty line settings. Use this task
to create new tty settings and hunt sequences, and to
display (on your screen) and remove those settings.
To change an existing tty line setting, remove the
entry and then recreate it, including the changes.
Peripherals Setup
This menu provides backwards compatibility for pre-SVR4 add-
ons that install user interface forms and menus.
Line Printer Services Configuration and Operation
This menu lists tasks for managing the printers and print
services you can make available to your users through the LP
print service.
classes (Manage Classes of Related Printers)
Use this task to add a new class, list printers in
classes, modify the membership of a class, or remove
classes.
filters (Manage Filters for Special Processing)
Use this task to add new filters, list filter
information, modify a filter, remove filters, or
restore filters to factory settings.
forms (Manage Pre-Printed Forms)
Use this task to add a new form, list form
attributes, modify a form, or remove forms.
operations (Perform Daily Printer Service Operations)
Use this task to accept print requests for classes or
printers, control (stop) the printer service, disable
a printer, enable a printer, set LP to always copy
print request files, mount a form or font, reject
print requests, set a default print destination, or
unmount a form or print wheel.
printers (Configure printers for the Printer Service)
Use this task to add a new printer, list printer
configurations, modify a printer configuration, or
remove printers.
Copyright 1994 Novell, Inc. Page 5
sysadm(1M) sysadm(1M)
priorities (Assign Print Queue Priorities to Users)
Use this task to set a system default priority, list
priority limits for users, remove priority limit from
user(s), set a system priority limit, or set user(s)
priority limit.
requests (Manage Active Print Requests)
Use this task to cancel, hold, move or release active
print requests.
status (Display Status of Printer Service)
This task displays the status of forms, printers,
print requests, print wheels and character sets.
Restore Service Management
This menu lists the available levels of administrative support
for restore services.
basic (Basic Restore Service)
This task restores files to your hard disk that were
backed up to removable media. It restores files that
were backed up from your HOME directory or system
files.
Schedule Automatic Task
This menu lists tasks to add, change, delete or display cron
entries.
Software Installation and Information Management
This menu lists tasks for software package installation,
removal, and management of information about software
packages. This includes installing and removing packages, and
verifying package installation. Also included are setting
installation defaults, storing interactions with a particular
package, storing a package without actually installing it, and
listing installed packages.
check (Checks Accuracy of Installation)
Use this task to check installed software packages
for consistency, correct inconsistencies, check for
hidden files, and check the contents of files that
are likely to have changed.
defaults (Sets Installation Defaults)
Use this task to decide, ahead of time, how the
system should respond to an installation problem.
Copyright 1994 Novell, Inc. Page 6
sysadm(1M) sysadm(1M)
install (Installs Software Packages)
This task installs software packages onto a spool, a
hard disk, or a floppy diskette, and selects the
method that the system will use to respond to
installation problems.
interact (Stores Interactions with Package)
Use this task to interact with the software
installation process.
list (Displays Information about Packages)
This task displays software packages that are
installed on your system and tells you the name,
location, and category of each.
read_in (Stores Packages Without Installing)
This task reads in software packages without
installing them.
remove (Removes Packages)
This task removes 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.
add (Add Storage Device)
This task adds a storage device.
copy (Makes Duplicate Copies of Storage Volumes)
This task copies a storage volume.
devices (Device Alias and Attribute Management)
Use this task to add, list, and remove device
descriptions. This task also provides access to
device attribute management and device reservation
services.
display (Displays Information About Storage Devices)
This task displays information about storage devices.
erase (Erases the Contents of Storage Volumes)
This task erases the contents of a storage volume.
Copyright 1994 Novell, Inc. Page 7
sysadm(1M) sysadm(1M)
format (Formats Removable Volumes)
This task formats a storage volume.
remove (Remove Storage Device)
This task removes a storage device.
System Name, Date Time and Initial
This menu sets 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 sets 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. Date and time are processed
according to the locale specified in the LC_TIME
environment variable [see LANG on environ(5)].
file_maintenance (Maintain Files in /etc/default)
Use this task to add, remove or change files in
/etc/default.
nodename (System Name and Network Node Name of the Machine)
This task changes the node name and system name of
this machine. These names are used by various
communications networks to identify the machine.
password (Assigns Administrative Login Passwords)
This task assigns passwords to administrative logins.
setup (Sets up System Information for First Time)
Use this task to define the first login, set the
initial passwords for administration logins, and set
the time zone for your location.
User Login and Group Administration
This menu manages the user IDs and groups on your machine.
Tasks include adding, changing, and deleting users or groups
defined on your machine. You can place users in groups with
Copyright 1994 Novell, Inc. Page 8
sysadm(1M) sysadm(1M)
shared 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 used for subsequent user
definitions on your machine, and you can define or redefine
user password information.
add (Add Users or Groups)
This task defines either a new user or a new group
for your system.
defaults (Define Defaults for Adding Users)
This task changes 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 later.
list (List Users or Groups)
This task lists the attributes of the users and
groups on your system.
modify (Modify Attributes of Users or Groups)
This task modifies either a user definition or a
group definition on your system.
password ((Re-)define User Password Information)
This task defines or changes a user's password.
remove (Remove Users or Groups)
This task removes a user from your system.
RETURN VALUES
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.
Copyright 1994 Novell, Inc. Page 9
sysadm(1M) sysadm(1M)
7 The sysadm command is not available because it
cannot invoke fmli. (FMLI may not have been
installed.)
REFERENCES
delsysadm(1M), edsysadm(1M), shutdown(1M)
Copyright 1994 Novell, Inc. Page 10