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 following 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 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 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.

•• 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.)

•• 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.

•• 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 networks.

•• 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 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 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.

•• 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.

•• 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.

•• 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 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.

•• 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.

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 System V Release 4 may still need functionality that existed with the pre-System V Release 4 sysadm but is not available with System V Release 4 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).