ファイルボルトの Windchill プロパティ
wt.properties ファイルで定義されている以下の Windchill プロパティを設定して、ファイルボルト環境を設定します。グラフィカルユーザーインタフェースを使用して、またはマッピング規則ファイル内でプロパティを設定しない場合は、xconfmanager ユーティリティを使用してプロパティを追加または編集します。
詳細については、「基本的なカスタマイズ」セクションの「xconfmanager ユーティリティの使用」を参照してください。
|
プロパティ
|
説明
|
|---|---|
|
wt.fv.CCSUpload.NumOfQueues
|
コンテンツを取得するために作成して使用する共有処理キューの数を指定します。リモートサイトからのコンテンツの取得、および、そのメインサイトへの送信に使用する専用のキューは、すべてのレプリケーションセッションで共有されます。各キューは一度に 1 つのコンテンツファイルを取得します。デフォルトのキューの数は 1 です。この値を大きくすると、コンテンツを取得するための専用処理キューの数が増えます。
|
|
wt.fv.sync.disableCreateScheduleAtStartup
|
true に設定されている場合、起動時の同期化スケジュールの作成を無効にします。デフォルト設定は false で、初期起動時にファイル同期化スケジュールが存在することが保証されます。
|
|
wt.fv.verbose.properties
|
起動時にファイルボルトのプロパティをログに記録するかどうかを指定します。デフォルト設定は false です。
|
|
wt.fv.read.buffer_size
|
ボルトに送られるファイルのアップロード用のバッファサイズです。デフォルト値は 8192 (8 KB) です。
|
|
wt.fv.cleanup.buf_size
|
ファイルボルトのクリーンアップ操作用のバッファサイズです。このバッファは、非参照コンテンツファイルを除去するフォルダのファイル名の読み取りに使用されます。デフォルトは 10,240 個のファイル名 (80 KB) です。
|
|
wt.fv.log.mountInfoFile
|
情報のマウント用ログファイル名です。デフォルト名は $(wt.logs.dir)\\MountInfo.log です。
|
|
wt.fv.revaultOnChange
|
ドメインやライフサイクル状態を変更するオブジェクトについてリボルトをバックグラウンドで実行するかどうかを指定します。デフォルト設定は true です。
|
|
wt.fv.revaultQuerySize
|
リボルト処理で使用するバケツの最大サイズです。このパラメータを大きくすると、リボルトにかかる時間は短くなりますが、メソッドサーバーのメモリ使用量は増加します。このパラメータを小さくすると、メソッドサーバーのメモリ使用量は減少しますが、リボルトの完了にかかる時間は長くなります。デフォルト値は 1000 です。
|
|
wt.fv.purgeUnreferencedFvItemsInterval
|
非参照アイテムをクリーンアップする頻度 (日数) を指定します。デフォルト値は 1 日です。
|
|
wt.fv.purgeUnreferencedFvItemsOlderThan
|
非参照状態が何日経過した時点でアイテムをクリーンアップするかを指定します。デフォルトは 30 日です。
|
|
wt.fv.purgeUnreferencedMORItemsOlderThan
|
同期操作を実行したときに、非参照状態が何日経過した時点で MasteredOnReplicaItem をクリーンアップするかを指定します。デフォルト値は 30 日で、最小値は 2 日です。
|
|
wt.fv.purgeUnreferencedFilesOlderThan
|
「非参照ファイルを除去」を実行したときに、非参照状態が何日経過した時点でファイルをクリーンアップするかを指定します。デフォルト値は 2 日です。
|
|
wt.fv.forceContentToVault
|
すべてのコンテンツボルト用にボルトを 1 つ使用するかどうかを決定します。デフォルト設定は false です。詳細については、リボルトの管理のセクション「コンテンツの強制ボルト」を参照してください。
|
|
wt.fv.useFvFileThreshold
|
true に設定されている場合、プロパティ wt.fv.fvFileThreshold が有効になります。
false に設定されている場合、wt.fv.fvFileThreshold は無効です。
|
|
wt.fv.fvFileThreshold
|
ボルトに関連付けられている各フォルダが保持できるファイルの最大数。デフォルト値は 50,000 で、最小値は 10,000 です。
しきい値に達するまで、ファイルはフォルダに書き込まれます。しきい値に達すると、そのフォルダは読み取り専用になり、次のコンテンツファイルはボルトにマウントされた次のフォルダにボルトされます。
詳細については、セクション「ファイルのしきい値の指定」を参照してください。
|
|
wt.fv.useVaultsForAllContent
|
すべてのコンテンツをボルトに送信するように設定します。デフォルト設定は true です。このプロパティが true に設定されている場合、すべてのコンテンツは、ドメイン管理かどうかに関係なく、ボルト規則がなくても DefaultTargetForSite ボルトにアップロードされます。
詳細については、ボルト規則の作成のセクション「コンテンツのボルトへの送信」を参照してください。
|
|
wt.router.checkEmptyRouterQueues
|
空のルータキューがあるか確認した後で、新しいエントリを追加するルータキューを決めるかどうかを指定します。デフォルト設定は true です。
このプロパティを true に設定すると、空のルータキューがあるか確認され、ある場合は、その空のルータキューにエントリが追加されます。空のルータキューが見つからない場合は、エントリは各ルータキューに順番に追加されます。
このプロパティを false に設定した場合、新しいエントリは各ルータキューに順番に追加されます。
|
|
wt.fv.faultTolerantVaultsMountStatusCheck
|
クラスタ化された環境のマウントステータスに基づいて、キャッシュボルトまたは単一メインボルトに読み取り専用設定を指定します。
true に設定すると、クラスタ化されたノードのすべてのマウントステータスが無効である場合に、キャッシュボルトまたは単一メインボルトが読み取り専用に設定されます。
デフォルト設定は false です。デフォルト設定では、クラスタ化された環境で有効でチェックイン可能なマウントがないかチェックされます。
|
|
wt.fv.faultTolerantVaultsAutoRestore
|
ハードウェアまたはネットワークエラーが発生した場合に、クラスタ化された環境下のキャッシュボルトまたは単一メインボルトから読み取り専用フラグを自動的に除去します。
デフォルト値は true です。デフォルト設定では、自動復元メカニズムによって、クラスタ内のキャッシュボルトまたは単一メインボルトが書き込み可能であるかどうかが定期的にチェックされます。自動復元メカニズムは、ボルトが読み取り専用になった時刻から 1 時間だけ動作します。
false に設定した場合、キャッシュボルトまたは単一メインボルトは自動的に復元されません。
|
|
wt.fv.faultTolerantVaults.autoRestoreAttempts
|
読み取り専用のキャッシュボルトを自動的に復元する試行の回数を指定します。デフォルト値は 12 です。
|
|
wt.fv.faultTolerantVaults.autoRestoreInterval
|
読み取り専用のキャッシュボルトを自動的に復元する頻度を分単位で指定します。デフォルト値は 5 です。
|
|
wt.fv.faultTolerantVaults.queueName
|
キャッシュボルト自動復元ジョブを実行するキューを指定します。デフォルト値は commonScheduleQueue です。
|
|
wt.fv.fvMountValidator.validationInterval
|
ボルトへのネットワークアクセスの中断を防止するために、マウントステータスの検証チェックを実行する頻度 (秒) を指定します。デフォルト値は 86400 秒 (24 時間) です。
デフォルト設定では、自動マウント検証メカニズムによってマウントステータスが定期的にチェックされ、マウント検証に失敗した場合には管理者に電子メール通知が送信されます。値は 3600 秒から 86400 秒 (1 から 24 時間) の範囲で設定できます。このプロパティ値が -1 または 0 に設定されている場合、バックエンドメカニズムは機能せず、失敗電子メール警告は管理者に送信されません。
|
|
wt.content.blobSizeThreshold
|
ファイルボルトアラートの送信に使用されるデータベース BLOB ストレージのサイズ制限 (MB) を指定します。ストレージのデフォルト値は 2048 MB です。BLOB のサイズ制限に制約はありません。
|
|
wt.fv.useVaultsForAllContent
|
すべてのコンテンツをボルトに送信するように設定します。デフォルト設定は true です。デフォルト設定では、すべてのコンテンツは、ドメイン管理かどうかに関係なく、ボルト規則がなくても DefaultTargetForSite ボルトにアップロードされます。
詳細については、ボルト規則の作成の「コンテンツのボルトへの送信」のセクションを参照してください。
|
|
wt.content.disableSecureUpload
|
これが true に設定されている場合、セキュリティで保護されたコンテンツファイルのアップロードは無効になります。プライマリ添付資料とセカンダリ添付資料ではセキュリティラベルの検証は実行されず、IBA に基づいたセキュリティラベルの OIR には従いません。
デフォルト設定は false です。デフォルト設定では、セキュリティで保護されたアップロードが有効になっています。添付資料があるウィザードでは、「属性を設定」は「セキュリティラベルを設定」ステップの後で実行します。プライマリ添付資料とセカンダリ添付資料でセキュリティラベルの検証が実行され、IBA に基づいたセキュリティラベルの OIR に従います。
|
ファイルのしきい値の指定
 |
