[DCOS_OSS-1598] [Networking Docs Bugs] Document `hostname` resolution for DC/OS nodes. Created: 29/Aug/17  Updated: 25/Feb/19  Resolved: 25/Feb/19

Status: Resolved
Project: DC/OS
Component/s: docs, networking
Affects Version/s: None
Fix Version/s: DC/OS 1.11

Type: Bug Priority: Medium
Reporter: Avinash Sridharan (Inactive) Assignee: Lisa Gunn (Inactive)
Resolution: Done  
Labels: bulk-defer-to-1.10.2-20171106, issuetype:improvement, networking-docs
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Epic Link: [Doc Bugs] Doc Bugs Bucket
Team: Doc Team
Sprint: Networking Team 1.11 Sprint 14
Story Points: 3


We need to document that a DC/OS nodes hostname should resolve to a locally bindable IP address. If the hostname of a node is set to a non-local IP address, it might lead to undefined behavior from applications due to the fact that the most applications resolve the hostname to bind to local address.

Comment by Marco Monaco [ 06/Nov/17 ]

This ticket is deferred to DC/OS 1.10.2 as part of a bulk move (labels=bulk-defer-to-1.10.2-20171106). Please make sure this targeted fixVersion is correct, as well as the workflow status. �

Comment by Marco Monaco [ 21/Nov/17 ]

Are you able to do that for 1.10.2? If not, can you please update the fixVersion in here? Thanks

Comment by Suzanne Scala (Inactive) [ 22/Nov/17 ]

Avinash Sridharan – can you provide a bit more context about this? Is this something a user would configure at install time?

Comment by Seth Mason (Inactive) [ 25/Jan/18 ]

Avinash Sridharan can you assign this to an engineer to work with Thomas King to update the documentation? RC1 is Friday.

Comment by Marco Monaco [ 20/Apr/18 ]

As we continue to deferring this ticket, I am downgrading it now.

Comment by Marco Monaco [ 23/May/18 ]

Bulk change: please update the fixVersion DC/OS 1.11.2 as this has been released already.

Comment by Deepak Goel [ 14/Jun/18 ]

Sarah Stegall Could you please work with Ben Wood and me to document this ?

cc Pavi Sandhu

Comment by Lisa Gunn (Inactive) [ 25/Feb/19 ]

All DC/OS node host names should resolve to *locally bindable* IP addresses. Most applications require host names to resolve by binding to a local IP address to function correctly. Applications that cannot resolve the host name of a node by binding to a local IP address might fail to function or behave in unexpected ways.


Craig Neth [11:39 AM]
I think it was meant to go into the “System Requirements”, probably somewhere in this paragraph: https://docs.mesosphere.com/1.12/installing/production/system-requirements/#port-and-protocol-configuration

It’s related to bullet 3 in that list, I believe.


Comment by Lisa Gunn (Inactive) [ 25/Feb/19 ]

Add to 1.10, 1.11, 1.12, and 1.13 - PR:


Generated at Sun May 22 08:44:13 CDT 2022 using JIRA 7.8.4#78004-sha1:5704c55c9196a87d91490cbb295eb482fa3e65cf.