キャッシュ構成
キャッシュ構成ファイルには、登録されているすべてのキャッシュ/クラスターに関する情報が含まれています。 構成を読み取る必要があるモジュールは、最初に構成を見つけようとします。 config.ncconf アプリケーションフォルダー内、つまり Web.config。 場合 config.ncconf アプリケーションフォルダに見つからない場合は、インストールフォルダから構成を読み取ります。
Note
このファイルは NCache そしてに位置しています %NCHOME%\ config Windowsおよび NCache ディレクトリ/構成をインストールします Linuxで。
キャッシュ構成の構文とタグ
config.ncconf ファイルについては以下で説明します。
<!--
The configuration file (config.ncconf) contains the details of all the registered caches. All cache configurations are enclosed in the <configuration></configuration> tag. Whereas each cache detail is enclosed in <cache-config></cache-config>.
-->
<cache-config cache-name="demoCache" alias="" store-type="Distributed-Cache" config-id="6a49d9ce-9aa7-4312-ada6-4fec37a6e729" config-version="1">
<cache-settings inproc="False" last-modified="" auto-start="False" data-format="Serialized" serialization="Binary">
...
</cache-settings>
</cache-config>
cache-name
: キャッシュ識別子。キャッシュは、ここで指定した名前で認識されます。これは、キャッシュの初期化時に指定した名前と同じです。
store-type
:このキャッシュが使用される目的を指定します。 次のいずれかの値をとることができます。
Distributed-Cache
Distributed-Cache-Persistence
Pub/Sub-Messaging
Distributed-Lucene
inproc
: キャッシュを InProc (アプリケーション プロセス内) として実行するか、OutProc (アプリケーション プロセス内) として実行するかを決定します。 NCache サービスプロセス)。 「False」に設定すると、キャッシュは OutProc として実行され、「True」に設定すると、キャッシュは InProc として実行されます。
config-version
: 構成が変更されたかどうかを判断するために使用されます。
config-id
: 変更された構成の一意の ID を自動生成します。
last-modified
: キャッシュ構成の最後の変更に関連する情報が含まれます。
auto-start
: キャッシュ起動時のキャッシュの自動起動を有効にします。 (NCache Enterprise の)
data-format
:データがキャッシュに保存される形式は、シリアル化またはオブジェクトにすることができます。
serialization
: キャッシュのシリアル化形式。 JSON またはバイナリのいずれかにすることができます。
<logging enable-logs="True" trace-errors="True" trace-notices="False" trace-warnings="False" trace-debug="False" log-path=""/>
NCache 情報およびデバッグの目的でトレースを書き込むログ ファイルを維持します。これらのタグを使用すると、ユーザーはさまざまなトレースを有効または無効にすることができます。デフォルトでは、「エラー」トレースのみが有効になり、残りのトレースは無効になります。エラー トレースはキャッシュのパフォーマンスには影響しませんが、他のトレースには影響します。のパフォーマンスに影響を与えるため、運用環境では有効にしないことをお勧めします。 NCache.
log-path
:デフォルトでは、各キャッシュのログファイルは次の場所に作成されます。 %NCHOME%\ log-files Windowsおよび NCache ディレクトリ/ログファイルをインストールする Linuxでは。 ただし、ログを別の場所に保存する場合は、カスタムパスを指定できます。
<performance-counters enable-counters="True" snmp-port="0"/>
この属性が True に設定されている場合、 NCache 公開された PerfMon カウンタを更新します。 False に設定すると、 NCache 公開されている PerfMon カウンタは更新されません。
<replication-strategy synchronous="False"/>
パーティション レプリカの場合、このタグはキャッシュ構成内にあります。レプリケーション戦略は、データをバックアップ ノードにレプリケートする方法を定義します。
synchronous
: この属性は True/False に設定できます。 False に設定すると、データ操作はバックアップ ノード上で非同期的にレプリケートされます。 True に設定すると、データ操作がバックアップ ノード上で同期的に複製されます。
<pipelining enabled="False" batch-interval="250usec"/>
パイプラインを有効にするには、パイプライン有効タグを True に設定し、バッチ間隔の時間をマイクロ秒 (µs) 単位で入力します。デフォルト値は 250 μs で、最小値と最大値はそれぞれ 50 μs と 5000 μs です。
<compression enable-compression="False" threshold="100kb"/>
この XML タグは、指定されたしきい値を超える項目をクライアント側で圧縮/解凍するかどうかを指定します。
enable-compression
: 圧縮を有効にするには、この属性を True に設定し、それ以外の場合は False に設定します。
threshold
: 圧縮が有効になっている場合、しきい値属性で指定された値を超えるアイテムはクライアント側でのみ圧縮/解凍されます。
前述の圧縮タグの例によると、サイズが 100kb を超えるアイテムのみがクライアント側で圧縮/解凍されます。
<client-activity-notification enabled="False" retention-period="5sec"/>
Enabled
:このオプションを有効にすると、別のクライアントが接続または切断した場合にクライアントが通知を受信できるようになります。
retention-period
: 保持期間は、切断されたクライアントが切断されたとみなされるまでの時間間隔です。
<cache-notifications item-remove="False" item-add="False" item-update="False"/>
notifications
: XMLタグはキャッシュに登録されたイベントを指定します。
Item-add
: この属性は True または False に設定できます。 True に設定すると、アイテムがキャッシュに追加されたときに通知されます。同様に、False に設定すると、項目がキャッシュに追加されても通知は発行されません。
Item-remove
: この属性は True または False に設定できます。 True に設定すると、項目がキャッシュから削除されたときに通知されます。同様に、False に設定すると、項目がキャッシュから削除されても通知は発行されません。
Item-update
: この属性は True または False に設定できます。 True に設定すると、キャッシュ内の項目が更新されたときに通知されます。同様に、False に設定すると、キャッシュ内で項目が更新されても通知は発行されません。
<cleanup interval="15sec"/>
cleanup
: XML タグは、アイテムの有効期限がチェックされるまでの定期的な間隔を指定します。
Interval:
「15 秒」に設定すると、有効期限チェックが 15 秒ごとに実行されることを意味します。
<storage type="heap" cache-size="1024mb"/>
storage
: XML タグは、キャッシュのストレージ関連の詳細を指定します。
Type
: この属性は現在「ヒープ」にのみ設定できます NCache ヒープベースのストレージのみをサポートします。
Cache-size
: この属性はキャッシュ サイズの上限を MB 単位で指定します。
<eviction-policy enabled-eviction="True" default-priority="normal" policy="lru" eviction-ratio="5%"/>
この XML タグは、エビクションを実行するかどうかを指定します。エビクションが有効な場合、キャッシュは新しいアイテムに対応するために既存のアイテムを削除します。終了するアイテムは、エビクション戦略に基づいて削除されます。
Enabled-eviction
: エビクションを有効にするには、この属性を True に設定し、それ以外の場合は False に設定します。
Policy
: この属性は、使用するエビクション ポリシーを指定します。 エビクション ポリシーは次のいずれかになります。
- LRU (最近使用されていないもの) (NCache Enterprise の)
- LFU (最も頻繁に使用されない) (NCache Enterprise の)
- 優先度ベース
Default-priority
: 項目に優先順位が指定されていない場合に、その項目に関連付けられるデフォルトの優先順位を指定します。この属性は次のように設定できます。
- ハイ
- 通常以上
- ノーマル
- 通常以下
- ロー
これは、優先度に基づく退きの場合にのみ適用されます。
Eviction-ratio
: エビクションの実行時にデータの何パーセントをエビクションするかを指定します。
<expiration-policy enabled="True">
<absolute-expiration longer-enabled="False" longer-value="0" default-enabled="False" default-value="0"/>
<sliding-expiration longer-enabled="False" longer-value="0" default-enabled="False" default-value="0"/>
</expiration-policy>
enabled
:有効期限ポリシーを有効にします。
longer-enabled
: より長い有効期限を有効にするかどうかを指定します。 True の場合、値を指定する必要があります。
longer-value
: Longer-enabled が True の場合、この値は有効期限に使用されます。
default-enabled
: デフォルトの有効期限を有効にするかどうかを指定します。 True の場合、値も指定する必要があります。
default-value
:default-enabled が True の場合、この値は有効期限に使用されます。
<security>
<user id="john_smith" dn="CN=John Smith,OU=admin,DC=yourdomain,DC=org"/>
<user id="david_watson" dn="CN=David Watson,OU=admin,DC=yourdomain,DC=org"/>
<group id="DEV" dn="CN=DEV,OU=admin,DC=yourdomain,DC=org"/>
</security>
user
: この属性は、管理者ユーザーの資格情報を指定します。
id
: ユーザーのIDを指定します。dn
: ユーザーの識別名を指定します。
group
: この属性はグループの詳細を指定します。
id
:グループの名前を指定します。dn
: グループの識別名を指定します。
<cache-topology topology="partition-replica">
<cluster-settings operation-timeout="60sec" stats-repl-interval="2sec" use-heart-beat="True">
...
</cluster-settings>
</cache-topology>
この XML タグは、クラスター内通信の詳細を指定するために使用されます。また、クラスターの通信の詳細をさらに定義するサブタグ、チャネルも含まれています。
このタグはローカル キャッシュには存在しないことに注意してください。
topology
: クラスターが従うトポロジーを指定します。これは、によって提供される次のいずれかになります。 NCache:
- パーティションレプリカトポロジ (NCache Enterprise の)
- 複製されたトポロジー
- パーティション化されたトポロジ
- ミラートポロジ
operation-timeout
: クラスター内のサーバーが応答しなかった場合のサーバー間の接続のタイムアウトを決定します。
stats-repl-interval
: (統計レプリケーション間隔) サーバー間で情報を同期するためにクラスターに提供される間隔。
use-heart-beat
: HeartBeat は、ノード間の接続を監視するために使用されます。
<data-persistence store-name="demoPersistenceCache_db">
<provider-settings provider-type="ncache-persistence" connection-string="lxxKK7Xqh0Tpm3rPvPOmYcCRYyeUV8f8NswyNRFum/uA0HXudbm6vWkXcnJ33GE9"/>
<operation-setting persistence-interval="1000ms" persistence-retries="3" persistence-interval-longer="60sec"/>
</data-persistence>
このタグ data-persistence
持続性を持つ分散キャッシュの設定を決定するために使用されます。 設定した場合にのみ表示されます store-type
as distributed-cache-persistence
。 次のパラメータがあります。
provider-type
: このパラメーターは、サーバーで使用している持続性プロバイダーのタイプを示します。 distributed-cache-persistence
。 価値があります ncache-persistence
.
connection-string
:との接続を決定する有効な接続文字列 provider-type
指定。
persistence-interval
: これは、永続キューに存在する操作が永続ストアに適用されるまでの間隔です。
persistence-retries
: これは、永続化バッチが失敗した場合に、永続化間隔が永続化間隔が長めに移行されるまでの再試行の回数です。
persistence-interval-longer
: 複数の連続した失敗がpersistence-retriesに達すると、間隔はpersistence-interval-longerに設定されます。
<caching-modules>
<module name="lucene-net-4.8" enable="True">
<parameters name="IndexPath" value="C:\ProgramData\ncache\lucene-index\lucene"/>
</module>
</caching-modules>
<caching-module>
: この XML タグは、キャッシュに登録されているすべてのモジュールとそれぞれのパラメータを指定します。 を設定した場合にのみ表示されます。 store-type
as distributed-lucene
.
下 <module>
タグ、あなたは持っています:
name
: モジュールの名前を指定します。 モジュールは、ここで指定した名前によって識別されます。 この名前は一意である必要があります。
enable
: 提供されたモジュールを有効/無効にします。
下 <parameters>
タグ、あなたは持っています:
name
: モジュールに対して追加されるパラメータのリストを指定します。
value
: 追加されたパラメータに指定された値を指定します。
<cluster-connection-settings cluster-port="7806" port-range="1" connection-retries="2" connection-retry-interval="2secs" join_retry_count="24" join_retry_timeout="5"/>
<cluster-connection-settings>
: この XML タグは、クラスタ サーバー間のポート接続およびその他の通信オプションの詳細を指定します。
cluster-port
: 接続は TCP ポート経由で行われます。 この値は、それが占有するポートを定義します。
port-range
: 初期化時に、指定されたポートが他のアプリケーションによって使用されている場合、1 ずつ増分されたポートで接続を確立しようとします。このために範囲が指定されます。つまり、使用可能な TCP ポートを検索する範囲が指定されます。
connection-retries
: ノード間の接続が失敗した場合、永続的な失敗とみなすために何回再試行するかを定義します。
connection-retry-interval
: 接続を再試行する間隔はこの値で定義されます。
<alerts>
<email-notification email-notification-enabled="False" sender="" smtp-server="" smtp-port="0" ssl="False" authentication="False" sender-login="" sender-password=""/>
<alerts-types cache-stop="False" cache-start="False" node-left="False" node-joined="False" state-transfer-started="False" state-transfer-stop="False" state-transfer-error="False" cache-size="False"/>
</alerts>
電子メールによるイベント通知 (エンタープライズ機能のみ) が必要な場合は、そのセットアップの情報がここで構成されます。
Email-notification
: 電子メール アドレスに関連するすべての情報が含まれます。
Email-notification-enabled
: 電子メールによる通知を有効にします。
Sender
: 電子メール通知の送信元の電子メール アカウントを指定します。
Smtp-server
: 電子メール通知を送信するゲートウェイを指定します。
Smtp-port
: メールの転送に使用するポート番号。
SSL
: SSL セキュリティを有効にする Secure Socket Layer。
Authentication
: 認証が必要な場合、これは True になります。
Sender-login
: 認証が必要な場合は、ログイン名を指定します。
Sender-password
:認証パスワードを入力します。
Alert-Types
: 自動電子メールが生成されるイベントを指定します。
Cache-stop
: キャッシュが停止した場合は、電子メール通知が生成されます。
Cache-start
: キャッシュの開始時に、電子メール通知が生成されます。
Node-left
: サーバー ノードがクラスターから離脱する場合、または何らかの理由でサーバー ノードにアクセスできない場合、これが有効になっている場合は電子メール通知が送信されます。
Node-joined
: サーバー ノードに参加すると、電子メール通知が生成されます。
State-Transfer-started
: 負荷分散の実行時に発生する状態転送が発生するたびに通知するために、電子メール通知が生成されます。
Cache-size
: ホット アプライを使用してキャッシュ サイズが変更されるたびに、電子メール通知が生成されます。
<sql-dependency use-default="False"/>
このXMLタグは、キューイングおよびサービスSQL通知アーキテクチャーを指定します。 (エンタープライズのみ)
Use-default
: 属性は True/False に設定できます。この属性が True に設定されている場合、デフォルトの SQL 依存関係サービスとキューが実行時に作成されます。属性が False に設定されている場合、カスタム定義の SQL 依存関係サービスとキューが作成され、 NCache.