History of Changes

This chapter describes the version-specific changes in the command-line utilities. The changes are grouped by new features. To describe a particular change in CLI, we use the following notations:

• (+) - the specified utility, command, or option is added
• (-) - the specified utility, command, or option is deprecated
• (*) - the specified utility, command, or option is modified

Plesk 12.5

Reassignment of databases between subscriptions

• (*) database utility:

  New command: --assign-to-subscription.

Database user roles and privileges management

• (*) database utility:

  New options: -user-role, -set-privileges.

PHP handlers management

• (*) php_handler utility:

  New commands: --enable, --disable, --get-usage.

Listing mail accounts

• (*) mail utility:

  New command: --list.

Setting an end date for auto-replies

• (*) autoresponder utility:

  New option: -end-date.

Displaying global server settings

• (*) server_pref utility:

  New command: --show.

SSL ciphers and protocols management

• (*) server_pref utility:

  New options: -ssl-protocols, -ssl-ciphers.

Managing server-wide backup limits

• (*) server_pref utility:

  New options: -max-backup-files, -keep-local-backup.

Disabling automatic upgrading of extensions

• (*) server_pref utility:

  New option: -disable-upgrade-extensions.

Enabling and disabling Fail2ban

• (*) ip_ban utility:

  New commands: --enable, --disable.

Retrieving new license keys from KA

• (*) license utility:

  New command: --retrieve.

Managing Plesk locales

• (+) locales utility.

Installing and upgrading extensions via URL

• (*) extension utility:

  New command: --install-url.

Apache MPM mode management

• (+) optimization_settings utility.

Setting PHP-FPM in service plan setting

• (*) service_plan utility:

  New option: -php_served_by_nginx.

Security status of WordPress installations

• (*) wp_instance utility:

  New command: --get-security-status.

Enabling password protection fro site preview

• (*) server_pref utility

  New options: -preview-protection

Plesk 12.0

WordPress toolkit

• (+) wp_instance utility.
• (*) php_handler utility:

  New option: -clipath.

  

IP address banning (Fail2Ban)

• (+) ip_ban utility.

  

Web application firewall (ModSecurity)

• (*) subscription utility:

  New commands: --update-web-app-firewall, --show-web-app-firewall.

  New option: -waf-rule-engine.

• (*) server_pref utility:

  New commands: --update-web-app-firewall, --show-web-app-firewall.

  New options: -waf-rule-engine, -waf-rule-set.

  

Outgoing mail control

• (*) mailserver utility:

  New commands: --enable-outgoing-antispam, --disable-outgoing-antispam, --set-outgoing-messages-mbox-limit, --set-outgoing-messages-domain-limit, --set-outgoing-messages-subscription-limit, --set-outgoing-messages-enable-sendmail, --set-outgoing- messages-report-period, --set-outgoing-messages-notification-period.

  New option: -spf-ignore-dns-error.

• (*) service_plan and subscription_settings utilities:

  New options: -outgoing-messages-mbox-limit, -outgoing-messages-domain-limit, -outgoing-messages-subscription-limit, -outgoing-messages-enable-sendmail.

• (*) mail utility:

  New option: -outgoing-messages-mbox-limit.

• (*) site utility:

  New option: -outgoing-messages-domain-limit.

  

IP addresses to send mail from

• (*) mailserver utility:

  New command: --set-outgoing-email-mode.

  New options: -explicit-ipv4, -explicit-ipv6.

  

Prohibited domain names

• (+) domain_restriction utility.

 

Access control lists for MySQL database users

• (*) subscription_settings utility:

  New option: -remote_db_connection.

• (*) database utility:

  New option: -set-acl, -add-access, -remove-access.

 

Remote access for PostgreSQL database users

• (*) database utility:

  New option: -allow-access-from.

  

Automated migration and transfer of a large number of objects

• (+) migrate utility.

  

Converting reseller accounts to customer accounts

