Skip to content

Commit 6a991ef

Browse files
committed
[ci skip] add a note about connect times and schema metadata
1 parent 07f4960 commit 6a991ef

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

features/README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -327,6 +327,10 @@ Read more about CQL3 in the [CQL3 syntax documentation][1] and the [Cassandra qu
327327

328328
## Troubleshooting
329329

330+
### Cassandra.cluster is taking too long
331+
332+
Upon initial connection, the Ruby driver begins inspecting schema metadata and reconstructing token ranges. This is necessary for token-aware load balancing, but might take an very long time for some schemas/clusters. If you cannot wait for such a long startup time, you can disable schema metadata altogether by passing `synchronize_schema: false` to `Cassandra.cluster`.
333+
330334
### I get "connection refused" errors
331335

332336
Make sure that the native transport protocol is enabled. If you're running Cassandra 1.2.5 or later the native transport protocol is enabled by default, if you're running an earlier version (but later than 1.2) you must enable it by editing `cassandra.yaml` and setting `start_native_transport` to `true`.

0 commit comments

Comments
 (0)