添加事件处理程序

例如,为“客户帐户创建”事件创建事件处理程序。此处理程序将从环境变量处接收客户名以及该客户的登录名。简单而言,我们将使用一个名为 test-handler.sh 的外壳脚本,如下所示:

#!/bin/bash

echo "--------------" >> /tmp/event_handler.log

/bin/date >> /tmp/event_handler.log # 事件日期和事时间相关信息

/usr/bin/id >> /tmp/event_handler.log # 为确保控制而执行脚本的用户相关信息

echo "client created" >> /tmp/event_handler.log # 已创建的客户帐户相关信息

echo "name:${NEW_CONTACT_NAME}" >> /tmp/event_handler.log # 客户名称

echo "login:${NEW_LOGIN_NAME}" >> /tmp/event_handler.log # 客户登录名

echo "--------------" >> /tmp/event_handler.log

此脚本将某些信息打印到一个文件上,因此我们可以控制其执行(此脚本以后台模式执行,所以我们不能把信息输出到 stdout/stderr)。

假设我们的脚本位于目录 /plesk_installation_directory/bin (例如)。那么我们可以使用控制面板通过创建一个事件处理程序来注册该脚本:

  1. 选择导航窗格中的“服务器”快捷方式。
  2. 单击“控制面板”组中的“事件管理器”图标。
  3. 单击“添加时间管理器”图标。“事件处理程序设置”页面即会打开:
  4. “事件”下拉框中,选择您想要为其分配处理程序的事件。
  5. 为处理程序执行选择优先权,或指定一个自定义值。要执行该操作,请“优先级”下拉列表中选择自定义,然后键入所需值。

    当为单个事件分配多个处理程序时,您可以指定处理程序执行的顺序,并设置不同的优先级(数值越高,优先级越高)。

  6. 选择系统用户(如:"root"用户),代表将要被执行的事件处理程序。
  7. “命令”输入字段中,指定将要在所选事件上执行的命令。 在我们所举示例中它是 /usr/local/psa/bin/test-handler.sh
  8. 单击“确定”

注意:在此脚本中,我们已指定变量 $NEW_CONTACT_NAME 和 $NEW_LOGIN_NAME。在执行处理程序之前,将分别用已创建的客户端的名字和登录名替换它们。可用变量的完整列表将在后面的部分中提供。请记住,通过删除操作,未设置 $NEW_xxx 类型的变量。通过创建操作,未设置 $OLD_xxx 类型的参数。

现在,如果您登录到 Plesk 控制面板并创建了一个新客户(在“联系人姓名”字段中输入“Some Client”,在“登录字段”中输入“some_client”),那么该事件处理程序将被调用,并且以下记录将被添加至 /tmp/event_handler.log 中:

Fri Mar 16 15:57:25 NOVT 2007

uid=0(root) gid=0(root) groups=0(root)

client created

name:Some clientSome client

login: some_clientsome_client

如果您想指定一或多个事件处理程序,请为其他处理程序重复上述操作即可。

设置事件处理程序时可用的参数模板显示在以下表格中:

表。可用的事件处理程序参数模板

组件名称和说明

环境变量名称

 注释

 注释

之前所用的值

新值

“客户帐户创建”事件,“客户帐户更新”事件,“客户帐户删除”事件

 

登录名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

公司名称

OLD_COMPANY_NAME

NEW_COMPANY_NAME

 

 

电话

OLD_PHONE

NEW_PHONE

 

 

传真

OLD_FAX

NEW_FAX

 

 

电子邮件

OLD_EMAIL

NEW_EMAIL

 

 

地址

OLD_ADDRESS

NEW_ADDRESS

 

 

城市

OLD_CITY

NEW_CITY

 

 

省份

OLD_STATE_PROVINCE

NEW_STATE_PROVINCE

 

 

邮编

OLD_POSTAL_ZIP_CODE

NEW_POSTAL_ZIP_CODE

 

 

国家/地区

OLD_COUNTRY

NEW_COUNTRY

 

 

“站点创建”事件,“站点更新”事件,“站点删除”事件

“站点创建”事件,“站点更新”事件,“站点删除”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

“子站点创建”事件,“子站点更新”事件,“子站点删除”事件

“子站点创建”事件,“子站点更新”事件,“子站点删除”事件

子站点名称

OLD_SUBDOMAIN_NAME