• (*) reseller utility:

  New command: --convert-to-customer.

 

Moving customer accounts to another owner

• (*) customer utility:

  New command: --change-owner.

 

Converting customer accounts to reseller accounts

• (*) customer utility:

  New command: --convert-to-reseller.

 

Custom descriptions of Plesk objects

• (*) reseller, customer, and mail utilities:

  New option: -description.

• (*) site utility:

  New options: -description, -admin-description.

• (*) subscription utility:

  New options: -description, -reseller-description, -admin-description.

  

Preventing customers from using a Plesk server as an FTP storage for Plesk backups

• (*) server_pref utility:

  New command: --allow-local-ftp-backup.

 

Database users’ access to databases

• (*) database utility:

  New options: -database, -any-database.

Clearance of APS applications cache

• (*) aps utility:

  New command: --clear-cache.

 

Restoring selected objects from a backup

• (*) pleskrestore utility:

  New options: -only-mailnames, -only-databases, -only-web-content, -only-sites, -domain-name.

Plesk 11.5

Custom web server settings for websites

• (*) subscription utility:

  New command: --update-web-server-settings.

  New options: -apache-mime-types, -apache-handlers, –ip-deny, -ip-allow, -apache-directory-index, -nginx-transparent-mode, -nginx-serve-static, -nginx-static-extensions, -nginx-serve-php.

 

Status of websites in suspended subscriptions

• (*) subscription, service_plan utilities:

  New option: -unpaid-website-status.

 

External SMTP server for Plesk notifications and outgoing mail generated by scripts

• (*) mailserver utility:

  New command: --update-smtp-settings.

  New options: -smtp-host, -smtp-port, -smtp-login, -smtp-password, -mail-notifications, -smtp-tls, -smtp-allow-users.

 

APS applications settings

• (*) aps utility:

  New options: -db-server, -prefix, -aps-force-updates.

 

Restricting the list of applications available for installation

• (*) customer utility:

  New commands: --add-aps-filter-item, --remove-aps-filter-item, --enable-aps-filter, --disable-aps-filter, --show-aps-filter-info.

  New options: -aps-filter-item-name, -aps-filter-item-value.

• (*) serice_plan_addon utility:

  New commands: --add-aps-filter-item, --remove-aps-filter-item, --show-aps-filter-info.

  New options: -aps-filter-item-name, -aps-filter-item-value.

 

Search engine friendly redirection and forwarding

• (*) subscription, subdomain, site, and domalias utilities:

  New option: -seo-redirect.

• (*) subscription, site utilities:

  New option: -http_code.

 

Multiple PHP versions

• (*) service_plan, service_plan_addon, subscription, subdomain, and site utilities:

  New option: -php_handler_id.

  Deprecated option: -php_handler_type.

 

Custom PHP handlers

• (+) php_handler utility.

 

Mail autoresponder settings

• (*) autoresponder utility:

  New option: -frq.

 

Plesk Administrator account settings

• (*) admin utility:

  New commands: --set-admin-password, --set-password.

  New options: -passwd, -encrypted-password, -plain-password, -remote_access_interface, -manage_server_mailgate, -manage_secure_passwords.

 

Additional Administrator accounts

• (+) admin_alias utility

 

One database user to access all databases

• (*) database utility:

  New commands: --create-dbuser, --update-dbuser, --remove-dbuser.

 

The default database server

• (*) service_plan, subscription_settings utilities:

  New options: -default_server_mysql, -default_server_postgresql.

 

Creating auxiliary users while creating mail accounts

• (*) mail utility:

  New option: -cp-access.

 

Specifying mail accounts and instant messengers for auxiliary users

• (*) user utility:

  New options: -email, -external-email, -im-type, -im.

 

Plesk UI appearance and branding

• (*) branding_theme utility:

  New commands: --set, --list.

  New option: -name.

