)]}'
{"doc/source/afs.rst":[{"author":{"_account_id":27803,"name":"Jeffrey Altman","email":"jaltman@auristor.com"},"change_message_id":"e1b38268173e008311966802796ec565c0ab7a78","unresolved":false,"context_lines":[{"line_number":232,"context_line":"   Do *not* run these operations on the fileservers where the volumes"},{"line_number":233,"context_line":"   or replicas are to be created (``afs01`` or ``afs02``).  There is a"},{"line_number":234,"context_line":"   bug with ~pre 1.6.16 openafs and Debuntu\u0027s use of ``127.0.1.1`` as"},{"line_number":235,"context_line":"   with the hostname in ``/etc/hosts``.  If you create the volume on"},{"line_number":236,"context_line":"   host where it will reside, when updating the volume database (VLDB)"},{"line_number":237,"context_line":"   openafs may look itself up, get the localhost address (and not"},{"line_number":238,"context_line":"   filter it out correctly) and use that as the server\u0027s address in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff570b3c_5d014406","line":235,"updated":"2020-06-11 12:55:23.000000000","message":"The problem isn\u0027t specific to pre-1.6.16 and will affect all versions of openafs.\n\nThe problem is that Volume Location entries in the database are constructed by the \"vos\" program and not by the vlserver.  These records do not store DNS hostnames but use the IPv4 address of the fileserver as the canonical server identifier.  In IBM AFS 3.4 there was an introduction of a fileserver UUID to represent multi-homed servers but IBM never finished the conversion of the VLDB from IPv4 based identifiers to UUIDs.  (AuriStorFS \n\nTo this day, OpenAFS vos when creating or updating a volume entry will blindly insert the IPv4 address provided from the command line.  When the volume location entry is received by the vlserver, the vlserver blindly creates a fileserver entry for any IPv4 address received for which there is no matching fileserver entry.\n\nAs you concluded, the problem is the hostname to IPv4 address translation where /etc/hosts is taking precedence over the DNS lookups.  The acceptance of DNS hostnames by \"vos\" is a convenience for humans.   It also accepts IPv4 addresses and doing so will be safe anywhere.\n\nNote that this same problem exists with NAT addresses in case opendev.org ever deploys servers behind a NAT.","commit_id":"3218ec30bf26015cbb56aaa342d904cd28bef6e4"}]}