NAME¶
serv_config - view and configure system service policies and settings on IBM
ppc64 platforms
SYNOPSIS¶
/usr/sbin/serv_config [-b] [-s] [-r] [-m]
/usr/sbin/serv_config -l
/usr/sbin/serv_config -z filename
/usr/sbin/serv_config -e var[=value]
/usr/sbin/serv_config [--surveillance[=settings]]
[ --reboot-policy[=settings]]
[ --ring-indicate[=settings]]
[ --remote-maint[=settings]]
[ --force]
DESCRIPTION¶
The
serv_config utility is used to view and manipulate various system
service policies and settings on PAPR-compliant PowerPC-64 machines, such as
IBM pSeries, iSeries, System p or System i machines.
serv_config can be run in one of two modes; interactive mode, in which
the user will be prompted for the value of each variable in the specified
category, or macro mode, in which the string provided on the command line will
be parsed for the values of the variables in the category. Macro mode is for
expert use only; most users should be utilizing the interactive options (
-s,
-b,
-r, and
-m).
NOTE: It is recommended that the current service settings are backed up
with the
-l option before the settings are manipulated with this
utility. Should a value be mistakenly updated to an incorrect value, all the
settings can be restored to the backed up values with the
-z option.
OPTIONS¶
- -l
- List all of the current service settings. If this output is
stored to a file, these settings can be later restored with the -z
option.
- -e var[=value]
- If only var is specified, the value of the specified
service setting is displayed; if a value is also specified, the
value of the specified service setting is updated to the specified
value.
- -s
- Interactively update the Surveillance settings.
- -b
- Interactively update the Reboot policies.
- -r
- Interactively update the Remote Power-On settings (either
Ring Indicate Power-On or Wake On LAN).
- -m
- Interactively update the Remote Maintenance settings.
- -z filename
- Restore the service settings that were previously stored to
filename (using the -a option).
ADVANCED OPTIONS¶
The following options are for expert users only. They are intended to be used by
scripts and utilities which have been designed to automate the
retrieval/manipulation of service settings.
- --surveillance[=settings]
- View or update the Surveillance settings in macro mode. If
the settings argument is not specified, all of the Surveillance
variables are printed along with their corresponding values. If the
settings argument is specified, the Surveillance settings are
updated to the specified values. The settings argument should be in
the following format:
sp-sen,sp-sti,sp-del,immediate
- --reboot-policy[=settings]
- View or update the Reboot policies in macro mode. If the
settings argument is not specified, all of the Reboot policy
variables are printed along with their corresponding values. If the
settings argument is specified, the Reboot policies are updated to
the specified values. The settings argument should be in the
following format on legacy systems:
sp-bootrt-limit,sp-os-plt-reboot,sp-plt-reboot,
sp-dookc,sp-ac-reboot
On recent systems, the following format is used:
partition_auto_restart,platform_auto_power_restart
- --remote-pon[=settings]
- View or update the Remote Power-On settings in macro mode.
If the settings argument is not specified, all of the Remote
Power-On variables are printed along with their corresponding values. If
the settings argument is specified, the Remote Power-On settings
are updated to the specified values. The settings argument should
be in the following format for systems with support for Ring Indicate
Power-On:
sp-ri-pon,sp-rb4-pon
On systems with support for Wake On LAN, the format
is as follows:
sp-remote-pon
- --remote-maint[=settings]
- View or update the Remote Maintenance settings in macro
mode. If the settings argument is not specified, all of the Remote
Maintenance variables are printed along with their corresponding values.
If the settings argument is specified, the Remote Maintenance
settings are updated to the specified values.
- --force
- Do not prompt for confirmation before modifying system
settings; only valid in macro mode (ignored in interactive mode).
SEE ALSO¶
bootlist(8),
lscfg(8),
nvram(8)