Sun Java System Calendar Server 6 2005Q4 管理ガイド

付録  E Calendar Server の設定パラメータ

Calendar Server の設定パラメータは、ics.conf および counter.conf などの設定ファイルに格納されます。

この章で説明する内容は次のとおりです。

ics.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 プロセスが正常に実行されないことがあります。


Procedureics.conf ファイルを編集するには

手順
  1. Calendar Server が稼動しているシステムの管理者権限を持つユーザーとしてログインします。

  2. ics.conf ファイルが格納されている /etc/opt/SUNWics5/config ディレクトリに移動します。

  3. 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 ファイルに記録されていないパラメータを使用するには、パラメータとその値をファイルに追加します。

      • 同じパラメータを複数回記録した場合、リストの最後にあるパラメータの値が、それ以前のパラメータに優先して適用されます。

      • すべてのオプションは行頭から始める必要があります。

  4. ics.conf ファイルでパラメータを変更したら、新しい設定値が適用されるように Calendar Server を停止し、再起動します。

    ics.conf ファイルの編集前に Calendar Server を停止しておくこともできます。詳細は、「Calendar Server の起動と停止」を参照してください。

設定パラメータファイル (ics.conf)

ics.conf ファイルには次の設定パラメータが記録されています。

ローカル設定

次の表は、ローカル設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–1 ics.conf ファイルのローカル設定用パラメータ

パラメータ 

デフォルト値 

説明 

local.autoprovision

"yes" 

Calendar Server ユーザーの自動プロビジョニングを有効 ("yes") または無効 ("no") にします。 

local.authldapbasedn

" " 

LDAP 認証のベース DN。指定しない場合は local.ugldapbasedn の設定が適用されます。 

local.authldaphost

"localhost" 

LDAP 認証用のホスト。指定しない場合は local.ugldaphost の設定が適用されます。 

local.authldapbindcred

" " 

local.authldapbinddn で指定された、ユーザーのバインドに必要な資格情報 (パスワード)。 

local.authldapbinddn

" " 

ユーザー DN の検索時に LDAP 認証ホストへのバインドに使用される DN。指定しない場合または " " の場合は匿名バインドです。 

local.authldapport

"389" 

LDAP 認証用のポート。指定しない場合は local.ugldapport の設定が適用されます。 

local.authldappoolsize

"1" 

LDAP 認証用に維持される LDAP クライアント接続の最小数。指定しない場合は local.ugldappoolsize の設定が適用されます。 

local.authldapmaxpool

"1024" 

LDAP 認証用に維持される LDAP クライアント接続の最大数。指定しない場合は local.ugldapmaxpool の設定が適用されます。 

local.lookupldap.search.minwildcardsize

"3" 

出席者ルックアップ検索のワイルドカード検索に使用する文字列の最小サイズを指定します。ゼロ (0) は常にワイルドカード検索を行うことを意味します。 

local.caldb.deadlock.autodetect

"no" 

Berkeley データベースがデッドロック状態にあるかどうかを定期的に調べます。 デッドロック状態にある場合は、データベースのリセットを指示します。 

local.domain.language

"en" 

ドメインの言語。 

local.enduseradmincred

" " 

LDAP ユーザー設定認証用のバインド資格情報 (パスワード)。 

local.enduseradmindn

" " 

LDAP ユーザー設定ホストへのバインドに使用される DN。このプロパティーの指定は必須。" " (未指定) の場合、匿名バインドと見なされます。 

local.hostname

" "

Calendar Server がインストールされているマシンのホスト名。 

local.installeddir

"cal_svr_base/SUNWics5/cal"

Calendar Server がインストールされている場所へのディレクトリパス。 

local.instancedir

"cal_svr_base/SUNWics5/cal"

Calendar Server のこのインスタンスのプログラムとデータがインストールされている場所へのディレクトリパス。 

local.instance.lockdir.path

"cal_svr_base/SUNWics5/cal/lib/lock"

このサーバーインスタンスのロックファイルが格納されている場所を指定します。 

local.instance.pidfile.path

"/etc/opt/SUNWics5/
config"

このサーバーインスタンスの PID ファイルが格納されている場所を指定します。 

local.instance.counter.path

"cal_svr_base/SUNWics5/cal/lib/counter"

このサーバーインスタンスのカウンタファイルが格納されている場所を指定します。 

local.plugindir.path

" "

Calendar Server のこのインスタンスの CSAPI プラグインがインストールされている場所へのディレクトリパス。 

local.rfc822header.allow8bit

"n"

このサーバーが送信する電子メールメッセージでの 8 ビットヘッダーの使用を許可 (y) または拒否(n) します。

local.servergid

"icsgroup"

カウンタやログなどの Calendar Server ファイルのグループ ID (GID)。

local.serveruid

"icsuser"

カウンタやログなどの Calendar Server ファイルのユーザー ID (UID)。

local.sitelanguage

"en"

Calendar Server のこのインスタンスのデフォルト言語。 

local.smtp.defaultdomain

" "

電子メールアドレスに対応する出席者のカレンダ ID の検索で使用されるデフォルトドメインの名前。たとえば、この値が「sesta.com」に設定されている場合は、jsmith は jsmith@sesta.com として解決されます。 

local.supportedlanguages

"en"

Calendar Server のこのインスタンスがサポートしているユーザー言語。 

local.ugldapbasedn

" "

LDAP ユーザー設定のベース DN。指定が必須であり、空白は許可されません。 

local.ugldaphost

"localhost"

LDAP ユーザー設定を格納するマシンのホスト名。 

local.ugldapicsextendeduserprefs

"ceColorSet,

ceFontFace,

ceFontSizeDelta,

ceDateOrder,

ceDateSeparator,

ceClock,

ceDayHead,

ceDayTail,

ceInterval,

ceToolText,

ceToolImage,

ceDefaultAlarmStart,

ceSingleCalendarTZID,

ceAllCalendarTZIDs,

ceDefaultAlarmEmail,

ceNotifyEmail,

ceNotifyEnable,

ceDefaultView,

ceExcludeSatSun,

ceGroupInviteAll"

icsExtendedUserPrefs 属性のオプションの値。

local.ugldapport

"389"

LDAP ユーザー設定を格納するマシンのポート番号。 

local.ugldappoolsize

"1"

LDAP ユーザー設定用に維持される LDAP クライアント接続の最小数。 

local.ugldapmaxpool

"1024"

LDAP ユーザー設定用に維持される LDAP クライアント接続の最大数。 

local.user.authfilter

“uid=%u’”

ユーザー検索に使用するフィルタ。 

カレンダストアの設定

次の表は、カレンダストア設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–2 ics.conf ファイルのカレンダストア設定用パラメータ

パラメータ 

デフォルト値 

説明 

calstore.anonymous.calid

"anonymous"

匿名ログインに使用されるカレンダ ID (calid)。

user.allow.doublebook

"yes"

カレンダの作成時に、ユーザーカレンダの同一時間帯に複数の予定をスケジューリングできるように設定するかどうかを指定します。 

  • "no": 複数のユーザーからの予約は拒否されます。

  • "yes": 複数のユーザーからの予約は許可されます。

calstore.calendar.default.acl

"@@o^a^r^g;
@@o^c^wdeic^g;
@^a^fs^g;
@^c^^g;
@^p^r^g"

ユーザーがカレンダを作成したときに使用されるデフォルトのアクセス制御設定を指定します。形式は、ACE (アクセス制御エントリ) 引数をセミコロンで区切ったリスト形式の文字列です。 

ACE の形式については、「カレンダのアクセス制御」を参照してください。

コマンド行ユーティリティーを使用して 1 つ以上の ACE (アクセス制御エントリ) を指定する方法については、「cscal」を参照してください。

calstore.calendar.owner.acl

"@@o^a^rsf^g;
@@o^c^wdeic^g"

カレンダ所有者のデフォルトのアクセス制御設定を指定します。 

calstore.calendar.create.

lowercase

"no"

カレンダの新規作成時、または LDAP CLD プラグインを使用してカレンダを検索する場合に、Calendar Server がカレンダ ID (calid) を小文字に変換するかどうかを指定します。

calstore.default.timezoneID

"America/
New_York"

次の状況で使用するタイムゾーン ID。 

  • タイムゾーン ID が指定されていない

  • カレンダのタイムゾーン ID が見つからない

  • ユーザーのタイムゾーン ID が見つからない

    無効な値を指定した場合、サーバーは GMT (グリニッジ標準時) タイムゾーンを適用します。

calstore.filterprivateevents

"yes"

Calendar Server が、非公開の、および時刻と日付のみが公開される (極秘の) 予定と作業をフィルタリング (認識) できるかどうかを指定します。"no" に設定すると、Calendar Server はそれらを公開の予定および作業と同様に扱います。

calstore.freebusy.include.

defaultcalendar

"yes"

ユーザーのデフォルトカレンダを、そのユーザーの空き/予定ありカレンダリストに含めるかどうかを指定します。 

calstore.freebusy.remove.

defaultcalendar

"no"

ユーザーのデフォルトカレンダを、そのユーザーの空き/予定ありカレンダリストから削除できるかどうかを指定します。 

calstore.group.attendee.maxsize

"0"

予定を拡張するときに、LDAP グループで許可される最大出席者数。"0" の値はグループ全体を拡張することを意味します。

calstore.recurrence.bound

"60"

定期拡張で作成できる予定の最大数。 

calstore.subscribed.include.

defaultcalendar

"yes"

ユーザーのデフォルトカレンダを、そのユーザーの登録済みカレンダリストに含めるかどうかを指定します。 

calstore.subscribed.remove.

defaultcalendar

"no"

ユーザーのデフォルトカレンダを、そのユーザーの登録済みカレンダリストから削除できるようにするかどうかを指定します。 

calstore.userlookup.maxsize

"200"

ユーザー検索の LDAP ルックアップで返される結果の最大数。値 "0" は制限のないことを意味します。

