This guide covers adding shards or replicas to an NFA ClickHouse cluster. Configure all XML files first, then restart ClickHouse Server once per existing node. Run database initialization only from the NFA node.
Example Topology #
| Node | Hostname | Services |
|---|---|---|
| Shard 01 / Replica 01 | shard1-node.example.com | NFA + ClickHouse + Keeper |
| Shard 02 / Replica 01 | shard2-node.example.com | ClickHouse |
Network Requirements #
| Connection | Port | Requirement |
|---|---|---|
| ClickHouse native | TCP 9000 | Reachable between all ClickHouse nodes |
| ClickHouse Keeper | TCP 9181 | Reachable from every ClickHouse node |
Important: Use real hostnames and addresses throughout. Restrict these ports to trusted hosts and networks.

