Change Details

We are maintaining two datacenters with the goal of surviving a DC-wide outage, such as a power failure or fiber cut. Supporting multi-DC replication has been a design consideration for RESTBase from the start. By choosing Cassandra as the storage backend, we get to use Cassandra's relatively mature cross-DC replication support. We are in the process of purchasing a replica cluster for codfw (see T93790). The hardware there will hopefully come online before the end of this quarter. In the meantime, we should prepare and test cross-DC replication. We don't have a general ipsec setup between the datacenters, so we'll likely need to [encrypt and strongly authenticate](http://docs.datastax.com/en/cassandra/2.1/cassandra/security/secureSSLCertificates_t.html) the cross-DC connections at the Cassandra level. Assuming one instance per hardware node (depends on T95253), testing at the full replication volume might require six nodes to keep up with compaction. Unless there are that many spares in codfw we might not be able to test this fully with the production cluster. We could however consider setting this up for the staging cluster, which has modest and controllable resource needs. Any set of three nodes (SSD or not) in codfw should be sufficient to test this in staging. = Proposed Online Migration Process = # Update `system_auth` keyspace replication (`{'eqiad': 9, 'codfw': 3}`) # Set up the nodes in codfw. ## Setting `auto_bootstrap: false` ## `cassandra-rackdc.properties` configured accordingly. # Ensure that eqiad RESTBase clients do not auto-discover codfw nodes (or enable {T111113}) # Ensure that `localQuorum` or `localOne` are used throughout RESTBase # Start Cassandra on the new codfw nodes # Alter the existing keyspaces to set replication accordingly (T76494) # Rebuild each codfw node against the eqiad DC (`nodetool rebuild -- eqiad`) # Set `auto_bootstrap: true` on codfw nodes # Implement multi-DC-aware RESTBase keyspace creation (T76494) Rationale: Rebuilds are preferred to bootstraps here because it allows us to decouple membership and data transfer; to put the modified topology in place //before// any data movement. If you were to bootstrap the new nodes individually, the first new node would end up with an entire cluster's worth of data (a replica for every range).

We are maintaining two datacenters with the goal of surviving a DC-wide outage, such as a power failure or fiber cut. Supporting multi-DC replication has been a design consideration for RESTBase from the start. By choosing Cassandra as the storage backend, we get to use Cassandra's relatively mature cross-DC replication support. We are in the process of purchasing a replica cluster for codfw (see T93790). The hardware there will hopefully come online before the end of this quarter. In the meantime, we should prepare and test cross-DC replication. We don't have a general ipsec setup between the datacenters, so we'll likely need to [encrypt and strongly authenticate](http://docs.datastax.com/en/cassandra/2.1/cassandra/security/secureSSLCertificates_t.html) the cross-DC connections at the Cassandra level. Assuming one instance per hardware node (depends on T95253), testing at the full replication volume might require six nodes to keep up with compaction. Unless there are that many spares in codfw we might not be able to test this fully with the production cluster. We could however consider setting this up for the staging cluster, which has modest and controllable resource needs. Any set of three nodes (SSD or not) in codfw should be sufficient to test this in staging. = Proposed Online Migration Process = # [x] Implement multi-DC-aware RESTBase keyspace creation (T76494) # [ ] Update `system_auth` keyspace replication (`{'eqiad': 9, 'codfw': 6}`) # [ ] Set up the new nodes in codfw. ## [ ] Setting `auto_bootstrap: false` ## [ ] `cassandra-rackdc.properties` configured accordingly. # ~~Ensure that eqiad RESTBase clients do not auto-discover codfw nodes (or enable {T111113})~~ # [x] Ensure that `localQuorum` or `localOne` are used throughout RESTBase # [ ] Start Cassandra on the new codfw nodes # [ ] Alter the existing keyspaces to set replication accordingly (see T76494) # ~~Rebuild each codfw node against the eqiad DC (`nodetool rebuild -- eqiad`)~~ # ~~Set `auto_bootstrap: true` on codfw nodes~~ Rationale: Rebuilds are preferred to bootstraps here because it allows us to decouple membership and data transfer; to put the modified topology in place //before// any data movement. If you were to bootstrap the new nodes individually, the first new node would end up with an entire cluster's worth of data (a replica for every range). Notes: Step 4 was meant to prevent unencrypted cross-DC client traffic in the event that the hot RESTBase instances (in eqiad) needed to fail-over connections to codfw. Such a fail-over scenario is highly unlikely, and the unencrypted traffic would transit a private link, so this step is on hold until after codfw comes on-line, (both to expedite this issue, and to simplify the transition to client encryption). Step 8 would have streamed the nodes' data from eqiad, bringing the codfw cluster up to date with a full copy of eqiad. However, this would bring the 6 newly provisioned codfw nodes to an average of 966GB each, which is precariously close to when we began to [[https://issues.apache.org/jira/browse/CASSANDRA-9624|experience problems bootstrapping]]. Therefore, this step will be postponed. In the absence of a complete rebuild, newly written data //will// however be actively replicated, and available for reads. Once T95253 is complete, each new instance can be fully bootstrapped as has been the plan.