calstore.unqualifiedattendee.

fmt1.type

"uid"

予定の出席者についてディレクトリルックアップを行うときに、jdoejdoe:tv などの文字列を Calendar Server がどのように扱うかを指定します。設定できる値は、次のとおりです。uidcngid resmailtocap

calstore.unqualifiedattendee.

fmt2.type

"mailto"

Calendar Server が予定の出席者についてディレクトリルックアップを行うときに、jdoe@sesta.com などのアットマーク (@) を含む文字列をどのように扱うかを指定します。設定できる値は、次のとおりです。uidcngidresmailtocap

calstore.unqualifiedattendee.

fmt3.type

"cn"

予定の出席者についてディレクトリルックアップを行うときに、john doe などの空白文字を含む文字列を Calendar Server がどのように扱うかを指定します。設定できる値は、次のとおりです。uidcngidrescap

store.partition.primary.path

"."

カレンダ情報が格納される一次ディスクパーティションの場所。 

カレンダログ情報の設定

次の表は、カレンダログ設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–3 ics.conf ファイルのカレンダログ設定用パラメータ

パラメータ 

デフォルト値 

説明 

logfile.admin.logname

"admin.log"

ログ記録管理ツール用のログファイルの名前。 

logfile.buffersize

"0"

ログバッファーのサイズ (バイト単位)。 

logfile.dwp.logname

"dwp.log"

DWP (データベースワイヤプロトコル) に関する情報のログ記録管理ツール用ログファイルの名前。 

logfile.expirytime

"604800"

ログファイルの有効期限 (秒単位)。 

logfile.flushinterval

"60"

バッファーの内容をログファイルにフラッシュする間隔 (秒単位)。 

logfile.http.logname

"http.log"

cshttpd サービスの現在のログファイルの名前。

logfile.http.access.logname

"httpd.access"

現在の HTTP アクセスログファイルの名前。 

logfile.logdir

"logs"

ログファイルが格納されるディレクトリ。 

logfile.loglevel

"NOTICE"

サーバーがログに記録する情報の詳細度を指定します。各ログレベルには、次のいずれかのレベルが割り当てられます。CRITICALALERTERRORWARNINGNOTICEINFORMATIONDEBUG

logfile.maxlogfiles

"10"

ログディレクトリ内のログファイルの最大数。 

logfile.maxlogfilesize

"2097152"

各ログファイルの最大サイズ (バイト単位)。 

logfile.maxlogsize

"20971520"

すべてのログファイルの最大合計ディスク容量 (バイト単位)。 

logfile.minfreediskspace

"5242880"

ログ記録用に必要な最小ディスク空き容量 (バイト単位)。 

logfile.notify.logname

"notify.log"

csnotifyd サービスのログファイル名。

logfile.rollovertime

"86400"

ログファイルのローテーション間隔 (秒単位)。 

管理者構成パラメータ

次の表は、管理者に関する ics.conf パラメータを示しています。

表 E–4 管理者の構成パラメータ

パラメータ 

デフォルト値 

説明 

service.admin.calmaster.

cred

" "

Calendar Server 管理者として指定されたユーザー ID のパスワード。この値の指定は、インストール時にインストーラによって要求されます。 

service.admin.calmaster.

userid

"calmaster"

Calendar Server 管理者として指定されたユーザーのユーザー ID。この値の指定は、インストール時にインストーラによって要求されます。 

service.admin.calmaster.

overrides.accesscontrol

"no"

Calendar Server の管理者がアクセス制御の適用に反してアクセスできるかどうかを指定します。 

service.admin.calmaster
.wcap.allowgetmodify
userprefs

"no"

Calendar Server 管理者が WCAP コマンドを使用してユーザー設定を取得、設定できるかどうかを指定します。 

service.admin.ldap.enable

"yes" 

“yes” を指定すると、service.admin.calmaster.userid に設定されるユーザーのユーザー認証で LDAP が有効になります。 

サービスの設定

次の表は、各種のサービス設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–5 ics.conf ファイルのサービス設定用パラメータ

パラメータ 

デフォルト値 

説明 

service.admin.alarm

"yes"

管理ツールのアラーム通知を有効 ("yes")、または無効 ("no") にします。

service.admin.checkpoint

"yes"

"yes" に設定すると、csadmind データベースチェックポイントスレッドが開始されます。

service.admin.dbcachesize

"8388608"

管理セッション用の Berkeley データベースの最大キャッシュサイズ (バイト単位)。 

service.admin.deadlock

"yes"

"yes" に設定すると、csadmind データベースデッドロック検出スレッドが開始されます。

service.admin.diskusage

"no"

"yes" に設定すると、csadmind ディスク容量低下監視スレッドが開始されます。

service.admin.enable

"yes"

"yes" に設定すると、すべてのサービスを開始するときに csadmind サービスを開始し、すべてのサービスを終了するときに csadmind サービスを終了します。

service.admin.idletimeout

"120"

csadmind で HTTP 接続をタイムアウトにするまでの秒数。

service.admin.maxsessions

"100"

許容される管理セッションの最大数。 

service.admin.maxthreads

"10"

1 管理セッションで実行されるスレッドの最大数。 

service.admin.numprocesses

なし 

同時に実行可能な管理プロセスの最大数。 

service.admin.port 

注意 

なし 

システムによって設定されます。変更しないでください。 

service.admin.resourcetimeout

"900"

管理接続をタイムアウトにするまでの秒数。 

service.admin.serverresponse

"no"

"yes" に設定すると、csadmind サービス応答スレッドが開始されます。 

service.admin.sessiondir.path

" "

管理セッション要求用の一時ディレクトリ。 

service.admin.sessiontimeout

"1800"

csadmind で HTTP セッションをタイムアウトにするまで待機する秒数。

service.admin.sleeptime

"2"

カレンダサービスの状態 (稼動、終了、待機) を調べる間隔 (秒単位)。 

service.admin.starttime

"300"

カレンダサービスが開始するまで待機する秒数。 

service.admin.stoptime

"300"

カレンダサービスが終了するまで待機する秒数。 

service.admin.stoptime.next

"60"

カレンダサービスに終了コマンドを送信するまで待機する秒数。 

service.dcroot

"o=internet"

ディレクトリ内の DC ツリーのルートサフィックス。 

service.dnsresolveclient

"no"

"yes" に設定すると、HTTP アクセスが許可されるかどうかについて DNS に対してクライアント IP アドレスがチェックされます。 

service.plaintextloginpause

"0"

プレーンテキスト形式のパスワードによるユーザーの認証に成功した後の遅延時間 (秒単位)。 

service.http.admins

"calmaster"

この Calendar Server の管理権限を持つユーザー ID を空白文字で区切って指定します。 

service.http.allowadminproxy

"no"

"yes" に設定すると、プロキシ経由のログインが許可されます。 

service.http.allowanonymouslogin

"yes"

"yes" に設定すると、匿名アクセス (認証なし) が許可されます。これは特殊なタイプのログインであり、指定した制限付きのアクセス (通常は公開カレンダへの読み取り専用アクセス) のみが許可されます。 

service.http.calendarhostname

"" (Null)

HTML ドキュメントを取得するための HTTP ホスト。 

service.http.cookies

"yes"

cookie をサポートするかどうかをサーバーに指示します ("yes" または "no")。シングルサインオンを有効にするには、"yes" を指定する必要があります。

service.http.dbcachesize

"8388608"

HTTP セッション用の Berkeley データベースの最大キャッシュサイズ。 

service.http.domainallowed

"" (Null)

" " 以外を指定した場合は、TCP ドメインに基づくフィルタリングによってアクセスが許可されます。たとえば、「ALL:LOCAL.sesta.com」と指定した場合は、sesta.com ドメインのすべてのユーザーによるローカル HTTP アクセスが許可されます。複数のフィルタを指定する場合は、CR-LF (改行) で区切ります。

service.http.domainnotallowed

"" (Null)

" " 以外を指定した場合は、TCP ドメインに基づくフィルタリングによってアクセスが拒否されます。たとえば、「ALL:LOCAL.sesta.com」と指定した場合は、sesta.com ドメインのすべてのユーザーによる HTTP アクセスが拒否されます。複数のフィルタを指定する場合は、CR-LF (改行) で区切ります。

service.http.attachdir.path

"."

インポートされたファイルが一時的に格納されるディレクトリの local.queuedir への相対パス (指定する場合は絶対パス)。 

service.http.ipsecurity

"yes"

"yes" を指定すると、既存のセッションを参照するすべての要求は、同じ IP アドレスから発せられているものとして検証されます。 

service.http.enable

"yes"

"yes" を指定すると、すべてのサービスを開始するときに cshhpd サービスを開始し、すべてのサービスを終了するときに cshhpd サービスを終了します。

service.http.idletimeout

"120"

HTTP 接続をタイムアウトにするまでの秒数。 

service.http.ldap.enable

"yes"

"yes" を指定すると、認証用の LDAP 接続とユーザー設定が作成、維持されます。 

service.http.listenaddr

"INADDR_ANY"

HTTP サービスがクライアント要求を待機する TCP アドレスを指定します。"INADDR_ANY" は任意のアドレスを意味します。

service.http.logaccess

"no"

"yes" を指定すると、サーバーへの HTTP 接続が完全にログに記録されます。 

service.http.maxsessions

"5000"

cshttpd サービスでの HTTP セッションの最大数。 

service.http.maxthreads

"20"

cshttpd サービスでの HTTP 要求を処理するスレッドの最大数。 

service.http.numprocesses

"1"

サーバーでの実行が必要な HTTP サービス (cshttpd) プロセスの最大並行実行数。

複数の CPU を持つサーバーについては、「複数 CPU 間でのロードバランスの使用」を参照してください。

service.http.port

"80"

Calendar Server ユーザーからの HTTP 要求用のポート。 

service.http.proxydomainallowed

""

"" 以外を指定した場合は、TCP ドメインに基づくフィルタリングによってプロキシログインが許可されます。構文は service.http.domainallowed と同じです。

