<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:52:10 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-6367] Config server migration procedures incorrectly refer to &quot;hostnames&quot;</title>
                <link>https://jira.mongodb.org/browse/DOCS-6367</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;There are two docs for migrating config server(s):&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;&lt;a href=&quot;http://docs.mongodb.org/manual/tutorial/migrate-config-servers-with-same-hostname/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Migrate Config Servers with the Same Hostname&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;http://docs.mongodb.org/manual/tutorial/migrate-config-servers-with-different-hostnames/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Migrate Config Servers with Different Hostnames&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;The former is a relatively easy procedure, whereas the latter requires a (brief) downtime, so it&apos;s important to choose the right one.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;TLDR:&lt;/b&gt;  All references to &quot;hostname&quot; (or &quot;hostnames&quot;) in these docs should be replaced by references to &quot;DNS name&quot; (or &quot;DNS names&quot;).&lt;/p&gt;

&lt;hr /&gt;

&lt;p&gt;&lt;b&gt;GORY DETAILS:&lt;/b&gt;&lt;/p&gt;

&lt;p&gt;Since one doc is &quot;same hostnames&quot; and the other is &quot;different hostnames&quot;, the differentiator between these two procedures is (apparently) whether or not the hostnames of the config servers need to change during the migration.&lt;/p&gt;

&lt;p&gt;This is not true.  &quot;DNS names&quot; are subtly different from &quot;hostnames&quot;, and these docs conflate the two concepts.  This can cause considerable confusion.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;Background:&lt;/b&gt;&lt;/p&gt;

&lt;p&gt;By definition, a host has &lt;em&gt;exactly one&lt;/em&gt; &quot;hostname&quot;.  The definitive source is the locally running operating system kernel.  It is independent of anything on the network, including DNS servers, IP addresses, and so on.  Even a host that has no network interfaces, and networking disabled in its kernel, will still have a hostname.  Hostnames are considered to be uniquely identifying of the host (within some given realm/environment/whatever).  &lt;em&gt;The hostname is what the host considers its &lt;b&gt;own name&lt;/b&gt; to be.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;By contrast, a host may have &lt;em&gt;any number&lt;/em&gt; of &quot;DNS names&quot; (including none).  &lt;em&gt;DNS names are what &lt;b&gt;other hosts&lt;/b&gt; use to connect to that host.&lt;/em&gt;  (Thus, the term &quot;DNS name&quot; is not ideal, since it is independent of DNS per se &amp;#8212; for example, &lt;tt&gt;/etc/hosts&lt;/tt&gt; can be used instead, and everything written here is still true.  Open to alternative suggestions.)  If there are no DNS names, then only an IP address can be used to connect to the host.  This definition clearly demonstrates that DNS names are a property of &lt;b&gt;remote&lt;/b&gt; hosts, and subject to how those other hosts have been configured.  Unlike the hostname, they are not an intrinsic property of the host itself.  Very often there will be a DNS name that matches the hostname, but this is not actually required.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;Migrating configsvrs:&lt;/b&gt;&lt;/p&gt;

&lt;p&gt;When migrating config servers, the issue at stake is purely this:  &lt;b&gt;does the string supplied to &lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt; need to change, or not?&lt;/b&gt;  If the names supplied to &lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt; &lt;b&gt;do not&lt;/b&gt; need to change, then the procedure currently described as &quot;same hostnames&quot; should be used.  If the names supplied to &lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt; &lt;b&gt;do&lt;/b&gt; need to change, then the procedure currently described as &quot;different hostnames&quot; should be used.  The important thing is that &lt;em&gt;hostnames have nothing to do with this &amp;#8212; &lt;b&gt;only the names that are in &lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt;&lt;/b&gt;&lt;/em&gt;.&lt;/p&gt;

&lt;p&gt;Knowing this, we can see that &quot;same hostnames&quot; is just one special case of &quot;&lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt; string does not need to change&quot;.  The other valid and common case is where &lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt; is using logical DNS names which can easily be updated, for example, CNAMEs.  All that matters is that the CNAME gets updated to point to the new config server (and its hostname could be anything).&lt;/p&gt;

&lt;p&gt;The flipside of this is that it is possible to have a situation where the DNS names in &lt;tt&gt;&amp;#45;&amp;#45;configdb&lt;/tt&gt; must change, yet the actual hostnames of the config servers do not.  In this case, a user might mistakenly believe that they can use the &quot;same hostnames&quot; procedure, when in fact the &quot;different hostnames&quot; procedure is required.&lt;/p&gt;</description>
                <environment></environment>
        <key id="234245">DOCS-6367</key>
            <summary>Config server migration procedures incorrectly refer to &quot;hostnames&quot;</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="2">Won&apos;t Fix</resolution>
                                        <assignee username="kay.kim@mongodb.com">Kay Kim</assignee>
                                    <reporter username="kevin.pulo@mongodb.com">Kevin Pulo</reporter>
                        <labels>
                    </labels>
                <created>Wed, 14 Oct 2015 02:04:33 +0000</created>
                <updated>Mon, 30 Oct 2023 21:40:36 +0000</updated>
                            <resolved>Tue, 1 Nov 2022 11:01:28 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>6</watches>
                                                                                                                <comments>
                            <comment id="4943593" author="edu.bot" created="Tue, 1 Nov 2022 11:01:25 +0000"  >&lt;p&gt;Hello! This ticket has been closed due to inactivity. If you believe this ticket is still important, please reopen it and leave a comment to explain why. Thank you!&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Tue, 1 Nov 2022 11:01:25 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        1 year, 14 weeks, 1 day ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCSP-1769</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>false</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            1 year, 14 weeks, 1 day ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>edu.bot</customfieldvalue>
            <customfieldvalue>kay.kim@mongodb.com</customfieldvalue>
            <customfieldvalue>kevin.pulo@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrq1ev:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hsng6v:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hryrwv:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>