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 passwd command. 

The following menus, which appear on the main sysadm menu, are available on the current release of this product. 

If you install FACE or X11 software packages, the applications option will appear as part of the main sysadm menu.  If neither package is present, the applications option will not appear. 

The rest of this section describes each menu listed on the main menu. 

Help on Sysadm Interface Settings and Keys Usage
This menu provides six areas of support for the sysadm interface itself.

Current Setup (Settings for correct interface operation)
This text menu provides the user with the matching terminal emulator mode for the preset environment variable $TERM for correct interface operation.

Keys Usage (Keys Usage for Current Setup)
This text menu lists the function keys mapped to the labels highlighted from left to right at the bottom of the screen.

Interface table (Recommended interface settings)
This text menu displays a table of various supported terminal emulator modes and matching environment variable $TERM settings for the user to select from to ensure correct interface operation.

Functions table (Summary of sysadm functions)
This text menu displays a table to summarize the functions that are highlighted from left to right at the bottom of the screen.

Commands table (Summary of Command Menu functions)
This text menu displays a table to summarize the functions that are available within the popup command menu.

Alternate Keys (Table of alternate keystrokes)
This text menu provides the user with the table of supported alternate keystrokes and the different functions they perform.

Backup Service Management
This menu lists four areas of administrative support for the backup services.

basic (Backup to Removable Media)
This menu contains subtasks to perform the following: display backup history of operations, make personal backups, schedule backups for automatic execution, and make system backups. NOTE: This menu item is not available unless the Xenix Compatibility Package (xcp) is installed.

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.

configuration (Display System Configuration)
This task lets you display the system information or summary information.

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.

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 turn off the power in the machine.

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 provided by port monitors. Specifically, it allows you to add, disable, enable, list, modify, and remove port services.

quick_terminal (Setup a quick terminal)
This menu enables you to quickly add or remove a terminal from a port.

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. It also allows you 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

basic (Restore from Removable Media)
This menu contains subtasks for restoring personal files, directories, system restores, and selective system restores. NOTE: This menu item is not available unless the Xenix Compatibility Package (xcp) is installed.

Schedule Automatic Task
This menu contains subtasks to add, change, delete, and display tasks bound for automatic execution.

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.

add This menu lets you add a storage device to the system.  This menu lets you copy volumes from one device to another.

devices
This menu lets you manage devices in the datebase.

display
This task will display information about devices.

groups
This menu lets you manage device groups in the Device management feature.

remove
This menu lets you remove a device from the system.

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.

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. 

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

EXAMPLE

sysadm nodename

INTERNATIONAL FUNCTIONS

Some messages output by sysadm use the word character(s), however, this actually means byte(s). 

SEE ALSO

checkfsys(1M), cpio(1), delsysadm(1M), edsysadm(1M), groupadd(1M), groupdel(1M), groupmod(1M), makefsys(1M), mountfsys(1M), password(1M), setup(1M), shutdown(1M), useradd(1M), userdel(1M), usermod(1M). 

NOTES

When sysadm is executed, a ’stty -tabs’ is invoked on the current terminal, to ensure proper tabs.  If the user had no tabs set prior to running sysadm, invoking ’stty tabs’ after leaving sysadm will return the terminal to its previous state.