> システムを設定する

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

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

イベントハンドラの追加

例えば、’クライアントアカウント作成’イベントのイベントハンドラを作成してみましょう。ハンドラはクライアント名を最初のパラメータとして受け入れ、クライアントのログインを2番目のパラメータとして受け入れます。説明を簡単にするために、以下のような test-handler.sh と呼ばれるシェルスクリプトを使用します:

----------------------------------------------------------------------
#!/bin/bash
echo "--------------" >> /tmp/event_handler.log
/bin/date             >> /tmp/event_handler.log # information on the event date and time
/usr/bin/id           >> /tmp/event_handler.log # information on the user, on behalf of which the script was executed (to ensure control)
echo "client created" >> /tmp/event_handler.log # information on the created client account
echo "name: $1"       >> /tmp/event_handler.log # client's name
echo "login: $2"      >> /tmp/event_handler.log # client's login
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_namenew_login_name必須
連絡名old_contact_namenew_contact_name必須
企業名old_company_namenew_company_name 
電話番号old_phonenew_phone 
Faxold_faxnew_fax 
E-mailold_emailnew_email 
住所old_addressnew_address 
old_citynew_city 
州/県old_state_provincenew_state_province 
郵便番号old_postal_zip_codenew_postal_zip_code 
old_countrynew_country 
’ドメイン作成’、’ドメイン更新’、’ドメイン削除’のイベント
ドメイン名old_domain_namenew_domain_name必須
’サブドメイン作成’、’サブドメイン更新’、’サブドメイン削除’のイベント
サブドメイン名old_subdomain_namenew_subdomain_name必須
親ドメイン名old_domain_namenew_domain_name必須
FTPアカウントold_system_user_typenew_system_user_type 
サブドメインオーナーのログイン名old_system_usernew_system_user 
ハードディスククォータ old_hard_disk_quotanew_hard_disk_quota 
SSI対応 old_ssi_supportnew_ssi_support 
PHP対応 old_php_supportnew_php_support 
CGI対応 old_cgi_supportnew_cgi_support 
Perl対応old_mod_perl_supportnew_mod_perl_support 
Python対応old_mod_python_supportnew_mod_python_support 
ColdFusion対応old_coldfusion_supportnew_coldfusion_support 
Apache ASP対応 old_apache_asp_supportnew_apache_asp_support 
SSL対応 old_ssl_supportnew_ssl_support 
’物理的ホスティング作成’、’物理的ホスティング更新’、’物理的ホスティング削除’のイベント
ドメイン名old_domain_namenew_domain_name必須
IPアドレスold_ip_addressnew_ip_address 
IPタイプold_ip_typenew_ip_type 
システムユーザold_system_usernew_system_user 
システムユーザパスワードold_system_user_passwordnew_system_user_password 
シェルアクセスold_system_shellnew_system_shell 
FP対応 old_fp_supportnew_fp_support 
FP SSL対応 old_fpssl_supportnew_fpssl_support 
FPオーサリングold_fp_authoringnew_fp_authoring 
FP管理者ログインold_fp_admin_loginnew_fp_admin_login 
FP管理者パスワードold_fp_admin_passwordnew_fp_admin_password 
SSI対応 old_ssi_supportnew_ssi_support 
PHP対応 old_php_supportnew_php_support 
CGI対応 old_cgi_supportnew_cgi_support 
Mod Perl対応old_mod_perl_supportnew_mod_perl_support 
Apache ASP対応 old_apache_asp_supportnew_apache_asp_support 
SSL対応 old_ssl_supportnew_ssl_support 
Web統計 old_web_statisticsnew_web_statistics 
カスタムエラードキュメント old_apache_error_documentsnew_apache_error_documents 
ハードディスククォータ old_hard_disk_quotanew_hard_disk_quota 
’物理的ホスティング削除’のイベント
ドメイン名old_domain_namenew_domain_name必須
’メール名作成’、’メール名削除’のイベント
メール名old_mailnamenew_mailname必須(mailname@domain 形式)
’メール名更新’のイベント
メール名old_mailnamenew_mailname必須(mailname@domain 形式)
メールボックスold_mailboxnew_mailbox 
パスワードold_passwordnew_password 
メールボックスクォータ old_mailbox_quotanew_mailbox_quota 
転送old_redirectnew_redirect 
転送アドレスold_redirect_addressnew_redirect_address 
メールグループ old_mail_groupnew_mail_group 
自動応答old_autorespondersnew_autoresponders 
メールユーザコントロールパネルアクセスold_mail_controlpanel_accessnew_mail_controlpanel_access 
’Webユーザ削除’のイベント
ドメイン名old_domain_namenew_domain_name必須
Webユーザ名old_webuser_namenew_webuser_name必須
’Webユーザ作成’、’Webユーザ更新’のイベント
ドメイン名old_domain_namenew_domain_name必須
Webユーザ名old_webuser_namenew_webuser_name必須
Webユーザパスワードold_webuser_passwordnew_webuser_password 
SSI対応 old_ssi_supportnew_ssi_support 
PHP対応 old_php_supportnew_php_support 
CGI対応 old_cgi_supportnew_cgi_support 
Mod Perl対応old_mod_perl_supportnew_mod_perl_support 
Mod Python対応old_mod_python_supportnew_mod_python_support 
Apache ASP対応 old_apache_asp_supportnew_apache_asp_support 
ハードディスククォータ old_hard_disk_quotanew_hard_disk_quota 
’クライアント制限更新’のイベント
連絡名old_contact_namenew_contact_name必須
ドメイン上限数 old_maximum_domainsnew_maximum_domains 
ディスク容量上限old_maximum_disk_spacenew_maximum_disk_space 
Maximum Amount of Trafficold_maximum_trafficnew_maximum_traffic 
Maximum Number of Web Usersold_maximum_webusersnew_maximum_webusers 
データベースの上限数 old_maximum_databasesnew_maximum_databases 
メールボックスの上限数 old_maximum_mailboxesnew_maximum_mailboxes 
メールボックスクォータ old_maximum_mailbox_quotanew_maximum_mailbox_quota 
メール転送の上限数 old_maximum_mail_redirectsnew_maximum_mail_redirects 
メールグループの上限数 old_maximum_mail_groupsnew_maximum_mail_groups 
メール自動応答の上限数 old_maximum_mail_autorespon dersnew_maximum_mail_autorespon ders 
メーリングリストの上限数 old_maximum_mail_listsnew_maximum_mail_lists 
webアプリケーションの上限数 old_maximum_tomcat_web_appli cationsnew_maximum_tomcat_web_appli cations 
有効期限old_expiration_datenew_expiration_date 
’ドメイン制限更新’のイベント
ドメイン名old_domain_namenew_domain_name必須
ディスク容量上限old_maximum_disk_spacenew_maximum_disk_space 
トラフィック上限量 old_maximum_trafficnew_maximum_traffic 
webユーザの上限数 old_maximum_webusersnew_maximum_webusers 
データベースの上限数 old_maximum_databasesnew_maximum_databases 
メールボックスの上限数 old_maximum_mailboxesnew_maximum_mailboxes 
メールボックスクォータ old_maximum_mailbox_quotanew_maximum_mailbox_quota 
メール転送の上限数 old_maximum_mail_redirectsnew_maximum_mail_redirects 
メールグループの上限数 old_maximum_mail_groupsnew_maximum_mail_groups 
メール自動応答の上限数 old_maximum_mail_autorespon dersnew_maximum_mail_autorespon ders 
メーリングリストの上限数 old_maximum_mail_listsnew_maximum_mail_lists 
webアプリケーションの上限数 old_maximum_tomcat_web_appli cationsnew_maximum_tomcat_web_appli cations 
有効期限old_expiration_datenew_expiration_date 
’メーリングリスト作成’、’メーリングリスト更新’、’メーリングリスト削除’のイベント
ドメイン名old_domain_namenew_domain_name必須
メーリングリスト名old_mail_list_namenew_mail_list_name必須
有効なメーリングリストold_mail_list_enablednew_mail_list_enabled 
’コントロールパネルユーザのログイン’、’コントロールパネルユーザのログアウト’のイベント
連絡名old_contact_namenew_contact_name 
’ドメインユーザアカウント更新’のイベント
ドメインユーザにアクセスを許可old_allow_domain_user_accessnew_allow_domain_user_access 
ログイン名old_login_namenew_login_name必須
ドメイン名old_domain_namenew_domain_name必須
連絡名old_contact_namenew_contact_name 
会社名old_company_namenew_company_name 
電話番号old_phonenew_phone 
ファックスold_faxnew_fax 
E-mailold_emailnew_email 
アドレスold_addressnew_address 
都市old_citynew_city 
州/県old_state_provincenew_state_province 
郵便番号old_postal_zip_codenew_postal_zip_code 
old_countrynew_country 
’サイトアプリケーションのインストール’、’サイトアプリケーションの再構築’、’サイトアプリケーションのアンインストール’のイベント
サイトアプリケーションパッケージ名old_site_application_package_ namenew_site_application_package_ name必須
ドメインタイプ(ドメインまたはサブドメイン)old_site_application_domain_typenew_site_application_domain_type必須
インストレーションパス(httpdocs または httpsdocs)old_site_application_directorynew_site_application_directory必須
インストール先ディレクトリ内のインストレーションパスold_site_application_installation_ prefixnew_site_application_installation_ prefix必須
’サイトアプリケーションパッケージのインストール’、’サイトアプリケーションパッケージのアンインストール’のイベント
サイトアプリケーションパッケージ名old_site_application_package_ namenew_site_application_package_ name必須
’サービスの停止、起動、または再起動’のイベント
サービスold_servicenew_service必須
’IPアドレス作成、変更、削除’のイベント
IPアドレスold_ip_addressnew_ip_address必須
IPマスクold_ip_masknew_ip_mask 
インターフェースold_interfacenew_interface 
IPタイプold_ip_typenew_ip_type 
’転送作成、変更、削除’のイベント
ドメイン名old_domain_namenew_domain_name必須
転送タイプold_forwarding_typenew_forwarding_type 
URLold_urlnew_url 
’管理者情報変更’のイベント
ログイン名old_login_namenew_login_name必須
連絡名old_contact_namenew_contact_name 
企業名old_company_namenew_company_name 
電話番号old_phonenew_phone 
ファックスold_faxnew_fax 
E-mailold_emailnew_email 
アドレスold_addressnew_address 
都市old_citynew_city 
州/県old_state_provincenew_state_province 
郵便番号old_postal_zip_codenew_postal_zip_code 
old_countrynew_country 
’サイトアプリケーションのインストール、再構築、アンインストール’のイベント
サイトアプリケーション名old_package_namenew_package_name必須
’クライアントステータス更新’のイベント
連絡名old_contact_namenew_contact_name必須
ログイン名old_login_namenew_login_name必須
ステータスold_statusnew_status 
’クライアント選択設定更新’のイベント
連絡名old_contact_namenew_contact_name必須
ログイン名old_login_namenew_login_name必須
ページのサイズold_lines_per_pagenew_lines_per_page 
インターフェーススキンold_interface_skinnew_interface_skin 
’クライアントのIPプールの変更’のイベント
連絡名old_contact_namenew_contact_name必須
IPアドレスold_ip_addressnew_ip_address必須
ステータスold_statusnew_status 
’クライアントアカウントのディスク容量制限超過’のイベント
ディスク容量制限 old_maximum_disk_spacenew_maximum_disk_space必須
’クライアントアカウントのトラフィック制限超過’のイベント
トラフィック制限old_maximum_trafficnew_maximum_traffic 
’ドメインステータス更新’のイベント
ドメイン名old_domain_namenew_domain_name必須
ドメインステータスold_statusnew_status 
’ドメインのDNSゾーン更新’のイベント
ドメイン名old_domain_namenew_domain_name必須
’ドメインのディスク容量制限超過’のイベント
ディスク容量制限 old_maximum_disk_spacenew_maximum_disk_space 
’ドメインのトラフィック制限超過’のイベント
トラフィック制限old_maximum_trafficnew_maximum_traffic 
’ライセンスキー更新’のイベント
ライセンスキー番号old_licensenew_license必須
ライセンスキーのタイプ(Plesk、追加)old_license_typenew_license_type 
ライセンスキーの名前(追加キー用)old_license_namenew_license_name 

トップへ