reseller_pref: Reseller Limits, Permissions, and Interface Settings

The reseller_pref CL utility enables the administrator to set and edit the reseller's limits and permissions, and to define Plesk interface preferences (e.g. the default language and skin).

Note: The utility is available since Plesk 9.0.

 

Usage
reseller_pref <command> <login> [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]

Example

The following command updates the reseller account with the login name JDoe as follows: the reseller is allowed to manage log rotation and mailing lists and to create customer accounts. The maximum number of available customer accounts for the reseller is restricted to 20.

plesk bin reseller_pref --update JDoe -manage_log true -manage_maillists true -create_clients true -max_cl 20

Commands
Command Parameter Description Example

--update or -u

<login>

Updates preferences and limits for an existing reseller account.

To disable changing domain limits for the reseller account with the login name JDoe:

plesk bin reseller_pref --update JDoe -change_limits false

or

plesk bin reseller_pref -u JDoe -change_limits false

--skin-list or -sl

 

Displays the list of available control panel interface skins.

To view the list of available interface skins:

plesk bin reseller_pref --skin-list

or

plesk bin reseller_pref -sl

--info or -i

<login>

Displays information about reseller account preferences and limits.

To view information about preferences and limits set on the reseller account with login name JDoe:

plesk bin reseller_pref --info JDoe

or

plesk bin reseller_pref -i JDoe

--help or -h

 

Displays help on the use of the utility.

To view help on the use of this utility:

plesk bin reseller_pref --help

or

plesk bin reseller_pref -h

Options
Option Parameter Description Example

-power-user

true|false

Switches the reseller to Power User mode.

To switch the reseller with the login name JDoe to the Power User mode:

plesk bin reseller_pref -u JDoe -power-user true

-create_domains

true|false

Allows/Prohibits creation domains.

Is false by default.

To allow the reseller with the login name JDoe to create domains:

plesk bin reseller_pref -u JDoe -create_domains true

-manage_phosting

true|false

Allows/Prohibits managing physical hosting.

Is false by default.

To allow the reseller with the login name JDoe to manage physical hosting:

plesk bin reseller_pref -u JDoe -manage_phosting true

-manage_php_settings

true|false

Allows/Prohibits managing common PHP settings.

To allow the reseller with the login name JDoe to manage common PHP settings:

plesk bin reseller_pref -u JDoe -manage_php_settings true

-manage_php_version

true|false

Allows/Prohibits choosing the PHP version.

To allow the reseller with the login name JDoe to choose the PHP version:

plesk bin reseller_pref -u JDoe -manage_php_version true

-manage_php_safe_mode

true|false

Allows/Prohibits managing PHP safe mode.

Is false by default.

To allow the reseller with login name JDoe to manage PHP safe mode:

plesk bin reseller_pref -u JDoe -manage_php_safe_mode true

-manage_dns

true|false

Allows/Prohibits managing DNS.

Is false by default.

To allow the reseller with the login name JDoe to manage DNS:

plesk bin reseller_pref -u JDoe -manage_dns true

-manage_log

true|false

Allows/Prohibits managing log rotation.

Is false by default.

To allow the reseller with the login name JDoe to manage log rotation:

plesk bin reseller_pref -u JDoe -manage_log true

-manage_crontab

true|false

Allows/Prohibits managing task scheduler.

Is false by default.

To allow the reseller with the login name JDoe to manage task scheduler:

plesk bin reseller_pref -u JDoe -manage_crontab true

-manage_anonftp

true|false

Allows/Prohibits managing anonymous FTP.

Is false by default.

To allow the reseller with the login name JDoe to manage anonymous FTP:

plesk bin reseller_pref -u JDoe -manage_anonftp true

-manage_webapps

true|false

Allows/Prohibits managing Java applications.

Is false by default.

To allow the reseller with the login name JDoe to manage Java applications:

plesk bin reseller_pref -u JDoe -manage_webapps true

-manage_mail_settings

true|false

Allows/Prohibits changing the mail settings.

Is false by default.

To allow the reseller with the login name JDoe to manage the mail settings:

plesk bin reseller_pref -u JDoe -manage_mail_settings true

-manage_maillists

true|false

Allows/Prohibits managing mailing lists.

Is false by default.

To allow the reseller with the login name JDoe to manage mailing lists:

plesk bin reseller_pref -u JDoe -manage_maillists true