• (*) panel_gui utility:

  New options: ---billing_enabled.

 

Websites maintenance mode

• (*) subscription, site, subdomain utilities:

  Deprecated option: -maintenance-mode. The Suspended website status is used instead (see the next change).

 

The Suspended status of websites

• (*) subscription, site, subdomain utilities:

  New command: --suspend.

 

Loading Plesk settings from Partner Central

• (*) server_pref utility:

  New command: --load-customizations.

 

Server-wide Plesk settings

• (*) server_pref utility:

  New options: -aps-force-updates, -aps-suggest-updates, -apache-pipelog, -forbid-ftp-user-rename, -forbid-subscription-rename, -ftp-over-ssl, -autoupdates-third-party.

 

Server cloning settings

• (*) cloning utility:

  New options: --reset-init-conf, -skip-update.

 

Access to Control Panel for resellers

• (*) reseller_plan utility:

  Deprecated option: -cp-access.

 

Making copies of service plans, add-on plans, and reseller plans

• (*) service_plan, service_plan_addon, reseller_plan utilities:

  New command: --duplicate.

  New option: -duplicate-name.

 

Domains and domain aliases settings

• (*) subscription, subdomain, site, and domalias utilities:

  New options: -notify, -max-connections, -traffic-bandwidth.

 

Displaying customers and subscriptions in a list

• (*) customer, subscription utilities:

  New command: --list.

Plesk 11.0

Installing the Plesk license key with an activation code

• (*) license utility:
  The --install command now accepts activation codes.

 

Managing Plesk extensions

• (+) extension utility.

  

Improved Plesk security

• (*) server_pref utility.
  New option: -min_password_strength.

 

Cloning Plesk in virtual environments

• (+) cloning utility.

  

Custom buttons improvements

• (*) custombutton utility:
  New parameters for the -place option: admin-settings, reseller-settings.
  New option: -noframe.
• (*) custom_plan_items utility:
  New option: -noframe.

 

Plesk updates improvements

• (*) product_info utility:
  New command: --updates-info.

 

Subscribing to security notifications from Plesk

• (*) init_conf utility:
  New option: -send_tech_announce.

 

Using license bundles (web app licenses associated with a Plesk license)

• (*) service_plan, service_plan_addon, reseller_plan, subscription_settings utilities:
  New option: -allow_license_stubs.

Plesk 10.4

Customizable PHP configuration

• (*) service_plan, service_plan_addon, subscription, subscription_settings, site utilities:
  New commands: --update-php-settings, --show-php-settings
  New options: -settings, -additional-settings

  

Extended overuse options

• (*) service_plan, subscription_settings, reseller_pref, reseller_plan utilities:
  The overuse management options of these utilities now support new value: not_suspend_notify

 

Custom view for administrators

• (*) poweruser utility:
  New options: -simple, -lock
• (*) admin utility:
  New options for fine adjustment of Custom view.

 

Restricting users to access only one subscription

• (*) user utility:
  New options: -subscription-name, -for-all-subscriptions

Support for wildcard subdomains

• (*) subdomain utility:
  The -create command allows to use the asterisk symbol to create wildcard subdomains.

  

Quick preview of a website

• (*) server_pref utility:
  New option: -preview-domain

 

Manage availability of apps from Storefront

• (*) server_pref utility:
  New option: -show-commercial-apps

 

Allowing Subdomains to Have Own DNS Zones

• (*) server_pref utility:
  New option: -subdomain-dns-zone

 

Updating Business Manager administrator's profile

• (+) update-admin utility.

Updating Business Manager company settings

• (+) update-company utility.

Managing Business Manager database connection

• (+) billing-db utility.

Migrating a standalone Plesk Billing database to Business Manager

• (+) migrate-db utility.

Getting Business Manager error information

• (+) get-error-report utility.

Troubleshooting GUI Integration between Business Manager and connected Plesks

• (+) integration utility.