service.http.resourcetimeout

"900"

HTTP セッションをタイムアウトにするまでの秒数。 

service.http.sessiondir.path

"http"

HTTP セッション用の一時ディレクトリ。 

service.http.sessiontimeout

"1800"

cshttpd サービスで HTTP セッションをタイムアウトにするまでの秒数。

service.http.sourceurl

" "

実行可能ファイルへのすべての URL 参照が格納されるディレクトリの、実行可能ファイルに対する相対パス。 

service.http.tmpdir 

 

実行可能ファイルへのすべての URL 参照が格納されるディレクトリの、実行可能ファイルに対する相対パス。 

デフォルトは次のとおりです。"/var/opt/SUNWics5/tmp"

service.http.uidir.path

"html"

デフォルトのカレンダクライアントが格納されるディレクトリ。WCAP アクセスだけを許可する場合は "" を指定します。

service.ldapmemcache

"no"

"yes" を指定すると、LDAP SDK でキャッシュが使用されます。 

service.ldapmemcachettl

"30"

service.ldapmemcache に "yes" を指定した場合に、この値は LDAP SDK に渡されます。これは項目をキャッシュしておける最大秒数です。0 を指定した場合、項目をキャッシュしておける時間に制限が適用されなくなります。 

service.ldapmemcachesize

"131072"

service.ldapmemcache に "yes" を指定した場合に、この値は LDAP SDK に渡されます。これはキャッシュに使用できるメモリーの最大容量 (バイト単位) です。0 を指定した場合、キャッシュ容量の制限は適用されなくなります。 

service.wcap.anonymous

.allowpubliccalendarwrite 

"yes"

"yes" を指定すると、書き込み可能な公開カレンダに対する匿名ユーザーによる書き込みが許可されます。 

service.wcap.format

"text/calendar"

現在は空き/予定ありだけに適用されているコマンドのデフォルトの出力形式を指定します。 

service.wcap.freebusybegin

"30"

get_freebusy の範囲指定の開始時刻に適用される、現在時刻からのデフォルトのオフセットを指定します。 

service.wcap.freebusyend

"30"

get_freebusy の範囲指定の終了時刻に適用される、現在時刻からのデフォルトのオフセットを指定します。 

service.wcap.freebusy.redirecturl 

““ 

移行プロセスの場合、移行が部分的に行われると、カレンダが元のデータベースと Calendar Server のターゲットデータベースに分かれます。カレンダが Calendar Server データベースに見つからない場合に検索するための元のデータベースの URL です。 

service.wcap.allowcreatecalendars

"yes"

"yes" を指定すると、カレンダの作成が許可されます。 

service.wcap.allowdeletecalendars

"yes"

"yes" を指定すると、カレンダの削除が許可されます。 

service.wcap.allowchangepassword

"no"

"yes" を指定すると、このサーバー経由でのユーザーによるパスワードの変更が許可されます。 

service.wcap.

allowpublicwritablecalendars 

"yes"

"yes" を指定すると、ユーザーは、書き込み可能な公開カレンダを所有できます。 

service.wcap.allowsetprefs.cn

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "cn" (LDAP ユーザーの共通名) の変更が許可されます。 

service.wcap.allowsetprefs.givenname

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "givenname" (LDAP ユーザーの名 (姓名の名)) の変更が許可されます。 

service.wcap.allowsetprefs.icsCalendar

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "icsCalendar" (ユーザーのデフォルトカレンダ ID) の変更が許可されます。 

service.wcap.allowsetprefs.mail

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "mail" (ユーザーの電子メールアドレス) の変更が許可されます。 

service.wcap.allowsetprefs

.preferredlanguage 

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "preferredlanguage" (LDAP ユーザーの選択言語) の変更が許可されます。 

service.wcap.allowsetprefs.sn

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "sn" (LDAP ユーザーの姓) の変更が許可されます。 

service.wcap.allowsetprefs.nswccalid

"no"

"yes" を指定すると、set_userprefs.wcap 属性によるユーザー設定の "nswccalid" (ユーザーのデフォルトカレンダ ID) の変更が許可されます。 

service.wcap.login.calendar.publicread

"no"

"yes" を指定すると、ユーザーのデフォルトカレンダは公開読み取り/非公開書き込みに初期設定されます。"no" を指定すると、ユーザーのデフォルトカレンダは非公開読み取り/非公開書き込みに初期設定されます。 

service.wcap.userprefs.ldapproxyauth

"no"

"yes" を指定すると、get_userprefs.wcap コマンドの LDAP プロキシ認証が有効になります。"no" を指定すると、匿名の LDAP 検索が行われます。 

service.wcap.validateowners

"no"

"yes" を指定した場合、サーバーはディレクトリ内に存在するカレンダの各所有者を検証する必要があります (LDAP、または CSAPI 互換のユーザーディレクトリメカニズムを使用)。 

service.wcap.version

"3.0"

WCAP のバージョン。 

SSL の設定

次の表は、ics.conf の SSL 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。SSL パラメータのほとんどはデフォルト値を使用しますが、2 つのパラメータには SSL のデフォルト値を次のように変更する必要があります。

次の表に、ics.conf パラメータとそのデフォルト設定を示します。ics.conf パラメータに適切な値が設定されているかどうかを確認してください。

表 E–6 SSL の設定パラメータ

パラメータ 

デフォルト値 

説明 

encryption.rsa.nssslactivation

"on" 

SSL 用の RSA Cypher Encryption Family サービスを有効にします。 

encryption.rsa.nsssltoken

"internal" 

RSA Cypher Encryption Family トークンの場所を指定します。 

encryption.rsa.nssslpersonalityssl

"SampleSSLServerCert" 

RSA Cypher Encryption Family の証明書名を指定します。 

service.http.tmpdir 

"/var/opt/SUNWis5/
tmp"

一時ディレクトリを指定します。 

service.http.uidir.path 

“html” 

UI ファイルが格納されているディレクトリを指定します。 

service.http.ssl.cachedir

"." 

SSL キャッシュの場所への物理パスを指定します。 

service.http.ssl.cachesize

"10000" 

SSL キャッシュデータベースの最大サイズを指定します。 

service.http.ssl.usessl

"no" 

SSL 設定のために、値を “yes” に変更します。 

cshttpd プロセスが SSL サブシステムを使用するかどうかを指定します。

service.http.ssl.port.enable

"no" 

SSL 設定のために、値を “yes” に変更します。 


注 –

これによって、そのポートで待機するために HTTP プロセスが無効になることはありません。HTTP を実際に無効にする方法はありませんが、機能していない別のポートに HTTP を割り当てることができます。

service.http.enable=”no” を設定しないでください。HTTPS プロセスも無効になります。


service.http.ssl.port

"443" 

cshttpd プロセスが Calendar Server ユーザーからの HTTPS 要求を待機する SSL ポートの番号を指定します。

この値を、HTTP が使用するのと同じデフォルトポート ("80") に設定しないでください。

service.http.ssl.securesession

"yes" 

セッション全体を暗号化するかどうかを指定します。 

service.http.ssl.certdb.path

"alias" 

SSL 証明書データベースの場所への物理パスを指定します。 

service.http.ssl.certdb.password

"password"

SSL 証明書データベースのアクセスパスワードを指定します。 

service.http.ssl.sourceurl

"https://localhost:443"

発信元ソース URL の SSL ホスト名とポート番号を指定します。 

service.http.ssl.ssl2.ciphers

"" 

SSL2 用の暗号化方式を指定します。 

service.http.ssl.ssl2.sessiontimeout

"0" 

SSL2 のセッションタイムアウトを指定します。 

service.http.ssl.ssl3.ciphers

"rsa_rc4_40_md5,
rsa_rc2_40_md5,
rsa_des_sha,
rsa_rc4_128_md5,
rsa_3des_sha"

サポートされる、または有効な SSL 暗号化方式のリストを指定します。 

service.http.ssl.ssl3.

sessiontimeout 

"0"

SSL セッションのタイムアウト値を指定します。 

ホストされたドメインの設定

次の表は、ホストされた (仮想) ドメインの設定用パラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–7 ホストされたドメインをサポートするための設定パラメータ

パラメータ 

デフォルト値 

説明 

service.virtualdomain.

support

"n"

ホストされた (仮想) ドメインモードのサポートを有効 ("y") または無効 ("n") にします。

local.schemaversion

"1"

LDAP スキーマのバージョンを指定します。 

  • "1" = Sun LDAP Schema 1。 service.dcroot も参照してください。

  • "2" = Sun LDAP Schema 2。 service.schema2root も参照してください。

service.dcroot

" "

local.schemaversion = 1 の場合に、LDAP ディレクトリの DC ツリーのルートサフィックスを指定します。次に例を示します。"o=internet"

service.schema2root

" "

local.schemaversion = 2 の場合に、下にすべてのドメインが属するルートサフィックスを指定します。次に例を示します。"o=sesta.com"

service.defaultdomain

" "

Calendar Server のこのインスタンスのデフォルトドメインを指定します。ログイン時にドメイン名が指定されない場合は、このドメイン名が適用されます。次に例を示します。"sesta.com"

service.loginseparator

"@+"

Calendar Server が userid[login-separator ]domain をパースするときに login-separator で使用される区切り文字を指定します。Calendar Server は各区切り文字を順に使用します。

service.siteadmin.userid

" "

ドメイン管理者のユーザー ID を指定します。 

service.siteadmin.cred

" "

ドメイン管理者のパスワードを指定します。 

アラーム通知のパラメータ

次の表は、アラーム通知サーバー設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–8 ics.conf ファイルのアラーム通知設定用パラメータ

パラメータ 

デフォルト値 

説明 

alarm.diskstat.msgalarmdescription

"percentage calendar partition disk space available"

ディスク容量の不足時に送信されるメッセージ。 

alarm.diskstat.msgalarmstatinterval

"3600"