-manage_sh_access

true|false

Allows/Prohibits managing system access.

Is false by default.

To allow the reseller with the login name JDoe to manage system access:

plesk bin reseller_pref -u JDoe -manage_sh_access true

-manage_not_chroot_shell

true|false

Allows/Prohibits managing non-chrooted environment.

Is false by default.

To allow the reseller with the login name JDoe to manage non-chrooted environment:

plesk bin reseller_pref -u JDoe -manage_not_chroot_shell true

-manage_subdomains

true|false

Allows/Prohibits managing subdomains.

Is false by default.

To allow the reseller with the login name JDoe to manage subdomains:

plesk bin reseller_pref -u JDoe -manage_subdomains true

-manage_quota

true|false

Allows/Prohibits managing hard disk quota.

Is false by default.

To allow the reseller with login name JDoe to manage hard disk quota:

plesk bin reseller_pref -u JDoe -manage_quota true

-allow_local_backups

true|false

Allows/Prohibits backing up and restoring data using the Plesk's storage.

Is false by default.

To allow the reseller with the login name JDoe to backup and restore data using the Plesk's storage:

plesk bin reseller_pref -u JDoe -allow_local_backups true

-allow_ftp_backups

true|false

Allows/Prohibits backing up and restoring data using the FTP storage.

Is false by default.

To allow the reseller with the login name JDoe to backup and restore data using the FTP storage:

plesk bin reseller_pref -u JDoe -allow_ftp_backups true

-allow_account_local_backups

true|false

Allows/Prohibits backing up and restoring account data using the Plesk's storage.

Is false by default.

To allow the reseller with the login name JDoe to backup and restore account data using the Plesk's storage:

plesk bin reseller_pref -u JDoe -allow_account_local_backups true

-allow_account_ftp_backups

true|false

Allows/Prohibits backing up and restoring account data using the FTP storage.

Is false by default.

To allow the reseller with the login name JDoe to backup and restore account data using the FTP storage:

plesk bin reseller_pref -u JDoe -allow_account_ftp_backups true

-manage_virusfilter

true|false

Allows/Prohibits managing antivirus tool used on reseller's domains.

Is false by default.

To allow the reseller with the login name JDoe to manage antivirus tool:

plesk bin reseller_pref -u JDoe -manage_virusfilter true

-remote_access_interface

true|false

Allows/Prohibits using Plesk API.

Is false by default.

To allow the reseller with the login name JDoe to use Plesk API:

plesk bin reseller_pref -u JDoe -remote_access_interface true

-manage_domain_aliases

true|false

Allows/Prohibits managing domain aliases.

Is false by default.

To allow the reseller with the login name JDoe to manage domain aliases:

plesk bin reseller_pref -u JDoe -manage_domain_aliases true

-manage_subftp

true|false

Allows/Prohibits managing additional FTP accounts.

Is false by default.

To allow the reseller with the login name JDoe to manage additional FTP accounts:

plesk bin reseller_pref --update JDoe -manage_subftp true

-cp_access

true|false

Allows/Prohibits accessing Plesk GUI (as opposite to using Plesk API).

Is true by default.

To prohibit the reseller with login name JDoe from accessing Plesk GUI:

plesk bin reseller_pref -u JDoe -cp_access false

-manage_spamfilter

true|false

Allows/Prohibits managing spam filter.

Is false by default.

To allow the reseller with the login name JDoe to manage spam filter:

plesk bin reseller_pref -u JDoe -manage_spamfilter true

-manage_webstat

true|false

Allows/Prohibits managing web statistics.

Is false by default.

To allow the reseller with the login name JDoe to manage web statistics:

plesk bin reseller_pref -u JDoe -manage_webstat true

-max_dom

<number>

Limits the number of available domains.

Unlimited if set to-1.

To restrict maximum number of domains available to the reseller with the login name JDoe to 100:

plesk bin reseller_pref -u JDoe -max_dom 100

-max_dom_aliases

<number>

Limits the number of available domain aliases.

Unlimited if set to -1.

To restrict the maximum number of domain aliases available to the reseller with the login name JDoe to 50:

plesk bin reseller_pref -u JDoe -max_dom_aliases 50

-max_subftp_users

 

<number>

Limits the number of available additional FTP accounts.

Unlimited if set to -1.