We are maintaining two datacenters with the goal of surviving a DC-wide outage, such as a power failure or fiber cut. Supporting multi-DC replication has been a design consideration for RESTBase from the start. By choosing Cassandra as the storage backend, we get to use Cassandra's relatively mature cross-DC replication support. We are in the process of purchasing a replica cluster for codfw (see T93790). The hardware there will hopefully come online before the end of this quarter. In the meantime, we should prepare and test cross-DC replication. We don't have a general ipsec setup between the datacenters, so we'll likely need to [encrypt and strongly authenticate](http://docs.datastax.com/en/cassandra/2.1/cassandra/security/secureSSLCertificates_t.html) the cross-DC connections at the Cassandra level. Assuming one instance per hardware node (depends on T95253), testing at the full replication volume might require six nodes to keep up with compaction. Unless there are that many spares in codfw we might not be able to test this fully with the production cluster. We could however consider setting this up for the staging cluster, which has modest and controllable resource needs. Any set of three nodes (SSD or not) in codfw should be sufficient to test this in staging. = Proposed Online Migration Process = # Update `system_auth` keyspace replication (`{'eqiad': 9, 'codfw': 3}`# [x] Implement multi-DC-aware RESTBase keyspace creation (T76494) # Set up the nodes in # [ ] Update `system_auth` keyspace replication (`{'eqiad': 9, 'codfw.': 6}`) ## Setting `auto_bootstrap: false`# [ ] Set up the new nodes in codfw. ## `cassandra-rackdc.properties` configured accordingly.## [ ] Setting `auto_bootstrap: false` # Ensure that eqiad RESTBase clients do not auto-discover codfw nodes (or enable {T111113})## [ ] `cassandra-rackdc.properties` configured accordingly. # # ~~Ensure that `localQuorum` or `localOne` are used throughout RESTBaseeqiad RESTBase clients do not auto-discover codfw nodes (or enable {T111113})~~ # Start Cassandra on the new codfw nodes# [x] Ensure that `localQuorum` or `localOne` are used throughout RESTBase # Alter the existing keyspaces to set replication accordingly (T76494)# [ ] Start Cassandra on the new codfw nodes # Rebuild each codfw node against the eqiad DC (`nodetool rebuild -- eqiad`# [ ] Alter the existing keyspaces to set replication accordingly (see T76494) # Set `auto_bootstrap: true` on codfw nodes# ~~Rebuild each codfw node against the eqiad DC (`nodetool rebuild -- eqiad`)~~ # Implement multi-DC-aware RESTBase keyspace creation (T76494)# ~~Set `auto_bootstrap: true` on codfw nodes~~ Rationale: Rebuilds are preferred to bootstraps here because it allows us to decouple membership and data transfer; to put the modified topology in place //before// any data movement. If you were to bootstrap the new nodes individually, the first new node would end up with an entire cluster's worth of data (a replica for every range). Notes: Step 4 was meant to prevent unencrypted cross-DC client traffic in the event that the hot RESTBase instances (in eqiad) needed to fail-over connections to codfw. Such a fail-over scenario is highly unlikely, and the unencrypted traffic would transit a private link, so this step is on hold until after codfw comes on-line, (both to expedite this issue, and to simplify the transition to client encryption). Step 8 would have streamed the nodes' data from eqiad, bringing the codfw cluster up to date with a full copy of eqiad. However, this would bring the 6 newly provisioned codfw nodes to an average of 966GB each, which is precariously close to when we began to [[https://issues.apache.org/jira/browse/CASSANDRA-9624|experience problems bootstrapping]]. Therefore, this step will be postponed. In the absence of a complete rebuild, newly written data //will// however be actively replicated, and available for reads. Once T95253 is complete, each new instance can be fully bootstrapped as has been the plan.