Updating Business Manager configuration and online stores locales and appearance

• (+) cache utility.

Allowing Subdomains to Have Own DNS Zones

• (*) server_pref utility:
  New option: -subdomain-dns-zone

Plesk 10.3

File sharing functionality

• (+) server_filesharing utility.
• (*) role utility:
  New option: -publishFilesOnTheWeb

Plesk 10.2

IPv6 support

• (*) dns and server-dns utilities:

  New option: -aaaa

• (*) subscription utility: -ip option can be used multiple times to specify a list of IPV4 and IPv6 addresses addresses.
• (*) reseller_plan utlity:

  New option: -excl_ipv6_num

Server Name Indication (SNI) support

• (*) domain and subdomain utilities:

  New option: -certificate-name

Note: The following operating systems support SNI: OpenSuSE Linux 11.3 or later, Ubuntu Linux 10.4 or later, Debian Linux 6.0 or later, and RedHat Linux 6.0 or later.For more information on SNI see section Hosting Multiple SSL Sites on a Single IP Address (Linux Hosting) of Administrator's Guide.

Encrypting the administrator's password

• (*) admin utility:

  New command: --show-password

Plesk 10.1

Ability to customize the list of applications available for installation on websites and add links to additional services (external or integrated with Plesk as extensions)

• (+) subscription utility replaces the domain utility and supports new commands and options.

  New commands: --enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info, --add-custom-plan-item, --remove-custom-plan-item, --remove-all-custom-plan-items, --show-custom-plan-items

  New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type, -custom-plan-item-name

• (+) custom_plan_items utility.
• (*) service_plan utility:

  New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info, --add-custom-plan-item, --remove-custom-plan-item, --remove-all-custom-plan-items, --show-custom-plan-items

  New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type, -custom-plan-item-name

• (*) reseller utility:

  New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info

  New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type

• (*) reseller_plan utility replaces the reseller-template utility and supports the following new commands and options.

  New commands: -enable-aps-filter, --add-aps-filter-item, --remove-aps-filter-item, --disable-aps-filter, --show-aps-filter-info

  New options: -aps-filter-item-name, -aps-filter-item-value, -aps-filter-type

Customization of interface appearance and branding settings

• (+) branding_theme utility
• (+) panel_gui utility replaces the interface-template utility and supports the following new options: -domain_registration_url, -domain_management_url, -cert_purchasing_url, -mpc_portal_url

Site maintenance mode

• (*) subscription utility: new option -maintenance-mode.
• (*) subdomain utility: new option -maintenance-mode.

Ability to create trial sites in SiteBuilder

• (*) service_plan utility: new option -upsell_site_builder.

Ability to register an external webmail service with Plesk and use it in hosting plans

• (*) mailserver utility:

  New commands: --add-external-webmail, --update-external-webmail, --remove-external-webmail.

  New options: -webmail-name, -webmail-url, -webmail-status.

Ability to hide mail management functions from Control Panel

• (*) server_pref utility: new option -disable-mail-ui.

Ability to set the default shell for execution of scheduled tasks through cron

• (*) server_pref utility: new option -crontab-secure-shell.

Utilities were renamed to better suit the new hosting model

• The client utility was replaced with the customer utility.
• The domain utility was replaced with the subscription and site utilities.
• The domain_prefs utility was replaced with the subscription_settings utility.
• The domain_template utility was replaced with the service_plan utility.
• The interface_template utility was replaced with the panel_gui utility.
• The reseller-template utility was replaced with the reseller_plan utility.
• The domain_addon_service_plan utility was replaced with the service_plan_addon utility.

Plesk 10.0

Changes in the hosting model and hierarchy of user accounts

