sysadm(8) CLIX sysadm(8)
NAME
sysadm - Runs a system administration menu interface
SYNOPSIS
sysadm [subcommand]
DESCRIPTION
The sysadm command gives the user access to menus for system setup,
configuration, and administration. With the subcommands listed in these
menus, the system administrator can, for example, powerdown and reboot the
system, set the system date and time, add/delete users and groups, and
backup/restore files.
The sysadm command, when invoked without an argument, presents a menu of
system administration subcommands, from which the user selects. If the
optional argument is presented, the named subcommand is run or the named
submenu is presented.
The sysadm command can be given a password. See admpasswd in the
Subcommands section.
Subcommands
The following menus of subcommands are available. (The number after each
item indicates the level of the menu or subcommand.)
filemgmt (1)
File Management Menu
The subcommands in this menu allow the user to protect files on the
fixed disk file systems by copying them to diskettes and later
restoring them to the fixed disk by copying them back. Subcommands
are also provided to determine the files to keep on diskette based
on age or size.
backup (2)
Backup files from integral fixed disk to disk or tape
The backup subcommand saves copies of files from the fixed disk
file systems. The menus provide several options for backup media,
including that of backing up a set of CLIX files to an archive file
on a VMSTM system or to a tape drive on another system. There are
two kinds of backups:
COMPLETE
Copies all files (useful in case of serious file system
damage)
2/94 - Intergraph Corporation 1
sysadm(8) CLIX sysadm(8)
INCREMENTAL
Copies files changed since the last backup
The normal usage is to do a complete backup of each file system and
then periodically do incremental backups. Two cycles are
recommended (one set of complete backups and several incrementals
to each cycle). Files backed up with backup are restored using
restore.
bupsched (2)
Backup Reminder Scheduling Menu
Backup scheduling is used to schedule backup reminder messages and
backup reminder checks. Backup reminder messages are sent to the
console to remind the administrator to backup particular file
systems when the machine is shutdown or a reminder check has been
run during the specified time period.
Backup reminder checks specify times that the system will check to
see if any backup reminder messages have been scheduled.
schedcheck (3)
Schedule backup reminder checks
Backup reminder checks are run at specific times to check to see if
any reminders are scheduled. The user specifies the times at which
the check is to be run. Checks are run for the reminder messages
scheduled by schedmsg.
schedmsg (3)
Schedule backup reminder message
Backup reminder messages are sent to the console if the machine is
shutdown or a reminder check has been scheduled. The user
specifies the times when it is appropriate to send a message and
the file systems to be included in the message.
diskuse (2)
Display how much of the fixed disk is being used
The diskuse subcommand lets the user know what percentage of the
fixed disk is currently occupied by files. The list is organized
by file system names.
fileage (2)
List files older than a particular date
The fileage subcommand displays the names of all files older than
the date specified by the user. If no date is entered, all files
older than 90 days are listed. If no directory is specified, the
/usr/admin directory is used.
2 Intergraph Corporation - 2/94
sysadm(8) CLIX sysadm(8)
filesize (2)
List the largest files in a particular directory
The filesize subcommand displays the names of the largest files
starting at a specific directory. If no directory is specified,
the /usr/admin directory is used. If the user does not specify how
many large files to list, 10 files are listed.
restore (2)
Restore files from backup and store media to disk
The restore subcommand restores back to the fixed disk those files
copied to disks and tapes by backup and store. Individual files,
directories of files, or the entire contents of a disk or tape can
be restored. The user can restore from both incremental and
complete media. The user can also list the names of files stored
on the disk or tape.
store (2)
Store files and directories of files on disk or tape
The store subcommand copies files from the fixed disk to disk or
tape and allows the user to optionally verify that they worked and
to optionally remove them when done. Typically, these would be
files that the user wants to archive or restrict access to. The
user can store single files and directories of files. Use the
restore command to put stored files back on the fixed disk and to
list the files stored.
machinemgmt (1)
Machine Management Menu
Machine management functions are tools used to operate the machine
(turn it off or reboot).
powerdown (2)
Prepare for shutting off the machine
The powerdown subcommand stops all running programs, closes any
open files, writes information to disk (such as directory
information), parks the heads of the disk drives, and displays the
message,
System halted
on the console. In this state, the machine can be powered down
without risk of damaging the file system.
reboot (2)
Stop all running programs, then reboot the machine
2/94 - Intergraph Corporation 3
sysadm(8) CLIX sysadm(8)
The reboot subcommand stops all running programs, closes any open
files, writes information to disk (such as directory information),
and reboots the machine. This can be used to escape some types of
system problems, such as when a process cannot be killed.
whoson (2)
Display list of users currently logged on the system
The whoson subcommand displays the login ID, terminal device
number, and sign-on time of all users who are currently using the
computer.
syssetup (1)
System Setup Menu
The system setup functions allow the user to tell the computer what
its environment looks like, including the date, time, and time
zone, the administration and system capabilities to be under
password control, and so forth. The first-time setup sequence is
also here.
admpasswd (2)
Assign or change administrative passwords
The admpasswd subcommand lets passwords for administrative commands
and logins, such as setup and sysadm, be set or changed.
datetime (2)
Set the date, time, time zone, and Daylight Savings Time (DST)
The datetime subcommand tells the computer the date, time, time
zone, and whether DST is observed. It is normally run once when
the machine is first set up. If DST is observed, the computer will
automatically start to observe it in the Sring and return to
standard time in the Fall. The machine must be turned off and
turned back on to guarantee that all times will be reported
correctly. Most are correct the next time the user logs in.
setup (2)
Set up the machine the first time.
The setup subcommand allows the user to define the first login, to
set the passwords on the user-definable administration logins, and
to set the time zone for the machine's location.
syspasswd (2)
Assign system passwords
The syspasswd subcommand lets the user set system passwords
normally reserved for the very knowledgeable user. For this
reason, the syspasswd procedure can assign those passwords, but may
4 Intergraph Corporation - 2/94
sysadm(8) CLIX sysadm(8)
not change or clear them. Once set, they may only be changed by
the specific login or the root login.
usermgmt (1)
User management menu
These subcommands allow the user to add, modify, or delete the list
of users that can access the machine. The usermgmt subcommands can
also be placed in separate groups so that they can share access to
files within the group, but protect themselves from other groups.
addgroup (2)
Add a group to the system
The addgroup subcommand adds a new group name or ID to the
computer. Group names and IDs are used to identify groups of users
who desire common access to a set of files and directories.
adduser (2)
Add a user to the system
The adduser subcommand installs a new login ID on the machine. A
series of questions is asked about the user and then the new entry
is made. More than one user can be entered at a time. Once this
procedure is finished, the new login ID is available.
delgroup (2)
Delete a group from the system
The delgroup subcommand allows groups to be removed from the
computer. The deleted group is no longer identified by name.
However, files can still be identified with the group ID number.
deluser (2)
Delete a user from the system
The deluser subcommand allows users to be removed from the
computer. The deleted user's files are removed from the fixed disk
and their logins are removed from the /etc/passwd file.
lsgroup (2)
List groups in the system
The lsgroup subcommand lists all groups entered in the computer.
This list is updated automatically by addgroup and delgroup.
lsuser (2)
List users in the system
The lsuser subcommand lists all users entered in the computer.
This list is updated automatically by adduser and deluser.
2/94 - Intergraph Corporation 5
sysadm(8) CLIX sysadm(8)
modadduser (2)
Modify defaults used by adduser
The modadduser subcommands allow the user to change some defaults
used when adduser creates a new login. Changing the defaults does
not affect any existing logins, only logins made from this point
forward.
modgroup (2)
Change a group on the system
The modgroup subcommand allows the user to change the name of a
group that the user enters when addgroup is run to set up new
groups.
moduser (2)
Modify a Login Menu
This menu contains commands that modify the various aspects of a
user's login.
chgloginid (3)
Change a user's login ID
This procedure allows the user to change a user's login ID.
Administrative and system logins cannot be changed.
chgpasswd (3)
Change a user's password
This procedure allows removal or change of a user's password.
Administrative and system login passwords cannot be changed. To
change administrative and system login passwords, see the system
setup menu in this section.
chgshell (3)
Change a user's login shell
This procedure allows the user to change the command run when a
user logs in. The login shell of the administrative and system
logins cannot be changed by this procedure.
EXAMPLES
sysadm adduser
FILES
/usr/admin Files that support sysadm
/usr/admin/menu The directory in which menu begins
6 Intergraph Corporation - 2/94
sysadm(8) CLIX sysadm(8)
NOTES
As presently implemented, the backup and restore facilities of sysadm are
convenient but inefficient. Moving large amounts of data (hundreds of
megabytes) can take an unacceptable length of time. Furthermore, sysadm
does not support multiple tape volumes. For large disks, using scpio(1)
on a local tape drive is recommended. The sysadm command will be enhanced
in the future to support scpio(1).
DIAGNOSTICS
... is not a valid subcommand or submenu name
An option that is not valid is entered.
EXIT VALUES
The sysadm command exits with a value of 1 if a problem is encountered.
RELATED INFORMATION
AT&T UNIX System V System Administrator's Guide
2/94 - Intergraph Corporation 7