hashicorp / hashicorp/nomad

document why servers and clients uses different port to join server 4647 VS 4648

Open
#20,119 1 comment 0 reactions 0 assignees View on GitHub
stage/accepted theme/config theme/docs
Dominant language
Go
Stars
17k
Forks
2.1k
Avg merge
1d 9h
Merged PRs (30d)
105

Description

![image](https://github.com/hashicorp/nomad/assets/139780495/7c311ce7-1751-4ed1-8ab1-76949b0a29e0)

1. This not clear information is documented on this page: https://developer.hashicorp.com/nomad/tutorials/manage-clusters/clustering#manual-clustering

2. Also please clarify 'The port corresponds to the RPC port. ' part. Which RPC port do you mean here: nomad, consul etc? Provide a link to corresponding configuration option.

3. > This means only one server must be specified because, after initial contact, the full set of servers in the client's region are shared with the client.

I do not remember where but I am sure that you used array of servers as the value for this option. Anyway we can see that you require array. Notice `[]` for the value. It is ambiguous is `only one server must be specified` why this one value is passed via array?

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the Manual Clustering section at the linked Nomad documentation page and review the explanation of ports 4647 and 4648, the RPC port wording, and the servers array example. Done means the page explains why clients and servers use different ports, identifies the relevant RPC configuration, and removes the ambiguity about specifying one server in an array.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.