Documentation updates for gnt-debug and gnt-os
[ganeti-local] / scripts / gnt-os
1 #!/usr/bin/python
2 #
3
4 # Copyright (C) 2006, 2007 Google Inc.
5 #
6 # This program is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 2 of the License, or
9 # (at your option) any later version.
10 #
11 # This program is distributed in the hope that it will be useful, but
12 # WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 # General Public License for more details.
15 #
16 # You should have received a copy of the GNU General Public License
17 # along with this program; if not, write to the Free Software
18 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19 # 02110-1301, USA.
20
21
22 # pylint: disable-msg=W0401,W0614
23 # W0401: Wildcard import ganeti.cli
24 # W0614: Unused import %s from wildcard import (since we need cli)
25
26 import sys
27 from optparse import make_option
28
29 from ganeti.cli import *
30 from ganeti import opcodes
31 from ganeti import utils
32 from ganeti import constants
33
34
35 def ListOS(opts, args):
36   """List the valid OSes in the cluster.
37
38   @param opts: the command line options selected by the user
39   @type args: list
40   @param args: should be an empty list
41   @rtype: int
42   @return: the desired exit code
43
44   """
45   op = opcodes.OpDiagnoseOS(output_fields=["name", "valid"], names=[])
46   result = SubmitOpCode(op)
47
48   if not result:
49     ToStderr("Can't get the OS list")
50     return 1
51
52   if not opts.no_headers:
53     headers = {"name": "Name"}
54   else:
55     headers = None
56
57   data = GenerateTable(separator=None, headers=headers, fields=["name"],
58                        data=[[row[0]] for row in result if row[1]])
59
60   for line in data:
61     ToStdout(line)
62
63   return 0
64
65
66 def DiagnoseOS(opts, args):
67   """Analyse all OSes on this cluster.
68
69   @param opts: the command line options selected by the user
70   @type args: list
71   @param args: should be an empty list
72   @rtype: int
73   @return: the desired exit code
74
75   """
76   op = opcodes.OpDiagnoseOS(output_fields=["name", "valid", "node_status"],
77                             names=[])
78   result = SubmitOpCode(op)
79
80   if not result:
81     ToStderr("Can't get the OS list")
82     return 1
83
84   has_bad = False
85
86   for os_name, os_valid, node_data in result:
87     nodes_valid = {}
88     nodes_bad = {}
89     nodes_hidden = {}
90     for node_name, node_info in node_data.iteritems():
91       nodes_hidden[node_name] = []
92       if node_info: # at least one entry in the per-node list
93         first_os_status, first_os_path = node_info.pop(0)
94         first_os_msg = ("%s (path: %s)" %
95                         (first_os_status, first_os_path))
96         if first_os_status == constants.OS_VALID_STATUS:
97           nodes_valid[node_name] = first_os_msg
98         else:
99           nodes_bad[node_name] = first_os_msg
100         for hstatus, hpath in node_info:
101           nodes_hidden[node_name].append("    [hidden] path: %s, status: %s" %
102                                          (hpath, hstatus))
103       else:
104         nodes_bad[node_name] = "OS not found"
105
106     if nodes_valid and not nodes_bad:
107       status = "valid"
108     elif not nodes_valid and nodes_bad:
109       status = "invalid"
110       has_bad = True
111     else:
112       status = "partial valid"
113       has_bad = True
114
115     def _OutputPerNodeOSStatus(msg_map):
116       map_k = utils.NiceSort(msg_map.keys())
117       for node_name in map_k:
118         ToStdout("  Node: %s, status: %s", node_name, msg_map[node_name])
119         for msg in nodes_hidden[node_name]:
120           ToStdout(msg)
121
122     ToStdout("OS: %s [global status: %s]", os_name, status)
123     _OutputPerNodeOSStatus(nodes_valid)
124     _OutputPerNodeOSStatus(nodes_bad)
125     ToStdout("")
126
127   return int(has_bad)
128
129
130 commands = {
131   'list': (ListOS, ARGS_NONE, [DEBUG_OPT, NOHDR_OPT], "",
132            "Lists all valid OSes on the master"),
133   'diagnose': (DiagnoseOS, ARGS_NONE, [DEBUG_OPT], "",
134                "Diagnose all OSes"),
135   }
136
137 if __name__ == '__main__':
138   sys.exit(GenericMain(commands))