[OpenAFS] Modifying the output of vos commands to include server UUIDs
Jeffrey Altman
jaltman@secure-endpoints.com
Tue, 13 Apr 2010 09:26:24 -0400
This is a cryptographically signed message in MIME format.
--------------ms040009090001020707000000
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
In 2002, the OpenAFS version of the "vos listaddrs" command was updated
to include the Arla -printuuid and -noresolve options which permits the
UUID and IP address of registered file servers to be displayed. For
example:
UUID: 006cab10-0e3e-1b20-a3-aa-2601a8c0aa77
24.193.47.88
192.168.122.1
192.168.1.38
In 2008, the -noresolve option was made generic so that it could apply
to all vos commands so that instead of seeing DNS names the actual IP
addresses of server could be viewed. This change was made because DNS
name resolution often makes it appear that a file server is properly
registered when instead it is in fact not.
However, IP addresses are not the canonical method of identifying a file
server. For that the UUID is required and at the present time there is
no mechanism when using vos listvldb or vos examine to identify the UUID
of the server on which a volume is located. This lack has come up
several times in the #openafs IRC channel when attempting to help users
setup new cells or add new file servers. The most recent time on March
30th.
Gerrit http://gerrit.openafs.org/#change,1742 is an attempt to add
-printuuid as a standard option to all vos commands. The only issue at
the moment is what the format of the output should look like. UUIDs and
DNS names are long. Extending the existing format to include the UUID
inline with each server produces output that will not fit in an 80
column terminal.=20
An example of "vos examine -printuuid" output:
root.cell 537870331 RW 42 K On-line
ASCLEPIUS.MIT.EDU [0037555a-be36-19a6-a2-4d-5e3c0912aa77] /vicepr
RWrite 537870331 ROnly 537870333 Backup 537870332
MaxQuota 500 K
Creation Fri Jun 06 12:24:21 2008
Copy Thu Feb 26 11:43:23 2009
Backup Tue Apr 13 02:00:17 2010
Last Update Thu Oct 18 12:44:23 2007
7647 accesses in the past day (i.e., vnode references)
RWrite: 537870331 ROnly: 537870333 Backup: 537870332
number of sites -> 4
server ASCLEPIUS.MIT.EDU [0037555a-be36-19a6-a2-4d-5e3c0912aa77]
partition /vicepr RW Site
server ASCLEPIUS.MIT.EDU [0037555a-be36-19a6-a2-4d-5e3c0912aa77]
partition /vicepr RO Site
server MNEMOSYNE.MIT.EDU [005d91e8-f824-19a6-aa-5c-613c0912aa77]
partition /vicepr RO Site
server IXION.MIT.EDU [00086236-fa87-19a6-b4-de-ab015b12aa77]
partition /vicepr RO Site
An example of "vos listvldb -printuuid" output:
root.cell
RWrite: 536870915 ROnly: 536870916
number of sites -> 4
server bethlehem.your-file-system.com
[0008fa02-d48c-19b9-81-fc-419a1dccaa77] partition /vicepa RW Site
server bethlehem.your-file-system.com
[0008fa02-d48c-19b9-81-fc-419a1dccaa77] partition /vicepa RO Site
server faultline.your-file-system.com
[0007580a-7001-1aae-85-8e-2f9a1dccaa77] partition /vicepa RO Site
server cpe-24-193-47-88.nyc.res.rr.com
[006cab10-0e3e-1b20-a3-aa-2601a8c0aa77] partition /vicepa RO Site
One alternative output format that could be used when the -printuuid
option is specified is found below.
vos examine -printuuid:
root.cell 537870331 RW 42 K On-line
UUID: 0037555a-be36-19a6-a2-4d-5e3c0912aa77
Server ASCLEPIUS.MIT.EDU
Partition /vicepr
RWrite 537870331 ROnly 537870333 Backup 537870332
MaxQuota 500 K
Creation Fri Jun 06 12:24:21 2008
Copy Thu Feb 26 11:43:23 2009
Backup Tue Apr 13 02:00:17 2010
Last Update Thu Oct 18 12:44:23 2007
7647 accesses in the past day (i.e., vnode references)
RWrite: 537870331 ROnly: 537870333 Backup: 537870332
number of sites -> 4
RW Site
server ASCLEPIUS.MIT.EDU
uuid 0037555a-be36-19a6-a2-4d-5e3c0912aa77
partition /vicepr
RO Site
server ASCLEPIUS.MIT.EDU
uuid 0037555a-be36-19a6-a2-4d-5e3c0912aa77
partition /vicepr
RO Site
server MNEMOSYNE.MIT.EDU
uuid 005d91e8-f824-19a6-aa-5c-613c0912aa77
partition /vicepr
RO Site
server IXION.MIT.EDU
uuid 00086236-fa87-19a6-b4-de-ab015b12aa77
partition /vicepr
vos listvldb -printuuid:
root.cell
RWrite: 536870915 ROnly: 536870916
number of sites -> 4
RW Site
server bethlehem.your-file-system.com
uuid 0008fa02-d48c-19b9-81-fc-419a1dccaa77
partition /vicepa
RO Site
server bethlehem.your-file-system.com
uuid 0008fa02-d48c-19b9-81-fc-419a1dccaa77
partition /vicepa
RO Site
server faultline.your-file-system.com
uuid 0007580a-7001-1aae-85-8e-2f9a1dccaa77
partition /vicepa
RO Site
server cpe-24-193-47-88.nyc.res.rr.com
uuid 006cab10-0e3e-1b20-a3-aa-2601a8c0aa77
partition /vicepa
Please offer your opinions. As people have a variety of scripts that
parse the output of vos commands to automate behaviors, we would not be
changing the default output. Any format change would only be used when
the -printuuid option is specified.
Jeffrey Altman
--------------ms040009090001020707000000
Content-Type: application/pkcs7-signature; name="smime.p7s"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="smime.p7s"
Content-Description: S/MIME Cryptographic Signature
MIAGCSqGSIb3DQEHAqCAMIACAQExCzAJBgUrDgMCGgUAMIAGCSqGSIb3DQEHAQAAoIIJeTCC
AxcwggKAoAMCAQICEAMF9RTCGOz151fTpHLih+cwDQYJKoZIhvcNAQEFBQAwYjELMAkGA1UE
BhMCWkExJTAjBgNVBAoTHFRoYXd0ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMT
I1RoYXd0ZSBQZXJzb25hbCBGcmVlbWFpbCBJc3N1aW5nIENBMB4XDTA5MDgyODA0MDExOVoX
DTEwMDgyODA0MDExOVowczEPMA0GA1UEBBMGQWx0bWFuMRUwEwYDVQQqEwxKZWZmcmV5IEVy
aWMxHDAaBgNVBAMTE0plZmZyZXkgRXJpYyBBbHRtYW4xKzApBgkqhkiG9w0BCQEWHGphbHRt
YW5Ac2VjdXJlLWVuZHBvaW50cy5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
AQDZNscYIvF6xzGSAfa/QUIqiElyn0EUxL2b86eKiYqe91bj0gLr/MJoErLnb+OmokxqSAH6
y0zlFqSbiFwgNM8m69K6m/6YO+x3+5zBc+u6snwTWMEWygnhx3rQ/lMhoQOgArraL+/k9aWL
kNdaXQKk6EZVW9pfV2A4Lk4DoZGFjY8tJRWWDLlFkYnxDuIEpLYwJpwakv3QHOaq/G8KW0iE
jVhVzPobuZzwD2tuepY/bsClwqxz/gfAEpUvAn/lYTqnoT7RYljZlCIdbrgcG/HSYMxAy1Zp
Yh8Fx+9cqsG8O4nqo26SVfYZvrYhh8m6OqW8Vakdt7vBLCTa/QhIdJ4hAgMBAAGjOTA3MCcG
A1UdEQQgMB6BHGphbHRtYW5Ac2VjdXJlLWVuZHBvaW50cy5jb20wDAYDVR0TAQH/BAIwADAN
BgkqhkiG9w0BAQUFAAOBgQBvbvJNXUJ4atv1CExIe0J38jZqoEUTttkXOfCDT9e3mSmVboOK
ifHDyLZQC4qSsCUfP7vdwAXjKtjak22HbfX2sEKCUgtnOkxRqXMM2V/NW/ESNVQZF0TO7L/Z
cW3icObO9FIZCSmgFMt2Al7VPfMQmaJNlqu9SLmXSwbRFJ5b4zCCAxcwggKAoAMCAQICEAMF
9RTCGOz151fTpHLih+cwDQYJKoZIhvcNAQEFBQAwYjELMAkGA1UEBhMCWkExJTAjBgNVBAoT
HFRoYXd0ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMTI1RoYXd0ZSBQZXJzb25h
bCBGcmVlbWFpbCBJc3N1aW5nIENBMB4XDTA5MDgyODA0MDExOVoXDTEwMDgyODA0MDExOVow
czEPMA0GA1UEBBMGQWx0bWFuMRUwEwYDVQQqEwxKZWZmcmV5IEVyaWMxHDAaBgNVBAMTE0pl
ZmZyZXkgRXJpYyBBbHRtYW4xKzApBgkqhkiG9w0BCQEWHGphbHRtYW5Ac2VjdXJlLWVuZHBv
aW50cy5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZNscYIvF6xzGSAfa/
QUIqiElyn0EUxL2b86eKiYqe91bj0gLr/MJoErLnb+OmokxqSAH6y0zlFqSbiFwgNM8m69K6
m/6YO+x3+5zBc+u6snwTWMEWygnhx3rQ/lMhoQOgArraL+/k9aWLkNdaXQKk6EZVW9pfV2A4
Lk4DoZGFjY8tJRWWDLlFkYnxDuIEpLYwJpwakv3QHOaq/G8KW0iEjVhVzPobuZzwD2tuepY/
bsClwqxz/gfAEpUvAn/lYTqnoT7RYljZlCIdbrgcG/HSYMxAy1ZpYh8Fx+9cqsG8O4nqo26S
VfYZvrYhh8m6OqW8Vakdt7vBLCTa/QhIdJ4hAgMBAAGjOTA3MCcGA1UdEQQgMB6BHGphbHRt
YW5Ac2VjdXJlLWVuZHBvaW50cy5jb20wDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQUFAAOB
gQBvbvJNXUJ4atv1CExIe0J38jZqoEUTttkXOfCDT9e3mSmVboOKifHDyLZQC4qSsCUfP7vd
wAXjKtjak22HbfX2sEKCUgtnOkxRqXMM2V/NW/ESNVQZF0TO7L/ZcW3icObO9FIZCSmgFMt2
Al7VPfMQmaJNlqu9SLmXSwbRFJ5b4zCCAz8wggKooAMCAQICAQ0wDQYJKoZIhvcNAQEFBQAw
gdExCzAJBgNVBAYTAlpBMRUwEwYDVQQIEwxXZXN0ZXJuIENhcGUxEjAQBgNVBAcTCUNhcGUg
VG93bjEaMBgGA1UEChMRVGhhd3RlIENvbnN1bHRpbmcxKDAmBgNVBAsTH0NlcnRpZmljYXRp
b24gU2VydmljZXMgRGl2aXNpb24xJDAiBgNVBAMTG1RoYXd0ZSBQZXJzb25hbCBGcmVlbWFp
bCBDQTErMCkGCSqGSIb3DQEJARYccGVyc29uYWwtZnJlZW1haWxAdGhhd3RlLmNvbTAeFw0w
MzA3MTcwMDAwMDBaFw0xMzA3MTYyMzU5NTlaMGIxCzAJBgNVBAYTAlpBMSUwIwYDVQQKExxU
aGF3dGUgQ29uc3VsdGluZyAoUHR5KSBMdGQuMSwwKgYDVQQDEyNUaGF3dGUgUGVyc29uYWwg
RnJlZW1haWwgSXNzdWluZyBDQTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAxKY8VXNV
+065yplaHmjAdQRwnd/p/6Me7L3N9VvyGna9fww6YfK/Uc4B1OVQCjDXAmNaLIkVcI7dyfAr
hVqqP3FWy688Cwfn8R+RNiQqE88r1fOCdz0Dviv+uxg+B79AgAJk16emu59l0cUqVIUPSAR/
p7bRPGEEQB5kGXJgt/sCAwEAAaOBlDCBkTASBgNVHRMBAf8ECDAGAQH/AgEAMEMGA1UdHwQ8
MDowOKA2oDSGMmh0dHA6Ly9jcmwudGhhd3RlLmNvbS9UaGF3dGVQZXJzb25hbEZyZWVtYWls
Q0EuY3JsMAsGA1UdDwQEAwIBBjApBgNVHREEIjAgpB4wHDEaMBgGA1UEAxMRUHJpdmF0ZUxh
YmVsMi0xMzgwDQYJKoZIhvcNAQEFBQADgYEASIzRUIPqCy7MDaNmrGcPf6+svsIXoUOWlJ1/
TCG4+DYfqi2fNi/A9BxQIJNwPP2t4WFiw9k6GX6EsZkbAMUaC4J0niVQlGLH2ydxVyWN3amc
OY6MIE9lX5Xa9/eH1sYITq726jTlEBpbNU1341YheILcIRk13iSx0x1G/11fZU8xggNxMIID
bQIBATB2MGIxCzAJBgNVBAYTAlpBMSUwIwYDVQQKExxUaGF3dGUgQ29uc3VsdGluZyAoUHR5
KSBMdGQuMSwwKgYDVQQDEyNUaGF3dGUgUGVyc29uYWwgRnJlZW1haWwgSXNzdWluZyBDQQIQ
AwX1FMIY7PXnV9OkcuKH5zAJBgUrDgMCGgUAoIIB0DAYBgkqhkiG9w0BCQMxCwYJKoZIhvcN
AQcBMBwGCSqGSIb3DQEJBTEPFw0xMDA0MTMxMzI2MjRaMCMGCSqGSIb3DQEJBDEWBBQ1QuqU
E3cG5Cfu+InB7LyzOvfvpjBfBgkqhkiG9w0BCQ8xUjBQMAsGCWCGSAFlAwQBAjAKBggqhkiG
9w0DBzAOBggqhkiG9w0DAgICAIAwDQYIKoZIhvcNAwICAUAwBwYFKw4DAgcwDQYIKoZIhvcN
AwICASgwgYUGCSsGAQQBgjcQBDF4MHYwYjELMAkGA1UEBhMCWkExJTAjBgNVBAoTHFRoYXd0
ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4xLDAqBgNVBAMTI1RoYXd0ZSBQZXJzb25hbCBGcmVl
bWFpbCBJc3N1aW5nIENBAhADBfUUwhjs9edX06Ry4ofnMIGHBgsqhkiG9w0BCRACCzF4oHYw
YjELMAkGA1UEBhMCWkExJTAjBgNVBAoTHFRoYXd0ZSBDb25zdWx0aW5nIChQdHkpIEx0ZC4x
LDAqBgNVBAMTI1RoYXd0ZSBQZXJzb25hbCBGcmVlbWFpbCBJc3N1aW5nIENBAhADBfUUwhjs
9edX06Ry4ofnMA0GCSqGSIb3DQEBAQUABIIBACh9A2TcnILwGwFdJ4k5oGFHdE89Ejohbl8N
OD3+uE/02/wpqwXedzb9Sz9Q+Yrv4+Ki1XMXiWBxk2oba1iGqAbupmJ/b9uZ2r/gAN4EiAq5
6J9RNpu0gAUf/ZCdD8cqpfxIMSeHyZXHG0dzTJdZlEQs3YzqMxUQyoB6619Ev8IHMZn5bUjc
2ApcbB/CkawIsbeU/prBsj58SfiTAhkAl6Bttwjs5jBQMbzL8sxf/+b7cKAQesK6Q8/K5tPM
rXT+1m4vqc/4HRAVCoRzlLCKAvrCoCeskyJk3YKqEQrMeo2lmkIWS/A1Xp++u/ZIGfzv7ZyN
iFtD3hH4pHfgn4kvQqMAAAAAAAA=
--------------ms040009090001020707000000--