SERV_CONFIG(8)

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)