To restrict the maximum number of additional FTP accounts available to the reseller with the login name JDoe to 100:

plesk bin reseller_pref -u JDoe -max_subftp_users 100

-disk_space

<number>[B|K|M|G|T]

Limits the amount of available disk space.

A number without a letter is interpreted as the number of bytes.

Unlimited if set to -1.

To restrict the maximum amount of disk space available to the reseller with the login name JDoe to 100 MB:

plesk bin reseller_pref -u JDoe -disk_space 100M

-disk_space_soft

<number>[B|K|M|G|T]

Sets the amount of disk space upon reaching which notification is sent.

To set the amount of disk space upon reaching which notification is sent for the reseller with the login name JDoe to 70 GB:

plesk bin reseller_pref -u JDoe -disk_space_soft 70G

-max_traffic

<number>[B|K|M|G|T]

Limits the monthly traffic usage.

A number without a letter is interpreted as the number of bytes.

Unlimited if set to -1.

To restrict the maximum amount of traffic available to the reseller with the login name JDoe to 100 GB/month:

plesk bin reseller_pref -u JDoe -max_traffic 100G

-max_traffic_soft

<number>[B|K|M|G|T]

Sets the monthly amount of traffic upon reaching which notification is sent.

To set the amount of traffic upon reaching which notification is sent to 70 GB/month:

plesk bin reseller_pref -u JDoe -max_traffic_soft 70G

-max_box

<number>

Limits the number of available mailboxes.

Unlimited if set to -1.

To restrict the maximum number of mailboxes available to the reseller with the login name JDoe to 1000:

plesk bin reseller_pref -u JDoe -max_box 1000

-mbox_quota

<number>[K|M|G]

Limits the amount of disk space that a single mailbox can occupy.

A number without a letter is interpreted as the number of bytes.

Unlimited if set to -1.

To set the mailbox quota for the reseller with login name JDoe to 10 GB:

plesk bin reseller_pref -u JDoe -mbox_quota 10G

-max_wu

<number>

Limits the number of available web users.

Unlimited if set to -1.

To restrict the maximum number of web users available to the reseller with the login name JDoe to 50:

plesk bin reseller_pref -u JDoe -max_wu 50

-max_maillists

<number>

Limits the number of available mailing lists.

Unlimited if set to -1.

To restrict the maximum number of mailing lists available to the resellers with the login name JDoe to 30:

plesk bin reseller_pref -u JDoe -max_maillists 30

-max_db

<number>

Limits the number of available databases.

Unlimited if set to -1.

To restrict the maximum number of databases available to the reseller with the login name JDoe to 20:

plesk bin reseller_pref -u JDoe -max_db 2

-max_webapps

<number>

Limits the number of available Java applications.

Unlimited if set to -1.

To restrict the maximum number of Java applications available to the reseller with the login name JDoe to 50:

plesk bin reseller_pref -u JDoe -max_webapps 50

-max_subdom

<number>

Limits the number of available subdomains.

Unlimited if set to -1.

To restrict the maximum number of subdomains available to the reseller with the login name JDoe to 40:

plesk bin reseller_pref -u JDoe -max_subdom 40

-locale

<language_code>

Sets the default interface language for client's control panel interface.

The argument of the command 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.

To set the default interface language for the reseller with the login name JDoe to Russian:

plesk bin reseller_pref -u JDoe -locale ru-RU

-skin

<skin_name>

Sets the default interface skin for a reseller's control panel interface.

To set the skin WinXP Olivegreen as the default interface skin for the reseller with the login name JDoe:

plesk bin reseller_pref -u JDoe -skin "WinXP Olivegreen"

-multiple-sessions

true|false

Allows/Prohibits having several simultaneous sessions under reseller's login.

Is true by default.

To prohibit multiple sessions to run simultaneously under login of the reseller with the login name JDoe:

plesk bin reseller_pref -u JDoe -multiple-sessions false

-select_db_server

true|false

Allows/Prohibits choosing a DB server from the servers registered in Plesk, when creating a database.

Is false by default.

To allow the reseller with the login name JDoe to choose DB server on which a database is to be created:

plesk bin reseller_pref -u JDoe -select_db_server true

-remote_db_connection

true|false

Allows/Prohibits managing remote access for database users.

 

-access_appcatalog

true|false

Allows or prohibits access to applications catalog for viewing and installing prepackaged applications on sites.