• (-) client_template utility.
• (*) client utility: the commands --convert-to-reseller and --change-owner are no longer supported; the options -template, -sb-user, -status, and -force are no longer supported.
• (*) client_pref utility: the command --set-iis-app-pool-settings and options -iis-app-pool-turned-on, -cpu-usage-state, -cpu-usage-value were added; the options -manage dashboard, -max-mg, -desktop-preset, -max_redir, -max_resp, -lock-screen, -desktop-preset are no longer supported.
• (-) domadmin utility.
• (-) domuser utility.
• (*) domain utility: the commands --webspace-status, --lock-subscription, --unlock-subscription, --no-subscription, --switch-subscription, --sync-subscription, --add-subscription, --remove-subscription were added; the options -service-plan, -force-lock, -www-root, -webspace-name, -vendor were added.
• (+) domain_addon_service_plan utility.
• (*) domain_pref utility. The following options were removed: -max_redir, -max_mg, -max_resp.

  The following options were added: -max_site, -max_subftp_users, -max_site_builder, -max_unity_mobile_sites, -create_domains, -manage_phosting, -manage_php_safe_mode, -manage_performance, -manage_sh_access, -manage_quota, -manage_subdomains, -manage_domain_aliases, -manage_log, -manage_anonftp, -manage_subftp, -manage_crontab, -manage_dns, -manage_webapps, -manage_maillists, -manage_spamfilter, -manage_virusfilter, -manage_webstat, -select_db_server, -allow_local_backups, -allow_ftp_backups, -access_appcatalog, -allow_insecure_sites.

  The option -overuse can now take the new parameter not_suspend.

• (+) domain_service_plan utility is intended to replace the utility domain_template.

  In addition to the options previously supported by the domain_template utility, the following new options are now supported: -max_site, -max_subftp_users, -max_site_builder, -max_unity_mobile_sites, -create_domains, -manage_phosting, -manage_php_safe_mode, -manage_performance, -manage_sh_access, -manage_quota, -manage_subdomains, -manage_domain_aliases, -manage_log, -manage_anonftp, -manage_subftp, -manage_crontab, -manage_dns, -manage_webapps, -manage_maillists, -manage_spamfilter, -manage_virusfilter, -manage_webstat, -select_db_server, -allow_local_backups, -allow_ftp_backups, -access_appcatalog, -allow_insecure_sites.

  The option -overuse can now take the new parameter not_suspend.

• (*) ip_pool utility: It now supports only operations on IP addresses assigned to resellers; customers are assigned IP addresses in a different manner, only when hosting subscriptions are created for them.
• (*) mail utility - the following options were removed: -cp-access, -multiple-sessions, -locale, -lines-per-page, -max-button-length, -skin, -lock-screen. The option -forwarding-addresses was added.
• (*) reseller utility. The following commands are now supported: --lock-subscription, --unlock-subscription, --no-subscription, --switch-subscription, --sync-subscription.

  The following new options are now supported: -service-plan, -force-lock.

  The following commands and options are no longer supported: --convert-to-client, -sb-user, -template.

• (*) reseller_pref utility. The following new options are now supported: -access_appcatalog, -allow_insecure_sites, -max_site_builder, -max_subftp_users, -max_unity_mobile_sites.

  The following options are no longer supported: -manage_dashboard, -dashboard, -stdgui, -expiration, -max-redir, -max-mg, -max-resp.

• (+) reseller_service_plan utility is intended to replace the utility reseller_template.

  In addition to the options previously supported by the reseller_template utility, the following new options are now supported: -max_subftp_users, -max_site_builder, -max_unity_mobile_sites, -allow_insecure_sites.

  The option -overuse can now take the new parameter not_suspend.

  The following options are no longer supported: -manage_dashboard, -dashboard, -stdgui, -expiration.

• (+) role utility.
• (+) user utility.
• (*) subdomain utility: the new option -www-root is now supported; the following options are no longer supported: -ftp_user, -hard_quota, -sb_publish, -hst_type.

VPS-optimized mode

• (+) vps_optimized utility.

Power User interface

• (+) poweruser utility.

