History of Changes in CL Utilities

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

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

Plesk 9.0

APS Catalog

(+) aps-catalog utility

Command line utilities now reside in %plesk_cli% and %plesk_bin% depending on the application scope. For details, see the Getting Started With Command Line Utilities section.

Plesk resellers

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

New utilities

• (+) admin.exe utility
• (+) admin_alias.exe utility
• (+) autoresponder.exe utility
• (+) certificate.exe utility
• (+) dns.exe utility
• (+) dsn.exe utility
• (+) event_handler.exe utility
• (+) siteapp.exe utility
• (+) server_dns.exe utility
• (+) skeleton.exe utility
• (+) tomcat.exe utility
• (+) coldfusion_dsn.exe utility
• (+) hotlink_protection.exe utility
• (+) shared_ssl.exe utility
• (+)traffic.exe utility
• (+)interface_template.exe utility
• (+)cfsetting.exe utility

Removed utilities

• (-) spamassassin_server.exe utility

Updates of existing utilities

• (*) mailserver.exe utility:
  • (+) --set-relay command
  • (+) --set-max-letter-size command
  • (+) --set-message-submission command
  • (+) -auth-type option
  • (+) -lock-time option
  • (+) -submission-ip option

• (*) webuser.exe utility:
  • (*) -quota option

• (*) server_pref.exe utility:
  • (*) --set-default-locale command deprecated
  • (*) --set-default-skin command deprecated
  • (+) --set-default command
  • (+) --templates-list command
  • (+) -locale option
  • (+) -skin option
  • (+) -template option
  • (+) -hostname option
  • (+) -include-logs option
  • (+) -include-mysql-databases option
  • (+) -include-mssql-databases option
  • (+) -include-mailboxes option
  • (+) -include-webapps option
  • (+) -include-maillists option
  • (+) -include-domaindumps option
  • (+) -stat-keep option
  • (+) -traffic-direction option
  • (+) -force-db-prefix option
  • (+) -forbid-create-dns-subzone option
  • (+) -force-db-user-prefix option
  • (+) -db-user-length option
  • (+) -forbid-create-dns-subzone option

• (*) anonftp.exe utility:
  • (*) -incoming-limit option
  • (*) -bandwidth option

• (*) client_pref.exe utility:
  • (+) -manage_dashboard option
  • (+) -locale option
  • (+) -multiple-sessions option
  • (+) -max-button-length option
  • (+) -lock-screen option
  • (+) -desktop-preset option
  • (*) -disk_space option
  • (*) -max_traffic option
  • (*) -mbox_quota option

• (*) client_template.exe utility:
  • (-) -max_db option
  • (+) --xml-info command
  • (+) -sb-user option
  • (-) -site_builder option
  • (-) -use_sbnet option
  • (+) -disk-space option
  • (-) -disk_space option
  • (+) -max-traffic option
  • (-) -max_traffic option
  • (+) -mbox-quota option
  • (-) -mbox_quota option
  • (+) -cp-access option
  • (-) -cp_access option
  • (+) -create-domains option
  • (-) -create_domains option
  • (+) -manage-phosting option
  • (-) -manage_phosting option
  • (+) -manage-sh-access option
  • (-) -manage_sh_access option
  • (+) -manage-quota option
  • (-) -manage_quota option
  • (+) -manage-subdomains option
  • (-) -manage_subdomains option
  • (+) -manage-domain-aliases option
  • (-) -manage_domain_aliases option
  • (+) -manage-log option
  • (-) -manage_log option
  • (+) -manage-anonftp option
  • (-) -manage_anonftp option
  • (+) -manage-crontab option
  • (-) -manage_crontab option
  • (+) -change-limits option
  • (-) -change_limits option
  • (+) -manage-dns option
  • (-) -manage_dns option
  • (+) -manage-webapps option
  • (-) -manage_webapps option
  • (+) -manage-maillists option
  • (-) -manage_maillists option
  • (+) -manage-virusfilter option
  • (-) -manage_virusfilter option