To allow the reseller with the login name JDoe to access applications catalog and install applications on websites:

plesk bin reseller_pref -u JDoe -access_appcatalog true

-allow_license_stubs

true|false

Allow activating APS apps using license keys from the Plesk license pool.

To allow the reseller with the login name JDoe to activate aps applications using license keys from the Plesk license pool:

plesk bin reseller_pref -u JDoe -allow_license_stubs true

-allow_insecure_sites

true|false

Allows or prohibits overriding server-wide security policy on web hosting scripting options, if the policy is set up.

To allow the reseller with the login name JDoe to override security policy:

plesk bin reseller_pref -u JDoe -allow_insecure_sites true

-manage_performance

true|false

Allows/Prohibits managing hosting performance.

Is false by default.

To allow the reseller with the login name JDoe to manage hosting performance:

plesk bin reseller_pref -u JDoe -manage_performance true

-create_clients

true|false

Allows/Prohibits creating customer accounts.

Is false by default.

To allow the reseller with the login name JDoe to create customer accounts:

plesk bin reseller_pref -u JDoe -create_clients true

-allow_oversell

true|false

Allows/Prohibits managing limits policy.

Is false by default.

To allow managing limits policy to the reseller with the login name JDoe:

plesk bin reseller_pref -u JDoe -allow_oversell true

-manage_website_maintenance

true|false

Allows/Prohibits access to website copying.

To allow the reseller with the login name JDoe access to website copying:

plesk bin reseller_pref -u JDoe -manage_website_maintenance true

-manage_wordpress_toolkit

true|false

Allows/Prohibits access to the WordPress toolkit.

To allow the reseller with the login name JDoe access to the WordPress toolkit:

plesk bin reseller_pref -u JDoe -manage_wordpress_toolkit true

-manage_security_wordpress_toolkit

true|false

Allows/Prohibits access to the WordPress toolkit security features.

To allow the reseller with the login name JDoe access to the WordPress toolkit security features:

plesk bin reseller_pref -u JDoe -manage_security_wordpress_toolkit true

-manage_protected_dirs

true|false

Allows/Prohibits managing the password-protected directories.

To allow the reseller with the login name JDoe to manage the password-protected directories:

plesk bin reseller_pref -u JDoe -manage_protected_dirs true

-access_service_users

true|false

Allows/Prohibits managing the auxiliary user accounts.

To allow the reseller with the login name JDoe to manage the auxiliary user accounts:

plesk bin reseller_pref -u JDoe -access_service_users true

-oversell

true|false

Specifies limits policy:

true - oversell policy

false - strict policy

Is true by default.

To set limits policy for the reseller with the login name JDoe to strict:

plesk bin reseller_pref -u JDoe -oversell false

-max_cl

<number>

Limits the number of available customer accounts.

Unlimited if set to -1.

To set the number of available customer accounts for the reseller with the login name JDoe to 5:

plesk bin reseller_pref -u JDoe -max_cl 5

-max_site_builder

<number>

Specifies the number of websites that can be created and published with Presence Builder.

To set the number of websites that can be created and published with Presence Builder for reseller with the username JDoe to 5:

plesk bin reseller_pref -u JDoe -max_site_builder 5

-max_unity_mobile_sites

<number>

Specifies the number of mobile site versions that can be created with the external UNITY Mobile service.

To set the number of mobile websites that can be created under subscriptions of reseller JDoe to 5:

plesk bin reseller_pref -u JDoe -max_unity_mobile_sites 5

-overuse

block|not_suspend|notify|normal|not_suspend_notify

Sets the overuse policy:

  • normal - overuse is allowed.
  • notify - overuse is allowed; when the resource usage limit is reached, an e-mail notice is sent according to the event notification settings.
  • not_suspend - overuse is allowed only for disk space and traffic resources.
  • block - overuse is not allowed, and the user account is suspended when the resource usage limit is reached.
  • not_suspend_notify - overuse is allowed only for disk space and traffic resources; an e-mail notice is sent according to the event notification settings.

 

To set the overuse policy for the reseller with the login name JDoe to notify:

plesk bin reseller_pref -u JDoe -overuse notify

-site_builder

true|false

Allows/Prohibits to manage Presence Builder.

To allow the reseller with the login name JDoe to use Presence Builder:

plesk bin reseller_pref -u JDoe -site_builder true