NEW_SUBDOMAIN_NAME

要求

要求

父站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

FTP 帐户

OLD_SYSTEM_USER_TYPE

NEW_SYSTEM_USER_TYPE

 

 

子站点管理员的登录名

OLD_SYSTEM_USER

NEW_SYSTEM_USER

 

 

磁盘空间配额

OLD_HARD_DISK_QUOTA

NEW_HARD_DISK_QUOTA

 

 

SSI 支持

OLD_SSI_SUPPORT

NEW_SSI_SUPPORT

 

 

PHP 支持

OLD_PHP_SUPPORT

NEW_PHP_SUPPORT

 

 

CGI 支持

OLD_CGI_SUPPORT

NEW_CGI_SUPPORT

 

 

Perl 支持

OLD_MOD_PERL_SUPPORT

NEW_MOD_PERL_SUPPORT

 

 

Python 支持

OLD_MOD_PYTHON_SUPPORT

NEW_MOD_PYTHON_SUPPORT

 

 

ColdFusion 支持

OLD_COLDFUSION_SUPPORT

NEW_COLDFUSION_SUPPORT

 

 

Apache::ASP 支持

OLD_APACHE_ASP_SUPPORT

NEW_APACHE_ASP_SUPPORT

 

 

SSL 支持

OLD_SSL_SUPPORT

NEW_SSL_SUPPORT

 

 

对于事件“站点别名创建、更新、删除、域名解析修改”

对于事件“站点别名创建、更新、删除、域名解析修改”

站点别名

OLD_DOMAIN_ALIAS_NAME

NEW_DOMAIN_ALIAS_NAME

要求

要求

站点别名打开或关闭

OLD_STATUS

NEW_STATUS

 

 

站点别名的 Web 服务打开或关闭

OLD_DOMAIN_ALIAS_WEB

NEW_DOMAIN_ALIAS_WEB

 

 

站点别名的邮件服务打开或关闭

OLD_DOMAIN_ALIAS_MAIL

NEW_DOMAIN_ALIAS_MAIL

 

 

支持站点别名访问者访问用 Java 写的 web 应用程序(打开或关闭)

OLD_DOMAIN_ALIAS_TOMCAT

NEW_DOMAIN_ALIAS_TOMCAT

 

 

对于“本机站点创建”事件,“本机站点更新”事件

对于“本机站点创建”事件,“本机站点更新”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

IP 地址

OLD_IP_ADDRESS

NEW_IP_ADDRESS

 

 

IP 类型

OLD_IP_TYPE

NEW_IP_TYPE

 

 

系统用户

OLD_SYSTEM_USER

NEW_SYSTEM_USER

 

 

系统用户密码

OLD_SYSTEM_USER_PASSWORD

NEW_SYSTEM_USER_PASSWORD

 

 

Shell 访问

OLD_SYSTEM_SHELL

NEW_SYSTEM_SHELL

 

 

FP 支持

OLD_FP_SUPPORT

NEW_FP_SUPPORT

 

 

FP-SSL 支持

OLD_FPSSL_SUPPORT

NEW_FPSSL_SUPPORT

 

 

FP 创作

OLD_FP_AUTHORING

NEW_FP_AUTHORING

 

 

FP 管理员登录名

OLD_FP_ADMIN_LOGIN

NEW_FP_ADMIN_LOGIN

 

 

FP 管理员密码

OLD_FP_ADMIN_PASSWORD

NEW_FP_ADMIN_PASSWORD

 

 

SSI 支持

OLD_SSI_SUPPORT

NEW_SSI_SUPPORT

 

 

PHP 支持

OLD_PHP_SUPPORT

NEW_PHP_SUPPORT

 

 

CGI 支持

OLD_CGI_SUPPORT

NEW_CGI_SUPPORT

 

 

Perl 支持

OLD_MOD_PERL_SUPPORT

NEW_MOD_PERL_SUPPORT

 

 

Apache ASP 支持

OLD_APACHE_ASP_SUPPORT

NEW_APACHE_ASP_SUPPORT

 

 

SSL 支持

OLD_SSL_SUPPORT

NEW_SSL_SUPPORT

 

 

Web 统计信息

OLD_WEB_STATISTICS

NEW_WEB_STATISTICS

 

 

自定义错误文档

OLD_APACHE_ERROR_DOCUMENTS

NEW_APACHE_ERROR_DOCUMENTS

 

 