User interface customization

• (*) interface_template utility: the options -hide_disabled, -hide_unavailable_limits, -hide_unavailable_permissions are no longer supported.

Additional FTP accounts

• (+) ftpsubaccount utility
• (+) client_pref utility: -max-subftp-users option
• (+) client_pref utility: -manage_subftp option
• (+) domadmin utility: -manage_subftp option
• (+) domain_pref utility: -max-subftp-users option
• (+) domain_template utility: -max-subftp-users option
• (+) reseller_pref utility: -max-subftp-users option
• (+) reseller_pref utility: -manage_subftp option
• (+) reseller_template utility: -max-subftp-users option
• (+) reseller_template utility: -manage_subftp option

Changes in Application Catalog

• (-) aps_catalog utility
• (+) aps utility

Changes in settings of mail services

• (*) autoresponder utility: the commands --create, --remove, --attachments, --on, --off are no longer supported; the options -requires, -replyto, -frq, -store, - redirect, -files are no longer supported.
• (*) domain_pref utility - the following options were removed: -max_redir, -max_mg, -max_resp.
• (+) spamassassin utility: new parameter -action move.

E-mail notification about system events

• (+) notification utility.

Plesk 9.5

(+) new options related to integration with Google Services for Websites were added to the admin, reseller, client, and server_pref utilities.

Plesk 9.2

Greylisting

(+) grey_listing utility

Plesk 9.0

APS Catalog

• (+) aps-catalog utility

Plesk resellers

• (+) client utility: --change-owner command
• (+) client utility: --convert-to-reseller command
• (+) client utility: -owner option
• (-) client_pref utility: -ip_pool option
• (+) client_pref utility: -overuse option
• (*) domain utility: --change-owner command
• (-) domain utility: -clogin option
• (*) domain utility: --create command
• (+) domain_pref: -overuse option
• (+) ip_pool utility
• (+) reseller utility
• (+) reseller_pref utility
• (+) reseller_template utility

New utilities

• (+) event_handler utility
• (+) keyinfo utility

Updates of existing utilities:

• (-) client_pref utility: -ip_pool option

• (+) custombutton utility: --list command

•  (*) domain_template utility
  • (-) -fp option
  • (-) -fp_ssl option
  • (-) -fpauth option
  • (+) -miva option

•  (*) domain utility
  • (-) -fplogin option
  • (-) -fppasswd option

Plesk 8.6

Permission to choose a database server for a database

• (+) client_pref utility: -select_db_server option
• (+) client_template utility: -select-db-server option
• (+) domadmin utility: -select_db_server option

Plesk 8.4

DomainKeys support

• (+) domain_pref utility: -sign_outgoing_mail option
• (+) mailserver utility: --sign-outgoing-mail command
• (+) mailserver utility: --verify-incoming-mail command

Permission to create DNS subzones in DNS superzones owned by other Plesk users

• (+) server_pref utility: -forbid-create-dns-subzone option

Plesk 8.3

Limit on maximum number of available connections

• (+) domain utility: -max-connections option

Opportunity to publish sites with Sitebuilder

• (+) domain utility: -publish-sb-site option

Limit on network use

• (+) domain utility: -traffic-bandwidth option

The <webuser_name>@<domain_name> format of access to Plesk

• (-) domain_pref utility: -at-access option

SSO service

• (+) sso utility

Site applications and site application licenses management

• (-) siteapp utility: --add-to-vault command

  Use siteapp-item utility instead.

• (-) siteapp utility: -release option

  Use -sapp-release option instead.

• (-) siteapp utility: -sapp option

  Use -sapp-name option instead.

• (-) siteapp utility: -version option

  Use -sapp-version option instead.

• (+) siteapp utility: -sapp-name option
• (+) siteapp utility: -sapp-release option
• (+) siteapp utility: -sapp-version option
• (+) siteapp-item utility
• (+) siteapp-license utility