•  (*) client.exe utility:
  • (+) -template option
  • (+) -force option
  • (+) -sb-user option
  • (-) -sb_sync option
  • (+) -status option

•  (*) database.exe utility:
  • (+) --remove-dbs command
  • (+) --remove-dbus command
  • (+) -server option
  • (+) -printid option

•  (*) database-server.exe utility
  • (+) --set-default-server-local command

•  (*) domain_pref.exe utility
  • (+) --set-default command
  • (*) -disk_space option
  • (*) -max_traffic option
  • (*) -mbox_quota option
  • (+) -max_mysql_db option
  • (-) -max_db option
  • (+) -max_odbc option
  • (*) -no_usr option

•  (*) domain_template.exe utility
  • (*) -disk_space option
  • (*) -max_traffic option
  • (*) -mbox_quota option
  • (*) -log_bysize option
  • (*) -quota option
  • (+) -dns_zone_type option
  • (+) -publish-sb-site option
  • (+) -max_mysql_db option
  • (-) -max_db option
  • (*) -no_usr option

•  (*) domain.exe utility
  • (*) --change-owner command
  • (+) -template option
  • (+) -force option
  • (+) -creation-date option
  • (+) -maillist_service option
  • (+) -max-connections option
  • (+) -traffic-bandwidth option
  • (+) -map_ip option
  • (+) -publish-sb-site option
  • (-) -sb_publish option
  • (*) -hard_quota option
  • (*) -log_bysize option
  • (*) -status option
  • (-) -dom_user option
  • (-) -du_passwd option
  • (-) -du_pname option
  • (-) -du_email option
  • (-) -du_language option

•  (*) domalias.exe utility
  • (+) --delete command
  • (-) --remove command
  • (+) --delete-all command
  • (-) --remove-all command

• (*) init_conf.exe utility
  • (+) --check-configured command
  • (+) -zip option
  • (-) -pcode option

• (*) keyinfo.exe utility
  • (+) --xml-info command
  • (+) --reset_ssl_certificate command

• (*) mail.exe utility
  • (+) --update-service command
  • (+) --reset_ssl_certificate command
  • (+) -cp-access option
  • (+) -manage-virusfilter option
  • (+) -manage-spamfilter option
  • (+) -multiple-sessions option
  • (+) -locale option
  • (+) -max-button-length option
  • (+) -skin option
  • (+) -lock-screen option
  • (+) -status option
  • (+) -new option
  • (-) -cp_access option
  • (-) -autorsp option
  • (-) -autoname option
  • (-) -autostatus option
  • (-) -autoreq option
  • (-) -autosubj option
  • (-) -auto_replyto option
  • (-) -autotext option
  • (-) -autoatch option
  • (-) -autofrq option
  • (-) -autostor option
  • (-) -autored option
  • (*) -mbox_quota option
  • (*) -boxquota option

• (*) maillist.exe utility
  • (+) --update-service command
  • (+) --on command
  • (+) --off command
  • (*) -status option

• (*) spamassassin.exe utility
  • (+) --update-server command
  • (+) --info-server command
  • (+) -status option
  • (+) -personal-conf option
  • (+) -max-proc option
  • (+) -reject-spam option
  • (+) -blacklist option
  • (+) -whitelist option
  • (+) -reject-spam option
  • (+) -enable-filtering option
  • (+) -trusted-languages option
  • (+) -trusted-locales option
  • (+) -trusted-networks option
  • (-) -server-conf option
  • (-) -action option
  • (-) -enable-filtering option

• (*) subdomain.exe utility
  • (*) -hard_quota option

Plesk 8.6

Limit on maximum number of ODBC DSN connections

• (+) client_pref.exe: -max_odbc_dsn option
• (+) domain_pref.exe: -max_odbc_dsn option

