search

cockroachdb / docs

CockroachDB user documentation
https://cockroachlabs.com/docs
Creative Commons Attribution 4.0 International
190 stars 460 forks source link

Feedback: Deploy CockroachDB On-Premises #18472

Open mgoddard opened 7 months ago

mgoddard commented 7 months ago

Michael Goddard (mgoddard) commented:

Page: https://cockroachlabs.com/docs/v23.2/deploy-cockroachdb-on-premises.html

What is the reason for your feedback?

[ ] Missing the information I need

[ ] Too complicated

[ ] Out of date

[X] Something is broken

[ ] Other

Additional details

Jira Issue: DOC-10079

mgoddard commented 7 months ago

I was just watching a user start a node using the syntax provided on this page:

cockroach start --certs-dir=certs --advertise-addr=<node1 address> --join=<node1 address>,<node2 address>,<node3 address> --cache=.25 --max-sql-memory=.25 --background

And the node was actually still listening on port 26257, the default if --listen-addr isn't specified (he had used the host:port syntax). I think, for this example, it's more helpful to either use --listen-addr alone, or to include it as well as --advertise-addr.

exalate-issue-sync[bot] commented 6 months ago

Shannon Bradshaw (shannonbradshaw) commented: Michael Goddard any more detail you can provide here?

mgoddard commented 6 months ago

Sure, and apologies for the delay. My point above was that the startup command, as shown, could lead a user to expect that the node will listen on the address provided to the --advertise-addr= flag and be puzzled when that doesn't happen. My suggestion was to alter this example and provide the --listen-addr= flag instead.