PLESK 7.5 RELOADED > システムを構築する

イベントマネージャを使用する

イベントマネージャはPleskと外部システム間のデータ交換の構成に役立つよう設計されたものです。特定のコントロールパネルイベントで実行されるスクリプトを作成し、イベントの処理をトリガーするイベントハンドラを作成します。複数のハンドラを1つのイベントに割り当てることができます。

重要

Plesk管理者はユーザrootの代わりにサーバ上で実行可能なイベントハンドラを作成できます。If you wish to restrict usage of the rootアカウントの使用を制限するには、root.event_handler.lockという名前の空ファイルをロケーション/usr/local/psa/var/に作成します。

イベントハンドラの追加

例えば、’クライアントアカウント作成’イベントのイベントハンドラを作成してみましょう。ハンドラはクライアント名を最初のパラメータとして受け入れ、クライアントのログインを2番目のパラメータとして受け入れます。説明を簡単にするために、以下のような 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: $1"       >> /tmp/event_handler.log # クライアント名
echo "login: $2"      >> /tmp/event_handler.log # クライアントのログイン
echo "--------------" >> /tmp/event_handler.log
----------------------------------------------------------------------

このスクリプトはファイルにある情報をプリントし、その実行を制御します(スクリプトはバックグラウンドモードで実行されるため、stdout/stderrには情報を出力できません)。

スクリプトがディレクトリ /usr/local/psa/bin(例)にある場合を見てみましょう。コントロールパネル経由でイベントハンドラを作成し、スクリプトを登録します。

  1. ナビゲーションペインのサーバショートカットをクリックします。

  2. サーバ管理ページで(イベントマネージャ)アイコンをクリックします。イベントマネージャーページが開きます。

  3. (新しいイベントハンドラを追加)アイコンをクリックします。イベントハンドラ設定ページが表示されます。

  4. [イベント]ドロップダウンボックスでハンドラを割り当てるイベントを選択します。

  5. ハンドラ実行の優先順位を選択するか、カスタム値を指定します。これを実行するには、優先度ドロップダウンリストで[カスタム]を選択して値を入力します。複数のハンドラを1つのイベントに割り当てる場合、異なる優先度(高い値に設定すると優先度も高くなります)でハンドラの実行シーケンスを指定できます。

  6. ハンドラを実行するシステムユーザを選択します。

  7. コマンド入力フィールドで選択したイベントで実行するコマンドラインを指定します。この例では、/usr/local/psa/bin/test-handler.sh <new_contact_name> <new_login_name> です。

  8. [OK]をクリックします。

コマンドラインのうち、括弧でくくった<new_contact_name> と <new_login_name>の部分でパラメータを指定します。ハンドラを実行する前に、作成したクライアントの名前とログインをそれぞれ置き換えます。使用可能なパラメータの完全なリストは次のセクションで提供されます。削除オペレーションでは、new_xxx のパラメータは空白行にする点に注意してください。作成オペレーションでは、old_xxx のパラメータが空白行になります。

Pleskコントロールパネルにログインし新規クライアントを作成するには、[連絡名]フィールドに’Some Client’、[ログイン]フィールドに'some_client'という値を指定してハンドラを呼び出すと、以下のレコードが /tmp/event_handler.log に追加されます。

--------------
	Sat Jun 26 21:46:34 NOVT 2004
	uid=0(root) gid=0(root) groups=0(root)
	client created
	name: Some client
	login: some_client
	--------------

1つ以上のハンドラを指定するには、他のハンドラについても同じアクションを繰り返してください。

イベントハンドラの削除

1つ以上のイベントハンドラを削除するには、ハンドラのリストの該当するチェックボックスをチェックして、[選択を削除]をクリックします。

使用可能なイベントハンドラパラメータテンプレート

イベントハンドラ設定時に使用可能なパラメータテンプレートは以下の表の通りです。

表 2.1.

コンポーネント名/説明 コマンドラインパラメータ
古いコンポーネントの値 新しいコンポーネントの値
’クライアントアカウント作成’、’クライアントアカウント更新’、’クライアントアカウント削除’のイベント
ログイン名 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  
E-mail 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_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  
シェルアクセス 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  
Mod 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 形式)
’メール名更新’のイベント
メール名 old_mailname new_mailname 必須(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ユーザ削除’のイベント
ドメイン名 old_domain_name new_domain_name 必須
Webユーザ名 old_webuser_name new_webuser_name 必須
’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  
Mod Perl対応 old_mod_perl_support new_mod_perl_support  
Mod 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_autorespon ders new_maximum_mail_autorespon ders  
メーリングリストの上限数 old_maximum_mail_lists new_maximum_mail_lists  
Javaアプリケーションの上限数 old_maximum_tomcat_web_appli cations new_maximum_tomcat_web_appli cations  
有効期限 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_autorespon ders new_maximum_mail_autorespon ders  
メーリングリストの上限数 old_maximum_mail_lists new_maximum_mail_lists  
Javaアプリケーションの上限数 old_maximum_tomcat_web_appli cations new_maximum_tomcat_web_appli cations  
有効期限 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  
E-mail 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_site_application_package_ name new_site_application_package_ name 必須
ドメインタイプ(ドメインまたはサブドメイン) old_site_application_domain_type new_site_application_domain_type 必須
インストレーションパス(httpdocs または httpsdocs) old_site_application_directory new_site_application_directory 必須
インストール先ディレクトリ内のインストレーションパス old_site_application_installation_ prefix new_site_application_installation_ prefix 必須
’サイトアプリケーションパッケージのインストール’、’サイトアプリケーションパッケージのアンインストール’のイベント
サイトアプリケーションパッケージ名 old_site_application_package_ name new_site_application_package_ name 必須
’サービスの停止、起動、または再起動’のイベント
サービス old_service new_service 必須
’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  
E-mail 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プールの変更’のイベント
連絡名 old_contact_name new_contact_name 必須
IPアドレス old_ip_address new_ip_address 必須
ステータス old_status new_status  
’クライアントアカウントのディスク容量制限超過’のイベント
ディスク容量制限 old_maximum_disk_space new_maximum_disk_space 必須
’クライアントアカウントのトラフィック制限超過’のイベント
トラフィック制限 old_maximum_traffic new_maximum_traffic  
’ドメインステータス更新’のイベント
ドメイン名 old_domain_name new_domain_name 必須
ドメインステータス old_status new_status  
’ドメインのDNSゾーン更新’のイベント
ドメイン名 old_domain_name new_domain_name 必須
’ドメインのディスク容量制限超過’のイベント
ディスク容量制限 old_maximum_disk_space new_maximum_disk_space  
’ドメインのトラフィック制限超過’のイベント
トラフィック制限 old_maximum_traffic new_maximum_traffic  
’ライセンスキー更新’のイベント
ライセンスキー番号 old_license new_license 必須
ライセンスキーのタイプ(Plesk、追加) old_license_type new_license_type  
ライセンスキーの名前(追加キー用) old_license_name new_license_name  

トップへ