ディスク容量を監視する間隔 (秒単位)。 

alarm.diskstat.msgalarmthreshold

"10"

警告メッセージの送信対象となる使用可能なディスク容量の割合 (パーセント)。 

alarm.diskstat.msgalarmthresholddirection

"-1"

alarm.diskstat.msgalarmthreshold に設定される割合を上回っているか、または下回っているか。-1 は下回っており、1 は上回っています。

alarm.diskstat.

msgalarmwarninginterval

"24"

不十分なディスク容量に関する警告メッセージを送信する間隔 (時間単位)。 

alarm.msgalarmnoticehost

"localhost"

サーバーアラームの送信に使用される SMTP サーバーのホスト名。 

alarm.msgalarmnoticeport

"25"

サーバーアラームの送信に使用される SMTP ポート。 

alarm.msgalarmnoticercpt

"Postmaster
@localhost"

サーバーアラームの送信先電子メールアドレス。 

alarm.msgalarmnoticesender

"Postmaster
@localhost"

サーバーが送信するアラームの送信元として指定される電子メールアドレス。 

alarm.msgalarmnoticetemplate

""

送信する電子メールアラームのデフォルト形式。 

"From: %s\nTo: %s\nSubject: ALARM: %s of \"%s\" is n\n%s\n"

alarm.responsestat.

msgalarmdescription

"calendar service not responding"

サービスからの応答がない場合に送信されるメッセージ。 

alarm.responsestat.

msgalarmstatinterval

"3600"

サービスを監視する間隔 (秒単位)。 

alarm.responsestat.

msgalarmthreshold

"100"

サービスの応答がない場合にだけ警告メッセージを送信します。 

alarm.responsestat.

msgalarmthresholddirection

"-1"

alarm.responsestat.

msgalarmthreshold の割合を上回っているか、または下回っているかを指定します。

-1 は下回っており、1 は上回っています。

alarm.responsestat.

msgalarmwarninginterval

"24"

サービスからの応答がないことに関する警告メッセージを送信する間隔 (時間単位)。 

カレンダ検索データベースの設定

次の表は、カレンダ検索データベース (CLD) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–9 ics.conf ファイルのカレンダ検索データベース (CLD) 設定パラメータ

パラメータ 

デフォルト値 

説明 

csapi.plugin.calendarlookup

"n"

カレンダ検索プラグインを有効 ("y") または無効 ("n") にします。

csapi.plugin.calendarlookup.name

"*"

ロードするカレンダ検索プラグインの名前を指定します。この値にアスタリスク ("*") を指定すると、Calendar Server はすべてのプラグインをロードします。

caldb.cld.type

"local"

使用する CLD プラグインの種類を指定します。 

"local" は、Calendar Server が稼動するローカルサーバーにすべてのカレンダが格納され、プラグインをロードしないことを指定します。

"directory" は、LDAP CLD プラグインを指定します。 目的のカレンダを格納しているサーバーは、カレンダ所有者の icsDWPHost LDAP 属性を使用して特定されます。

caldb.dwp.server.default

" "

LDAP サーバーデータベース内のユーザーまたはリソースのカレンダエントリが icsDWPHost 属性を持たない場合に、Calendar Server が使用するデフォルトの DWP サーバーの名前を完全修飾名で指定します。 

Communications Express 経由、または WCAP コマンドを使用して Calendar Server にログインするユーザーが icsDWPHost 属性を持たない場合、Calendar Server はこのパラメータを使用して属性の自動プロビジョニングを行います。

ユーザーがすでに icsDWPHost 属性を持っている場合は、caldb.dwp.server.default は使用されません。

この名前は、DNS (ドメイン名サービス) によって有効な IP アドレスに解決できる必要があります。 

caldb.cld.cache.enable

"yes"

カレンダ検索データベース (CLD) のキャッシュオプションを有効 ("yes") または無効 ("no") にします。LDAP CLD プラグインのパフォーマンスを最適にするには、"yes" を指定します。

caldb.cld.cache.logfilesizemb

"10"

チェックポイントファイルの最大サイズを M バイト単位で指定します。 

caldb.cld.cache.mempoolsizemb

"4"

共有メモリーのサイズを M バイト単位で指定します。 

caldb.cld.cache.maxthread

"1000"

データベーススレッドの最大数を指定します。 

caldb.cld.cache.homedir.path

"."

CLD キャッシュオプションのデータベース予定、作業、アラームファイルの場所を指定します。デフォルト値の "." を指定した場合、これらのファイルは /var/opt/SUNWics5/csdb/cld_cache ディレクトリに格納されます。

caldb.cld.cache.checkpointinterval

"60"

チェックポイントの間隔を秒単位で指定します。 

caldb.cld.cache.circularlogging

"yes"

CLD キャッシュオプション用に同期されたあとにチェックポイントファイルを削除するかどうかを指定します。 

caldb.dwp.server.host-name .ip

" "

カレンダデータベースを格納するサーバーのホスト名を指定します。このサーバーでは、DWP (csdwpd) サービスが稼動している必要があります。この名前は、DNS (ドメイン名サービス) によって有効な IP アドレスに解決できる必要があります。このパラメータには、LDAP CLD プラグインによって使用されます。 

注: パラメータの各部で同じ host-name を完全修飾名で指定します。次に例を示します。

caldb.dwp.server.sesta.com.ip="sesta.com"

caldb.dwp.connthreshold

"1"

サーバーが新しいネットワーク接続を獲得する前にバックログされる要求の最大数。 

caldb.dwp.initconns

"2"

DWP (データベースワイヤプロトコル) サービスクライアントが各 DWP サービスホストに対して確立する接続の初期数。 

caldb.dwp.initthreads

"2"

DWP (データベースワイヤプロトコル) サービス要求を処理するスレッドの初期数。 

caldb.dwp.maxcons

"1000"

DWP (データベースワイヤプロトコル) サービスを使用するサーバーに許容される接続の最大数。 

caldb.dwp.maxthreads

"20"

DWP (データベースワイヤプロトコル) サービスを使用するサーバーに許容されるスレッドの最大数。 

caldb.dwp.md5

"n"

すべての DWP (データベースワイヤプロトコル) サービス要求に対してサーバーが MD5 (Message Digest 5) の一方向ハッシュチェックを行うかどうかを指定します。一方向ハッシュ機能は、メッセージ認証用の電子署名を作成するために使用されます。 

  • "n": MD5 ハッシュチェックを無効にします。

  • "y": MD5 ハッシュチェックを有効にします。

caldb.dwp.server.hostname.ip

" "

指定したマシンのホスト名で DWP (データベースワイヤプロトコル) サービスを使用するサーバーの IP アドレスを指定します。 

caldb.dwp.server.hostname.port

"9779"

指定したマシンのホスト名で DWP (データベースワイヤプロトコル) サービスを使用するサーバーのポート番号を指定します。 

caldb.dwp.server.back-end-server .admin

" "

フロントエンドサーバーで、バックエンドサーバーとの DWP 接続の認証に使用されるユーザー ID を指定します。 back-end-server はサーバー名です。 

caldb.dwp.server.back-end-server.cred

" "

フロントエンドサーバーで、バックエンドサーバーとの DWP 接続の認証に使用されるパスワードを指定します。 back-end-server はサーバー名です。

caldb.dwp.stacksize

"65536"

DWP (データベースワイヤプロトコル) サービススレッドのスタックサイズ。 

caldb.cld.directory.ldapbasedn

 

LDAP プラグインがカレンダ検索機構に使用されている場合の認証するベース DN。 

caldb.cld.directory.ldaphost

 

LDAP プラグインがカレンダ検索機構に使用される場合にアクセスする LDAP サーバーのホスト名。 

caldb.cld.directory.ldapbindcred

 

LDAP プラグインがカレンダ検索機構に使用される場合に local.authldapbinddn の設定で指定されたユーザーのバインド資格情報 (パスワード)。

caldb.cld.directory.ldapbinddn

 

LDAP プラグインがカレンダ検索機構に使用される場合に、ユーザーの DN を検索するための認証用のバインドに使用する DN。 

caldb.cld.directory.ldapport

"389" 

LDAP プラグインがカレンダ検索機構に使用される場合にアクセスする LDAP サーバーのポート番号。 

csapi.plugin.authentication

"n" 

"y" を指定すると、csapi.plugin.authentication.name に設定されるプラグインだけがロードされます。 指定しない場合は、すべての認証クラスプラグインがアルファベット順にロードされます。認証には、これらのプラグインがアルファベット順に使用されます。

csapi.plugin.authentication.name

" " 

csapi.plugin.loadall に "n" を指定し、csapi.plugin.authentication に "y" を指定した場合、このプラグインだけがロードされます。指定しない、または空白 (" ") の場合、すべての認証クラスプラグインがロードされます。 

logfile.dwp.buffersize

"0" 

DWP (データベースワイヤプロトコル) サービスのログバッファーのサイズ (バイト単位)。 

logfile.dwp.expirytime

"604800" 

DWP (データベースワイヤプロトコル) サービスのログファイルの有効期限が切れるまでの時間 (秒単位)。 

logfile.dwp.flushinterval

"60" 

バッファーの内容を DWP (データベースワイヤプロトコル) サービスのログファイルにフラッシュする間隔 (秒単位)。 

logfile.dwp.logdir

"logs" 

DWP (データベースワイヤプロトコル) サービスのログファイルが格納されるディレクトリ。 

logfile.dwp.loglevel

"Notice" 

サーバーがログに記録する DWP (データベースワイヤプロトコル) の情報の詳細度を指定します。DWP (データベースワイヤプロトコル) の各ログレベルには、次のいずれかのレベルが割り当てられます。CRITICAL、ERROR、WARNING、NOTICE、INFORMATION、DEBUG (重要度順)。この詳細度を CRITICAL に設定した場合、サーバーがログに記録する情報の詳細度は最も低くなります。最も高い詳細度でログを記録するには、DEBUG を指定します。たとえば、WARNING を指定した場合は、CRITICAL、ERROR、WARNING の各レベルのログレベルのみが記録されます。 