磁盘空间配额

OLD_HARD_DISK_QUOTA

NEW_HARD_DISK_QUOTA

 

 

对于“本机站点删除”事件

对于“本机站点删除”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

对于“邮件帐户已创建”、“邮件帐户已删除”事件

对于“邮件帐户已创建”、“邮件帐户已删除”事件

电子邮件地址

OLD_MAILNAME

NEW_MAILNAME

要求(按以下格式 mailname@domain)

要求(按以下格式 mailname@domain)

对于“邮件帐户更新”事件

对于“邮件帐户更新”事件

电子邮件地址

OLD_MAILNAME

NEW_MAILNAME

要求(按以下格式 mailname@domain)

要求(按以下格式 mailname@domain)

邮箱

OLD_MAILBOX

NEW_MAILBOX

 

 

密码

OLD_PASSWORD

NEW_PASSWORD

 

 

邮箱配额

OLD_MAILBOX_QUOTA

NEW_MAILBOX_QUOTA

 

 

转发

OLD_REDIRECT

NEW_REDIRECT

 

 

转发地址

OLD_REDIRECT_ADDRESS

NEW_REDIRECT_ADDRESS

 

 

邮件组

OLD_MAIL_GROUP

NEW_MAIL_GROUP

 

 

自动回复

OLD_AUTORESPONDERS

NEW_AUTORESPONDERS

 

 

邮件用户控制面板访问

OLD_MAIL_CONTROLPANEL_ACCESS

NEW_MAIL_CONTROLPANEL_ACCESS

 

 

“Web 用户删除”事件

“Web 用户删除”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

Web 用户名

OLD_WEBUSER_NAME

NEW_WEBUSER_NAME

要求

要求

对于“Web 用户创建”事件,“Web 用户更新”事件

对于“Web 用户创建”事件,“Web 用户更新”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

Web 用户名

OLD_WEBUSER_NAME

NEW_WEBUSER_NAME

要求

要求

Web 用户密码

OLD_WEBUSER_PASSWORD

NEW_WEBUSER_PASSWORD

 

 

SSI 支持

OLD_SSI_SUPPORT

NEW_SSI_SUPPORT

 

 

PHP 支持

OLD_PHP_SUPPORT

NEW_PHP_SUPPORT

 

 

CGI 支持

OLD_CGI_SUPPORT

NEW_CGI_SUPPORT

 

 

Perl 支持

OLD_MOD_PERL_SUPPORT

NEW_MOD_PERL_SUPPORT

 

 

Python 支持

OLD_MOD_PYTHON_SUPPORT

NEW_MOD_PYTHON_SUPPORT

 

 

Apache ASP 支持

OLD_APACHE_ASP_SUPPORT

NEW_APACHE_ASP_SUPPORT

 

 

磁盘空间配额

OLD_HARD_DISK_QUOTA

NEW_HARD_DISK_QUOTA

 

 

“客户端限制更新”事件

“客户端限制更新”事件

联系人姓名

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

最大站点数量

OLD_MAXIMUM_DOMAINS

NEW_MAXIMUM_DOMAINS

 

 

最大磁盘空间量

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

 

 

最大流量

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

Web 用户的最大数量

OLD_MAXIMUM_WEBUSERS

NEW_MAXIMUM_WEBUSERS

 

 

数据库的最大数量

OLD_MAXIMUM_DATABASES

NEW_MAXIMUM_DATABASES

 

 

邮箱的最大数量

OLD_MAXIMUM_MAILBOXES

NEW_MAXIMUM_MAILBOXES

 

 

邮箱配额

OLD_MAXIMUM_MAILBOX_QUOTA

NEW_MAXIMUM_MAILBOX_QUOTA

 

 

邮件转发的最大数量

OLD_MAXIMUM_MAIL_REDIRECTS

NEW_MAXIMUM_MAIL_REDIRECTS

 

 

邮件组的最大数量

OLD_MAXIMUM_MAIL_GROUPS

NEW_MAXIMUM_MAIL_GROUPS

 

 

邮件自动回复的最大数量

OLD_MAXIMUM_MAIL_AUTORESPONDERS

NEW_MAXIMUM_MAIL_AUTORESPONDERS

 

 

邮件列表的最大数量

OLD_MAXIMUM_MAIL_LISTS

NEW_MAXIMUM_MAIL_LISTS

 

 

