Feedback: Deploy CockroachDB On-Premises

[mgoddard]

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]

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]]

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

[mgoddard]

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.