logfile.dwp.maxlogfiles

"10" 

ログディレクトリ内の DWP (データベースワイヤプロトコル) に関連したログファイルの最大数。 

logfile.dwp.maxlogfilesize

"2097152" 

DWP (データベースワイヤプロトコル) の各ログファイルの最大サイズ (バイト単位)。 

logfile.dwp.maxlogsize

"20971520" 

DWP (データベースワイヤプロトコル) のすべてのログファイルの最大合計ディスク容量 (バイト単位)。 

logfile.dwp.minfreediskspace

"5242880" 

DWP (データベースワイヤプロトコル) サービスアクティビティーのログ記録用に必要な最小ディスク空き容量 (バイト単位)。この値に達すると、サーバーは古いログファイルの有効期限を終了してディスクの空き容量を増やそうとします。最小空き容量を回復できない場合、すべてのログの記録は一時的に停止されます。 

logfile.dwp.rollovertime

"86400" 

DWP (データベースワイヤプロトコル) サービスのログファイルのローテーション間隔 (秒単位)。 

service.dwp.admin.userid

" " 

バックエンドサーバーで、DWP 接続の認証に使用するユーザー ID を指定します。このパラメータは省略可能です。バックエンドサーバーがユーザー ID を指定しない場合、認証は行われません。 

service.dwp.admin.cred

" " 

バックエンドサーバーで、DWP 接続の認証に使用するパスワードを指定します。このパラメータは省略可能です。バックエンドサーバーがパスワードを指定しない場合、認証は行われません。 

service.dwp.calendarhostname

"localhost" 

DWP (データベースワイヤプロトコル) を実行しているマシンのホスト名。 

service.dwp.maxthreads

"1000" 

並行して実行できる DWP (データベースワイヤプロトコル) サービススレッドの最大数。 

service.dwp.numprocesses

"1" 

サーバーでの実行が必要な DWP (データベースワイヤプロトコル) サービス (csdwpd) プロセスの最大並行実行数。

複数の CPU を持つサーバーについては、「複数 CPU 間でのロードバランスの使用」を参照してください。

service.dwp.enable

"no" 

"yes" を指定すると、すべてのサービスを開始するときに csdwpd サービスを開始し、すべてのサービスを終了するときに csdwpd サービスを終了します。

service.dwp.idletimeout

"86400" 

アイドル状態にある DWP (データベースワイヤプロトコル) サービスの持続的接続を閉じるまでの時間 (秒単位)。 

service.dwp.port

"59779" 

DWP (データベースワイヤプロトコル) サービスが待機するポートの番号。この値は、LDAP CLD プラグインのデフォルトポート番号です。 

service.dwp.ldap.enable

"yes" 

DWP (データベースワイヤプロトコル) サービス (csdwpd) のリモートユーザーの認証で LDAP を有効 ("yes") または無効 ("no") にします。

service.calendarsearch.ldap 

"yes" 

Calendar Server が LDAP ディレクトリの後にカレンダデータベースを検索するか ("yes")、カレンダデータベースだけを検索するか ("no") を指定します。 

LDAP データキャッシュの設定パラメータ

次の表は、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 リソースカレンダの設定パラメータ

パラメータ 

デフォルト値 

説明 

resource.allow.doublebook

"no"

カレンダの作成時に、リソースカレンダ (会議室や視聴覚機器などのリソースのカレンダ) の同一時間帯に複数の予定をスケジューリングできるように設定するかどうかを指定します。 

  • "no": 複数のユーザーからの予約は拒否されます。

  • "yes": 複数のユーザーからの予約は許可されます。

    このパラメータは、リソースカレンダの作成時にのみ使用されます。

    リソースカレンダの作成後は、Calendar Server はカレンダのプロパティー (ics50calprops.db) を参照して複数のユーザーからの予約の可否を決定します。

    リソースカレンダのカレンダプロパティーを変更して複数のユーザーからの予約の可否を変更する場合は、-k オプションを指定した csresource コマンドを実行します。

resource.default.acl

 

リソースカレンダを作成するときに使用されるデフォルトのアクセス制御設定を指定します。 

デフォルトは次のとおりです。"@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g"

シングルサインオン (SSO) の設定

Access Manager による SSO の設定

次の表は、Access Manager を使用する場合の SSO 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–12 ics.conf ファイルの SSO 設定パラメータ (Access Manager を使用する場合)

パラメータ 

デフォルト 

説明 

local.calendar.sso.singlesignoff 

”yes” 

Calendar Server の SSO を有効 (“yes”) または無効 (“no”) にします。 

local.calendar.sso.amcookiename 

“iPlanetDirectoryPro” 

Access Manager の SSO cookie 名を指定します。 

local.calendar.sso.amnamingurl 

”http://AccessManager:port
/amserver/namingservice”

Access Manager の SSO ネーミングサービスの URL を指定します。

local.calendar.sso.amloglevel 

”3” 

Access Manager SSO のログレベルを指定します。範囲は 1 (非出力) から 5 (詳細) です。 

local.calendar.sso.logname 

“am_sso.log” 

Access Manager の SSO API ログファイル名を指定します。 

Communications サーバーの信頼できるサークルテクノロジを利用した SSO の設定

次の表は、Communications サーバーの信頼できるサークルテクノロジを使用する場合の SSO 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–13 ics.conf ファイルの SSO 設定パラメータ (Communications サーバーの信頼できるサークルテクノロジを使用する場合)

パラメータ 

デフォルト値 

説明 

sso.appid

"ics50"

Calendar Server のこのインストールの一意のアプリケーション ID。信頼できるそれぞれのアプリケーションは、一意のアプリケーション ID を持ちます。例: sso.appid="ics50"

sso.appprefix

"ssogrp1"

SSO cookie のフォーマットに使用される接頭辞値。Calendar Server は、この接頭辞を持つ SSO cookie だけを認識するため、信頼できるすべてのアプリケーションがこれと同じ値を使用する必要があります。 

Calendar Server が値にハイフン (-) を追加するため、アプリケーションの接頭辞はハイフンで終わってはいけません。次に例を示します。

sso.appprefix="ssogrp1"

sso.appid.url

 

sso.appid に指定された値の検証 URL。例:

"sso.ics50.url="http://siroe.com:80/
default.html"

sso.nnn.ip

sso.appid.ip

sso.appid に指定された値の IP アドレス。例: sso.ics50.ip=

"123.12.456.123"

sso.cookiedomain

"."

指定ドメイン内のサーバーだけに cookie を送信するようにブラウザに指示します。 

この値は、ピリオド (.) から開始する必要があります。次に例を示します。

".sesta.com"

sso.enable

"1"

SSO を有効または無効にします。 

  • "1" (デフォルト): SSO 機能を有効にします。

  • "0": SSO 機能を無効にします。

    このパラメータが ics.conf に指定されていない場合、Calendar Server は SSO 機能を無視します。

sso.singlesignoff

"true"

"true" を指定すると、ユーザーがログアウトするときに、サーバーは sso.apprefix の設定値と一致するユーザーのすべての SSO cookie を削除します。"false" を指定した場合は、サーバーは SSO ユーザー cookie だけを削除します。

sso.userdomain

" "

ユーザーの SSO 認証の一部として使用されるドメインを指定します。 

sso.appid.url=" verifyurl"

" "

ピア SSO ホストの検証 URL 値を指定します。信頼できるピアごとにこのパラメータが必要となります。 

appid は、SSO cookie が信頼できるピア SSO ホストのアプリケーション ID です。Calendar Server の appidics50 です。

verifyurl は、次の形式で信頼できるピアの URL を識別します。"http://host:port/VerifySSO?"VerifySSO のあとの疑問符 (?) を省略しないでください。

host はホストの URL、port はホストのポート番号を示します。 

たとえば、ポート番号 8883 の sesta.com 上の Calendar Server であれば、次のように指定します。

sso.ics50.url=

"http://sesta.com:8883/VerifySSO?"

GSE (グループスケジューリングエンジン) の設定

次の表は、GSE (グループスケジューリングエンジン) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–14 ics.conf ファイルの GSE (グループスケジューリングエンジン) 設定パラメータ

パラメータ 

デフォルト値 

説明 

gse.autorefreshreplystatus

"yes"

自動再読み込み機能を有効または無効にします。自動再読み込みを有効にすると、出席者が予定企画者に返信したあとに、その出席者の返信状態が、予定されているその予定のその他の出席者にも反映されます。 

  • "yes": 自動再読み込みを有効にします。

  • "no": 自動再読み込みを無効にします。

gse.belowthresholdtimeout

"3" 

受信ジョブのスケジュールキューをサーバーが走査するまでの時間を秒単位で指定します。キューに含まれるジョブが許容最大しきい値より多い場合、最後のスレッドが常にジョブキューをもう一度走査します。このため、この設定はジョブの数が最大しきい値より少ない場合にだけ適用されます。 

この値を大きくすると、サーバーがジョブキューを走査する回数が減り、全体的なパフォーマンスが向上します。 

gse.maxthreads

"10" 

スケジュールキューを処理するためにサーバーが並行して使用できるスレッドの最大数を指定します。各スレッドは、キュー内の 1 つのジョブを処理します。 

gse.retryexpiredinterval

"86400" 

サーバーがグループスケジューリングジョブの完了を再試行する最大時間を秒単位で指定します。再試行の時間が指定の最大時間を超えると、サーバーは再試行有効期限が切れた状態としてそのジョブを扱い、エラーを出力します。 

デフォルト値の 86400 秒は 1 日を意味することに注意してください。 

gse.retryinterval

"300" 

直前に失敗したジョブをサーバーが再試行する頻度を秒単位で指定します。サーバーは、ネットワークエラーが発生した場合にだけ失敗ジョブを再試行します。ただし、このようなエラーのほとんどは致命的なエラーとして扱われ、再試行とは見なされません。 

