DSE Advanced Replicationの使用

エッジ・クラスターのすべてのノードで、次のようにします。

1. dse.yamlファイルで、レプリケーションを有効にします。
   ファイルの最後で、advanced_replication_optionsのすべてのエントリーのコメントを解除し、enabled: trueを設定します。

   # Advanced Replication configuration settings
   advanced_replication_options:
   enabled:true

2. ローリング再起動を実行します。他のノードがオンラインで稼働し続けている状態で、エッジ・クラスターのノードを1つずつ再起動します。

レプリケーションが有効になっていない場合、データはレプリケーション・ログに書き込まれません。エッジ・クラスターのすべてのノードで、次のようにします。

1. レプリケーションを無効にするために、dse.yamlファイルを編集します。
   advanced_replication_optionsセクションで、enabled: falseを設定します。

   # Advanced Replication configuration settings
   advanced_replication_options:
   enabled:false

2. ローリング再起動を実行します。他のノードがオンラインで稼働し続けている状態で、エッジ・クラスターのノードを1つずつ再起動します。
3. DSE Advanced Replication用に使用されたデータを消去するために、次のキースペースを削除します。

   cqlsh> drop table dse_system.advrep_conf;
   cqlsh> drop table dse_system.advrep_table_conf;
   cqlsh> drop keyspace advrep;

グローバル設定は、CQLテーブルに直接書き込むことにより、変更できます。例：

cqlsh>INSERT INTO dse_system.advrep_conf (conf_key, conf_val) 
VALUES ('edge_replication', 'true');

または、次の構文のdse advrepコマンドライン・ツールを使用してグローバル設定を変更することもできます。

dse advrep edge conf ...

認証情報を複数の方法で提供できます。「認証情報」を参照してください。

dse advrepコマンドライン・ツールは、これらの構成キーを、dse advrepコマンドライン・ツールのコマンド引数として使用します。

エッジ・ノードの構成設定を表示するには、次のようにします。

dse advrep edge list-conf

次のように表示されます。

field            | value         
--------------------------------------------------
debug_output                      | true          
driver_connections                | 16            
replog_consumer_buffer            | 20000         
replication_log_audit_log_enabled | true          
rep_channel_permits               | 30000         
hub_ip_addresses                  | 10.200.241.156
remote_logging_ipaddress          | 10.200.164.72 
edge_replication                  | true          
driver_connections_max            | 256   

レプリケーション・チャネルは、エッジ・クラスターとハブ・クラスターとの間でデータを交換する、定義済みチャネル。です。各チャネル（一意のキースペースおよびテーブル）のレプリケーションは、自動作成されるCQLテーブルdse_system.advrep_table_confに保存されます。

CREATE TABLE dse_system.advrep_table_conf (
keyspace_name text,
table_name text,
edge_id text,
edge_id_col_name text,
enabled boolean,
hub_keyspace_name text,
hub_table_name text,
priority int,
truncate_timestamp timestamp,
PRIMARY KEY (keyspace_name, table_name)
)

変更する前に、チャネル構成を確認できます。例：

cqlsh> select * from dse_system.advrep_table_conf;

次のように表示されます。

keyspace_name | table_name | edge_id | edge_id_col_name | enabled | hub_keyspace_name | hub_table_name | ...
---------------+------------+---------+------------------+---------+-------------------+----------------+-...
foo            | bar        | null    | null             | True    | foo               | bar            | ...
(1 rows)

設定は、CQLテーブルに直接書き込むか、次の構文のdse advrepコマンドライン・ツールを使用して変更できます。

dse advrep edge channel ...

認証情報を複数の方法で提供できます。「認証情報」を参照してください。

プロパティはメタデータから継続的に読み取られるため、構成変更の完了後に再起動する必要はありません。次の表では、構成の設定について説明します。 レプリケーション・チャネルを構成した後、チャネルのステータスを表示できます。

dse advrep edge channel status

次のように表示されます。

keyspace_name | table_name | edge_id | edge_id_col_name | enabled | hub_keyspace_name | hub_table_name | priority | truncate_timestamp
--------------------------------------------------------------------------------------------------------------------------------------
advrep        | loki       |         |                  | True    | advrep            | loki           | 2        | None              
advrep        | thor       |         |                  | True    | advrep            | thor           | 1        | None       

ドライバーのパスワードはCQLテーブルに保存されます。デフォルトでは、ドライバーのパスワードはプレーン・テキストです。DataStaxでは、CQLテーブルに追加する前にドライバーのパスワードを暗号化することを推奨します。SSTable 暗号化のための、システム・キーと呼ばれるグローバル暗号化キーが作成されます。エッジ・クラスターの各ノードには、同じシステム・キーが必要です。ハブにはこのキーは必要ありません。

1. dse.yamlファイルで、次の操作を行います。
   • config_encryption_activeプロパティがfalseであることを確認します。

     config_encryption_active:false

   • conf_driver_password_encryption_enabledプロパティにより、ドライバーのパスワード暗号化を有効にします。

     conf_driver_password_encryption_enabled:true

   • system_key_directoryプロパティにより、システム・キーを保存するディスク上の場所を定義します。

     system_key_directory:/etc/dse/conf

     デフォルト値は/etc/dse/confです。
   • config_encryption_key_nameプロパティにより、暗号化キーがシステム・キーとして生成されることを指定します。

     config_encryption_key_name:system_key

2. システム・キーを生成します。
   サーバー内：

   dsetool createsystemkey cipher strength system_key_file

   サーバー外：

   dsetool createsystemkey cipher strength system_key_file -kmip=kmip_groupname

   例：

   dsetool createsystemkey 'AES/ECB/PKCS5Padding' 128 system_key_file

   system_key_fileは、生成されたシステム・キー・ファイルの一意のファイル名です。createsystemkeyを参照してください。

   結果: グローバル暗号化キーは、dse.yamlファイルのsystem_key_directoryで指定されている場所に作成できます。このデフォルトのグローバル暗号化キーは、system_key_fileサブプロパティが指定されていない場合に使用されます。

3. 返された値をコピーします。
4. エッジ・クラスターの任意のノードでdseコマンドを使用し、DSE Advanced Replication環境用に暗号化されたパスワードを設定します。

   dse advrep edge conf --driver-pwd "Sa9xOVaym7bddjXUT/eeOQ==" --driver-user "username"

5. dse.yamlで、conf_driver_password_encryption_enabledプロパティをtrueに設定します。

   conf_driver_password_encryption_enabled:true

6. dseを起動します。

サポートされるデータ挿入方法は次のとおりです。

• CQLの挿入（cqlsh、標準的なCassandraドライバーを使用するアプリケーションを含む）
• CSVファイルからのコピー
• Solr HTTPまたはCQL
• Spark saveToCassandra

サポートされないデータ挿入方法は次のとおりです。

• コンパクト・ストレージ用に定義されたテーブル
• Sstableloader（Cassandraバルク・ローダー）
• バックアップからのOpsCenter復元
• Spark bulkSaveToCassandra