以下の説明では、'ディレクトリ' という用語は Windows 環境のフォルダと同じ意味です。
|
一部のオペレーティングシステムでは、ディレクトリ内のファイル数がしきい値を超えて増えるにつれて、ディレクトリアクセスのファイルシステムパフォーマンスは大幅に低下します。パフォーマンスは、ディレクトリのコンテンツの読み込みとディレクトリへのファイルの追加の両方で影響を受けます。
そのような環境においても Windchill の十分なパフォーマンスを確保するために、ボルトフォルダごとにファイル数を制限できるようになっています。これは、CAD ファイルやテキストドキュメントなど、Windchill が管理するアプリケーションファイルの非 DBMS Windchill ストレージ領域すべてに適用されます。Windchill の新規インストールでは、フォルダごとのアプリケーションファイルの制限が、デフォルト値として 50,000 ファイルに設定されています。各 Windchill インストールの Windchill wt.properties ファイルの次のプロパティを使用して、この設定の有効または無効を切り替えることができます。
wt.fv.useFvFileThreshold=true
制限を有効にした場合 (言い換えれば、wt.fv.useFvFileThreshold を true に設定した場合)、実際のファイル制限値は
wt.fv.fvFileThreshold=<ディレクトリごとの最大ファイル数>
プロパティを使用して設定されます。
この制限が設定されており、現在書き込み可能なフォルダがファイル数の制限に達した場合、Windchill では自動的にフォルダが読み取り専用に設定され、ファイルのアップロード先が次の書き込み可能なフォルダに切り替えられます。
この制限の値を大きくする前に、新しい値がパフォーマンスに悪影響を与えないかどうかを確認してください。必要に応じて、オペレーティングシステムおよびファイルシステムに関するドキュメンテーションを参照してください。
|
|
また、フォルダの基本となるファイルシステムディレクトリにストレージ容量がない場合、フォルダは読み取り専用になります。
|
パフォーマンス上の理由から、フォルダごとのファイル数の制限には、プラスマイナス 10% の幅があります。たとえば、制限が 10,000 に設定されている場合、フォルダは 9,000 ～ 11,000 ファイルの間で読み取り専用になります。
Windchill の制限が無効な場合、管理者は Windchill フォルダのファイル数の増加を監視する必要があります。最終的に、読み取り専用にすることによって現在書き込み可能なフォルダへの追加を手動で中止し、次の使用可能なフォルダに切り替えてファイルをアップロードすることが適切な場合に、あるポイントに達します。
通知規則の作成
Windchill で、あるフォルダにどのマウントポイントからも書き込むことができない場合、そのフォルダは自動的に読み取り専用に設定されます。ネットワーク接続ストレージ (NAS) やストレージエリアネットワーク (SAN) 上の場所に保存されたボルトに対するネットワークアクセスが中断された場合のように、障害が一時的である場合にもこれは発生します。ボルトのすべてのフォルダが読み取り専用に設定されている場合、ボルトも読み取り専用に設定されています。
そのため、フォルダとボルトが読み取り専用になったときに管理者に警告する通知規則を作成することをお勧めします。これを行うには、「ポリシー管理」ユーティリティで、システム (サイト) ドメインを選択し、wt.fv.FvVault および wt.fv.FvFolder オブジェクトタイプの OVERFLOW イベントに関する管理者ユーザーの通知規則を作成します。
ボルトが読み取り専用に設定されたという通知を受け取った場合は、原因を調査する必要があります。フォルダのマウントを検証できる場合は、一般に、このフォルダと対応するボルトの読み取り専用設定を無効にしても問題は生じません。