gse.stacksize

"65535" 

グループスケジューリングスレッドの最大スタックサイズを指定します (バイト単位)。 

データベースの設定

次の表は、データベース処理の設定で使用される ics.conf パラメータを一覧表示し、各パラメータのデフォルト値と説明を示しています。

表 E–15 ics.conf ファイルのデータベース設定用パラメータ

パラメータ 

デフォルト値 

説明 

caldb.berkeleydb.checkpointinterval

"60"

チェックポイントデータベーストランザクションの間隔 (秒単位)。 

caldb.berkeleydb.circularlogging

"yes"

"yes" を指定すると、トランザクションの同期がとれた後でデータベースチェックポイントファイルが削除されます。自動バックアップを有効にしていないかぎり、この値を “no” に設定しないでください。

caldb.berkeleydb.deadlockinterval

"100"

ブレークが必要なデータベースデッドロックのチェック間隔 (ミリ秒単位)。 

caldb.berkeleydb.homedir.path

"."

データベース予定、作業、アラームファイルが格納されるディレクトリ (プログラム実行可能ファイルに対する相対パス、または絶対パス)。デフォルトは “.” で、次のディレクトリが指定されます。 

/var/opt/SUNWics5/csdb

caldb.berkeleydb.logfilesizemb

"10"

データベースチェックポイントファイルの最大サイズ (M バイト単位)。 

caldb.berkeleydb.maxthreads

"10000"

データベース環境で準備が必要なスレッドの最大数。 

caldb.berkeleydb.mempoolsizemb

"4"

データベース環境の共有メモリーのサイズ (M バイト単位)。 

caldb.calmaster

" "

データベースの管理を担当するユーザーまたはエイリアスの電子メールアドレス。 

caldb.counters

"yes"

"yes" を指定すると、データベース統計情報 (読み取り、書き込み、削除) がカウントされます。

caldb.counters.maxinstances

"100"

カウンタを持てるカレンダの最大数。カレンダでカウンタを有効にするには、cscal コマンド行ユーティリティーを使用します。

caldb.smtpmsgfmtdir

"en"

電子メール通知のフォーマットに使用するファイルのローカライズされたバージョンを含む、/etc/opt/SUNWics5/config 内のディレクトリを指定します。

たとえば、"en" は英語にローカライズされたバージョンのディレクトリを指定し、"fr" はフランス語にローカライズされたバージョンのディレクトリを指定します。 

caldb.smtpport

"25"

SMTP ホストのポート。 

カレンダデータベースの自動バックアップ

次の表は、自動バックアッププロセス (csstored) で使用されるパラメータを一覧表示し、使用可能なデフォルト値と ics.conf パラメータの説明を示しています。

表 E–16 自動バックアッププロセスで使用される ics.conf パラメータ

パラメータ 

デフォルト値 

説明 

logfile.store.logname

defaultstore.log

ログファイルの名前。 

logfile.logdir

"."

ログディレクトリへのパス。 

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" に設定する必要があります。

ENS メッセージ用のカレンダデータベースパラメータ

次の表は、カレンダデータベースの設定で使用されるパラメータ、デフォルト値、およびその説明を示しています。デフォルト値以外の値を指定するときは、ics.conf ファイルで設定する必要があります。

表 E–17 ENS メッセージ用のカレンダデータベースパラメータ

パラメータ 

デフォルト値 

説明 

caldb.serveralarms.url

"enp:///ics/alarm"

ENS メッセージの URL を指定します。 

caldb.serveralarms.contenttype

""

アラームデータの内容の種類を指定します。"text/xml" または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.createcal

"no"

カレンダの作成時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.createcal.url

"enp:///ics/calendarcreate"

ENS メッセージの URL を指定します。 

caldb.berkeleydb.ensmsg.createcal.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.deletecal

"no"

カレンダの削除時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.deletecal.url

"enp:///ics/calendardelete"

ENS メッセージの URL を指定します。 

caldb.berkeleydb.ensmsg.deletecal.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.modifycal

"no"

カレンダの修正時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.modifycal.url

"enp:///ics/calendarmodify"

ENS メッセージの URL。 

caldb.berleleydb.ensmsg.modifycal.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.createevent

"no"

予定の作成時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.createevent.url

"enp:///ics/caleventcreate"

ENS メッセージの URL を指定します。 

caldb.berleleydb.ensmsg.createevent.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.modifyevent

"no"

予定の修正時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.modifyevent.url

"enp:///ics/caleventmodify"

ENS メッセージの URL を指定します。 

caldb.berleleydb.ensmsg.modifyevent.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.deleteevent

"no"

予定の削除時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.deleteevent.url

"enp:///ics/caleventdelete"

ENS メッセージの URL を指定します。 

caldb.berkeleydb.ensmsg.deleteevent.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.createtodo

"no"

仕事の作成時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.createtodo.url

"enp:///ics/caltodocreate"

ENS メッセージの URL を指定します。 

caldb.berleleydb.ensmsg.createtodo.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.modifytodo

"no"

仕事の修正時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.modifytodo.url

"enp:///ics/caltodomodify"

ENS メッセージの URL を指定します。 

caldb.berleleydb.ensmsg.modifytodo.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.deletetodo

"no"

仕事の削除時に ENS メッセージを作成します。 

caldb.berkeleydb.ensmsg.deletetodo.url

"enp:///ics/caltododelete"

ENS メッセージの URL を指定します。 

caldb.berkeleydb.ensmsg.deletetodo.contenttype

"text/xml"

メッセージデータの内容の種類を指定します。"text/xml" (デフォルト) または "text/calendar" を指定できます。

ENS (予定通知サーバー) の設定

Calendar Server は、ENS (予定通知サーバー) という外部の汎用サービスを使用するように設定できます。 ENS は、特定の領域に分類できるサーバーレベルの予定レポートを受け付け、特定の予定カテゴリが登録されているほかのサーバーに、そのカテゴリの予定について通知します。Calendar Server は ENS を使用してアラーム通知を送受信します。 この通知には、運用上の一般的な警告やエラーメッセージだけでなく、カレンダ予定および作業の作成、削除、修正も含まれます。

次の表は、ics.conf ファイル内の ENS (予定通知サーバー) 設定用パラメータを示しています。また、各パラメータのデフォルト値と説明も示しています。

表 E–18 ics.conf ファイルの ENS (予定通知サーバー) 設定用パラメータ

パラメータ 

デフォルト値 

説明 

service.ens.enable

"yes"

"yes" を指定すると、すべてのサービスを開始するときに enpd サービスを開始し、すべてのサービスを終了するときに enpd サービスを終了します。

service.ens.host

"localhost"

ENS が稼働するマシンのホスト名。 

service.ens.port

"57997"

ENS が稼働するマシンのポート番号。 

service.ens.library

"xenp"

ENS プラグインの名前。 

service.notify.enable

"yes"

"yes" を指定すると、すべてのサービスを開始するときに csnotifyd サービスを開始し、すべてのサービスを終了するときに csnotifyd サービスを終了します。

service.notify.maxretrytime

"-1"

ENS への接続に失敗した場合に csnotifyd が何回連続して再試行するかを指定します。 

"-1" を指定すると、アラームスレッドが無制限に再試行を繰り返します。

service.notify.retryinterval

"3"

ENS への接続に失敗したあとに、csnotifyd が再試行を開始するまでの秒数。

service.notify.startupretrytime

"0"

Calendar Server が ENS への接続試行を停止するまでの合計秒数。この設定は caldb.serveralarms.maxretrytime に似ていますが、これはアラームスレッドが最初に開始された場合にだけ適用されます。アラームスレッドが正常に開始されたあとは、caldb.serveralarms.maxretrytime が使用されます。

"0" を指定すると、起動時に ENS への接続に失敗した直後にアラームスレッドが終了します。

ens.startlistener

"0"

許容できる値は次のとおりです。 

  • "1"

  • "0"

caldb.berkeleydb.alarmretrytime

"300"

復元可能なアラーム配信エラーの発生後、再試行までの時間を秒単位で指定します。 

caldb.berkeleydb.ensmsg.createcal

"no"

"yes" を指定すると、次の形式のカレンダが作成されたときに ENS (予定通知サービス) メッセージが作成されます。 

enp://ics/createcal?calid=cal

caldb.berkeleydb.ensmsg.modifycal

"no"

"yes" を指定すると、次の形式のカレンダが修正されたときに ENS (予定通知サービス) メッセージが作成されます。

enp://ics/modifycal?calid=cal

caldb.berkeleydb.ensmsg.deletecal

"no"

"yes" を指定すると、次の形式のカレンダが削除されたときに ENS (予定通知サービス) メッセージが作成されます。

enp://ics/deletecal?calid=cal

caldb.berkeleydb.ensmsg.advancedtopics

"no"

修正予定通知の配信方法を指定します。 

  • "yes": システムは次のそれぞれのトピックに配信することによって、replyrefresh、または modify の各トランザクションを区別します。

    caldb.berkeleydb.ensmsg.replyevent

    caldb.berkeleydb.ensmsg.refreshevent

    caldb.berkeleydb.ensmsg.modifyevent

  • "no": システムは 3 つのタイプ (replyrefreshmodify) のすべてを次のトピックに配信します。

    caldb.berkeleydb.ensmsg.modifyevent

caldb.berkeleydb.ensmsg.createevent

"no"

"yes" を指定すると、予定の作成時に ENS (予定通知サービス) メッセージが作成されます。

caldb.berkeleydb.ensmsg.deleteevent

"no"

"yes" を指定すると、予定の削除時に ENS (予定通知サービス) メッセージが作成されます。

caldb.berkeleydb.ensmsg.modifyevent

"no"

"yes" を指定すると、予定の修正時に ENS (予定通知サービス) メッセージが作成されます。

caldb.berkeleydb.ensmsg.refreshevent

"no"