最大 Java 应用程序数量

OLD_MAXIMUM_TOMCAT_WEB_APPLICATIONS

NEW_MAXIMUM_TOMCAT_WEB_APPLICATIONS

 

 

过期日期

OLD_EXPIRATION_DATE

NEW_EXPIRATION_DATE

 

 

“站点限制更新”事件

“站点限制更新”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

最大磁盘空间

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

 

 

最大流量

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

最大 web 用户数量

OLD_MAXIMUM_WEBUSERS

NEW_MAXIMUM_WEBUSERS

 

 

最大数据库数量

OLD_MAXIMUM_DATABASES

NEW_MAXIMUM_DATABASES

 

 

最大邮箱数量

OLD_MAXIMUM_MAILBOXES

NEW_MAXIMUM_MAILBOXES

 

 

邮箱配额

OLD_MAXIMUM_MAILBOX_QUOTA

NEW_MAXIMUM_MAILBOX_QUOTA

 

 

最大邮件转发数量

OLD_MAXIMUM_MAIL_REDIRECTS

NEW_MAXIMUM_MAIL_REDIRECTS

 

 

最大邮件组数量

OLD_MAXIMUM_MAIL_GROUPS

NEW_MAXIMUM_MAIL_GROUPS

 

 

最大邮件自动回复数量

OLD_MAXIMUM_MAIL_AUTORESPONDERS

NEW_MAXIMUM_MAIL_AUTORESPONDERS

 

 

最大邮件列表数量

OLD_MAXIMUM_MAIL_LISTS

NEW_MAXIMUM_MAIL_LISTS

 

 

最大 java 应用程序数量

OLD_MAXIMUM_TOMCAT_WEB_APPLICATIONS

NEW_MAXIMUM_TOMCAT_WEB_APPLICATIONS

 

 

过期时间

OLD_EXPIRATION_DATE

NEW_EXPIRATION_DATE

 

 

“邮件列表创建”事件,“邮件列表更新”事件,“邮件列表删除”事件

“邮件列表创建”事件,“邮件列表更新”事件,“邮件列表删除”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

邮件列表名

OLD_MAIL_LIST_NAME

NEW_MAIL_LIST_NAME

要求

要求

邮件列表已启用。

OLD_MAIL_LIST_ENABLED

NEW_MAIL_LIST_ENABLED

 

 

“控制面板用户登录”事件,“控制面板用户注销”事件

“控制面板用户登录”事件,“控制面板用户注销”事件

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

 

 

对于“站点管理员帐户更新”事件

对于“站点管理员帐户更新”事件

允许站点管理员访问

OLD_ALLOW_DOMAIN_USER_ACCESS

NEW_ALLOW_DOMAIN_USER_ACCESS

 

 

登录名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

联系人姓名

OLD_CONTACT_NAME

NEW_CONTACT_NAME

 

 

公司名称

OLD_COMPANY_NAME

NEW_COMPANY_NAME

 

 

电话

OLD_PHONE

NEW_PHONE

 

 

传真

OLD_FAX

NEW_FAX

 

 

电子邮件

OLD_EMAIL

NEW_EMAIL

 

 

地址

OLD_ADDRESS

NEW_ADDRESS

 

 

城市

OLD_CITY

NEW_CITY

 

 

省份

OLD_STATE_PROVINCE

NEW_STATE_PROVINCE

 

 

邮编

OLD_POSTAL_ZIP_CODE

NEW_POSTAL_ZIP_CODE

 

 

国家/地区

OLD_COUNTRY

NEW_COUNTRY

 

 

对于“站点应用程序安装”事件,“站点应用程序重新配置”事件,“站点应用程序卸载”事件

对于“站点应用程序安装”事件,“站点应用程序重新配置”事件,“站点应用程序卸载”事件

站点应用程序包名称

OLD_PACKAGE_NAME

NEW_PACKAGE_NAME

要求

要求

站点类型(站点或子站点)

OLD_DOMAIN_TYPE

NEW_DOMAIN_TYPE

要求

要求

安装路径(httpdocs 或 httpsdocs)

OLD_DIRECTORY

NEW_DIRECTORY

要求

要求

在目标目录中的安装路径

OLD_INSTALLATION_PREFIX

NEW_INSTALLATION_PREFIX

要求

要求

对于“站点应用程序包安装”事件,“站点应用程序包卸载”事件

