Reseller Limits, Permissions, and Interface Settings: reseller_pref.exe

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

Location

%plesk_cli%

 

Usage

reseller_pref.exe <command> [<login_name>] [
<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 clients. The maximum number of available clients for the reseller is restricted to 20.

>reseller_pref.exe --update JDoe -manage_log true -manage_maillists true -create_clients true -max_cl 20

 

Commands

Command

Parameter

Description

Example

--update or -u

<login_name>

Sets various properties of a reseller account.

To prohibit changing domain limits to the JDoe reseller account:

>reseller_pref.exe --update JDoe -change_limits false

or

>reseller_pref.exe -u JDoe -change_limits false

--skin-list or -sl

 

Displays a list of available skins.

To view the list of available skins:

>reseller_pref.exe --skin-list

or

>reseller_pref.exe -sl

--info or -i

<login_name>

Displays information on reseller's limits, permissions, IP pool settings and preferences.

To retrieve the information about the JDoe reseller account:

>reseller_pref.exe --info JDoe

or

>reseller_pref.exe -i JDoe

--help or -h

 

Displays help on the utility use.

To view help on the utility:

>reseller_pref.exe –-help

or

>reseller_pref.exe –h

 

Options

Option

Parameter

Description

Example

-create_domains

true|false

Allows/Prohibits creating domains.

Is false by default.

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

>reseller_pref.exe --update 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:

>reseller_pref.exe --update JDoe -manage_phosting true

-change_limits

true|false

Allows/Prohibits changing domain limits.

Is false by default.

To allow the reseller with the login name JDoe to change domain limits:

>reseller_pref.exe --update JDoe -change_limits 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:

>reseller_pref.exe --update JDoe -manage_dns true

-manage_log

true|false

Allows/Prohibits managing log rotation, namely, to adjust the cleanup and recycling of processed log files.

Is false by default.

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

>reseller_pref.exe --update 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:

>reseller_pref.exe --update JDoe -manage_crontab true

-manage_anonftp

true|false

Allows/Prohibits managing Anonymous FTP.

A web site should reside on a dedicated IP address in order to use anonymous FTP service.

Is false by default.

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

>reseller_pref.exe --update JDoe -manage_anonftp true

-manage_webapps

true|false

Allows/Prohibits managing Tomcat web applications.

Is false by default.

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

>reseller_pref.exe --update JDoe -manage_webapps 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:

>reseller_pref.exe --update JDoe -manage_maillists true

-manage_sh_access

true|false

Allows/Prohibits managing access to the system through Remote Desktop.

Is false by default.

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

>reseller_pref.exe --update JDoe -manage_sh_access 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:

>reseller_pref.exe --update JDoe -manage_subdomains true

-manage_quota

true|false

Allows/Prohibits changing limit on using disk space.

Is false by default.

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

>client_pref.exe --update JohnDoe -manage_quota true

-make_dumps

true|false

Allows/Prohibits backing up and restoring domains.

Is false by default.

To allow the reseller with the login name JDoe to back up and restore domains:

>reseller_pref.exe --update JDoe -make_dumps true

-manage_virusfilter

true|false

Allows/Prohibits managing server-side antivirus protection.

Is false by default.

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

>reseller_pref.exe --update JDoe -manage_virusfilter true

-remote_access_interface

true|false

Allows/Prohibits using Parallels Plesk Panel API.

Is false by default.

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

>reseller_pref.exe --update JDoe -remote_access_interface true

-site_builder

true|false

Allows/Prohibits using Sitebuilder.

Is false by default.

To allow the reseller with the login name JDoe to use Sitebuilder:

>reseller_pref.exe --update JDoe -site_builder true

-max_dom

<number>

Limits the number of available domains.

Includes domains hosted on this server, and domain forwarders that point to domains hosted on other servers.

Unlimited if set to -1.

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

>reseller_pref.exe --update JDoe -max_dom 3

-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 2:

>reseller_pref.exe --update JDoe -max_dom_aliases 2

-disk_space

<MB>

Limits the amount of available disk space.

Unlimited if set to -1.

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

>reseller_pref.exe --update JDoe -disk_space 1024

-disk_space_soft

<MB>

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 700 MB:

>reseller_pref -u JDoe -disk_space_soft 700

-max_traffic

<MB/month>

Limits monthly traffic usage.

Unlimited if set to -1.

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

>reseller_pref.exe --update JDoe -max_traffic 10240

-max_traffic_soft

<MB/month>

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 5 GB/month:

>reseller_pref -u JDoe -max_traffic_soft 5120

-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 10:

>reseller_pref.exe --update JDoe -max_box 10

-mbox_quota

<KB>

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

Unlimited if set to -1.

To set the quota of a single mailbox to the reseller with the login name JDoe to 100 MB:

>reseller_pref.exe --update JDoe -mbox_quota 102400

-max_redir

<number>

Limits the number of available mail redirects.

Unlimited if set to -1.

To restrict the maximum number of mail redirects available to the reseller with the login name JDoe to 3:

>reseller_pref.exe --update JDoe -max_redir 3

-max_mg

<number>

Limits the number of available mail groups.

Unlimited if set to -1.

To restrict the maximum number of mail groups available to the reseller with the login name JDoe to 5:

>reseller_pref.exe --update JDoe -max_mg 5

-max_resp

<number>

Limits the number of available mail autoresponders.

Unlimited if set to -1.

To restrict the maximum number of mail autoresponders available to the reseller with the login name JDoe to 5:

>reseller_pref.exe --update JDoe -max_resp 5

-max_wu

<number>

Limits the number of available web users.

Unlimited if set to -1.

To set the number of web users available to the reseller with the login name JDoe to unlimited:

>reseller_pref.exe --update JDoe -max_wu -1

-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 reseller with the login name JDoe to 30:

>reseller_pref.exe --update JDoe -max_maillists 30

-max_fpse_users

<number>

Limits the number of available additional Microsoft FrontPage accounts.

Unlimited if set to -1.

To set the number of additional Microsoft FrontPage accounts available to the reseller with the login name JDoe to unlimited:

>reseller_pref.exe -u JDoe -max_fpse_users -1

-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:

>reseller_pref.exe -u JDoe -max_subftp_users 100

-max_db

<number>

Limits the number of available MySQL databases.

Unlimited if set to -1.

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

>reseller_pref.exe -u JDoe -max_db 5

-max_mssql_db

<number>

Limits the number of available Microsoft SQL databases.

Unlimited if set to -1.

To restrict the number of Microsoft SQL databases available to the reseller with the login name JDoe to 15:

>reseller_pref.exe --update JDoe -max_mssql_db 15

-mysql_dbase_space

<MB>

Limits the amount of disk space that all MySQL databases can occupy.

Unlimited if set to -1.

To set the MySQL databases quota to the reseller with the login name JDoe to 200 MB:

>reseller_pref.exe --update JDoe -mysql_dbase_space 200

-mssql_dbase_space

<MB>

Limits the amount of disk space that all Microsoft SQL databases can occupy.

Unlimited if set to -1.

To set the Microsoft SQL databases quota to the reseller with the login name JDoe to 300 MB:

>reseller_pref.exe --update JDoe -mssql_dbase_space 300

-max_webapps

<number>

Limits the number of available Tomcat web applications.

Unlimited if set to -1.

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

>reseller_pref.exe --update JohnDoe -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 4:

>reseller_pref.exe -u JDoe -max_subdom 4

-max_iis_app_pools

<number>

Limits the number of available IIS application pools.

Unlimited if set to -1.

To restrict the maximum number of IIS application pools available to the reseller with the login name JDoe to 6:

>reseller_pref.exe -u JDoe -max_iis_app_pools 6

-max_shared_ssl_links

<number>

Limits the number of available shared SSL links.

Unlimited if set to -1.

To restrict the maximum number of shared SSL links available to the reseller with the login name JDoe to 3:

>reseller_pref.exe -u JDoe -max_shared_ssl_links 3

-max_cf_dsn

<number>

Limits the number of available Coldfusion DSN connections.

Unlimited if set to -1.

To set the number of Coldfusion DSN connections available to the reseller with the login name JDoe to unlimited:

>reseller_pref.exe -u JDoe -max_cf_dsn -1

-max_odbc_dsn

<number>

Limits the number of ODBC DSN connections available to the reseller.

Unlimited if set to -1.

To restrict the maximum number of ODBC connections available to the reseller with the login name JDoe to 5:

>reseller_pref.exe -u JDoe -max_odbc_dsn 5

-expiration

<YYYY-MM-DD>

Limits the validity period of a reseller account.

To make the JDoe reseller account valid till 31 December 2008:

>reseller_pref.exe -u JDoe -expiration 2008-12-31

-language

<string>

Specifies which language is used in a reseller's control panel interface.

String should contain the first two letters of the language name and first two letters of the country name.

To set Italian language as default for the JDoe reseller account:

>reseller_pref.exe -u JDoe -language it-IT

-skin

<string>

Specifies which skin is used in a reseller's control panel interface.

To set the WinXP Reloaded skin for the JDoe reseller account:

>reseller_pref.exe --update JDoe -desktop-preset "WinXP Reloaded"

-cp_access

true|false

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

Is true by default.

To prohibit reseller with the login name JDoe from accessing to Parallels Plesk Panel CP:

>reseller_pref.exe --update JDoe -cp_access false

-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:

>reseller_pref.exe --update JDoe -manage_subftp 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:

>reseller_pref.exe --update JDoe -manage_domain_aliases 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 settings:

>reseller_pref.exe --update JDoe -manage_performance true

-manage_iis_app_pool

true|false

Allows/Prohibits managing IIS application pool.

Is false by default..

To allow the reseller with the login name JDoe to manage IIS application pool:

>reseller_pref.exe --update JDoe -manage_iis_app_pool true

-manage_webstat

true|false

Allows/Prohibits managing Web Statistics on the reseller's domains, namely, to choose which of the web statistics tools (or none) to use.

Is false by default.

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

>reseller_pref.exe --update JDoe -manage_webstat true

-manage_additional_permissions

true|false

Allows/Prohibits managing additional write and modify permissions.

If it is true, the full access permission for the domain httpdocs/ and httpsdocs/ files and subfolders are granted to the Parallels Plesk Panel IIS User.

May be required for web applications correct functioning, but is insecure.

Is false by default.

To allow the client with the login name JDoe to manage additional write/modify permissions:

>reseller_pref.exe --update JDoe -manage_additional_permissions true

-manage_spamfilter

true|false

Allows/Prohibits configuring spam filter on the mail account level (if the correspondent option is enabled in the server-wide configuration).

Is false by default.

To allow the client with the login name JohnDoe to configure spam filter:

>reseller_pref.exe --update JDoe -manage_spamfilter true

-manage_shared_ssl

true|false

Allows/prohibits managing the Shared SSL feature: making one of the client's domains a Master SSL Domain which shares its SSL certificates with other domains, and creating shared SSL links to Master for his other domains.

Is false by default.

To allow the client with the login name JDoe to manage shared SSL:

>reseller_pref.exe --update JDoe -manage_shared_ssl true

-select_db_server

true|false

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

Is false by default.

To allow the reseller with the login name JDoe to choose a DB server when creating a database:

>reseller_pref.exe --update JDoe -select_db_server true

-create_clients

true|false

Allows/Prohibits creating clients.

Is false by default.

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

>reseller_pref.exe -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:

>reseller_pref.exe -u JDoe -allow_oversell 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:

>reseller_pref.exe -u JDoe -oversell false

-max_cl

<number>

Limits the number of available clients.

Unlimited if set to -1.

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

>reseller_pref.exe -u JDoe -max_cl 5

-overuse

block|notify|normal

Sets the overuse policy.

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

>reseller_pref.exe -u JDoe -overuse notify