Permission to choose a database server for a database

• (+) client_pref.exe: -select_db_server option
• (+) client_template.exe: -select_db_server option
• (+) domadmin.exe: -select_db_server option 

Plesk 8.4

Opportunity to create blog and photo subdomains in Sitebuilder upon domain creation in Plesk

• (-) domain.exe: -sb_subdomains_create option
• (-) server_pref.exe:-blog-and-photo option
• (-) domain_template.exe: -sb_subdomains_create option

DomainKeys support

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

Plesk 8.3

Plesk 8.3 for Windows CLI Reference introduces the following new features:

• Choosing Webmail

  It is possible now to choose which Webmail to use on a per-domain basis.

• Managing ASP settings

  The improved utility virtdir.exe allows managing the following ASP settings: specifying the maximum size of ASP buffer and entity body of ASP requests, and enabling/disabling ASP client-side and server-side script debugging.

• Managing Firewall

  The new utility firewall.exe allows managing Windows Firewall as follows: enabling/disabling Windows Firewall and enabling default Firewall rules for a network interface.

• Calculating mailbox usage statistics

  The improved utility statistics.exe allows calculating the amount of disk space used by every mailbox on a specified or all domains.

• Managing SSO service

  The new utility sso.exe allows managing configuration of the single sign-on authentication form as follows: enabling/disabling the SSO service on Plesk server, configuring SSO service and getting SSO service configuration. The utility also allows managing the SSO branding: set, get and remove branded URLs for domains.

Plesk 8.2

Plesk 8.2 for Windows CLI Reference introduces the following new features.

• SQL queries execution

  It is possible now to execute UPDATE and SELECT SQL queries against local or remote Microsoft SQL, MySQL and Jet databases via CLI.

• Restoring mail server configuration

  The current reference now contains a completed description of the mchk.exe utility which allows you to restore mail server configuration basing on the data stored in Plesk database.

• Calculating resources usage statistics

  Improved statistics.exe allows calculating HTTP, FTP traffic and/or disk space usage for selected domains, sending configurable email notifications on exceeding limits, and launching "reached-limit" event actions.

• Configuring Windows security settings of Plesk server, and Plesk hosted objects

  Two brand new utilities ApplySecurity.exe and HostingSecurity.exe make configuring Windows security of the entire Plesk server really easy.

Plesk 8.1.x

Command line utilities in Plesk 8.1 for Windows introduce the following new features.

• Managing domain administrator accounts

  Plesk 8.1 CLI provides a new utility domadmin.exe which serves to manage domain administrators' accounts. This includes editing domain administrator's personal information, viewing information about the domain, setting up the domain management preferences (control panel access and interface features), and domain administrator's permissions.

• Managing additional FTP accounts

  Along with the "main" FTP account created during the setup of physical hosting on a domain, Plesk allows creating additional FTP accounts with adjustable access rights to specific domain folders. Plesk 8.1 introduces the new utility ftpsubaccount.exe which enables Plesk administrator to create and remove additional FTP accounts on domains, change account login credentials, hard disk quota, home directory, and user permissions.

• Managing domain aliases

  The new Plesk 8.1 utility domalias.exe allows creating or deleting domain aliases, viewing information about domain aliases, enabling or disabling Web and mail services on domain aliases.

• Managing client and domain templates

  Plesk client and templates are now managed via CLI, which means that you can create/remove templates, and edit all the templates parameters: limits on resource usage, permissions of a client and domain users, hosting parameters, and so on.

• Managing desktop presets

  The new Plesk task-oriented Desktop design allows Plesk users to access the Plesk pages and functions they need much more quickly. Desktop preset is a specific Desktop configuration used as default for a specific type of Plesk users.

• Managing custom buttons

  Custom buttons pointing to a URL, and custom buttons linked to Web applications can now be created, removed, and edited (interface location, button names, context help messages, and other parameters).

