Interface and System Preferences: server_pref Utility

The server_pref utility is used to manage Plesk default interface preferences and Plesk server system preferences.

Syntax

server_pref <command> [

<option_1> [<param>]

[<option_2> [<param>]]

…[<option_N> [<param>]]

Example

The following command line sets the Plesk server host name to host.example.com, enables including databases in the disk space usage calculation, and enables including only outbound traffic in the traffic calculation.

# ./server_pref --update -hostname host.example.com -include-databases true -traffic-direction out

Commands

Ñommand

Parameter

Description

Example

--set-default or -sd

 

Sets Plesk Default Interface Preferences.

To set Plesk servers Default locale to English(United States):

# ./server_pref --set-default -locale en-US

or

# ./server_pref -sd -locale en-US

--locales-list or -ll

 

Displays the list of available supported interface languages (locales).

To display the list of available interface languages (locales):

# ./server_pref --locales-list

or

# ./server_pref -ll

--skins-list or -sl

 

Displays the list of available Plesk control panel skins.

To display the list of available skins:

# ./server_pref --skins-list

or

# ./server_pref -sl

--templates-list or -tl

 

Displays the list of available interface customization templates.

To display the list of available interface customization templates:

# ./server_pref --templates-list

or

# ./server_pref -tl

-update or -u

 

Updates Plesk server preferences.

To set the WinXP Olivegreen skin as the default skin:

# ./server_pref --update -skin "WinXP Olivegreen"

or

# ./server_pref -u -skin "WinXP Olivegreen"

--help or -h

 

Displays help on the use of the utility.

To display help on the use of the server_pref utility:

# ./server_pref --help

or

# ./server_pref -h

Options

Option

Parameter

Description

Example

-locale

<language code>

Sets the default interface language for Plesk control panel (the Default locale parameter). The argument of the option must be a valid four-letter language code derived from the language code described in ISO-639-2 and the corresponding country code described in ISO-3166. For example, the Plesk code for the Italian language code is it-IT; the Plesk code for the American variant of English is en-US; the Plesk code for the British variant of English is en-GB.

Used only with the --set-default command.

To set the default interface language for Plesk administrator to Russian:

# ./server_pref -sd -locale -ru-RU

-skin

<skin name>

Sets the default interface skin for Plesk control panel (the Default skin parameter).

Used only with the --set-default command.

To set the WinXP Olivegreen skin as the default skin:

# ./server_pref -sd -skin "WinXP Olivegreen"

-template

<template name>

Sets the default interface customization template to Plesk control panel (the Default interface customization template parameter).

Used only with the --set-default command.

To apply customization template CustomTemplate to administrator's control panel:

# ./server_pref -sd -template CustomTemplate

-hostname

<string>

Changes the host name of the Plesk server (the Full hostname parameter).

To change the hostname of the Plesk server to host.example.com:

# ./server_pref -u-hostname host.example.com

-restart-apache

<number>

Sets the Apache restart interval parameter (in seconds).

To set the Apache restart interval to 1000 seconds:

# ./server_pref -u -restart-apache 1000

-include-logs

true|false

Enables or disables including log files in the disk space usage calculation (the Include in the disk space usage calculation parameter, log files and statistic reports option).

To enable including log files in the disk space usage calculation:

# ./server_pref -u -include-logs true

-include-databases

true|false

Enables or disables including databases in the disk space usage calculation (the Include in the disk space usage calculation parameter, databases option).

To enable including databases in the disk space usage calculation:

# ./server_pref -u -include-databases true

-include-mailboxes

true|false

Enables or disables including mailboxes in the disk space usage calculation (the Include in the disk space usage calculation parameter, mailboxes option).

To enable including mailboxes in the disk space usage calculation:

# ./server_pref -u -include-mailboxes true

-include-maillists

true|false

Enables or disables including mailing lists in the disk space usage calculation (the Include in the disk space usage calculation parameter, mailing lists option).

To enable including mailing lists in the disk space usage calculation:

# ./server_pref -u -include-maillists true

-include-domaindumps

true|false

Enables or disables including domain backup files in the disk space usage calculation (the Include in the disk space usage calculation parameter, domain backup files option).

To enable including domain backup files in the disk space usage calculation:

# ./server_pref -u -include-domaindumps true

-count-type

byte|block

Sets the When calculating disk space usage, count parameter (file size (byte) or amount of disk space used (block) options).

To enable counting disk space usage based on actual file sizes:

# ./server_pref -u -count-type -byte

-stat-keep

<number>

Sets the Retain traffic statistics for parameter (in months).

Set to 4 by default.

To set the Retain traffic statistics for parameter to 3 months:

/server_pref -u -stat-keep 3

-traffic-direction

both|in|out

Sets the Include in the traffic calculation parameter (inbound and outbound traffic, only inbound traffic, or only outbound traffic options)

To include only outbound traffic in the traffic calculation:

# ./server_pref -u -traffic-direction out