予定の再読み込み時に Calendar Server が ENS (予定通知サービス) メッセージを作成するかどうかを指定します。 

caldb.berkeleydb.ensmsg.refreshevent.contenttype

"text/xml"

予定の再読み込みに関するメッセージデータの内容の種類を指定します。"text/xml" または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.refreshevent.url

"enp:///ics/caleventrefresh"

予定の再読み込みに関する ENS (予定通知サービス) メッセージの URL を指定します。 

caldb.berkeleydb.ensmsg.replyevent

"no"

予定の返信に関する ENS (予定通知サービス) メッセージを Calendar Server が作成するかどうかを指定します。 

caldb.berkeleydb.ensmsg.replyevent.contenttype

"text/xml"

予定の返信に関するメッセージデータの内容の種類を指定します。"text/xml" または "text/calendar" を指定できます。

caldb.berkeleydb.ensmsg.replyevent.url

"enp:///ics
/caleventreply"

予定の返信に関する ENS (予定通知サービス) メッセージの URL を指定します。 

caldb.berkeleydb.ensmsg.createtodo

"no"

"yes" を指定すると、次の形式の仕事 (作業) が作成されたときに ENS (予定通知サービス) メッセージが作成されます。

enp://ics/createtodo?
uid=uid&rid=rid

caldb.berkeleydb.ensmsg.modifytodo

"no"

"yes" を指定すると、次の形式の仕事 (作業) が修正されたときに ENS (予定通知サービス) メッセージが作成されます。 

enp://ics/modifytodo?
uid=uid&rid=rid

caldb.berkeleydb.ensmsg.deletetodo

"no"

"yes" を指定すると、次の形式の仕事 (作業) が削除されたときに ENS (予定通知サービス) メッセージが作成されます。

enp://ics/deletetodo?uid=uid&rid=rid

caldb.berkeleydb.ensmsg.qsize

"10000"

メモリー内の ENS (予定通知サーバー) メッセージキューの初期サイズ。このキューには、アラーム以外の ENS メッセージが格納されます。 

caldb.berkeleydb.ensmsg.schedreq

"no"

"yes" を指定すると、次の形式の削除されたカレンダにスケジューリング要求が書き込まれたときに ENS (予定通知サービス) メッセージが作成されます。

enp://ics/schedreq?calid=cal
&method=method&type={event|todo}
&uid=uid&rid=rid

caldb.serveralarms

"yes"

"yes" を指定すると、アラーム電子メールが送信されます。 

caldb.serveralarms.acktimeout

"30"

ENS (予定通知サーバー) のアラームスレッドが、アラーム通知の配信後、csnotifyd からの受信確認を待つ秒数を指定します。この時間が経過すると、アラームスレッドはアラーム通知が処理されていないものと見なし、アラーム通知を再配信します。 

caldb.serveralarms.dispatchtype

"ens"

Calendar Server アラームの送信タイプを指定します。 

  • "ens": サーバーは外部の ENS (予定通知サーバー) を使用してアラームを送受信します。

  • "smtp": サーバーは ENS (予定通知サーバー) をバイパスし、標準の SMTP メッセージとしてアラームを送信します。

caldb.serveralarms.initthreads

"10"

サーバーアラームスレッドの初期数。 

caldb.serveralarms.maxretrytime

"-1"

ENS (予定通知サーバー) への接続に失敗した場合にアラームスレッドが何回連続して再試行するかを指定します。 

"-1" を指定すると、アラームスレッドが無制限に再試行を繰り返します。

caldb.serveralarms.maxthreads

"10"

サーバーアラームスレッドの最大数。 

caldb.serveralarms.retryinterval

"5"

アラームスレッド (csadmind に含まれる) が ENS (予定通知サーバー) への再接続を試行するまでの秒数。 

caldb.serveralarms.stacksize

"65536"

サーバーアラームスレッドのスタックフレームのサイズ。 

caldb.serveralarms.startupretrytime

"0"

Calendar Server が、失敗するまでに ENS への接続試行を続ける合計秒数。この設定は caldb.serveralarms.maxretrytime に似ていますが、これはアラームスレッドが最初に開始された場合にだけ適用されます。アラームスレッドが正常に開始されたあとは、caldb.serveralarms.maxretrytime が使用されます。 

"0" を指定すると、起動時に ENS への接続に失敗した直後にアラームスレッドが終了します。

caldb.smtphost

"localhost"

この SMTP ホストにアラーム電子メールが送信されます。 

Calendar Server API の設定

次の表は、Calendar Server API (CSAPI) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–19 ics.conf ファイルの CSAPI 設定用パラメータ

パラメータ 

デフォルト値 

説明 

csapi.plugin.authentication

"n"

"y" を指定すると、csapi.plugin.authentication.name に設定されているプラグインだけがロードされます。

csapi.plugin.accesscontrol

"n"

アクセス制御プラグインを有効 ("y") または無効 ("n") にします。

csapi.plugin.authentication

"n"

"y" を指定すると、csapi.plugin.authentication.name に設定されているプラグインだけがロードされます。

"n" を指定する、または値を指定しない場合は、すべての認証クラスプラグインがアルファベット順にロードされます。認証には、これらのプラグインがアルファベット順に使用されます。

csapi.plugin.authentication.

name

" "

csapi.plugin.loadall"n" を指定し、csapi.plugin.authentication"y" を指定した場合、このプラグインだけがロードされます。指定しない、または空白 (" ") の場合、すべての認証クラスプラグインがロードされます。

csapi.plugin.database

"y"

"y" を指定すると、csapi.plugin.database.name に設定されているプラグインだけがロードされます。

"n" を指定する、または指定しない場合、すべてのデータベースプラグインがアルファベット順にロードされます。

csapi.plugin.database.name

"cs_caldb
_berkeley10"

csapi.plugin.loadall"n" を指定し、csapi.plugin.database"y" を指定した場合、このプラグインだけがロードされます。指定しない、または空白 (" ") の場合、すべてのデータベースプラグインがアルファベット順にロードされます。

csapi.plugin.datatranslator

"y"

"y" を指定すると、csapi.plugin.datatranslator.name に設定されるプラグインだけがロードされます。 指定しない場合は、すべてのデータ変換クラスプラグインがアルファベット順にロードされます。データ変換には、これらのプラグインがアルファベット順に使用されます。

csapi.plugin.datatranslator.

name

"cs_data
translatorcsv10"

csapi.plugin.loadall"n" を指定し、csapi.plugin.datatranslator"y" を指定した場合、このプラグインだけがロードされます。

空白 (" ")、または指定しない場合、すべてのデータ変換クラスプラグインがロードされます。

csapi.plugin.dbtranslator

"y"

データベースからの出力をフォーマットするプラグインを有効 ("y") または無効 ("n") にします。

csapi.plugin.dbtranslator.name

"*"

csapi.plugin.dbtranslator"y" を指定した場合は、次のいずれかの処理が行われます。

  • この値が "*" であれば、データベースからの出力をフォーマットするすべてのプラグインがロードされます。

  • この値がライブラリ名であれば、この特定のプラグインだけがロードされます。

 

csapi.plugin.dbtranslator"n" を指定した場合は、この設定は無視されます。

csapi.plugin.loadall

"n"

"y" を指定すると、プラグインディレクトリ内のすべてのプラグインがロードされます。プラグインには .so という拡張子が付けられています。

"n" を指定した場合、対応するパラメータによってフラグが付けられた特定クラスのプラグインだけがロードされます。たとえば、csapi.plugin.authentication"y" を設定した場合は、認証クラスプラグインがロードされます。

csapi.plugin.userprefs

"n"

"y" を指定すると、csapi.plugin.userprefs.name に設定されるプラグインだけがロードされます。 指定しない場合は、すべてのユーザー設定クラスプラグインがアルファベット順にロードされます。ユーザー設定には、これらのプラグインがアルファベット順に使用されます。

csapi.plugin.userprefs.name

" "

csapi.plugin.loadall"n" を指定し、csapi.plugin.userprefs"y" を指定した場合は、このパラメータが使用されます。指定しない、または空白 (" ") の場合、すべてのユーザー設定クラスプラグインがロードされます。それ以外の場合は、この指定プラグインだけがロードされます。

csmonitor ユーティリティーの設定

次の表は、csmonitor ユーティリティー設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。

表 E–20 ics.conf ファイル内の csmonitor ユーティリティー設定パラメータ

パラメータ 

デフォルト値 

説明 

service.monitor.continuous

"0" 

csmonitor を連続してループするかどうかを指定します。 

"0": 連続的にループしません。 

"1": 連続的にループします。 

このオプションはより多くのシステムリソースを必要としますが、デバッグモードでは便利です。 

service.monitor.loopsdelay

"60" 

2 つの監視ループの間の遅延時間を秒単位で指定します。 

service.monitor.emailaddress.from

なし 

csmonitor が送信するメッセージの送信元となる電子メールアドレスを指定します。 

service.monitor.emailaddress.to

なし 

csmonitor が送信するメッセージの送信先となる電子メールアドレスを指定します。 

service.monitor.csdb.logthreshold 

"90" 

正常と判断される最大ディスク消費量のしきい値を、ディスク容量全体のパーセント値で指定します。カレンダデータベースが存在するディレクトリ (csdb ディレクトリ) のディスク消費量がこの値を超えると、csmonitor は警告電子メールメッセージを送信します。

logfile.monitor.logname

"csmonitor.log" 

csmonitor のログファイル名を指定します。 

logfile.monitor.maxlogfilesize

"2097152" 

ログファイルの最大サイズを指定します。ログファイルのサイズがこれを超えると、csmonitor はログを csmonitor.log.timestamp という名前で保存し、ログをリセットします。

service.monitor.dbglevel

"0" 

デバッグレベルを指定します。この値が大きいほど、csmonitor は詳細なメッセージを送信します。 

カウンタ設定ファイル (counter.conf)

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 ファイルのアラームカウンタ

名前 

種類 

サイズ 

説明 

alarm.high

