Calendar Server の設定パラメータは、ics.conf および counter.conf などの設定ファイルに格納されます。
この章で説明する内容は次のとおりです。
Calendar Server の設定パラメータは、次のファイルに格納されます。
/etc/opt/SUNWics5/config/ics.conf
ics.conf ファイルは ASCII テキスト形式のファイルで、各行にパラメータとその値が定義されています。パラメータの初期化は、Calendar Server のインストール時に行われます。インストール後は、テキストエディタでファイルを編集できます。
ics.conf ファイル内のパラメータ設定の変更は、Sun のマニュアルで解説されている場合、またはカスタマサポート担当者からの指示があった場合にだけ行なってください。
例: Calendar Server はリモート管理をサポートしていません。service.admin.port パラメータの値はすでに Calendar Server によって適切な値に設定されているので、変更しないでください。この値を変更すると、csadmind プロセスが正常に実行されないことがあります。
Calendar Server が稼動しているシステムの管理者権限を持つユーザーとしてログインします。
ics.conf ファイルが格納されている /etc/opt/SUNWics5/config ディレクトリに移動します。
vi などのテキストエディタを使用して ics.conf ファイルのパラメータを編集します。パラメータの表記規則は次のとおりです。
すべてのパラメータは小文字のみで記述します。
パラメータとその値は等号 (=) で区切り、等号の前後には空白文字を挿入します。次に例を示します。
service.http.idletimeout = "120"
パラメータの値は二重引用符 (" ") で囲む必要があります。パラメータが複数の値をとれる場合は、値文字列全体を二重引用符で囲みます。次に例を示します。
calstore.calendar.owner.acl= "@@o^a^rsf^g;@@o^c^wdeic^g"
コメント行の先頭文字は感嘆符 (!) です。コメント行は情報の提供だけを目的とし、Calendar Server からは無視されます。
一部のパラメータはコメントとして記録されており、先頭に 1 つまたは 2 つの感嘆符 (! または !!) が付けられています。このようなパラメータを使用するには、感嘆符を削除し、必要に応じて値を指定します。 また、新しいパラメータが適用されるように Calendar Server を再起動する必要があります。
たとえば、!!caldb.dwp.server.[ hostname].ip を使用するには、先頭の感嘆符(!!) を削除し、hostname の部分に値を指定してから Calendar Server を再起動します。
ics.conf ファイルに記録されていないパラメータを使用するには、パラメータとその値をファイルに追加します。
同じパラメータを複数回記録した場合、リストの最後にあるパラメータの値が、それ以前のパラメータに優先して適用されます。
すべてのオプションは行頭から始める必要があります。
ics.conf ファイルでパラメータを変更したら、新しい設定値が適用されるように Calendar Server を停止し、再起動します。
ics.conf ファイルの編集前に Calendar Server を停止しておくこともできます。詳細は、「Calendar Server の起動と停止」を参照してください。
ics.conf ファイルには次の設定パラメータが記録されています。
次の表は、ローカル設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–1 ics.conf ファイルのローカル設定用パラメータ
次の表は、カレンダストア設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–2 ics.conf ファイルのカレンダストア設定用パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"anonymous" |
匿名ログインに使用されるカレンダ ID (calid)。 |
|
"yes" |
カレンダの作成時に、ユーザーカレンダの同一時間帯に複数の予定をスケジューリングできるように設定するかどうかを指定します。
|
|
"@@o^a^r^g; @@o^c^wdeic^g; @^a^fs^g; @^c^^g; @^p^r^g" |
ユーザーがカレンダを作成したときに使用されるデフォルトのアクセス制御設定を指定します。形式は、ACE (アクセス制御エントリ) 引数をセミコロンで区切ったリスト形式の文字列です。 ACE の形式については、「カレンダのアクセス制御」を参照してください。 コマンド行ユーティリティーを使用して 1 つ以上の ACE (アクセス制御エントリ) を指定する方法については、「cscal」を参照してください。 |
|
"@@o^a^rsf^g; @@o^c^wdeic^g" |
カレンダ所有者のデフォルトのアクセス制御設定を指定します。 |
|
calstore.calendar.create. lowercase |
"no" |
カレンダの新規作成時、または LDAP CLD プラグインを使用してカレンダを検索する場合に、Calendar Server がカレンダ ID (calid) を小文字に変換するかどうかを指定します。 |
"America/ New_York" |
次の状況で使用するタイムゾーン ID。
|
|
"yes" |
Calendar Server が、非公開の、および時刻と日付のみが公開される (極秘の) 予定と作業をフィルタリング (認識) できるかどうかを指定します。"no" に設定すると、Calendar Server はそれらを公開の予定および作業と同様に扱います。 |
|
defaultcalendar |
"yes" |
ユーザーのデフォルトカレンダを、そのユーザーの空き/予定ありカレンダリストに含めるかどうかを指定します。 |
defaultcalendar |
"no" |
ユーザーのデフォルトカレンダを、そのユーザーの空き/予定ありカレンダリストから削除できるかどうかを指定します。 |
"0" |
予定を拡張するときに、LDAP グループで許可される最大出席者数。"0" の値はグループ全体を拡張することを意味します。 |
|
"60" |
定期拡張で作成できる予定の最大数。 |
|
defaultcalendar |
"yes" |
ユーザーのデフォルトカレンダを、そのユーザーの登録済みカレンダリストに含めるかどうかを指定します。 |
defaultcalendar |
"no" |
ユーザーのデフォルトカレンダを、そのユーザーの登録済みカレンダリストから削除できるようにするかどうかを指定します。 |
"200" |
ユーザー検索の LDAP ルックアップで返される結果の最大数。値 "0" は制限のないことを意味します。 |
|
fmt1.type |
"uid" |
予定の出席者についてディレクトリルックアップを行うときに、jdoe や jdoe:tv などの文字列を Calendar Server がどのように扱うかを指定します。設定できる値は、次のとおりです。uid、cn、gid、 res、mailto、cap。 |
fmt2.type |
"mailto" |
Calendar Server が予定の出席者についてディレクトリルックアップを行うときに、jdoe@sesta.com などのアットマーク (@) を含む文字列をどのように扱うかを指定します。設定できる値は、次のとおりです。uid、cn、gid、res、mailto、cap。 |
fmt3.type |
"cn" |
予定の出席者についてディレクトリルックアップを行うときに、john doe などの空白文字を含む文字列を Calendar Server がどのように扱うかを指定します。設定できる値は、次のとおりです。uid、cn、gid、res、cap。 |
"." |
カレンダ情報が格納される一次ディスクパーティションの場所。 |
次の表は、カレンダログ設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–3 ics.conf ファイルのカレンダログ設定用パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"admin.log" |
ログ記録管理ツール用のログファイルの名前。 |
|
"0" |
ログバッファーのサイズ (バイト単位)。 |
|
"dwp.log" |
DWP (データベースワイヤプロトコル) に関する情報のログ記録管理ツール用ログファイルの名前。 |
|
"604800" |
ログファイルの有効期限 (秒単位)。 |
|
"60" |
バッファーの内容をログファイルにフラッシュする間隔 (秒単位)。 |
|
"http.log" |
cshttpd サービスの現在のログファイルの名前。 |
|
"httpd.access" |
現在の HTTP アクセスログファイルの名前。 |
|
"logs" |
ログファイルが格納されるディレクトリ。 |
|
"NOTICE" |
サーバーがログに記録する情報の詳細度を指定します。各ログレベルには、次のいずれかのレベルが割り当てられます。CRITICAL、ALERT、ERROR、WARNING、NOTICE、INFORMATION、DEBUG。 |
|
"10" |
ログディレクトリ内のログファイルの最大数。 |
|
"2097152" |
各ログファイルの最大サイズ (バイト単位)。 |
|
"20971520" |
すべてのログファイルの最大合計ディスク容量 (バイト単位)。 |
|
"5242880" |
ログ記録用に必要な最小ディスク空き容量 (バイト単位)。 |
|
"notify.log" |
csnotifyd サービスのログファイル名。 |
|
"86400" |
ログファイルのローテーション間隔 (秒単位)。 |
次の表は、管理者に関する ics.conf パラメータを示しています。
表 E–4 管理者の構成パラメータ
次の表は、各種のサービス設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–5 ics.conf ファイルのサービス設定用パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"yes" |
管理ツールのアラーム通知を有効 ("yes")、または無効 ("no") にします。 |
|
"yes" |
"yes" に設定すると、csadmind データベースチェックポイントスレッドが開始されます。 |
|
"8388608" |
管理セッション用の Berkeley データベースの最大キャッシュサイズ (バイト単位)。 |
|
"yes" |
"yes" に設定すると、csadmind データベースデッドロック検出スレッドが開始されます。 |
|
"no" |
"yes" に設定すると、csadmind ディスク容量低下監視スレッドが開始されます。 |
|
"yes" |
"yes" に設定すると、すべてのサービスを開始するときに csadmind サービスを開始し、すべてのサービスを終了するときに csadmind サービスを終了します。 |
|
"120" |
csadmind で HTTP 接続をタイムアウトにするまでの秒数。 |
|
"100" |
許容される管理セッションの最大数。 |
|
"10" |
1 管理セッションで実行されるスレッドの最大数。 |
|
なし |
同時に実行可能な管理プロセスの最大数。 |
|
service.admin.port 注意 |
なし |
システムによって設定されます。変更しないでください。 |
"900" |
管理接続をタイムアウトにするまでの秒数。 |
|
"no" |
"yes" に設定すると、csadmind サービス応答スレッドが開始されます。 |
|
" " |
管理セッション要求用の一時ディレクトリ。 |
|
"1800" |
csadmind で HTTP セッションをタイムアウトにするまで待機する秒数。 |
|
"2" |
カレンダサービスの状態 (稼動、終了、待機) を調べる間隔 (秒単位)。 |
|
"300" |
カレンダサービスが開始するまで待機する秒数。 |
|
"300" |
カレンダサービスが終了するまで待機する秒数。 |
|
"60" |
カレンダサービスに終了コマンドを送信するまで待機する秒数。 |
|
"o=internet" |
ディレクトリ内の DC ツリーのルートサフィックス。 |
|
"no" |
"yes" に設定すると、HTTP アクセスが許可されるかどうかについて DNS に対してクライアント IP アドレスがチェックされます。 |
|
"0" |
プレーンテキスト形式のパスワードによるユーザーの認証に成功した後の遅延時間 (秒単位)。 |
|
"calmaster" |
この Calendar Server の管理権限を持つユーザー ID を空白文字で区切って指定します。 |
|
"no" |
"yes" に設定すると、プロキシ経由のログインが許可されます。 |
|
"yes" |
"yes" に設定すると、匿名アクセス (認証なし) が許可されます。これは特殊なタイプのログインであり、指定した制限付きのアクセス (通常は公開カレンダへの読み取り専用アクセス) のみが許可されます。 |
|
"" (Null) |
HTML ドキュメントを取得するための HTTP ホスト。 |
|
"yes" |
cookie をサポートするかどうかをサーバーに指示します ("yes" または "no")。シングルサインオンを有効にするには、"yes" を指定する必要があります。 |
|
"8388608" |
HTTP セッション用の Berkeley データベースの最大キャッシュサイズ。 |
|
"" (Null) |
" " 以外を指定した場合は、TCP ドメインに基づくフィルタリングによってアクセスが許可されます。たとえば、「ALL:LOCAL.sesta.com」と指定した場合は、sesta.com ドメインのすべてのユーザーによるローカル HTTP アクセスが許可されます。複数のフィルタを指定する場合は、CR-LF (改行) で区切ります。 |
|
"" (Null) |
" " 以外を指定した場合は、TCP ドメインに基づくフィルタリングによってアクセスが拒否されます。たとえば、「ALL:LOCAL.sesta.com」と指定した場合は、sesta.com ドメインのすべてのユーザーによる HTTP アクセスが拒否されます。複数のフィルタを指定する場合は、CR-LF (改行) で区切ります。 |
|
"." |
インポートされたファイルが一時的に格納されるディレクトリの local.queuedir への相対パス (指定する場合は絶対パス)。 |
|
"yes" |
"yes" を指定すると、既存のセッションを参照するすべての要求は、同じ IP アドレスから発せられているものとして検証されます。 |
|
"yes" |
"yes" を指定すると、すべてのサービスを開始するときに cshhpd サービスを開始し、すべてのサービスを終了するときに cshhpd サービスを終了します。 |
|
"120" |
HTTP 接続をタイムアウトにするまでの秒数。 |
|
"yes" |
"yes" を指定すると、認証用の LDAP 接続とユーザー設定が作成、維持されます。 |
|
"INADDR_ANY" |
HTTP サービスがクライアント要求を待機する TCP アドレスを指定します。"INADDR_ANY" は任意のアドレスを意味します。 |
|
"no" |
"yes" を指定すると、サーバーへの HTTP 接続が完全にログに記録されます。 |
|
"5000" |
cshttpd サービスでの HTTP セッションの最大数。 |
|
"20" |
cshttpd サービスでの HTTP 要求を処理するスレッドの最大数。 |
|
"1" |
サーバーでの実行が必要な HTTP サービス (cshttpd) プロセスの最大並行実行数。 複数の CPU を持つサーバーについては、「複数 CPU 間でのロードバランスの使用」を参照してください。 |
|
"80" |
Calendar Server ユーザーからの HTTP 要求用のポート。 |
|
"" |
"" 以外を指定した場合は、TCP ドメインに基づくフィルタリングによってプロキシログインが許可されます。構文は service.http.domainallowed と同じです。 |
|
"900" |
HTTP セッションをタイムアウトにするまでの秒数。 |
|
"http" |
HTTP セッション用の一時ディレクトリ。 |
|
"1800" |
cshttpd サービスで HTTP セッションをタイムアウトにするまでの秒数。 |
|
" " |
実行可能ファイルへのすべての URL 参照が格納されるディレクトリの、実行可能ファイルに対する相対パス。 |
|
service.http.tmpdir |
実行可能ファイルへのすべての URL 参照が格納されるディレクトリの、実行可能ファイルに対する相対パス。 デフォルトは次のとおりです。"/var/opt/SUNWics5/tmp" |
|
"html" |
デフォルトのカレンダクライアントが格納されるディレクトリ。WCAP アクセスだけを許可する場合は "" を指定します。 |
|
"no" |
"yes" を指定すると、LDAP SDK でキャッシュが使用されます。 |
|
"30" |
service.ldapmemcache に "yes" を指定した場合に、この値は LDAP SDK に渡されます。これは項目をキャッシュしておける最大秒数です。0 を指定した場合、項目をキャッシュしておける時間に制限が適用されなくなります。 |
|
"131072" |
service.ldapmemcache に "yes" を指定した場合に、この値は LDAP SDK に渡されます。これはキャッシュに使用できるメモリーの最大容量 (バイト単位) です。0 を指定した場合、キャッシュ容量の制限は適用されなくなります。 |
|
.allowpubliccalendarwrite |
"yes" |
"yes" を指定すると、書き込み可能な公開カレンダに対する匿名ユーザーによる書き込みが許可されます。 |
"text/calendar" |
現在は空き/予定ありだけに適用されているコマンドのデフォルトの出力形式を指定します。 |
|
"30" |
get_freebusy の範囲指定の開始時刻に適用される、現在時刻からのデフォルトのオフセットを指定します。 |
|
"30" |
get_freebusy の範囲指定の終了時刻に適用される、現在時刻からのデフォルトのオフセットを指定します。 |
|
service.wcap.freebusy.redirecturl |
““ |
移行プロセスの場合、移行が部分的に行われると、カレンダが元のデータベースと Calendar Server のターゲットデータベースに分かれます。カレンダが Calendar Server データベースに見つからない場合に検索するための元のデータベースの URL です。 |
"yes" |
"yes" を指定すると、カレンダの作成が許可されます。 |
|
"yes" |
"yes" を指定すると、カレンダの削除が許可されます。 |
|
"no" |
"yes" を指定すると、このサーバー経由でのユーザーによるパスワードの変更が許可されます。 |
|
allowpublicwritablecalendars |
"yes" |
"yes" を指定すると、ユーザーは、書き込み可能な公開カレンダを所有できます。 |
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "cn" (LDAP ユーザーの共通名) の変更が許可されます。 |
|
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "givenname" (LDAP ユーザーの名 (姓名の名)) の変更が許可されます。 |
|
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "icsCalendar" (ユーザーのデフォルトカレンダ ID) の変更が許可されます。 |
|
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "mail" (ユーザーの電子メールアドレス) の変更が許可されます。 |
|
.preferredlanguage |
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "preferredlanguage" (LDAP ユーザーの選択言語) の変更が許可されます。 |
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "sn" (LDAP ユーザーの姓) の変更が許可されます。 |
|
"no" |
"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "nswccalid" (ユーザーのデフォルトカレンダ ID) の変更が許可されます。 |
|
"no" |
"yes" を指定すると、ユーザーのデフォルトカレンダは公開読み取り/非公開書き込みに初期設定されます。"no" を指定すると、ユーザーのデフォルトカレンダは非公開読み取り/非公開書き込みに初期設定されます。 |
|
"no" |
"yes" を指定すると、get_userprefs.wcap コマンドの LDAP プロキシ認証が有効になります。"no" を指定すると、匿名の LDAP 検索が行われます。 |
|
"no" |
"yes" を指定した場合、サーバーはディレクトリ内に存在するカレンダの各所有者を検証する必要があります (LDAP、または CSAPI 互換のユーザーディレクトリメカニズムを使用)。 |
|
"3.0" |
WCAP のバージョン。 |
次の表は、ics.conf の SSL 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。SSL パラメータのほとんどはデフォルト値を使用しますが、2 つのパラメータには SSL のデフォルト値を次のように変更する必要があります。
service.http.ssl.usessl = “yes”
service.http.ssl.port.enable = “yes”
次の表に、ics.conf パラメータとそのデフォルト設定を示します。ics.conf パラメータに適切な値が設定されているかどうかを確認してください。
表 E–6 SSL の設定パラメータ
次の表は、ホストされた (仮想) ドメインの設定用パラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–7 ホストされたドメインをサポートするための設定パラメータ
次の表は、アラーム通知サーバー設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–8 ics.conf ファイルのアラーム通知設定用パラメータ
次の表は、カレンダ検索データベース (CLD) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–9 ics.conf ファイルのカレンダ検索データベース (CLD) 設定パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"n" |
カレンダ検索プラグインを有効 ("y") または無効 ("n") にします。 |
|
"*" |
ロードするカレンダ検索プラグインの名前を指定します。この値にアスタリスク ("*") を指定すると、Calendar Server はすべてのプラグインをロードします。 |
|
"local" |
使用する CLD プラグインの種類を指定します。 "local" は、Calendar Server が稼動するローカルサーバーにすべてのカレンダが格納され、プラグインをロードしないことを指定します。 "directory" は、LDAP CLD プラグインを指定します。 目的のカレンダを格納しているサーバーは、カレンダ所有者の icsDWPHost LDAP 属性を使用して特定されます。 |
|
" " |
LDAP サーバーデータベース内のユーザーまたはリソースのカレンダエントリが icsDWPHost 属性を持たない場合に、Calendar Server が使用するデフォルトの DWP サーバーの名前を完全修飾名で指定します。 Communications Express 経由、または WCAP コマンドを使用して Calendar Server にログインするユーザーが icsDWPHost 属性を持たない場合、Calendar Server はこのパラメータを使用して属性の自動プロビジョニングを行います。 ユーザーがすでに icsDWPHost 属性を持っている場合は、caldb.dwp.server.default は使用されません。 この名前は、DNS (ドメイン名サービス) によって有効な IP アドレスに解決できる必要があります。 |
|
"yes" |
カレンダ検索データベース (CLD) のキャッシュオプションを有効 ("yes") または無効 ("no") にします。LDAP CLD プラグインのパフォーマンスを最適にするには、"yes" を指定します。 |
|
"10" |
チェックポイントファイルの最大サイズを M バイト単位で指定します。 |
|
"4" |
共有メモリーのサイズを M バイト単位で指定します。 |
|
"1000" |
データベーススレッドの最大数を指定します。 |
|
"." |
CLD キャッシュオプションのデータベース予定、作業、アラームファイルの場所を指定します。デフォルト値の "." を指定した場合、これらのファイルは /var/opt/SUNWics5/csdb/cld_cache ディレクトリに格納されます。 |
|
"60" |
チェックポイントの間隔を秒単位で指定します。 |
|
"yes" |
CLD キャッシュオプション用に同期されたあとにチェックポイントファイルを削除するかどうかを指定します。 |
|
caldb.dwp.server.host-name .ip |
" " |
カレンダデータベースを格納するサーバーのホスト名を指定します。このサーバーでは、DWP (csdwpd) サービスが稼動している必要があります。この名前は、DNS (ドメイン名サービス) によって有効な IP アドレスに解決できる必要があります。このパラメータには、LDAP CLD プラグインによって使用されます。 注: パラメータの各部で同じ host-name を完全修飾名で指定します。次に例を示します。 caldb.dwp.server.sesta.com.ip="sesta.com" |
"1" |
サーバーが新しいネットワーク接続を獲得する前にバックログされる要求の最大数。 |
|
"2" |
DWP (データベースワイヤプロトコル) サービスクライアントが各 DWP サービスホストに対して確立する接続の初期数。 |
|
"2" |
DWP (データベースワイヤプロトコル) サービス要求を処理するスレッドの初期数。 |
|
"1000" |
DWP (データベースワイヤプロトコル) サービスを使用するサーバーに許容される接続の最大数。 |
|
"20" |
DWP (データベースワイヤプロトコル) サービスを使用するサーバーに許容されるスレッドの最大数。 |
|
"n" |
すべての DWP (データベースワイヤプロトコル) サービス要求に対してサーバーが MD5 (Message Digest 5) の一方向ハッシュチェックを行うかどうかを指定します。一方向ハッシュ機能は、メッセージ認証用の電子署名を作成するために使用されます。
|
|
" " |
指定したマシンのホスト名で DWP (データベースワイヤプロトコル) サービスを使用するサーバーの IP アドレスを指定します。 |
|
"9779" |
指定したマシンのホスト名で DWP (データベースワイヤプロトコル) サービスを使用するサーバーのポート番号を指定します。 |
|
" " |
フロントエンドサーバーで、バックエンドサーバーとの DWP 接続の認証に使用されるユーザー ID を指定します。 back-end-server はサーバー名です。 |
|
" " |
フロントエンドサーバーで、バックエンドサーバーとの DWP 接続の認証に使用されるパスワードを指定します。 back-end-server はサーバー名です。 |
|
"65536" |
DWP (データベースワイヤプロトコル) サービススレッドのスタックサイズ。 |
|
LDAP プラグインがカレンダ検索機構に使用されている場合の認証するベース DN。 |
||
LDAP プラグインがカレンダ検索機構に使用される場合にアクセスする LDAP サーバーのホスト名。 |
||
LDAP プラグインがカレンダ検索機構に使用される場合に local.authldapbinddn の設定で指定されたユーザーのバインド資格情報 (パスワード)。 |
||
LDAP プラグインがカレンダ検索機構に使用される場合に、ユーザーの DN を検索するための認証用のバインドに使用する DN。 |
||
"389" |
LDAP プラグインがカレンダ検索機構に使用される場合にアクセスする LDAP サーバーのポート番号。 |
|
"n" |
"y" を指定すると、csapi.plugin.authentication.name に設定されるプラグインだけがロードされます。 指定しない場合は、すべての認証クラスプラグインがアルファベット順にロードされます。認証には、これらのプラグインがアルファベット順に使用されます。 |
|
" " |
csapi.plugin.loadall に "n" を指定し、csapi.plugin.authentication に "y" を指定した場合、このプラグインだけがロードされます。指定しない、または空白 (" ") の場合、すべての認証クラスプラグインがロードされます。 |
|
"0" |
DWP (データベースワイヤプロトコル) サービスのログバッファーのサイズ (バイト単位)。 |
|
"604800" |
DWP (データベースワイヤプロトコル) サービスのログファイルの有効期限が切れるまでの時間 (秒単位)。 |
|
"60" |
バッファーの内容を DWP (データベースワイヤプロトコル) サービスのログファイルにフラッシュする間隔 (秒単位)。 |
|
"logs" |
DWP (データベースワイヤプロトコル) サービスのログファイルが格納されるディレクトリ。 |
|
"Notice" |
サーバーがログに記録する DWP (データベースワイヤプロトコル) の情報の詳細度を指定します。DWP (データベースワイヤプロトコル) の各ログレベルには、次のいずれかのレベルが割り当てられます。CRITICAL、ERROR、WARNING、NOTICE、INFORMATION、DEBUG (重要度順)。この詳細度を CRITICAL に設定した場合、サーバーがログに記録する情報の詳細度は最も低くなります。最も高い詳細度でログを記録するには、DEBUG を指定します。たとえば、WARNING を指定した場合は、CRITICAL、ERROR、WARNING の各レベルのログレベルのみが記録されます。 |
|
"10" |
ログディレクトリ内の DWP (データベースワイヤプロトコル) に関連したログファイルの最大数。 |
|
"2097152" |
DWP (データベースワイヤプロトコル) の各ログファイルの最大サイズ (バイト単位)。 |
|
"20971520" |
DWP (データベースワイヤプロトコル) のすべてのログファイルの最大合計ディスク容量 (バイト単位)。 |
|
"5242880" |
DWP (データベースワイヤプロトコル) サービスアクティビティーのログ記録用に必要な最小ディスク空き容量 (バイト単位)。この値に達すると、サーバーは古いログファイルの有効期限を終了してディスクの空き容量を増やそうとします。最小空き容量を回復できない場合、すべてのログの記録は一時的に停止されます。 |
|
"86400" |
DWP (データベースワイヤプロトコル) サービスのログファイルのローテーション間隔 (秒単位)。 |
|
" " |
バックエンドサーバーで、DWP 接続の認証に使用するユーザー ID を指定します。このパラメータは省略可能です。バックエンドサーバーがユーザー ID を指定しない場合、認証は行われません。 |
|
" " |
バックエンドサーバーで、DWP 接続の認証に使用するパスワードを指定します。このパラメータは省略可能です。バックエンドサーバーがパスワードを指定しない場合、認証は行われません。 |
|
"localhost" |
DWP (データベースワイヤプロトコル) を実行しているマシンのホスト名。 |
|
"1000" |
並行して実行できる DWP (データベースワイヤプロトコル) サービススレッドの最大数。 |
|
"1" |
サーバーでの実行が必要な DWP (データベースワイヤプロトコル) サービス (csdwpd) プロセスの最大並行実行数。 複数の CPU を持つサーバーについては、「複数 CPU 間でのロードバランスの使用」を参照してください。 |
|
"no" |
"yes" を指定すると、すべてのサービスを開始するときに csdwpd サービスを開始し、すべてのサービスを終了するときに csdwpd サービスを終了します。 |
|
"86400" |
アイドル状態にある DWP (データベースワイヤプロトコル) サービスの持続的接続を閉じるまでの時間 (秒単位)。 |
|
"59779" |
DWP (データベースワイヤプロトコル) サービスが待機するポートの番号。この値は、LDAP CLD プラグインのデフォルトポート番号です。 |
|
"yes" |
DWP (データベースワイヤプロトコル) サービス (csdwpd) のリモートユーザーの認証で LDAP を有効 ("yes") または無効 ("no") にします。 |
|
service.calendarsearch.ldap |
"yes" |
Calendar Server が LDAP ディレクトリの後にカレンダデータベースを検索するか ("yes")、カレンダデータベースだけを検索するか ("no") を指定します。 |
次の表は、ics.conf ファイル内の LDAP データキャッシュに関するパラメータを示しています。
表 E–10 LDAP データキャッシュの設定パラメータ
パラメータ |
説明 |
---|---|
local.ldap.cache.enable |
LDAP データキャッシュを有効 (“yes”) または無効 (“no”) にします。デフォルトは “no” です。 |
local.ldap.cache.checkpointinterval |
チェックポイントスレッドがスリープするまでの秒数を指定します。デフォルトは “60” 秒です。 |
local.ldap.cache.circularlogging |
古いキャッシュファイルを削除するかどうかを指定します。デフォルトは “yes” です。 |
local.ldap.cache.homedir.path |
LDAP データキャッシュデータベースの物理的な場所を指定します。デフォルトは /var/opt/SUNWics5/csdb/ldap_cache です。 |
local.ldap.cache.logfilesizemb |
チェックポイントファイルの最大サイズを M バイト単位で指定します。デフォルトは “10”M バイトです。 |
local.ldap.cache.maxthreads |
LDAP データキャッシュデータベースの最大スレッド数を指定します。デフォルトは “1000” です。 |
local.ldap.cache.mempoolsizemb |
共有メモリーのサイズを M バイト単位で指定します。デフォルトは “4”M バイトです。 |
local.ldap.cache.entryttl |
LDAP データキャッシュエントリの存続時間 (TTL) を秒単位で指定します。デフォルトは “3600” 秒 (1 時間) です。 |
local.ldap.cache.stat.enable |
LDAP データキャッシュへのアクセスをログに記録し、ログファイルに統計情報を出力するかどうかを指定します。デフォルトは “no” です。 注: このパラメータはデバッグモードだけに適用されます。 |
local.ldap.cache.stat.interval |
統計情報レポートをログファイルに書き込む間隔を秒単位で指定します。デフォルトは “1800” 秒 (30 分) です。 |
local.ldap.cache.cleanup.interval |
データベースクリーンアップの間隔を秒単位で指定します。デフォルトは “1800” 秒 (30 分) です。 |
リソースカレンダを設定するには、次の表のパラメータを使用します。
表 E–11 リソースカレンダの設定パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"no" |
カレンダの作成時に、リソースカレンダ (会議室や視聴覚機器などのリソースのカレンダ) の同一時間帯に複数の予定をスケジューリングできるように設定するかどうかを指定します。 |
|
リソースカレンダを作成するときに使用されるデフォルトのアクセス制御設定を指定します。 デフォルトは次のとおりです。"@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g" |
次の表は、Access Manager を使用する場合の SSO 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–12 ics.conf ファイルの SSO 設定パラメータ (Access Manager を使用する場合)
次の表は、Communications サーバーの信頼できるサークルテクノロジを使用する場合の SSO 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–13 ics.conf ファイルの SSO 設定パラメータ (Communications サーバーの信頼できるサークルテクノロジを使用する場合)
次の表は、GSE (グループスケジューリングエンジン) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–14 ics.conf ファイルの GSE (グループスケジューリングエンジン) 設定パラメータ
次の表は、データベース処理の設定で使用される ics.conf パラメータを一覧表示し、各パラメータのデフォルト値と説明を示しています。
表 E–15 ics.conf ファイルのデータベース設定用パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"60" |
チェックポイントデータベーストランザクションの間隔 (秒単位)。 |
|
"yes" |
"yes" を指定すると、トランザクションの同期がとれた後でデータベースチェックポイントファイルが削除されます。自動バックアップを有効にしていないかぎり、この値を “no” に設定しないでください。 |
|
"100" |
ブレークが必要なデータベースデッドロックのチェック間隔 (ミリ秒単位)。 |
|
"." |
データベース予定、作業、アラームファイルが格納されるディレクトリ (プログラム実行可能ファイルに対する相対パス、または絶対パス)。デフォルトは “.” で、次のディレクトリが指定されます。 /var/opt/SUNWics5/csdb |
|
"10" |
データベースチェックポイントファイルの最大サイズ (M バイト単位)。 |
|
"10000" |
データベース環境で準備が必要なスレッドの最大数。 |
|
"4" |
データベース環境の共有メモリーのサイズ (M バイト単位)。 |
|
" " |
データベースの管理を担当するユーザーまたはエイリアスの電子メールアドレス。 |
|
"yes" |
"yes" を指定すると、データベース統計情報 (読み取り、書き込み、削除) がカウントされます。 |
|
"100" |
カウンタを持てるカレンダの最大数。カレンダでカウンタを有効にするには、cscal コマンド行ユーティリティーを使用します。 |
|
"en" |
電子メール通知のフォーマットに使用するファイルのローカライズされたバージョンを含む、/etc/opt/SUNWics5/config 内のディレクトリを指定します。 たとえば、"en" は英語にローカライズされたバージョンのディレクトリを指定し、"fr" はフランス語にローカライズされたバージョンのディレクトリを指定します。 |
|
"25" |
SMTP ホストのポート。 |
次の表は、自動バックアッププロセス (csstored) で使用されるパラメータを一覧表示し、使用可能なデフォルト値と ics.conf パラメータの説明を示しています。
表 E–16 自動バックアッププロセスで使用される ics.conf パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
defaultstore.log |
ログファイルの名前。 |
|
"." |
ログディレクトリへのパス。 |
|
caldb.berkeleydb.homedir.path |
なし |
ライブデータベースへのパス。 |
caldb.berkeleydb.archive.path |
なし |
アーカイブバックアップへのパス。 |
caldb.berkeleydb.hotbackup.path |
なし |
ホットバックアップへのパス。 |
caldb.berkeleydb.archive.enable |
"yes" |
自動的なアーカイブバックアップを有効または無効にします。 |
caldb.berkeleydb.hotbackup.enable |
"yes" |
自動的なホットバックアップを有効または無効にします。 |
caldb.berkeleydb.hotbackup.mindays |
"3" |
ディスク上に保持するホットバックアップコピーの最小日数。 |
caldb.berkeleydb.hotbackup. maxdays |
"7" |
ディスク上に保持するホットバックアップコピーの最大日数。 |
caldb.berkeleydb.hotbackup. threshold |
"70" |
古いホットバックアップコピーの破棄をトリガーする使用ディスク容量の割合 (パーセント)。 |
caldb.berkeleydb.archive.mindays |
"3" |
ディスク上に保持するアーカイブバックアップコピーの最小日数。 |
caldb.berkeleydb.archive.maxdays |
"7" |
ディスク上に保持するアーカイブバックアップコピーの最大日数。 |
caldb.berkeleydb.archive.threshold |
"70" |
古いアーカイブバックアップのコピーの破棄をトリガーする使用ディスク容量の割合 (パーセント)。 |
caldb.berkeleydb.circularlogging |
"yes" |
バックアップコピー数および占有するディスク容量の管理を有効または無効にします。 |
caldb.berkeleydb.archive.interval |
"120" |
新しいトランザクションログを開始する間隔 (秒単位)。 |
alarm.msgalarmnoticercpt |
"root@ localhost" |
必要な場合に通知する管理者の電子メールアドレスです。 |
service.store.enable (ics.conf ファイルに含まれない) |
"yes" |
start-cal によって、csstored を起動できるようにします。start-cal によって csstored を起動できないようにする場合は、ics.conf ファイルに追加して、"no" に設定する必要があります。 |
次の表は、カレンダデータベースの設定で使用されるパラメータ、デフォルト値、およびその説明を示しています。デフォルト値以外の値を指定するときは、ics.conf ファイルで設定する必要があります。
表 E–17 ENS メッセージ用のカレンダデータベースパラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"enp:///ics/alarm" |
ENS メッセージの URL を指定します。 |
|
"" |
アラームデータの内容の種類を指定します。"text/xml" または "text/calendar" を指定できます。 |
|
"no" |
カレンダの作成時に ENS メッセージを作成します。 |
|
"enp:///ics/calendarcreate" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
カレンダの削除時に ENS メッセージを作成します。 |
|
"enp:///ics/calendardelete" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
カレンダの修正時に ENS メッセージを作成します。 |
|
"enp:///ics/calendarmodify" |
ENS メッセージの URL。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
予定の作成時に ENS メッセージを作成します。 |
|
"enp:///ics/caleventcreate" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
予定の修正時に ENS メッセージを作成します。 |
|
"enp:///ics/caleventmodify" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
予定の削除時に ENS メッセージを作成します。 |
|
"enp:///ics/caleventdelete" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
仕事の作成時に ENS メッセージを作成します。 |
|
"enp:///ics/caltodocreate" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
仕事の修正時に ENS メッセージを作成します。 |
|
"enp:///ics/caltodomodify" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
|
"no" |
仕事の削除時に ENS メッセージを作成します。 |
|
"enp:///ics/caltododelete" |
ENS メッセージの URL を指定します。 |
|
"text/xml" |
メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。 |
Calendar Server は、ENS (予定通知サーバー) という外部の汎用サービスを使用するように設定できます。 ENS は、特定の領域に分類できるサーバーレベルの予定レポートを受け付け、特定の予定カテゴリが登録されているほかのサーバーに、そのカテゴリの予定について通知します。Calendar Server は ENS を使用してアラーム通知を送受信します。 この通知には、運用上の一般的な警告やエラーメッセージだけでなく、カレンダ予定および作業の作成、削除、修正も含まれます。
次の表は、ics.conf ファイル内の ENS (予定通知サーバー) 設定用パラメータを示しています。また、各パラメータのデフォルト値と説明も示しています。
表 E–18 ics.conf ファイルの ENS (予定通知サーバー) 設定用パラメータ
次の表は、Calendar Server API (CSAPI) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–19 ics.conf ファイルの CSAPI 設定用パラメータ
次の表は、csmonitor ユーティリティー設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E–20 ics.conf ファイル内の csmonitor ユーティリティー設定パラメータ
パラメータ |
デフォルト値 |
説明 |
---|---|---|
"0" |
csmonitor を連続してループするかどうかを指定します。 "0": 連続的にループしません。 "1": 連続的にループします。 このオプションはより多くのシステムリソースを必要としますが、デバッグモードでは便利です。 |
|
"60" |
2 つの監視ループの間の遅延時間を秒単位で指定します。 |
|
なし |
csmonitor が送信するメッセージの送信元となる電子メールアドレスを指定します。 |
|
なし |
csmonitor が送信するメッセージの送信先となる電子メールアドレスを指定します。 |
|
service.monitor.csdb.logthreshold |
"90" |
正常と判断される最大ディスク消費量のしきい値を、ディスク容量全体のパーセント値で指定します。カレンダデータベースが存在するディレクトリ (csdb ディレクトリ) のディスク消費量がこの値を超えると、csmonitor は警告電子メールメッセージを送信します。 |
"csmonitor.log" |
csmonitor のログファイル名を指定します。 |
|
"2097152" |
ログファイルの最大サイズを指定します。ログファイルのサイズがこれを超えると、csmonitor はログを csmonitor.log.timestamp という名前で保存し、ログをリセットします。 |
|
"0" |
デバッグレベルを指定します。この値が大きいほど、csmonitor は詳細なメッセージを送信します。 |
Calendar Server のカウンタ (統計情報) 設定パラメータは、次のファイルに格納されます。
/etc/opt/SUNWics5/config/counter.conf
counter.conf ファイルは ASCII テキストファイルで、各行にカウンタとそのパラメータが定義されています (名前、種類、サイズ (バイト単位)、説明)。空白文字を含むパラメータは二重引用符 (" ") で囲む必要があります。コメント行の先頭文字は感嘆符 (!) です。コメント行は情報提供のみに使用されます。
カウンタ名の最初の部分は、csstats ユーティリティーで使用されるカウンタオブジェクトを識別しています。コマンド行ユーティリティーについては、付録 D 「Calendar Server のコマンド行ユーティリティーのリファレンス」を参照してください。
カスタマサポート担当者からの指示がないかぎり、counter.conf ファイルの内容を変更しないでください。
ここでは、Calendar Server の counter.conf パラメータについて、次の項目を説明します。
次の表は、各アラームカウンタの名前、種類、サイズ、説明を示しています。
表 E–21 counter.conf ファイルのアラームカウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
GAUGE |
4 |
記録された最高値。 |
|
GAUGE |
4 |
記録された最低値。 |
|
GAUGE |
4 |
監視対象の現在の値。 |
|
GAUGE |
4 |
警告状態: 真 (1) または偽 (0)。 |
|
COUNTER |
4 |
しきい値に達した回数。 |
|
COUNTER |
4 |
警告の送信回数。 |
|
TIME |
4 |
現在の値が設定された最終時刻。 |
|
TIME |
4 |
警告が送信された最終時刻。 |
|
TIME |
4 |
リセットが行われた最終時刻。 |
|
TIME |
4 |
アラーム状態が変化した最終時刻。 |
次の表は、各ディスク使用率カウンタの名前、種類、サイズ、説明を示しています。
表 E–22 counter.conf ファイルのディスク使用率カウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
GAUGE |
5 |
ディスクパーティション内で使用できる合計容量。 |
|
TIME |
4 |
統計情報が得られた最終時刻。 |
|
STRING |
512 |
カレンダパーティションのパス。 |
|
GAUGE |
4 |
ディスクパーティション内の使用可能容量の割合 (パーセント)。 |
|
GAUGE |
5 |
ディスクパーティション内の合計容量。 |
次の表は、各 HTTP カウンタの名前、種類、サイズ、説明を示しています。
表 E–23 counter.conf ファイルの HTTP (httpstat) カウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
GAUGE |
4 |
接続応答の平均時間。 |
|
TIME |
4 |
Calendar Server の起動時刻。 |
|
TIME |
4 |
新規クライアント接続が受け付けられた最終時刻。 |
|
COUNTER |
4 |
現在の接続が処理される最大回数。 |
|
COUNTER |
4 |
WCAP セッションが処理される最大回数。 |
|
COUNTER |
4 |
処理された接続の総数。 |
|
GAUGE |
4 |
アクティブな接続の現在の数。 |
|
GAUGE |
4 |
WCAP セッションの現在の数。 |
|
COUNTER |
4 |
処理された接続失敗の総数。 |
|
COUNTER |
4 |
現在の HTTP サーバーによって処理された成功ログインの回数。 |
|
COUNTER |
4 |
現在の HTTP サーバーによって処理された失敗ログインの回数。 |
次の表は、各 GSE (グループスケジューリングエンジン) カウンタの名前、種類、サイズ、説明を示しています。
表 E–24 counter.conf ファイルの GSE (グループスケジューリングエンジン) カウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
TIME |
4 |
GSE が稼動し、ジョブを処理した最終時刻。 |
|
TIME |
4 |
GSE がジョブを処理した最終時刻。 |
|
COUNTER |
4 |
GSE が処理したジョブの総数。 |
|
COUNTER |
4 |
アクティブなワーカースレッドの総数。 |
次の表は、各認証カウンタの名前、種類、サイズ、説明を示しています。
表 E–25 counter.conf ファイルの認証 (authstat) カウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
TIME |
4 |
ユーザーがログインした最終時刻。 |
|
COUNTER |
4 |
処理された成功ログインの総数。 |
|
COUNTER |
4 |
処理された失敗ログインの総数。 |
次の表は、各 WCAP カウンタの名前、種類、サイズ、説明を示しています。
表 E–26 counter.conf ファイルの WCAP (wcapstat) カウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
COUNTER |
4 |
WCAP 要求の総数。 |
次の表は、各データベースカウンタの名前、種類、サイズ、説明を示しています。
表 E–27 counter.conf ファイルのデータベース (dbstat) カウンタ
名前 |
種類 |
サイズ |
説明 |
---|---|---|---|
COUNTER |
4 |
データベース読み取りの総数。 |
|
COUNTER |
4 |
データベース書き込みの総数。 |
|
COUNTER |
4 |
データベース削除の総数。 |
|
TIME |
4 |
データベース読み取りの最終時刻。 |
|
TIME |
4 |
データベース書き込みの最終時刻。 |
|
TIME |
4 |
データベース削除の最終時刻。 |
次の表は、各サーバー応答カウンタの名前、種類、サイズ、説明を示しています。
表 E–28 counter.conf ファイルのサーバー応答カウンタ
名前 |
種類 |
サイズ |
スケール |
説明 |
---|---|---|---|---|
TIME |
4 |
統計情報が得られた最終時刻。 |
||
GAUGE |
4 |
2 |
サーバーの応答時間 (ミリ秒単位)。 |
次の表は、各セッション状態カウンタの名前、種類、サイズ、説明を示しています。
表 E–29 counter.conf ファイルのセッション状態カウンタ
名前 |
種類 |
サイズ |
スケール |
説明 |
---|---|---|---|---|
COUNTER |
4 |
4 |
HTTP セッションが処理される最大回数。 |
|
GAUGE |
4 |
2 |
HTTP セッションの現在の数。 |
Calendar Server は、「Calendar Server のメールパラメータ」で説明している各種電子メールメッセージを送信します。これらのメッセージの形式は、表に示されるフォーマットファイル (.fmt) によって制御されます。フォーマットファイルは、次のディレクトリ内の各ロケールのディレクトリ (英語であれば /en、フランス語であれば /fr など) に格納されています。
/etc/opt/SUNWics5/config
たとえば、英語バージョンの作業 (仕事) アラームメッセージの形式は、次のファイルに指定されています。
/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt
ここで説明する内容は次のとおりです。
次の表は、Calendar Server の各メールパラメータのメッセージタイプ、パラメータ名、デフォルトフォーマットファイル、説明、受信者を示しています。
表 E–30 ics.conf ファイルの Calendar Server 電子メールフォーマットパラメータ
メッセージタイプ |
パラメータ |
フォーマットファイル (デフォルト) |
説明 |
受信者 |
---|---|---|---|---|
予定の公開 |
予定の公開、または既存予定の変更を通知します。 |
通知登録ユーザー |
||
予定の取り消し |
予定の取り消しを通知します。 |
通知登録ユーザー |
||
予定への返信 |
"mail_eventreply.fmt" |
予定通知に返信します。 |
通知登録ユーザー |
|
予定の要求 |
"mail_eventrequest.fmt" |
予定通知に登録します。 |
通知登録ユーザー |
|
予定アラーム |
次の予定のアラーム。 |
アラーム登録ユーザー |
||
定期的な予定の通知 |
“mail_eventnotificationrecur.fmt” |
定期的な予定の通知。 |
通知登録ユーザー |
|
予定の取り消し通知 |
“mail_eventcancel notification.fmt” |
取り消された予定の通知。 |
通知登録ユーザー |
|
定期的な予定の取り消しの通知 |
“mail_eventcancelnotificationrecur.fmt” |
取り消された定期的な予定の通知。 |
通知登録ユーザー |
|
作業の公開 |
作業または既存作業の変更を通知します。 |
通知登録ユーザー |
||
作業の取り消し |
作業の取り消しを通知します。 |
通知登録ユーザー |
||
作業への返信 |
"mail_todoreply.fmt" |
作業通知に返信します。 |
通知登録ユーザー |
|
仕事の要求 |
"mail_todorequest.fmt" |
仕事通知に登録します。 |
通知登録ユーザー |
|
作業アラーム |
次の作業のアラーム。 |
アラーム登録ユーザー |
Calendar Server は、特定の予定または作業を組み合わせ、フォーマットファイルに基づいて通知メッセージを生成します。予定または作業内のデータフィールドの値は、メッセージに出力することができます。通知メッセージには、MIME ヘッダー行と関連する特殊値を含めることもできます。特殊文字列 (フォーマット表記) を使用することで、予定、作業、MIME ヘッダーの値をメッセージに含めることができます。フォーマットファイル内の行は、メールメッセージの生成時にカレンダデータフィールドからの実際の値に置き換えられる特殊文字列から構成されます。特殊文字列には 2 つの文字が含まれます。 1 つはパーセント記号 (%) で、もう 1 つの文字は特別なフォーマット表記を表します。
次に、これらの特殊文字列について説明します。
次の表は、フォーマットコードと、予定通知用の特殊文字列の意味を示しています。
表 E–31 予定通知用の特殊文字列
フォーマットコード |
意味 |
---|---|
%0 |
ローカライズされたフォーマットでの開始時刻 |
%1 |
ローカライズされたフォーマットでの終了時刻 |
%A |
iCalendar 形式の exdates (除外する日付をセミコロンで区切ったリスト形式の ISO 8601 日付文字列) |
%a |
iCalendar 形式の rdates (予定日付をセミコロンで区切ったリスト形式の ISO 8601 日付文字列) |
%B |
開始時刻 (%Z も参照) |
%b |
開始時刻と終了時刻を iCalendar 形式で出力します。開始時刻のパラメータが value=date という形式であれば、日付の月 / 日 / 年の部分だけが出力されます。終了時刻の月 / 日 / 年の値が開始時刻と等しい場合は、開始時刻だけが生成されます。 |
%C |
作成時刻 |
%c |
予定クラス |
%d |
予定の説明 (%F も参照) |
%E |
終了時刻 (%Z も参照) |
%e |
iCalendar 形式の例外規則 |
%F |
予定の説明、iCalendar 形式の折り返し行 (%d も参照) |
%G |
予定の地理的な場所 (緯度と経度) |
%g |
企画者の電子メールアドレス。この値の信頼性は保証されません。 |
%K |
企画者の mailto:url 形式の電子メールアドレス |
%k |
アラームカウント |
%L |
場所 |
%l |
iCalendar 形式の繰り返し規則 |
%M |
修正時刻 |
%N |
新規行 |
%n |
DTSTAMP で使用される現在のタイムスタンプ |
%P |
優先度 |
%r |
定期予定 ID (この予定が繰り返し予定でない場合は空白) |
%S |
予定のシーケンス番号 |
%s |
概要 |
%t |
予定の状態 |
%U |
一意の予定識別子 |
%Z |
時刻フィールドコードと組み合わせて使用され、UTC 時間で時間を表示します。(%B は開始時刻を現地時間で表示し、%ZB は開始時刻を UTC 時間で表示する) |
%% |
パーセント記号 (%) を通常文字として表示します。 |
% (サブフォーマットコード) |
コードによって識別されるデータのサブフォーマットを指定します (詳細は、「日付のサブフォーマット」を参照)。 |
日時の値は、さまざまな形式に設定できます。サブフォーマットを使用することで、日時値の形式について追加情報を指定することができます。サブフォーマットを指定しない場合、サーバーはデフォルトの形式で日時値を出力します。サブフォーマットフィールドを使用することで、適用する形式を具体的に指定することができます。
たとえば、%B は、出力文字列に予定の開始時刻を含めることを指定します。このデフォルトフォーマットでは、日付に関連するすべての情報 (日付、時刻、タイムゾーンなど) が出力されます。日付値のサブフォーマット文字列は、strftime フォーマット文字列です (「日付用の特殊文字列」を参照)。開始時刻の月と年だけが重要な場合は、%B の代わりに %(%m %Y)B というフォーマットを使用します。
次に例を示します。
The event begins: %B%N The event ends: %(%b %d, %Y %I:%M %p)E%N |
これは、次のような通知として出力されます。
The event begins Feb 02, 1999 23:30:00 GMT Standard Time The event ends Feb 03, 1999 02:30 AM |
特定の条件が満たされる場合にだけ行を出力できると便利なことがあります。たとえば、次のような行です。
title: %S%N start: %B%N end: %E%N |
これは、次のような通知として出力されます。
title: Staff Meeting start: Feb 04, 1999 09:00:00 end: Feb 04, 1999 10:00:00 |
ただし、上の例には不正確な結果を招く 2 つの条件があります。
予定の終了時刻が指定されていない
予定が「終日」予定であるため、開始と終了が同じ日になる
このような状況では、終了時刻を一切出力しない方法が最適です。デフォルトでは、タイムスタンプが all-day という属性を持つ場合、年、月、日だけが出力されます。さらに、予定の開始時刻が all-day 属性を持ち、予定が開始日と同じ日に終了する場合、特別な条件フラグが設定されます。特別な条件フラグが設定されていない場合にだけ ? 修飾子を使用して条件値を出力します。
たとえば、上の例の行を次のように変更します。
title: %S%N start: %B%N end: %?E%N |
最後の行は、開始日と終了日が同じ終日予定では出力されません。これは、一般的な終日予定 (誕生日や記念日など) について次のように出力します。
title: Staff Meeting start: Feb 04, 1999 |
? フラグは、その他の修飾子と組み合わせて使用することができます。次に例を示します。
The event ends: %?(%b %d, %Y %I:%M %p)E%N
次の表は、フォーマットコードと、作業通知用の特殊文字列の意味を示しています。
表 E–32 作業通知用の特殊文字列
フォーマットコード |
意味 |
---|---|
%A |
iCalendar 形式の exdates (除外する日付をセミコロンで区切ったリスト形式の ISO 8601 日付文字列) |
%a |
iCalendar 形式の rdates (予定日付をセミコロンで区切ったリスト形式の ISO 8601 日付文字列) |
%B |
開始時刻 (%Z も参照) |
%C |
作成時刻 |
%c |
作業クラス |
%D |
締め切り日時 |
%d |
作業の説明 (%F も参照) |
%E |
IMIP 形式の締め切り日時 |
%e |
iCalendar 形式の例外規則 |
%F |
作業の説明、iCalendar 形式の折り返し行 (%d も参照) |
%G |
作業の地理的な場所 (緯度と経度) |
%g |
企画者の電子メールアドレス (この値の信頼性は保証されない) |
%K |
企画者の mailto:URL 形式の電子メールアドレス |
%k |
アラームカウント |
%L |
場所 |
%l |
iCalendar 形式の繰り返し規則 |
%M |
修正時刻 |
%N |
新規行 |
%n |
現在 (DTSTAMP で使用される現在のタイムスタンプ) |
%P |
優先度 |
%r |
定期予定 ID (この作業が繰り返し作業でない場合は空白) |
%S |
作業のシーケンス番号 |
%s |
概要 |
%t |
状態 |
%U |
UID |
%Z |
時刻フィールドコードと組み合わせて使用され、UTC 時間で時間を表示します (%B は開始時刻を現地時間で表示し、%ZB は開始時刻を UTC 時間で表示する) |
%% |
% 記号を通常文字として表示します |
% (サブフォーマットコード) |
コードによって識別されるデータのサブフォーマットを指定します (詳細は、「日付のサブフォーマット」を参照) |
次の表は、フォーマットコードと、日付用の特殊文字列の意味を示しています。
ここに示す特別な日付フォーマットコードは、利便性だけを目的に紹介されています。Calendar Server がコードを書き換えるわけではなく、実際にはオペレーティングシステムに実装されているものが使用されます。
フォーマットコード |
意味 |
---|---|
%a |
曜日の略号表記 |
%A |
曜日の完全表記 |
%b |
月名の略号表記 |
%B |
月名の完全表記 |
%c |
ロケールに基づいて表示される日時 |
%d |
月の日付の 10 進表記 (01 〜 31) |
%H |
時間の 24 時間制表記 (00 〜 23) |
%I |
時間の 12 時間制表記 (01 〜 12) |
%j |
年の日付の 10 進表記 (001 〜 336) |
%m |
月の 10 進表記 (01 〜 12) |
%M |
分の 10 進表記 (00 〜 59) |
%p |
12 時間制表記用の、現在のロケールの A.M./P.M. |
%S |
秒の 10 進表記 (00 〜 59) |
%U |
日曜日を週の先頭とした場合の年初からの週数 (00 〜 53) |
%w |
曜日の 10 進表記 (0 〜 6、日曜日が 0) |
%W |
月曜日を週の先頭とした場合の年初からの週数 (00 〜 53) |
%x |
現在のロケールの日付表記 |
%X |
現在のロケールの時刻表記 |
%y |
世紀部分を含まない年の 10 進表記 (00 〜 99) |
%Y |
世紀部分を含む年の 10 進表記 |
%Z |
タイムゾーンの名前または略号、タイムゾーンが不明の場合は何も出力されません |
%% |
パーセント記号 |
次の例は、デフォルトの予定アラームメッセージのフォーマットを示しています。
1 EVENT REMINDER 2 ~~MIME-Version: 1.0%N 3 ~~Content-Type: text/plain; charset=%s%N 4 ~~Content-Transfer-Encoding: %x%N%N 5 Summary: %s%N 6 Start: %(%a, %d %b %Y %I:%M %p)B%N 7 End: (%a, %d %b %Y %I:%M %p)E%N 8 Location: %L%N%N 9 Description: %N%d%N |
この例の各行について説明します。
行 1 は、メッセージの件名です。
行 2 は ~~ から始まります。 これは、MIME 折り返し行を示しています。つまり、特殊文字列に置き換えられるのは、予定または作業ではなく、内部 MIME オブジェクトに関連する情報です。特殊文字列 %N は改行を表します。件名の行は特殊文字列による改行を必要としませんが、その他すべての行では必要です。
行 3 も MIME ヘッダー行です。ここには、特殊文字列 %s が含まれます。 これは、メール送信の対象となる予定または作業に関連付けられた文字セットに置き換えられます。
行 4 は MIME ヘッダーの最終行です。 %x は、このメッセージに必要なコンテンツ転送用のエンコード文字列です。
行 5 では、%s によって予定の概要が呼び出されます。
行 6 には予定の開始時刻が表示されます。これは、特殊文字列 %B のサブフォーマット文字列を使用しています。詳細は、「日付のサブフォーマット」を参照してください。
行 7 には予定の終了時刻が表示されます。
行 8 には予定の場所が表示されます。
行 9 には予定の説明が表示されます。
次の例は、上の例から生成される通知メッセージのサンプルを示しています。
From: jsmith@sesta.com (James Smith) Date: Wed, 15 Nov 1999 19:13:49 To: jsmith@sesta.com Subject: EVENT REMINDER MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Summary: smtp_rig event 1 Start: Tues, 16 Nov 1999 02:00 PM End: Tues, 16 Nov 1999 03:00 PM Location: Green Conference Room Description: This is the description for a randomly generated event. |
次の例は、より複雑な複数部分から構成されるメッセージを示しています。この例には、テキスト部分と IMIP PUBLISH 部分が含まれます。
EVENT PUBLICATION ~~MIME-Version: 1.0%N ~~Content-Type: multipart/mixed; boundary="%b"%N%N This is a multi-part message in MIME format.%N ~~--%b%N ~~Content-Type: text/plain; charset=%s%N ~~Content-Transfer-Encoding: %x%N%N Summary: %s%N Start: %(%a, %d %b %Y %I:%M %p)B%N End: %(%a, %d %b %Y %I:%M %p)E%N Location: %L%N%N Description: %N%d%N%N ~~--%b%N ~~Content-Type: text/calendar; method=%m; component=%c; charset=%s%N ~~Content-Transfer-Encoding: %x%N%N BEGIN:VCALENDAR%N PRODID:-//iPlanet/Calendar Hosting Server//EN%N METHOD:PUBLISH%N VERSION:2.0%N BEGIN:VEVENT%N ORGANIZER:%K%N DTSTAMP:%Zn%N DTSTART:%ZB%N DTEND:%ZE%N SUMMARY:%s%N UID:%U%N %R %A %a %e %l SEQUENCE:%S%N LOCATION:%L%N GEO:%G%N %F STATUS:%t%N END:VEVENT%N END:VCALENDAR%N ~~--%b-- |