付録 E
Calendar Server の設定パラメータ
Sun JavaTM System 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 プロセスが正常に実行されないことがあります。
|
|
ics.conf ファイルを編集するには
- Calendar Server が稼動しているシステムの管理者権限を持つユーザーとしてログインします。
- ics.conf ファイルが格納されている /etc/opt/SUNWics5/config ディレクトリに移動します。
- vi などのテキストエディタを使用して ics.conf ファイルのパラメータを編集します。パラメータの表記規則は次のとおりです。
一部のパラメータはコメントとして記録されており、先頭に 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)
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/sbin"
|
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.instance.use.tmpfs
|
"false"
|
「true」に設定すると、service.http.sessiondir.path と service.admin.sessiondir.path の設定に基づいて、セッションデータベースのメモリベースファイルシステム (tmpfs) がオーバーレイされます。
|
|
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"
|
カレンダー所有者のデフォルトのアクセス制御設定を指定します。
注: ユーザーが Calendar Express のユーザーインタフェースの「プライバシー」ダイアログを使用してアクセス権を指定した場合、その権限は逆の順序で適用されます。たとえば、@@o^a^rsf^g;@@o^c^wdeic^g は @@o^c^wdeic^g;@@o^a^rsf^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.default
calendar
|
"yes"
|
ユーザーのデフォルトカレンダーを、そのユーザーの空き/予定ありカレンダーリストに含めるかどうかを指定します。
|
|
calstore.freebusy.remove.default
calendar
|
"no"
|
ユーザーのデフォルトカレンダーを、そのユーザーの空き/予定ありカレンダーリストから削除できるかどうかを指定します。
|
|
calstore.group.attendee.maxsize
|
"0"
|
予定を拡張するときに、LDAP グループで許可される最大出席者数。0 の値はグループ全体を拡張することを意味します。
|
|
calstore.recurrence.bound
|
"60"
|
定期拡張で作成できる予定の最大数。
|
|
calstore.subscribed.include.default
calendar
|
"yes"
|
ユーザーのデフォルトカレンダーを、そのユーザーの登録済みカレンダーリストに含めるかどうかを指定します。
|
|
calstore.subscribed.remove.default
calendar
|
"no"
|
ユーザーのデフォルトカレンダーを、そのユーザーの登録済みカレンダーリストから削除できるようにするかどうかを指定します。
|
|
calstore.userlookup.maxsize
|
"200"
|
ユーザー検索の LDAP ルックアップで返される結果の最大数。値 "0" は制限のないことを意味します。
|
|
calstore.unqualifiedattendee.fmt1.
type
|
"uid"
|
予定の出席者についてディレクトリルックアップを行うときに、jdoe や jdoe:tv などの文字列を Calendar Server がどのように扱うかを指定します。設定できる値は、uid、cn、gid、res、mailto、cap です。
|
|
calstore.unqualifiedattendee.fmt2.
type
|
"mailto"
|
Calendar Server が予定の出席者についてディレクトリルックアップを行うときに、jdoe@sesta.com などのアットマーク (@) を含む文字列をどのように扱うかを指定します。設定できる値は、uid、cn、gid、res、mailto、cap です。
|
|
calstore.unqualifiedattendee.fmt3.
type
|
"cn"
|
予定の出席者についてディレクトリルックアップを行うときに、john doe などの空白文字を含む文字列を Calendar Server がどのように扱うかを指定します。設定できる値は、uid、cn、gid、res、cap です。
|
|
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"
|
サーバーがログに記録する情報の詳細度を指定します。各ログエントリには、CRITICAL、ALERT、ERROR、WARNING、NOTICE、INFORMATION、DEBUG のいずれかのレベルが割り当てられます。
|
|
logfile.maxlogfiles
|
"10"
|
ログディレクトリ内のログファイルの最大数。
|
|
logfile.maxlogfilesize
|
"2097152"
|
各ログファイルの最大サイズ (バイト単位)。
|
|
logfile.maxlogsize
|
"20971520"
|
すべてのログファイルの最大合計ディスク容量 (バイト単位)。
|
|
logfile.minfreediskspace
|
"5242880"
|
ログ記録用に必要な最小ディスク空き容量 (バイト単位)。
|
|
logfile.notify.logname
|
"notify.log"
|
csnotifyd サービスのログファイル名。
|
|
logfile.rollovertime
|
"86400"
|
ログファイルのローテーション間隔 (秒単位)。
|
管理者構成パラメータ
表 E-4 は、管理者に関する 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.
allowgetmodifyuserprefs
|
"no"
|
Calendar Server 管理者が WCAP コマンドを使用してユーザー設定を取得、設定できるかどうかを指定します。
|
|
service.admin.ldap.enable
|
"yes"
|
"yes" を指定すると、service.admin.calmaster.userid に設定されるユーザーのユーザー認証で LDAP が有効になります。
|
サービスの設定
表 E-5 は、各種のサービス設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 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
|
"/var/opt/SUNWics5/tmp"
|
実行可能ファイルへのすべての URL 参照が格納されるディレクトリの、実行可能ファイルに対する相対パス。
|
|
service.http.uidir.path
|
"html"
|
デフォルトのカレンダークライアントが格納されるディレクトリ。WCAP アクセスだけを許可する場合は "" を指定します。
|
|
service.http.renderhtml
|
"no"
|
Calendar Express だけに関する、「概要」フィールドおよび「詳細」フィールドでの HTML へのレンダリングを有効または無効にします。
|
|
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.allowpublic
calendarwrite
|
"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.allowpublicwritable
calendars
|
"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 の設定
表 E-6 は、ics.conf SSL 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。SSL パラメータのほとんどはデフォルト値を使用しますが、2 つのパラメータには SSL のデフォルト値を次のように変更する必要があります。
- service.http.ssl.usessl = "yes"
- service.http.ssl.port.enable = "yes"
表 E-6 に、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"
|
SSL 設定のために、値を "yes" に変更します。
cshttpd プロセスが SSL サブシステムを使用するかどうかを指定します。
|
|
service.http.ssl.port.enable
|
"no"
SSL を有効にするには、次の値を設定します。"yes"
|
SSL 設定のために、値を "yes" に変更します。
https が http ポートで待機し、このポートを SSL ポートとするかどうかを指定します。
注: これによって、同じポートで待機するために http プロセスが無効になることはありません。
|
|
service.http.ssl.port
|
"443"
|
cshttpd プロセスが Calendar Server ユーザーからの HTTPS 要求を受信する SSL ポートの番号を指定します。
|
|
service.http.ssl.securelogin
|
"yes"
|
ログインを暗号化するかどうかを指定します。
|
|
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 は、アラーム通知サーバー設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E-8 ics.conf ファイルのアラーム通知設定用パラメータ
|
パラメータ
|
デフォルト値
|
説明
|
|
alarm.diskstat.msgalarmdescription
|
"percentage calendar partition diskspace 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 %u¥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= "server-name"
|
" "
|
LDAP サーバーデータベース内のユーザーまたはリソースのカレンダーエントリが icsDWPHost 属性を持たない場合に、Calendar Server が使用するデフォルトの DWP サーバーの名前を完全修飾名で指定します。
Calendar 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 = "host-name"
|
" "
|
カレンダーデータベースを格納するサーバーのホスト名を指定します。このサーバーでは、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 データキャッシュの設定パラメータ
表 E-10 は、ics.conf ファイル内の LDAP データキャッシュに関するパラメータを示しています。
表 E-10 LDAP データキャッシュの設定パラメータ
|
パラメータ
|
説明
|
|
local.ldap.cache.enable
|
LDAP データキャッシュを有効 ("yes") または無効 ("no") にします。デフォルトは "no" です。
|
|
local.ldap.cache.checkpoint
interval
|
チェックポイントスレッドがスリープするまでの秒数を指定します。デフォルトは "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 のパラメータを使用します。
表 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 を有効または無効にします。
このパラメータが 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 の appid は ics50 です。
verifyurl は、http://host:port/VerifySSO? という形式で信頼できるピアの URL を識別します。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"
|
グループスケジューリングスレッドの最大スタックサイズを指定します (バイト単位)。
|
データベースの設定
表 E-15 は、データベース処理の設定で使用される 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 ホストのポート。
|
カレンダーデータベースの自動バックアップ
表 E-17 は、自動バックアッププロセス (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 メッセージ用のカレンダーデータベースパラメータ
表 E-17 は、カレンダーデータベースの設定で使用されるパラメータ、デフォルト値、およびその説明を示しています。デフォルト値以外の値を指定するときは、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 を使用してアラーム通知を送受信します。この通知には、運用上の一般的な警告やエラーメッセージだけでなく、カレンダー予定および作業の作成、削除、修正も含まれます。
表 E-18 は、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"
|
許容できる値は次のとおりです。
|
|
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": caldb.berkeleydb.ensmsg.replyevent、caldb.berkeleydb.ensmsg.refreshevent、または caldb.berkeleydb.ensmsg.modifyevent のそれぞれのトピックに対して配信することで、修正予定通知は返信、再読み込み、修正のトランザクションを区別します。
- "no": 返信、再読み込み、修正のどのトランザクションでも、修正予定通知は 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 (予定通知サービス) メッセージを作成するかどうかを指定します ("yes" または "no")。
|
|
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 が作成するかどうかを指定します ("yes" または"no")。
|
|
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"
|
ENS (予定通知サーバー) のスレッドの初期数。
|
|
caldb.serveralarms.maxretrytime
|
"-1"
|
ENS (予定通知サーバー) への接続に失敗した場合にアラームスレッドが何回連続して再試行するかを指定します。
"-1" を指定すると、アラームスレッドが無制限に再試行を繰り返します。
|
|
caldb.serveralarms.maxthreads
|
"10"
|
ENS (予定通知サーバー) のスレッドの最大数。
|
|
caldb.serveralarms.retryinterval
|
"5"
|
アラームスレッド (csadmind に含まれる) が ENS (予定通知サーバー) への再接続を試行するまでの秒数。
|
|
caldb.serveralarms.stacksize
|
"65536"
|
ENS (予定通知サーバー) スレッドのスタックフレームのサイズ。
|
|
caldb.serveralarms.startupretrytime
|
"0"
|
Calendar Server が ENS (予定通知サーバー) への接続試行を停止するまでの合計秒数。この設定は caldb.serveralarms.maxretrytime に似ていますが、これはアラームスレッドが最初に開始された場合にだけ適用されます。アラームスレッドが正常に開始された後は、caldb.serveralarms.maxretrytime が使用されます。
"0" を指定すると、起動時に ENS (予定通知サーバー) への接続に失敗した直後にアラームスレッドが終了します。
|
|
caldb.smtphost
|
"localhost"
|
この SMTP ホストにアラーム電子メールが送信されます。
|
Calendar Server API の設定
表 E-19 は、CSAPI (Calendar Server API) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 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 に設定されるプラグインだけがロードされます。指定しない場合は、すべての認証クラスプラグインがアルファベット順にロードされます。認証には、これらのプラグインがアルファベット順に使用されます。
|
|
csapi.plugin.authentication.name
|
" "
|
csapi.plugin.loadall に "n" を指定し、csapi.plugin.authentication に "y" を指定した場合、このプラグインだけがロードされます。未指定、または " " の場合、すべての認証クラスプラグインがロードされます。
|
|
csapi.plugin.database
|
"y"
|
"y" を指定すると、csapi.plugin.database.name に設定されるプラグインだけがロードされます。指定しない場合は、すべてのデータベースプラグインがアルファベット順にロードされます。
|
|
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_datatranslatorcsv10"
|
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 に yes を設定した場合は、認証クラスプラグインがロードされます。
|
|
csapi.plugin.userprefs
|
"n"
|
"y" を指定すると、csapi.plugin.userprefs.name に設定されるプラグインだけがロードされます。指定しない場合は、すべてのユーザー設定クラスプラグインがアルファベット順にロードされます。ユーザー設定には、これらのプラグインがアルファベット順に使用されます。
|
|
csapi.plugin.userprefs.name
|
" "
|
csapi.plugin.loadall に "n" を指定し、csapi.plugin.userprefs に "y" を指定した場合は、このパラメータが使用されます。未指定、または " " を指定した場合、すべてのユーザー設定クラスプラグインがロードされます。それ以外の場合は、この指定プラグインだけがロードされます。
|
Calendar Express の設定
次の表は、ユーザーインタフェース (UI) 設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E-20 ics.conf ファイルのユーザーインタフェース設定用パラメータ
|
パラメータ
|
デフォルト値
|
説明
|
|
ui.config.file
|
" "
|
Calendar Server は起動時にオプションの設定ファイル (XML ベース) を読み込み、ユーザーインタフェースの一部を非表示にすることができます。Calendar Server が使用できる設定ファイルは 1 つだけで、このパラメータの値は使用するファイルの名前を設定します。Calendar Server は、ユーザーインタフェースの XML ファイルと XSLT ファイルが格納されている次のデータディレクトリでこのファイルを検索します。
/opt/SUNWics5/cal/data
Calendar Server には、ユーザーインタフェースをカスタマイズするために次のファイルが用意されています。
- nogroup_config.xml: グループスケジューリングを無効にする
- ui_config.xml: デフォルトのユーザーインタフェース
|
|
ui.allow.anyone
|
"yes"
|
Calendar Express で「全員」ACL (アクセス制御リスト) を表示および使用できるようにします。
|
|
ui.allow.domain
|
"no"
|
Calendar Express で「このドメイン」ACL (アクセス制御リスト) を表示および使用できるようにします。
|
|
ui.proxyaddress.url
|
" "
|
HTML UI JavaScript ファイル内で先頭に追加されるプロキシサーバーアドレスを指定します。
例: https://web_portal.sesta.com/
|
|
ui.base.url
|
" "
|
ベースサーバーアドレスを指定します。
例: https://proxyserver
|
|
ine.invitation.enable
|
"yes"
|
予定への出席依頼通知を制御します。
"yes": 通知が送信されます。
"no": 通知は送信されません。
|
|
ine.cancellation.enable
|
"yes"
|
予定の取り消し通知を制御します。
"yes": 通知が送信されます。
"no": 通知は送信されません。
|
|
ui.eventdialog.inform.enable
|
"no"
|
ユーザーが予定を作成または編集するときに、Calendar Express が「予定について連絡する人」オプションを表示するかどうかを指定します。この値が有効になっている場合は ("yes")、ユーザーが出席者を指定して情報の電子メールが送信されるようにできますが、その出席者のカレンダーに情報を追加することはできません。
|
|
ui.toolbar.repainting.enable
|
"yes"
|
Calendar Express ツールバーの再表示 (再読み込み) を有効 ("yes") または無効 ("no") にします。
"no" を指定すると、ツールバーの XML と XSLT の変換が行われないため、パフォーマンスを向上させることができます。"no" を指定するときは、Calendar Express のどのビューで再表示を実行してもデフォルトビューに戻ります。
ブラウザキャッシュオプション (次のパラメータ) が有効な場合、ツールバーの再表示オプションは使用されません。
|
|
browser.cache.enable
|
"no"
|
ブラウザのキャッシュオプションを有効 ("yes") または無効 ("no") にします。詳細については、「再表示オプションの使用」を参照してください。
|
|
render.xslonclient.enable
|
"yes"
|
エンドユーザーブラウザでの XSLT プロセッシングのダウンロードによるクライアント側レンダリングを有効 ("yes") または無効 ("no") にします。詳細については、「クライアントブラウザの XSL レンダリング」を参照してください。
|
csmonitor ユーティリティの設定
次の表は、csmonitor ユーティリティ設定用のパラメータ、各パラメータのデフォルト値、説明を示しています。
表 E-21 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-22 counter.conf ファイルのアラームカウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
alarm.high
|
GAUGE
|
4
|
記録された最高値。
|
|
alarm.low
|
GAUGE
|
4
|
記録された最低値。
|
|
alarm.current
|
GAUGE
|
4
|
監視対象の現在の値。
|
|
alarm.warningstate
|
GAUGE
|
4
|
警告状態: 真 (1) または偽 (0)。
|
|
alarm.countoverthreshold
|
COUNTER
|
4
|
しきい値に達した回数。
|
|
alarm.countwarningsent
|
COUNTER
|
4
|
警告の送信回数。
|
|
alarm.timelastset.desc
|
TIME
|
4
|
現在の値が設定された最終時刻。
|
|
alarm.timelastwarning
|
TIME
|
4
|
警告が送信された最終時刻。
|
|
alarm.timereset
|
TIME
|
4
|
リセットが行われた最終時刻。
|
|
alarm.timestatechanged.desc
|
TIME
|
4
|
アラーム状態が変化した最終時刻。
|
ディスク使用率カウンタ
次の表は、各ディスク使用率カウンタの名前、種類、サイズ、説明を示しています。
表 E-23 counter.conf ファイルのディスク使用率カウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
diskusage.availSpace
|
GAUGE
|
5
|
ディスクパーティション内で使用できる合計容量。
|
|
diskusage.lastStatTime
|
TIME
|
4
|
統計情報が得られた最終時刻。
|
|
diskusage.calPartitionPath
|
STRING
|
512
|
カレンダーパーティションのパス。
|
|
diskusage.percentAvail
|
GAUGE
|
4
|
ディスクパーティション内の使用可能容量の割合 (パーセント)。
|
|
diskusage.totalSpace
|
GAUGE
|
5
|
ディスクパーティション内の合計容量。
|
HTTP カウンタ
次の表は、各 HTTP カウンタの名前、種類、サイズ、説明を示しています。
表 E-24 counter.conf ファイルの HTTP (httpstat) カウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
httpstat.avgConnectionTime
|
GAUGE
|
4
|
接続応答の平均時間。
|
|
httpstat.currentStartTime
|
TIME
|
4
|
Calendar Server の起動時刻。
|
|
httpstat.lastConnectionTime
|
TIME
|
4
|
新規クライアント接続が受け付けられた最終時刻。
|
|
httpstat.maxConnections
|
COUNTER
|
4
|
現在の接続が処理される最大回数。
|
|
httpstat.maxSessions
|
COUNTER
|
4
|
WCAP セッションが処理される最大回数。
|
|
httpstat.numConnections
|
COUNTER
|
4
|
処理された接続の総数。
|
|
httpstat.numCurrentConnections
|
GAUGE
|
4
|
アクティブな接続の現在の数。
|
|
httpstat.numCurrentSessions
|
GAUGE
|
4
|
WCAP セッションの現在の数。
|
|
httpstat.numFailedConnections
|
COUNTER
|
4
|
処理された接続失敗の総数。
|
|
httpstat.numGoodLogins.desc
|
COUNTER
|
4
|
現在の HTTP サーバーによって処理された成功ログインの回数。
|
|
httpstat.numFailedLogins
|
COUNTER
|
4
|
現在の HTTP サーバーによって処理された失敗ログインの回数。
|
グループスケジューリングカウンタ
次の表は、各 GSE (グループスケジューリングエンジン) カウンタの名前、種類、サイズ、説明を示しています。
表 E-25 counter.conf ファイルの GSE (グループスケジューリングエンジン) カウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
gsestat.lastWakeUpTime
|
TIME
|
4
|
GSE が稼動し、ジョブを処理した最終時刻。
|
|
gsestat.lastJobProcessedTime
|
TIME
|
4
|
GSE がジョブを処理した最終時刻。
|
|
gsestat.numJobsProcessed
|
COUNTER
|
4
|
GSE が処理したジョブの総数。
|
|
gsestat.numActiveWorkerThreads
|
COUNTER
|
4
|
アクティブなワーカースレッドの総数。
|
認証カウンタ
次の表は、各認証カウンタの名前、種類、サイズ、説明を示しています。
表 E-26 counter.conf ファイルの認証 (authstat) カウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
authstat.lastLoginTime
|
TIME
|
4
|
ユーザーがログインした最終時刻。
|
|
authstat.numSuccessfulLogins
|
COUNTER
|
4
|
処理された成功ログインの総数。
|
|
authstat.numFailedLogins
|
COUNTER
|
4
|
処理された失敗ログインの総数。
|
WCAP カウンタ
次の表は、各 WCAP カウンタの名前、種類、サイズ、説明を示しています。
表 E-27 counter.conf ファイルの WCAP (wcapstat) カウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
wcapstat.numRequests
|
COUNTER
|
4
|
WCAP 要求の総数。
|
データベースカウンタ
次の表は、各データベースカウンタの名前、種類、サイズ、説明を示しています。
表 E-28 counter.conf ファイルのデータベース (dbstat) カウンタ
|
名前
|
種類
|
サイズ
|
説明
|
|
dbstat.numReads
|
COUNTER
|
4
|
データベース読み取りの総数。
|
|
dbstat.numWrites
|
COUNTER
|
4
|
データベース書き込みの総数。
|
|
dbstat.numDeletes
|
COUNTER
|
4
|
データベース削除の総数。
|
|
dbstat.lastReadTime
|
TIME
|
4
|
データベース読み取りの最終時刻。
|
|
dbstat.lastWriteTime
|
TIME
|
4
|
データベース書き込みの最終時刻。
|
|
dbstat.lastDeleteTime
|
TIME
|
4
|
データベース削除の最終時刻。
|
サーバー応答カウンタ
次の表は、各サーバー応答カウンタの名前、種類、サイズ、説明を示しています。
表 E-29 counter.conf ファイルのサーバー応答カウンタ
|
名前
|
種類
|
サイズ
|
スケール
|
説明
|
|
serverresponse.lastStatTime
|
TIME
|
4
|
|
統計情報が得られた最終時刻。
|
|
serverresponse.responseTime
|
GAUGE
|
4
|
2
|
サーバーの応答時間 (ミリ秒単位)。
|
セッション状態カウンタ
次の表は、各セッション状態カウンタの名前、種類、サイズ、説明を示しています。
表 E-30 counter.conf ファイルのセッション状態カウンタ
|
名前
|
種類
|
サイズ
|
スケール
|
説明
|
|
sessstat.maxSessions.desc
|
COUNTER
|
4
|
4
|
HTTP セッションが処理される最大回数。
|
|
sessstat.numCurrentSessions
|
GAUGE
|
4
|
2
|
HTTP セッションの現在の数。
|
通知メッセージ
Calendar Server は、表 E-31 に示される各種電子メールメッセージを送信します。これらのメッセージの形式は、表に示されるフォーマットファイル (.fmt) によって制御されます。フォーマットファイルは、次のディレクトリ内の各ロケールのディレクトリ (英語であれば /en、フランス語であれば /fr など) に格納されています。
/etc/opt/SUNWics5/config
たとえば、英語バージョンの作業 (仕事) アラームメッセージの形式は、次のファイルに指定されています。
/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt
ここで説明する内容は次のとおりです。
Calendar Server のメールパラメータ
次の表は、Calendar Server の各メールパラメータのメッセージタイプ、パラメータ名、デフォルトフォーマットファイル、説明、受信者を示しています。
表 E-31 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.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-32 予定通知用の特殊文字列
|
フォーマットコード
|
意味
|
|
%0
|
ローカライズされたフォーマットでの開始時刻
|
|
%1
|
ローカライズされたフォーマットでの終了時刻
|
|
%A
|
iCalendar 形式の exdates (除外する日付をセミコロンで区切ったリスト形式の ISO8601 日付文字列)
|
|
%a
|
iCalendar 形式の rdates (予定日付をセミコロンで区切ったリスト形式の ISO8601 日付文字列)
|
|
%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
|
一意の予定識別子
|
|
%u
|
予定への URL
|
|
%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-33 作業通知用の特殊文字列
|
フォーマットコード
|
意味
|
|
%A
|
iCalendar 形式の exdates (除外する日付をセミコロンで区切ったリスト形式の ISO8601 日付文字列)
|
|
%a
|
iCalendar 形式の rdates (予定日付をセミコロンで区切ったリスト形式の ISO8601 日付文字列)
|
|
%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
|
|
%u
|
作業への URL
|
|
%Z
|
時刻フィールドコードと組み合わせて使用され、UTC 時間で時間を表示します (%B は開始時刻を現地時間で表示し、%ZB は開始時刻を UTC 時間で表示する)
|
|
%%
|
% 記号を通常文字として表示します
|
|
% (サブフォーマットコード)
|
コードによって識別されるデータのサブフォーマットを指定します (詳細については、「日付のサブフォーマット」を参照)
|
日付用の特殊文字列
次の表は、フォーマットコードと、日付用の特殊文字列の意味を示しています。
|
|
注
|
ここに示す特別な日付フォーマットコードは、利便性だけを目的に紹介されています。Calendar Server が strftime コードを書き換えるわけではなく、実際にはオペレーティングシステムに実装されているものが使用されます。
|
|
表 E-34 日付用の特殊文字列
|
フォーマットコード
|
意味
|
|
%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--
|
|