对于“站点应用程序包安装”事件,“站点应用程序包卸载”事件

站点应用程序包名称

OLD_PACKAGE_NAME

NEW_PACKAGE_NAME

要求

要求

“服务停止、开始或重启”事件

“服务停止、开始或重启”事件

服务

OLD_SERVICE

NEW_SERVICE

要求

要求

“IP 地址创建、更改或删除”事件

“IP 地址创建、更改或删除”事件

IP 地址

OLD_IP_ADDRESS

NEW_IP_ADDRESS

要求

要求

IP 掩码

OLD_IP_MASK

NEW_IP_MASK

 

 

接口

OLD_INTERFACE

NEW_INTERFACE

 

 

IP 类型

OLD_IP_TYPE

NEW_IP_TYPE

 

 

对于“转发创建、更改和删除”事件

对于“转发创建、更改和删除”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

转发类型

OLD_FORWARDING_TYPE

NEW_FORWARDING_TYPE

 

 

URL

OLD_URL

NEW_URL

 

 

对于“管理员信息更改”事件

对于“管理员信息更改”事件

登录名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

 

 

公司名称

OLD_COMPANY_NAME

NEW_COMPANY_NAME

 

 

电话号码

OLD_PHONE

NEW_PHONE

 

 

传真

OLD_FAX

NEW_FAX

 

 

电子邮件

OLD_EMAIL

NEW_EMAIL

 

 

地址

OLD_ADDRESS

NEW_ADDRESS

 

 

城市

OLD_CITY

NEW_CITY

 

 

省份

OLD_STATE_PROVINCE

NEW_STATE_PROVINCE

 

 

邮编

OLD_POSTAL_ZIP_CODE

NEW_POSTAL_ZIP_CODE

 

 

国家/地区

OLD_COUNTRY

NEW_COUNTRY

 

 

对于“站点应用程序安装、重新配置、卸载”事件

对于“站点应用程序安装、重新配置、卸载”事件

站点应用程序名称

OLD_PACKAGE_NAME

NEW_PACKAGE_NAME

要求

要求

对于“客户端状态更新”事件

对于“客户端状态更新”事件

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

登录名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

状态

OLD_STATUS

NEW_STATUS

 

 

对于“客户首选项更新”事件

对于“客户首选项更新”事件

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

登录名

OLD_LOGIN_NAME

NEW_LOGIN_NAME

要求

要求

页面大小

OLD_LINES_PER_PAGE

NEW_LINES_PER_PAGE

 

 

界面外观

OLD_INTERFACE_SKIN

NEW_INTERFACE_SKIN

 

 

对于“客户 IP 池更改”事件

对于“客户 IP 池更改”事件

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

IP 地址

OLD_IP_ADDRESS

NEW_IP_ADDRESS

要求

要求

状态

OLD_STATUS

NEW_STATUS

 

 

对于“已达到此客户帐号磁盘空间的上限”事件

对于“已达到此客户帐号磁盘空间的上限”事件

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

磁盘空间限制

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

要求

要求

对于“已达到此客户帐户的流量上限”事件

对于“已达到此客户帐户的流量上限”事件

联系人

OLD_CONTACT_NAME

NEW_CONTACT_NAME

要求

要求

流量限制

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

对于“站点状态更改”事件

对于“站点状态更改”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

站点状态

OLD_STATUS

NEW_STATUS

 

 

对于“站点域名解析更新”事件

对于“站点域名解析更新”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

对于“已达到站点磁盘空间上限”事件

对于“已达到站点磁盘空间上限”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

磁盘空间限制

OLD_MAXIMUM_DISK_SPACE

NEW_MAXIMUM_DISK_SPACE

 

 

“已达到此站点流量上限”事件

“已达到此站点流量上限”事件

站点名称

OLD_DOMAIN_NAME

NEW_DOMAIN_NAME

要求

要求

流量限制

OLD_MAXIMUM_TRAFFIC

NEW_MAXIMUM_TRAFFIC

 

 

“许可证更新”事件

“许可证更新”事件

许可证号

OLD_LICENSE

NEW_LICENSE

要求

要求

许可证类型(Plesk,其他)

OLD_LICENSE_TYPE

NEW_LICENSE_TYPE

 

 

许可证名称(对于其他许可证)

OLD_LICENSE_NAME

NEW_LICENSE_NAME