• Managing Database Servers

  The database-server.exe and the database.exe utilities are updated to fully support new Plesk for Windows feature Remote Database Servers, meaning that now you can manage multiple database servers (local and remote) via CLI.

• Server-wide configuration of mail server

  Plesk 8.1.1 introduces new CL utility enabling Plesk administrators to set up server-wide configuration of mail service. Currently, only enabling/disabling check-up of the mailbox passwords in the dictionary is available, but the functionality is going to be extended.

Plesk 7.6x

Command line utilities in Plesk 7.6 and 7.6.1 for Windows introduce the following new features.

• Subscribing for mass mailing of SWsoft

  In Plesk 7.6 for Windows and later, the administrator is allowed to subscribe for mass mailing of SWsoft and to get announcements on new products, the information about discounts, and other useful information.

• ASP.NET version support on domains and subdomains

  Plesk CLI now allows choosing a default version of Microsoft ASP.NET (1.1 and 2.0) for domains and subdomains with ASP.NET support.

• Creating virtual subdomains

  Along with physical subdomains (having their own folder structure not related to the structure of a parent domain), Plesk now provides the opportunity to create virtual subdomains that are physically hosted within the folder structure of the parent domain. This approach allows direct access to resources (applications, etc.) of the parent domain from within a virtual subdomain.

• Creating virtual directories on the site

  This is the newest feature supported in Plesk 7.6.1 for Windows. Now Plesk supports virtual directories created on a site and mapping its physical folders. Virtual directories are provided with flexible access settings, SSL support, ASP.NET support and other useful features.

• Providing support for multiple FrontPage users on a domain

  For domains with FrontPage support, Plesk provides the opportunity to create multiple additional FrontPage user accounts (extra FP accounts created in addition to the one, FP WebAdmin). Once created, these accounts can be managed via the administrator's FP account. Additional FrontPage accounts cannot be deleted by FP WebAdmin.

• Providing remote access to Plesk for a client via XML-based interface

  Plesk can provide a client with an opportunity to create/manage/delete the client's domains programmatically via a special RPC-XML based interface. This feature can be useful for the clients selling domains via the Internet.

• Extended management capabilities for Clients

  The new version of Plesk for Windows provides some additional capabilities of managing clients via CLI. Namely, now the administrator can use CLI to allow/prohibit a client to access the client's Plesk via Control Panel, to manage the client's IIS application pool, to set aliases for the client's domains, to manage the client's hosting performance, and finally, to create and manage additional FTP accounts (a new feature that allows the use of FTP accounts with access permissions for the specified domain folders only) on the client's domains and subdomains.

• Managing SiteBuilder integration support on a Client and Domain

  Plesk supports integration with SWsoft SiteBuilder. Thus, if any version of SiteBuilder is integrated with Plesk and configured properly, creating a new client in Plesk entails creating a SB user associated with this client, which is called synchronization with SiteBuilder. Beginning with version 7.6, Plesk can integrate SiteBuilder v.3.0 or later and the administrator can decide via CLI whether to put a client in sync with SB or to disable SB support for this client.

  In case a given client supports SB (any version), then creating a new domain owned by this client entails creating an empty site and publishing it on the domain. Here Plesk allows the administrator to disable publishing, including via CLI.

  Also, in case a given client supports SB v.3.0 or later, creating a new domain can be accompanied with creating and publishing two related subdomains – blog and photo. The administrator is allowed to enable/disable this option via CLI.

• Managing spam filtering in SpamAssassin

  Now Plesk allows the administrator to enable/disable spam filtering for the specified email box by means of SpamAssassin via CLI.

• Managing server-wide spam filtering in SpamAssassin

  This is also the freshest feature supported in Plesk 7.6.1 for Windows and later. Now Plesk allows the administrator to define spam filtering settings on the server-wide level. These settings can be forcedly applied to all mailboxes of the server either instead of or along with personal spamcheck settings enabled for each mailbox individually.