GAUGE 

記録された最高値。 

alarm.low

GAUGE 

記録された最低値。 

alarm.current

GAUGE 

監視対象の現在の値。 

alarm.warningstate

GAUGE 

警告状態: 真 (1) または偽 (0)。 

alarm.countoverthreshold

COUNTER 

しきい値に達した回数。 

alarm.countwarningsent

COUNTER 

警告の送信回数。 

alarm.timelastset.desc

TIME 

現在の値が設定された最終時刻。 

alarm.timelastwarning

TIME 

警告が送信された最終時刻。 

alarm.timereset

TIME 

リセットが行われた最終時刻。 

alarm.timestatechanged.desc

TIME 

アラーム状態が変化した最終時刻。 

ディスク使用率カウンタ

次の表は、各ディスク使用率カウンタの名前、種類、サイズ、説明を示しています。

表 E–22 counter.conf ファイルのディスク使用率カウンタ

名前 

種類 

サイズ 

説明 

diskusage.availSpace

GAUGE 

ディスクパーティション内で使用できる合計容量。 

diskusage.lastStatTime

TIME 

統計情報が得られた最終時刻。 

diskusage.calPartitionPath

STRING 

512 

カレンダパーティションのパス。 

diskusage.percentAvail

GAUGE 

ディスクパーティション内の使用可能容量の割合 (パーセント)。 

diskusage.totalSpace

GAUGE 

ディスクパーティション内の合計容量。 

HTTP カウンタ

次の表は、各 HTTP カウンタの名前、種類、サイズ、説明を示しています。

表 E–23 counter.conf ファイルの HTTP (httpstat) カウンタ

名前 

種類 

サイズ 

説明 

httpstat.avgConnectionTime

GAUGE 

接続応答の平均時間。 

httpstat.currentStartTime

TIME 

Calendar Server の起動時刻。 

httpstat.lastConnectionTime

TIME 

新規クライアント接続が受け付けられた最終時刻。 

httpstat.maxConnections

COUNTER 

現在の接続が処理される最大回数。 

httpstat.maxSessions

COUNTER 

WCAP セッションが処理される最大回数。 

httpstat.numConnections

COUNTER 

処理された接続の総数。 

httpstat.numCurrentConnections

GAUGE 

アクティブな接続の現在の数。 

httpstat.numCurrentSessions

GAUGE 

WCAP セッションの現在の数。 

httpstat.numFailedConnections

COUNTER 

処理された接続失敗の総数。 

httpstat.numGoodLogins.desc

COUNTER 

現在の HTTP サーバーによって処理された成功ログインの回数。 

httpstat.numFailedLogins

COUNTER 

現在の HTTP サーバーによって処理された失敗ログインの回数。 

グループスケジューリングカウンタ

次の表は、各 GSE (グループスケジューリングエンジン) カウンタの名前、種類、サイズ、説明を示しています。

表 E–24 counter.conf ファイルの GSE (グループスケジューリングエンジン) カウンタ

名前 

種類 

サイズ 

説明 

gsestat.lastWakeUpTime

TIME 

GSE が稼動し、ジョブを処理した最終時刻。 

gsestat.lastJobProcessedTime

TIME 

GSE がジョブを処理した最終時刻。 

gsestat.numJobsProcessed

COUNTER 

GSE が処理したジョブの総数。 

gsestat.numActiveWorkerThreads

COUNTER 

アクティブなワーカースレッドの総数。 

認証カウンタ

次の表は、各認証カウンタの名前、種類、サイズ、説明を示しています。

表 E–25 counter.conf ファイルの認証 (authstat) カウンタ

名前 

種類 

サイズ 

説明 

authstat.lastLoginTime

TIME 

ユーザーがログインした最終時刻。 

authstat.numSuccessfulLogins

COUNTER 

処理された成功ログインの総数。 

authstat.numFailedLogins

COUNTER 

処理された失敗ログインの総数。 

WCAP カウンタ

次の表は、各 WCAP カウンタの名前、種類、サイズ、説明を示しています。

表 E–26 counter.conf ファイルの WCAP (wcapstat) カウンタ

名前 

種類 

サイズ 

説明 

wcapstat.numRequests

COUNTER 

WCAP 要求の総数。 

データベースカウンタ

次の表は、各データベースカウンタの名前、種類、サイズ、説明を示しています。

表 E–27 counter.conf ファイルのデータベース (dbstat) カウンタ

名前 

種類 

サイズ 

説明 

dbstat.numReads

COUNTER 

データベース読み取りの総数。 

dbstat.numWrites

COUNTER 

データベース書き込みの総数。 

dbstat.numDeletes

COUNTER 

データベース削除の総数。 

dbstat.lastReadTime

TIME 

データベース読み取りの最終時刻。 

dbstat.lastWriteTime

TIME 

データベース書き込みの最終時刻。 

dbstat.lastDeleteTime

TIME 

データベース削除の最終時刻。 

サーバー応答カウンタ

次の表は、各サーバー応答カウンタの名前、種類、サイズ、説明を示しています。

表 E–28 counter.conf ファイルのサーバー応答カウンタ

名前 

種類 

サイズ 

スケール 

説明 

serverresponse.lastStatTime

TIME 

 

統計情報が得られた最終時刻。 

serverresponse.responseTime

GAUGE 

サーバーの応答時間 (ミリ秒単位)。 

セッション状態カウンタ

次の表は、各セッション状態カウンタの名前、種類、サイズ、説明を示しています。

表 E–29 counter.conf ファイルのセッション状態カウンタ

名前 

種類 

サイズ 

スケール 

説明 

sessstat.maxSessions.desc

COUNTER 

HTTP セッションが処理される最大回数。 

sessstat.numCurrentSessions

GAUGE 

HTTP セッションの現在の数。 

通知メッセージ

Calendar Server は、「Calendar Server のメールパラメータ」で説明している各種電子メールメッセージを送信します。これらのメッセージの形式は、表に示されるフォーマットファイル (.fmt) によって制御されます。フォーマットファイルは、次のディレクトリ内の各ロケールのディレクトリ (英語であれば /en、フランス語であれば /fr など) に格納されています。

/etc/opt/SUNWics5/config

たとえば、英語バージョンの作業 (仕事) アラームメッセージの形式は、次のファイルに指定されています。

/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt

ここで説明する内容は次のとおりです。

Calendar Server のメールパラメータ

次の表は、Calendar Server の各メールパラメータのメッセージタイプ、パラメータ名、デフォルトフォーマットファイル、説明、受信者を示しています。

表 E–30 ics.conf ファイルの Calendar Server 電子メールフォーマットパラメータ

メッセージタイプ 

パラメータ 

フォーマットファイル (デフォルト) 

説明 

受信者 

予定の公開 

calmail.imipeventpublish.fname

"mail_eventpublish.fmt"

予定の公開、または既存予定の変更を通知します。 

通知登録ユーザー 

予定の取り消し 

calmail.imipeventcancel.fname

"mail_eventcancel.fmt"

予定の取り消しを通知します。 

通知登録ユーザー 

予定への返信 

calmail.imipeventreply.fname

"mail_eventreply.fmt" 

予定通知に返信します。 

通知登録ユーザー 

予定の要求 

calmail.imipeventrequest.fname

"mail_eventrequest.fmt" 

予定通知に登録します。 

通知登録ユーザー 

予定アラーム 

calmail.eventreminder.fname

"mail_eventreminder.fmt"

次の予定のアラーム。 

アラーム登録ユーザー 

定期的な予定の通知 

calmail.imipeventnotificationrecur.fname

“mail_eventnotificationrecur.fmt” 

定期的な予定の通知。 

通知登録ユーザー 

予定の取り消し通知 

calmail.imipeventcancelnotification.fname

“mail_eventcancel notification.fmt” 

取り消された予定の通知。 

通知登録ユーザー 

定期的な予定の取り消しの通知 

calmail.imipeventcancelnotificationrecur.fname

“mail_eventcancelnotificationrecur.fmt” 

取り消された定期的な予定の通知。 

通知登録ユーザー 

作業の公開 

calmail.imiptodopublish.fname

"mail_todopublish.fmt"

作業または既存作業の変更を通知します。 

通知登録ユーザー 

作業の取り消し 

calmail.imiptodocancel.fname

"mail_todocancel.fmt"

作業の取り消しを通知します。 

通知登録ユーザー 

作業への返信 

calmail.imiptodoreply.fname

"mail_todoreply.fmt" 

作業通知に返信します。 

通知登録ユーザー 

仕事の要求 

calmail.imiptodorequest.fname

"mail_todorequest.fmt" 

仕事通知に登録します。 

通知登録ユーザー 

作業アラーム 

calmail.todoreminder.fname

"mail_todoreminder.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 がコードを書き換えるわけではなく、実際にはオペレーティングシステムに実装されているものが使用されます。


表 E–33 日付用の特殊文字列

フォーマットコード 

意味 

%a

曜日の略号表記 

%A

曜日の完全表記 

%b

月名の略号表記 

%B

月名の完全表記 

%c

ロケールに基づいて表示される日時 

%d

月の日付の 10 進表記 (0131)

%H

時間の 24 時間制表記 (0023)

%I

時間の 12 時間制表記 (0112)

%j

年の日付の 10 進表記 (001336)

%m

月の 10 進表記 (0112)

%M

分の 10 進表記 (0059)

%p

12 時間制表記用の、現在のロケールの A.M./P.M. 

%S

秒の 10 進表記 (0059)

%U

日曜日を週の先頭とした場合の年初からの週数 (0053)

%w

曜日の 10 進表記 (06、日曜日が 0)

%W

月曜日を週の先頭とした場合の年初からの週数 (0053)

%x

現在のロケールの日付表記 

%X

現在のロケールの時刻表記 

%y

世紀部分を含まない年の 10 進表記 (0099)

%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

         

この例の各行について説明します。

次の例は、上の例から生成される通知メッセージのサンプルを示しています。


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--