sysadm(1M) DG/UX R4.11MU05 sysadm(1M)
NAME
sysadm, asysadm, xsysadm - menu-driven system administration
interface
SYNOPSIS
sysadm [-l] [ menu-alias ]
asysadm [-l] [ -m menu ] [ -o operation ] [ menu-alias ]
xsysadm [ X11-options ]
DESCRIPTION
The asysadm and xsysadm commands provide menu-driven interfaces to
system administration functions. sysadm is a generic invocation name
that uses the absence or presence of the WINDOWID environment
variable to determine whether to start asysadm or xsysadm.
References to sysadm are applicable to both asysadm and xsysadm.
asysadm is designed for use on a character-based terminal or terminal
emulator. This version of the command presents you with menus and
scrolling interactive queries to help you choose and execute the
commands to administer the system.
xsysadm uses the X11 window system on a graphics workstation. When
using this version of the command, you may use the mouse to select
functions to be performed from menus, and dialog windows appear in
which information is accepted.
Both interfaces are designed to be consistent while taking advantage
of the capabilities of the display device. In both cases you select
an object or class of objects to be managed, possibly refine your
selection through additional menus until you select a specific object
type, and then you select an operation to be performed. Once you
make this selection, sysadm prompts you to enter whatever information
is necessary to carry out the operation. When all information has
been obtained, the information is verified, you are asked to confirm
that you want the operation carried out, and then the operation is
performed.
Most operations are carried out by invoking
admobject -o operation options
for the given object class and operation. See admobject(1M) for
information on management of a specific object.
The method for traversing the menu hierarchy and interacting with the
menu system is described in idi(1). For a complete explanation of
the sysadm program, see Managing the DG/UX System.
Options
Options to sysadm depend on which command you are using.
xsysadm uses only those options which are defined by the X11 window
system. See X(1).
asysadm accepts the following options:
-l List the available menu-aliases.
-m menu Select menu as the first menu to be shown, bypassing the
Main Menu. The form of a menu is described in idi(1).
-o operation
Perform operation on menu.
asysadm accepts a menu-alias, which is sought in one of the system-
wide or personal alias files and expanded to -m and optionally -o
options. The alias directs you straight into a lower-level menu,
without seeing the Main Menu.
If you invoke asysadm with neither the -m option nor a menu-alias,
the top level menu, the Main Menu, of system administration objects
is displayed.
Resources
X11 resources for xsysadm use the class name "Idi" and the default
instance name "sysadm". See idi(1) for a list of resource names.
Configuration
The sysadm program offers several levels of customization.
Administrators may add site-specific menus and operations by creating
/usr/lib/sysadm/locale/sysadm.whatever.rc file(s), and host-specific
menus and operations by creating
/etc/sysadm/locale/sysadm.whatever.rc file(s) containing the new
items. Any such file(s) will be read along with the default
/usr/lib/sysadm/locale/sysadm.rc to create the sysadm menu tree. See
idl(4) for a description of the format of this file.
An individual user may add user-specific menus and operations by
creating a .sysadmrc file in the home directory or the current
directory.
Additionally, host-specific or user-specific menu aliases may be
added via the /etc/sysadm/locale/sysadm.alias or $HOME/sysadm.alias
files.
Users may customize xsysadm by modifying the values of the resources
used by idi. See idi(1) for a list of valid resources and X(1) for a
discussion of how to modify the resources.
EXAMPLES
# asysadm adduser
This command line takes you directly to the add operation for objects
of type user, because the line
adduser -m :user:login:add
appears in one of the system-wide alias files. You will begin
interacting with the dialogue to add a new user account.
In order to change xsysadm's font size, add the following lines to
the appropriate X resource file (see Xdefaults(5)):
sysadm*fontList: *helvetica-medium-r*18*
sysadm*logText.fontList: *courier-medium-r*18*
sysadm*reportText.fontList: *courier-medium-r*18*
sysadm*selectionBox.labelFontList: *helvetica-medium-r*18*
sysadm*selectionBox.textFontList: *courier-medium-r*18*
sysadm*XmList.fontList: *courier-medium-r*18*
These lines specify that xsysadm should use 18 point fonts, instead
of the default 14 point fonts.
If you often manage more than one system from the same graphics
display, you may wish to change xsysadm's title strings to indicate
which system is being managed. To do so, you could add the following
line to $HOME/.sysadmrc:
set TitleSuffix = " (`hostname`)"
This specifies that the name of the current host be added to the end
of all title strings in xsysadm.
FILES
/usr/lib/sysadm/locale/sysadm*.rc
Top-level file for host-independent DG/UX description files.
/etc/sysadm/locale/sysadm*.rc
Top-level file for host-dependent DG/UX description files.
/usr/opt/package/lib/sysadm/locale/sysadm.rc
Top-level file for package-specific host-independent
description files.
/opt/package/etc/sysadm/locale/sysadm.rc
Top-level file for package-specific host-dependent description
files.
$HOME/.sysadmrc
User-dependent description file.
./.sysadmrc
Invocation-dependent description file.
/usr/lib/sysadm/locale/sysadm.alias
Host-independent system-wide alias file.
/etc/sysadm/locale/sysadm.alias
Host-dependent system-wide alias file.
$HOME/sysadm.alias
Personal alias file.
/var/adm/log/sysadm.log
Log file.
/usr/opt/X11/lib/app-defaults/Idi
X11 default resources file.
ENVIRONMENT
LANG Used to determine the locale (the default locale is C).
HOME Used to locate files that are expected in the user's home
directory.
PATH Used to locate standard system commands, adm* commands, and
certain utility programs.
SYSADM_TIMEOUT
The number of seconds to wait when accessing /opt and
/usr/opt directories. The default value is 5 seconds.
SEE ALSO
admobject(1M), idi(1), idl(4), X(1), Xdefaults(5),
Installing the DG/UX System, Managing the DG/UX System.
NOTES
The sysadm command invokes idi to perform menu and query traversal.
Therefore, in order to kill a sysadm session via kill(1) or
dg_kill(1), you must kill the idi process.
Licensed material--property of copyright holder(s)