blob: d06a38e6c22984f66f79469b07860ad17abaa9f7 [file] [log] [blame]
Justin Thalerb8807ce2018-05-25 19:16:20 -05001#!/usr/bin/python3
Justin Thalere412dc22018-01-12 16:28:24 -06002"""
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05003 Copyright 2017,2019 IBM Corporation
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004
Justin Thalere412dc22018-01-12 16:28:24 -06005 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16"""
Justin Thalerf9aee3e2017-12-05 12:11:09 -060017import argparse
18import requests
19import getpass
20import json
21import os
22import urllib3
23import time, datetime
Justin Thalerf9aee3e2017-12-05 12:11:09 -060024import binascii
25import subprocess
26import platform
27import zipfile
Justin Thaler22b1bb52018-03-15 13:31:32 -050028import tarfile
29import tempfile
30import hashlib
Justin Thalera6b5df72018-07-16 11:10:07 -050031import re
Justin Thaler24d4efa2018-11-08 22:48:10 -060032import uuid
Justin Thalerf9aee3e2017-12-05 12:11:09 -060033
Matt Spinler220c3c42019-01-04 15:09:29 -060034jsonHeader = {'Content-Type' : 'application/json'}
35xAuthHeader = {}
Justin Thaler27197622019-01-23 14:42:11 -060036baseTimeout = 60
Matt Spinler220c3c42019-01-04 15:09:29 -060037
Justin Thalerf9aee3e2017-12-05 12:11:09 -060038def hilight(textToColor, color, bold):
Justin Thalere412dc22018-01-12 16:28:24 -060039 """
40 Used to add highlights to various text for displaying in a terminal
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -060041
Justin Thalere412dc22018-01-12 16:28:24 -060042 @param textToColor: string, the text to be colored
43 @param color: string, used to color the text red or green
44 @param bold: boolean, used to bold the textToColor
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -060045 @return: Buffered reader containing the modified string.
46 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -060047 if(sys.platform.__contains__("win")):
48 if(color == "red"):
49 os.system('color 04')
50 elif(color == "green"):
51 os.system('color 02')
52 else:
53 os.system('color') #reset to default
54 return textToColor
55 else:
56 attr = []
57 if(color == "red"):
58 attr.append('31')
59 elif(color == "green"):
60 attr.append('32')
61 else:
62 attr.append('0')
63 if bold:
64 attr.append('1')
65 else:
66 attr.append('0')
67 return '\x1b[%sm%s\x1b[0m' % (';'.join(attr),textToColor)
68
Justin Thalerf9aee3e2017-12-05 12:11:09 -060069def connectionErrHandler(jsonFormat, errorStr, err):
Justin Thalere412dc22018-01-12 16:28:24 -060070 """
71 Error handler various connection errors to bmcs
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -060072
73 @param jsonFormat: boolean, used to output in json format with an error code.
Justin Thalere412dc22018-01-12 16:28:24 -060074 @param errorStr: string, used to color the text red or green
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -060075 @param err: string, the text from the exception
76 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -060077 if errorStr == "Timeout":
78 if not jsonFormat:
79 return("FQPSPIN0000M: Connection timed out. Ensure you have network connectivity to the bmc")
80 else:
Justin Thaler115bca72018-05-25 19:29:08 -050081 conerror = {}
82 conerror['CommonEventID'] = 'FQPSPIN0000M'
83 conerror['sensor']="N/A"
84 conerror['state']="N/A"
85 conerror['additionalDetails'] = "N/A"
86 conerror['Message']="Connection timed out. Ensure you have network connectivity to the BMC"
87 conerror['LengthyDescription'] = "While trying to establish a connection with the specified BMC, the BMC failed to respond in adequate time. Verify the BMC is functioning properly, and the network connectivity to the BMC is stable."
88 conerror['Serviceable']="Yes"
89 conerror['CallHomeCandidate']= "No"
90 conerror['Severity'] = "Critical"
91 conerror['EventType'] = "Communication Failure/Timeout"
92 conerror['VMMigrationFlag'] = "Yes"
93 conerror["AffectedSubsystem"] = "Interconnect (Networking)"
94 conerror["timestamp"] = str(int(time.time()))
95 conerror["UserAction"] = "Verify network connectivity between the two systems and the bmc is functional."
96 eventdict = {}
97 eventdict['event0'] = conerror
98 eventdict['numAlerts'] = '1'
Justin Thaler115bca72018-05-25 19:29:08 -050099 errorMessageStr = errorMessageStr = json.dumps(eventdict, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600100 return(errorMessageStr)
101 elif errorStr == "ConnectionError":
102 if not jsonFormat:
103 return("FQPSPIN0001M: " + str(err))
104 else:
Justin Thaler115bca72018-05-25 19:29:08 -0500105 conerror = {}
106 conerror['CommonEventID'] = 'FQPSPIN0001M'
107 conerror['sensor']="N/A"
108 conerror['state']="N/A"
109 conerror['additionalDetails'] = str(err)
110 conerror['Message']="Connection Error. View additional details for more information"
111 conerror['LengthyDescription'] = "A connection error to the specified BMC occurred and additional details are provided. Review these details to resolve the issue."
112 conerror['Serviceable']="Yes"
113 conerror['CallHomeCandidate']= "No"
114 conerror['Severity'] = "Critical"
115 conerror['EventType'] = "Communication Failure/Timeout"
116 conerror['VMMigrationFlag'] = "Yes"
117 conerror["AffectedSubsystem"] = "Interconnect (Networking)"
118 conerror["timestamp"] = str(int(time.time()))
119 conerror["UserAction"] = "Correct the issue highlighted in additional details and try again"
120 eventdict = {}
121 eventdict['event0'] = conerror
122 eventdict['numAlerts'] = '1'
Justin Thaler115bca72018-05-25 19:29:08 -0500123 errorMessageStr = json.dumps(eventdict, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600124 return(errorMessageStr)
Justin Thaler115bca72018-05-25 19:29:08 -0500125
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600126 else:
127 return("Unknown Error: "+ str(err))
128
Justin Thalere412dc22018-01-12 16:28:24 -0600129
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600130def setColWidth(keylist, numCols, dictForOutput, colNames):
Justin Thalere412dc22018-01-12 16:28:24 -0600131 """
132 Sets the output width of the columns to display
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600133
134 @param keylist: list, list of strings representing the keys for the dictForOutput
Justin Thalere412dc22018-01-12 16:28:24 -0600135 @param numcols: the total number of columns in the final output
136 @param dictForOutput: dictionary, contains the information to print to the screen
137 @param colNames: list, The strings to use for the column headings, in order of the keylist
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600138 @return: A list of the column widths for each respective column.
Justin Thalere412dc22018-01-12 16:28:24 -0600139 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600140 colWidths = []
141 for x in range(0, numCols):
142 colWidths.append(0)
143 for key in dictForOutput:
144 for x in range(0, numCols):
145 colWidths[x] = max(colWidths[x], len(str(dictForOutput[key][keylist[x]])))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600146
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600147 for x in range(0, numCols):
148 colWidths[x] = max(colWidths[x], len(colNames[x])) +2
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600149
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600150 return colWidths
151
152def loadPolicyTable(pathToPolicyTable):
Justin Thalere412dc22018-01-12 16:28:24 -0600153 """
154 loads a json based policy table into a dictionary
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600155
Justin Thalere412dc22018-01-12 16:28:24 -0600156 @param value: boolean, the value to convert
157 @return: A string of "Yes" or "No"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600158 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600159 policyTable = {}
160 if(os.path.exists(pathToPolicyTable)):
161 with open(pathToPolicyTable, 'r') as stream:
162 try:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600163 contents =json.load(stream)
164 policyTable = contents['events']
Justin Thalere412dc22018-01-12 16:28:24 -0600165 except Exception as err:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600166 print(err)
167 return policyTable
168
Justin Thalere412dc22018-01-12 16:28:24 -0600169
170def boolToString(value):
171 """
172 converts a boolean value to a human readable string value
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600173
Justin Thalere412dc22018-01-12 16:28:24 -0600174 @param value: boolean, the value to convert
175 @return: A string of "Yes" or "No"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600176 """
Justin Thalere412dc22018-01-12 16:28:24 -0600177 if(value):
178 return "Yes"
179 else:
180 return "No"
181
Justin Thalera6b5df72018-07-16 11:10:07 -0500182def stringToInt(text):
183 """
184 returns an integer if the string can be converted, otherwise returns the string
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600185
Justin Thalera6b5df72018-07-16 11:10:07 -0500186 @param text: the string to try to convert to an integer
187 """
188 if text.isdigit():
189 return int(text)
190 else:
191 return text
Justin Thalere412dc22018-01-12 16:28:24 -0600192
Justin Thalera6b5df72018-07-16 11:10:07 -0500193def naturalSort(text):
194 """
195 provides a way to naturally sort a list
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600196
Justin Thalera6b5df72018-07-16 11:10:07 -0500197 @param text: the key to convert for sorting
198 @return list containing the broken up string parts by integers and strings
199 """
200 stringPartList = []
201 for c in re.split('(\d+)', text):
202 stringPartList.append(stringToInt(c))
203 return stringPartList
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600204
Justin Thalere412dc22018-01-12 16:28:24 -0600205def tableDisplay(keylist, colNames, output):
206 """
207 Logs into the BMC and creates a session
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600208
Justin Thalere412dc22018-01-12 16:28:24 -0600209 @param keylist: list, keys for the output dictionary, ordered by colNames
210 @param colNames: Names for the Table of the columns
211 @param output: The dictionary of data to display
212 @return: Session object
213 """
214 colWidth = setColWidth(keylist, len(colNames), output, colNames)
215 row = ""
216 outputText = ""
217 for i in range(len(colNames)):
218 if (i != 0): row = row + "| "
219 row = row + colNames[i].ljust(colWidth[i])
220 outputText += row + "\n"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600221
Justin Thalera6b5df72018-07-16 11:10:07 -0500222 output_keys = list(output.keys())
223 output_keys.sort(key=naturalSort)
224 for key in output_keys:
Justin Thalere412dc22018-01-12 16:28:24 -0600225 row = ""
Justin Thaler8fe0c732018-07-24 14:32:35 -0500226 for i in range(len(keylist)):
Justin Thalere412dc22018-01-12 16:28:24 -0600227 if (i != 0): row = row + "| "
228 row = row + output[key][keylist[i]].ljust(colWidth[i])
229 outputText += row + "\n"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600230
Justin Thalere412dc22018-01-12 16:28:24 -0600231 return outputText
232
Justin Thaler22b1bb52018-03-15 13:31:32 -0500233def checkFWactivation(host, args, session):
234 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600235 Checks the software inventory for an image that is being activated.
236
Justin Thaler22b1bb52018-03-15 13:31:32 -0500237 @return: True if an image is being activated, false is no activations are happening
238 """
239 url="https://"+host+"/xyz/openbmc_project/software/enumerate"
Justin Thaler22b1bb52018-03-15 13:31:32 -0500240 try:
Justin Thaler27197622019-01-23 14:42:11 -0600241 resp = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thaler22b1bb52018-03-15 13:31:32 -0500242 except(requests.exceptions.Timeout):
243 print(connectionErrHandler(args.json, "Timeout", None))
244 return(True)
245 except(requests.exceptions.ConnectionError) as err:
246 print( connectionErrHandler(args.json, "ConnectionError", err))
247 return True
Justin Thaler3a5771b2019-01-23 14:31:52 -0600248 fwInfo = resp.json()['data']
Justin Thaler22b1bb52018-03-15 13:31:32 -0500249 for key in fwInfo:
250 if 'Activation' in fwInfo[key]:
251 if 'Activating' in fwInfo[key]['Activation'] or 'Activating' in fwInfo[key]['RequestedActivation']:
252 return True
253 return False
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600254
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600255def login(host, username, pw,jsonFormat):
Justin Thalere412dc22018-01-12 16:28:24 -0600256 """
257 Logs into the BMC and creates a session
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600258
Justin Thalere412dc22018-01-12 16:28:24 -0600259 @param host: string, the hostname or IP address of the bmc to log into
260 @param username: The user name for the bmc to log into
261 @param pw: The password for the BMC to log into
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600262 @param jsonFormat: boolean, flag that will only allow relevant data from user command to be display. This function becomes silent when set to true.
Justin Thalere412dc22018-01-12 16:28:24 -0600263 @return: Session object
264 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600265 if(jsonFormat==False):
266 print("Attempting login...")
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600267 mysess = requests.session()
268 try:
Justin Thaler27197622019-01-23 14:42:11 -0600269 r = mysess.post('https://'+host+'/login', headers=jsonHeader, json = {"data": [username, pw]}, verify=False, timeout=baseTimeout)
Matt Spinler220c3c42019-01-04 15:09:29 -0600270
271 cookie = r.headers['Set-Cookie']
272 match = re.search('SESSION=(\w+);', cookie)
273 if match:
274 xAuthHeader['X-Auth-Token'] = match.group(1)
275 jsonHeader.update(xAuthHeader)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600276 loginMessage = json.loads(r.text)
277 if (loginMessage['status'] != "ok"):
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600278 print(loginMessage["data"]["description"].encode('utf-8'))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600279 sys.exit(1)
280# if(sys.version_info < (3,0)):
281# urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
282# if sys.version_info >= (3,0):
283# requests.packages.urllib3.disable_warnings(requests.packages.urllib3.exceptions.InsecureRequestWarning)
284 return mysess
285 except(requests.exceptions.Timeout):
Justin Thaler115bca72018-05-25 19:29:08 -0500286 return (connectionErrHandler(jsonFormat, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600287 except(requests.exceptions.ConnectionError) as err:
Justin Thaler115bca72018-05-25 19:29:08 -0500288 return (connectionErrHandler(jsonFormat, "ConnectionError", err))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600289
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600290
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600291def logout(host, username, pw, session, jsonFormat):
Justin Thalere412dc22018-01-12 16:28:24 -0600292 """
293 Logs out of the bmc and terminates the session
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600294
Justin Thalere412dc22018-01-12 16:28:24 -0600295 @param host: string, the hostname or IP address of the bmc to log out of
296 @param username: The user name for the bmc to log out of
297 @param pw: The password for the BMC to log out of
298 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600299 @param jsonFormat: boolean, flag that will only allow relevant data from user command to be display. This function becomes silent when set to true.
300 """
Justin Thalere412dc22018-01-12 16:28:24 -0600301 try:
Justin Thaler27197622019-01-23 14:42:11 -0600302 r = session.post('https://'+host+'/logout', headers=jsonHeader,json = {"data": [username, pw]}, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600303 except(requests.exceptions.Timeout):
304 print(connectionErrHandler(jsonFormat, "Timeout", None))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600305
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600306 if(jsonFormat==False):
Matt Spinlereae05b02019-01-24 12:59:34 -0600307 if r.status_code == 200:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600308 print('User ' +username + ' has been logged out')
309
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600310
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600311def fru(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -0600312 """
313 prints out the system inventory. deprecated see fruPrint and fruList
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600314
Justin Thalere412dc22018-01-12 16:28:24 -0600315 @param host: string, the hostname or IP address of the bmc
316 @param args: contains additional arguments used by the fru sub command
317 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600318 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
319 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600320 #url="https://"+host+"/org/openbmc/inventory/system/chassis/enumerate"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600321
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600322 #print(url)
323 #res = session.get(url, headers=httpHeader, verify=False)
324 #print(res.text)
325 #sample = res.text
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600326
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600327 #inv_list = json.loads(sample)["data"]
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600328
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600329 url="https://"+host+"/xyz/openbmc_project/inventory/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600330 try:
Justin Thaler27197622019-01-23 14:42:11 -0600331 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600332 except(requests.exceptions.Timeout):
333 return(connectionErrHandler(args.json, "Timeout", None))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600334
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600335 sample = res.text
336# inv_list.update(json.loads(sample)["data"])
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600337#
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600338# #determine column width's
339# colNames = ["FRU Name", "FRU Type", "Has Fault", "Is FRU", "Present", "Version"]
340# colWidths = setColWidth(["FRU Name", "fru_type", "fault", "is_fru", "present", "version"], 6, inv_list, colNames)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600341#
342# print("FRU Name".ljust(colWidths[0])+ "FRU Type".ljust(colWidths[1]) + "Has Fault".ljust(colWidths[2]) + "Is FRU".ljust(colWidths[3])+
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600343# "Present".ljust(colWidths[4]) + "Version".ljust(colWidths[5]))
344# format the output
345# for key in sorted(inv_list.keys()):
346# keyParts = key.split("/")
347# isFRU = "True" if (inv_list[key]["is_fru"]==1) else "False"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600348#
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600349# fruEntry = (keyParts[len(keyParts) - 1].ljust(colWidths[0]) + inv_list[key]["fru_type"].ljust(colWidths[1])+
350# inv_list[key]["fault"].ljust(colWidths[2])+isFRU.ljust(colWidths[3])+
351# inv_list[key]["present"].ljust(colWidths[4])+ inv_list[key]["version"].ljust(colWidths[5]))
352# if(isTTY):
353# if(inv_list[key]["is_fru"] == 1):
354# color = "green"
355# bold = True
356# else:
357# color='black'
358# bold = False
359# fruEntry = hilight(fruEntry, color, bold)
360# print (fruEntry)
361 return sample
Justin Thalere412dc22018-01-12 16:28:24 -0600362
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600363def fruPrint(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -0600364 """
365 prints out all inventory
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600366
Justin Thalere412dc22018-01-12 16:28:24 -0600367 @param host: string, the hostname or IP address of the bmc
368 @param args: contains additional arguments used by the fru sub command
369 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600370 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
371 @return returns the total fru list.
372 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600373 url="https://"+host+"/xyz/openbmc_project/inventory/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600374 try:
Justin Thaler27197622019-01-23 14:42:11 -0600375 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600376 except(requests.exceptions.Timeout):
377 return(connectionErrHandler(args.json, "Timeout", None))
378
Justin Thaler3a5771b2019-01-23 14:31:52 -0600379 frulist={}
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600380# print(res.text)
Justin Thaler3a5771b2019-01-23 14:31:52 -0600381 if res.status_code==200:
382 frulist['Hardware'] = res.json()['data']
383 else:
384 if not args.json:
385 return "Error retrieving the system inventory. BMC message: {msg}".format(msg=res.json()['message'])
386 else:
387 return res.json()
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600388 url="https://"+host+"/xyz/openbmc_project/software/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600389 try:
Justin Thaler27197622019-01-23 14:42:11 -0600390 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600391 except(requests.exceptions.Timeout):
392 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600393# print(res.text)
Justin Thaler3a5771b2019-01-23 14:31:52 -0600394 if res.status_code==200:
395 frulist['Software'] = res.json()['data']
396 else:
397 if not args.json():
398 return "Error retrieving the system inventory. BMC message: {msg}".format(msg=res.json()['message'])
399 else:
400 return res.json()
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600401 return frulist
402
Justin Thalere412dc22018-01-12 16:28:24 -0600403
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600404def fruList(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -0600405 """
406 prints out all inventory or only a specific specified item
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600407
Justin Thalere412dc22018-01-12 16:28:24 -0600408 @param host: string, the hostname or IP address of the bmc
409 @param args: contains additional arguments used by the fru sub command
410 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600411 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
412 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600413 if(args.items==True):
414 return fruPrint(host, args, session)
415 else:
Justin Thalere412dc22018-01-12 16:28:24 -0600416 return fruPrint(host, args, session)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600417
418
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600419
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600420def fruStatus(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -0600421 """
422 prints out the status of all FRUs
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600423
Justin Thalere412dc22018-01-12 16:28:24 -0600424 @param host: string, the hostname or IP address of the bmc
425 @param args: contains additional arguments used by the fru sub command
426 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600427 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
428 """
Justin Thalere412dc22018-01-12 16:28:24 -0600429 url="https://"+host+"/xyz/openbmc_project/inventory/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600430 try:
Matt Spinler220c3c42019-01-04 15:09:29 -0600431 res = session.get(url, headers=jsonHeader, verify=False)
Justin Thalere412dc22018-01-12 16:28:24 -0600432 except(requests.exceptions.Timeout):
433 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600434# print(res.text)
Justin Thaler3a5771b2019-01-23 14:31:52 -0600435 frulist = res.json()['data']
Justin Thalere412dc22018-01-12 16:28:24 -0600436 frus = {}
437 for key in frulist:
438 component = frulist[key]
439 isFru = False
440 present = False
441 func = False
442 hasSels = False
443 keyPieces = key.split('/')
444 fruName = keyPieces[-1]
445 if 'core' in fruName: #associate cores to cpus
446 fruName = keyPieces[-2] + '-' + keyPieces[-1]
447 if 'Functional' in component:
448 if('Present' in component):
Justin Thalere412dc22018-01-12 16:28:24 -0600449 if 'FieldReplaceable' in component:
450 if component['FieldReplaceable'] == 1:
451 isFru = True
452 if "fan" in fruName:
453 isFru = True;
454 if component['Present'] == 1:
455 present = True
456 if component['Functional'] == 1:
457 func = True
458 if ((key + "/fault") in frulist):
459 hasSels = True;
460 if args.verbose:
461 if hasSels:
462 loglist = []
463 faults = frulist[key+"/fault"]['endpoints']
464 for item in faults:
465 loglist.append(item.split('/')[-1])
466 frus[fruName] = {"compName": fruName, "Functional": boolToString(func), "Present":boolToString(present), "IsFru": boolToString(isFru), "selList": ', '.join(loglist).strip() }
467 else:
468 frus[fruName] = {"compName": fruName, "Functional": boolToString(func), "Present":boolToString(present), "IsFru": boolToString(isFru), "selList": "None" }
469 else:
470 frus[fruName] = {"compName": fruName, "Functional": boolToString(func), "Present":boolToString(present), "IsFru": boolToString(isFru), "hasSEL": boolToString(hasSels) }
Justin Thalerfb9c81c2018-07-16 11:14:37 -0500471 elif "power_supply" in fruName or "powersupply" in fruName:
Justin Thalere412dc22018-01-12 16:28:24 -0600472 if component['Present'] ==1:
473 present = True
474 isFru = True
475 if ((key + "/fault") in frulist):
476 hasSels = True;
477 if args.verbose:
478 if hasSels:
479 loglist = []
480 faults = frulist[key+"/fault"]['endpoints']
Obihörnchenff8035f2018-12-05 21:07:37 +0100481 for item in faults:
482 loglist.append(item.split('/')[-1])
Justin Thalere412dc22018-01-12 16:28:24 -0600483 frus[fruName] = {"compName": fruName, "Functional": "No", "Present":boolToString(present), "IsFru": boolToString(isFru), "selList": ', '.join(loglist).strip() }
484 else:
485 frus[fruName] = {"compName": fruName, "Functional": "Yes", "Present":boolToString(present), "IsFru": boolToString(isFru), "selList": "None" }
486 else:
487 frus[fruName] = {"compName": fruName, "Functional": boolToString(not hasSels), "Present":boolToString(present), "IsFru": boolToString(isFru), "hasSEL": boolToString(hasSels) }
488 if not args.json:
489 if not args.verbose:
490 colNames = ["Component", "Is a FRU", "Present", "Functional", "Has Logs"]
491 keylist = ["compName", "IsFru", "Present", "Functional", "hasSEL"]
492 else:
493 colNames = ["Component", "Is a FRU", "Present", "Functional", "Assoc. Log Number(s)"]
494 keylist = ["compName", "IsFru", "Present", "Functional", "selList"]
495 return tableDisplay(keylist, colNames, frus)
496 else:
497 return str(json.dumps(frus, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600498
Justin Thalere412dc22018-01-12 16:28:24 -0600499def sensor(host, args, session):
500 """
501 prints out all sensors
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600502
Justin Thalere412dc22018-01-12 16:28:24 -0600503 @param host: string, the hostname or IP address of the bmc
504 @param args: contains additional arguments used by the sensor sub command
505 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600506 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
507 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600508 url="https://"+host+"/xyz/openbmc_project/sensors/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600509 try:
Justin Thaler27197622019-01-23 14:42:11 -0600510 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600511 except(requests.exceptions.Timeout):
512 return(connectionErrHandler(args.json, "Timeout", None))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600513
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600514 #Get OCC status
515 url="https://"+host+"/org/open_power/control/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600516 try:
Justin Thaler27197622019-01-23 14:42:11 -0600517 occres = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600518 except(requests.exceptions.Timeout):
519 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600520 if not args.json:
521 colNames = ['sensor', 'type', 'units', 'value', 'target']
Justin Thaler3a5771b2019-01-23 14:31:52 -0600522 sensors = res.json()["data"]
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600523 output = {}
524 for key in sensors:
525 senDict = {}
526 keyparts = key.split("/")
527 senDict['sensorName'] = keyparts[-1]
528 senDict['type'] = keyparts[-2]
Justin Thalere412dc22018-01-12 16:28:24 -0600529 try:
530 senDict['units'] = sensors[key]['Unit'].split('.')[-1]
531 except KeyError:
Justin Thaler22b1bb52018-03-15 13:31:32 -0500532 senDict['units'] = "N/A"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600533 if('Scale' in sensors[key]):
534 scale = 10 ** sensors[key]['Scale']
535 else:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600536 scale = 1
Justin Thaler22b1bb52018-03-15 13:31:32 -0500537 try:
538 senDict['value'] = str(sensors[key]['Value'] * scale)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600539 except KeyError:
Justin Thaler22b1bb52018-03-15 13:31:32 -0500540 if 'value' in sensors[key]:
541 senDict['value'] = sensors[key]['value']
542 else:
543 senDict['value'] = "N/A"
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600544 if 'Target' in sensors[key]:
545 senDict['target'] = str(sensors[key]['Target'])
546 else:
547 senDict['target'] = 'N/A'
548 output[senDict['sensorName']] = senDict
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600549
Justin Thaler3a5771b2019-01-23 14:31:52 -0600550 occstatus = occres.json()["data"]
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600551 if '/org/open_power/control/occ0' in occstatus:
552 occ0 = occstatus["/org/open_power/control/occ0"]['OccActive']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600553 if occ0 == 1:
554 occ0 = 'Active'
555 else:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600556 occ0 = 'Inactive'
557 output['OCC0'] = {'sensorName':'OCC0', 'type': 'Discrete', 'units': 'N/A', 'value': occ0, 'target': 'Active'}
558 occ1 = occstatus["/org/open_power/control/occ1"]['OccActive']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600559 if occ1 == 1:
560 occ1 = 'Active'
561 else:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600562 occ1 = 'Inactive'
563 output['OCC1'] = {'sensorName':'OCC1', 'type': 'Discrete', 'units': 'N/A', 'value': occ0, 'target': 'Active'}
564 else:
565 output['OCC0'] = {'sensorName':'OCC0', 'type': 'Discrete', 'units': 'N/A', 'value': 'Inactive', 'target': 'Inactive'}
566 output['OCC1'] = {'sensorName':'OCC1', 'type': 'Discrete', 'units': 'N/A', 'value': 'Inactive', 'target': 'Inactive'}
567 keylist = ['sensorName', 'type', 'units', 'value', 'target']
Justin Thalere412dc22018-01-12 16:28:24 -0600568
569 return tableDisplay(keylist, colNames, output)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600570 else:
571 return res.text + occres.text
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600572
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600573def sel(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -0600574 """
575 prints out the bmc alerts
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600576
Justin Thalere412dc22018-01-12 16:28:24 -0600577 @param host: string, the hostname or IP address of the bmc
578 @param args: contains additional arguments used by the sel sub command
579 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600580 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
581 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600582
583 url="https://"+host+"/xyz/openbmc_project/logging/entry/enumerate"
Justin Thalere412dc22018-01-12 16:28:24 -0600584 try:
Justin Thaler27197622019-01-23 14:42:11 -0600585 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -0600586 except(requests.exceptions.Timeout):
587 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600588 return res.text
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600589
590
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600591def parseESEL(args, eselRAW):
Justin Thalere412dc22018-01-12 16:28:24 -0600592 """
593 parses the esel data and gets predetermined search terms
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600594
Justin Thalere412dc22018-01-12 16:28:24 -0600595 @param eselRAW: string, the raw esel string from the bmc
596 @return: A dictionary containing the quick snapshot data unless args.fullEsel is listed then a full PEL log is returned
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600597 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600598 eselParts = {}
599 esel_bin = binascii.unhexlify(''.join(eselRAW.split()[16:]))
600 #search terms contains the search term as the key and the return dictionary key as it's value
601 searchTerms = { 'Signature Description':'signatureDescription', 'devdesc':'devdesc',
Justin Thaler22b1bb52018-03-15 13:31:32 -0500602 'Callout type': 'calloutType', 'Procedure':'procedure', 'Sensor Type': 'sensorType'}
Justin Thaler24d4efa2018-11-08 22:48:10 -0600603 uniqueID = str(uuid.uuid4())
604 eselBinPath = tempfile.gettempdir() + os.sep + uniqueID + 'esel.bin'
Justin Thalercf1deae2018-05-25 19:35:21 -0500605 with open(eselBinPath, 'wb') as f:
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600606 f.write(esel_bin)
607 errlPath = ""
608 #use the right errl file for the machine architecture
609 arch = platform.machine()
610 if(arch =='x86_64' or arch =='AMD64'):
611 if os.path.exists('/opt/ibm/ras/bin/x86_64/errl'):
612 errlPath = '/opt/ibm/ras/bin/x86_64/errl'
613 elif os.path.exists('errl/x86_64/errl'):
614 errlPath = 'errl/x86_64/errl'
615 else:
616 errlPath = 'x86_64/errl'
617 elif (platform.machine()=='ppc64le'):
618 if os.path.exists('/opt/ibm/ras/bin/ppc64le/errl'):
619 errlPath = '/opt/ibm/ras/bin/ppc64le/errl'
620 elif os.path.exists('errl/ppc64le/errl'):
621 errlPath = 'errl/ppc64le/errl'
622 else:
623 errlPath = 'ppc64le/errl'
624 else:
625 print("machine architecture not supported for parsing eSELs")
626 return eselParts
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600627
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600628 if(os.path.exists(errlPath)):
Justin Thalercf1deae2018-05-25 19:35:21 -0500629 output= subprocess.check_output([errlPath, '-d', '--file='+eselBinPath]).decode('utf-8')
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600630# output = proc.communicate()[0]
631 lines = output.split('\n')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600632
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600633 if(hasattr(args, 'fullEsel')):
634 return output
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600635
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600636 for i in range(0, len(lines)):
637 lineParts = lines[i].split(':')
638 if(len(lineParts)>1): #ignore multi lines, output formatting lines, and other information
639 for term in searchTerms:
640 if(term in lineParts[0]):
641 temp = lines[i][lines[i].find(':')+1:].strip()[:-1].strip()
642 if lines[i+1].find(':') != -1:
643 if (len(lines[i+1].split(':')[0][1:].strip())==0):
644 while(len(lines[i][:lines[i].find(':')].strip())>2):
Justin Thaler43030422018-11-08 22:50:21 -0600645 #has multiple lines, process and update line counter
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600646 if((i+1) <= len(lines)):
647 i+=1
648 else:
649 i=i-1
650 break
Justin Thaler43030422018-11-08 22:50:21 -0600651 #Append the content from the next line removing the pretty display characters
652 #Finds the first colon then starts 2 characters after, then removes all whitespace
653 temp = temp + lines[i][lines[i].find(':')+2:].strip()[:-1].strip()[:-1].strip()
Justin Thaler22b1bb52018-03-15 13:31:32 -0500654 if(searchTerms[term] in eselParts):
655 eselParts[searchTerms[term]] = eselParts[searchTerms[term]] + ", " + temp
656 else:
657 eselParts[searchTerms[term]] = temp
Justin Thalercf1deae2018-05-25 19:35:21 -0500658 os.remove(eselBinPath)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600659 else:
660 print("errl file cannot be found")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600661
662 return eselParts
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600663
Justin Thalere412dc22018-01-12 16:28:24 -0600664
Matt Spinler02d0dff2018-08-29 13:19:25 -0500665def getESELSeverity(esel):
666 """
667 Finds the severity type in an eSEL from the User Header section.
668 @param esel - the eSEL data
669 @return severity - e.g. 'Critical'
670 """
671
672 # everything but 1 and 2 are Critical
673 # '1': 'recovered',
674 # '2': 'predictive',
675 # '4': 'unrecoverable',
676 # '5': 'critical',
677 # '6': 'diagnostic',
678 # '7': 'symptom'
679 severities = {
680 '1': 'Informational',
681 '2': 'Warning'
682 }
683
684 try:
685 headerPosition = esel.index('55 48') # 'UH'
686 # The severity is the last byte in the 8 byte section (a byte is ' bb')
687 severity = esel[headerPosition:headerPosition+32].split(' ')[-1]
688 type = severity[0]
689 except ValueError:
690 print("Could not find severity value in UH section in eSEL")
691 type = 'x';
692
693 return severities.get(type, 'Critical')
694
695
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600696def sortSELs(events):
Justin Thalere412dc22018-01-12 16:28:24 -0600697 """
698 sorts the sels by timestamp, then log entry number
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600699
Justin Thalere412dc22018-01-12 16:28:24 -0600700 @param events: Dictionary containing events
701 @return: list containing a list of the ordered log entries, and dictionary of keys
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600702 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600703 logNumList = []
704 timestampList = []
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600705 eventKeyDict = {}
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600706 eventsWithTimestamp = {}
707 logNum2events = {}
708 for key in events:
709 if key == 'numAlerts': continue
710 if 'callout' in key: continue
711 timestamp = (events[key]['timestamp'])
712 if timestamp not in timestampList:
713 eventsWithTimestamp[timestamp] = [events[key]['logNum']]
714 else:
715 eventsWithTimestamp[timestamp].append(events[key]['logNum'])
716 #map logNumbers to the event dictionary keys
717 eventKeyDict[str(events[key]['logNum'])] = key
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600718
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600719 timestampList = list(eventsWithTimestamp.keys())
720 timestampList.sort()
721 for ts in timestampList:
722 if len(eventsWithTimestamp[ts]) > 1:
723 tmplist = eventsWithTimestamp[ts]
724 tmplist.sort()
725 logNumList = logNumList + tmplist
726 else:
727 logNumList = logNumList + eventsWithTimestamp[ts]
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600728
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600729 return [logNumList, eventKeyDict]
730
Justin Thalere412dc22018-01-12 16:28:24 -0600731
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600732def parseAlerts(policyTable, selEntries, args):
Justin Thalere412dc22018-01-12 16:28:24 -0600733 """
734 parses alerts in the IBM CER format, using an IBM policy Table
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600735
Justin Thalere412dc22018-01-12 16:28:24 -0600736 @param policyTable: dictionary, the policy table entries
737 @param selEntries: dictionary, the alerts retrieved from the bmc
738 @return: A dictionary of the parsed entries, in chronological order
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600739 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600740 eventDict = {}
741 eventNum =""
742 count = 0
743 esel = ""
744 eselParts = {}
745 i2cdevice= ""
Matt Spinler02d0dff2018-08-29 13:19:25 -0500746 eselSeverity = None
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600747
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600748 'prepare and sort the event entries'
749 for key in selEntries:
750 if 'callout' not in key:
751 selEntries[key]['logNum'] = key.split('/')[-1]
752 selEntries[key]['timestamp'] = selEntries[key]['Timestamp']
753 sortedEntries = sortSELs(selEntries)
754 logNumList = sortedEntries[0]
755 eventKeyDict = sortedEntries[1]
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600756
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600757 for logNum in logNumList:
758 key = eventKeyDict[logNum]
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600759 hasEsel=False
760 i2creadFail = False
761 if 'callout' in key:
762 continue
763 else:
764 messageID = str(selEntries[key]['Message'])
765 addDataPiece = selEntries[key]['AdditionalData']
766 calloutIndex = 0
767 calloutFound = False
768 for i in range(len(addDataPiece)):
769 if("CALLOUT_INVENTORY_PATH" in addDataPiece[i]):
770 calloutIndex = i
771 calloutFound = True
772 fruCallout = str(addDataPiece[calloutIndex]).split('=')[1]
773 if("CALLOUT_DEVICE_PATH" in addDataPiece[i]):
774 i2creadFail = True
Matt Spinlerd178a472018-08-31 09:48:52 -0500775
776 fruCallout = str(addDataPiece[calloutIndex]).split('=')[1]
777
778 # Fall back to "I2C"/"FSI" if dev path isn't in policy table
779 if (messageID + '||' + fruCallout) not in policyTable:
780 i2cdevice = str(addDataPiece[i]).strip().split('=')[1]
781 i2cdevice = '/'.join(i2cdevice.split('/')[-4:])
782 if 'fsi' in str(addDataPiece[calloutIndex]).split('=')[1]:
783 fruCallout = 'FSI'
784 else:
785 fruCallout = 'I2C'
Justin Thalere34c43a2018-05-25 19:37:55 -0500786 calloutFound = True
787 if("CALLOUT_GPIO_NUM" in addDataPiece[i]):
788 if not calloutFound:
789 fruCallout = 'GPIO'
790 calloutFound = True
791 if("CALLOUT_IIC_BUS" in addDataPiece[i]):
792 if not calloutFound:
793 fruCallout = "I2C"
794 calloutFound = True
795 if("CALLOUT_IPMI_SENSOR_NUM" in addDataPiece[i]):
796 if not calloutFound:
797 fruCallout = "IPMI"
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600798 calloutFound = True
799 if("ESEL" in addDataPiece[i]):
800 esel = str(addDataPiece[i]).strip().split('=')[1]
Matt Spinler02d0dff2018-08-29 13:19:25 -0500801 eselSeverity = getESELSeverity(esel)
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600802 if args.devdebug:
803 eselParts = parseESEL(args, esel)
804 hasEsel=True
805 if("GPU" in addDataPiece[i]):
806 fruCallout = '/xyz/openbmc_project/inventory/system/chassis/motherboard/gpu' + str(addDataPiece[i]).strip()[-1]
807 calloutFound = True
808 if("PROCEDURE" in addDataPiece[i]):
809 fruCallout = str(hex(int(str(addDataPiece[i]).split('=')[1])))[2:]
810 calloutFound = True
Justin Thalere412dc22018-01-12 16:28:24 -0600811 if("RAIL_NAME" in addDataPiece[i]):
812 calloutFound=True
813 fruCallout = str(addDataPiece[i]).split('=')[1].strip()
814 if("INPUT_NAME" in addDataPiece[i]):
815 calloutFound=True
816 fruCallout = str(addDataPiece[i]).split('=')[1].strip()
817 if("SENSOR_TYPE" in addDataPiece[i]):
818 calloutFound=True
819 fruCallout = str(addDataPiece[i]).split('=')[1].strip()
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600820
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600821 if(calloutFound):
Justin Thaler22b1bb52018-03-15 13:31:32 -0500822 if fruCallout != "":
823 policyKey = messageID +"||" + fruCallout
Matt Spinler02d0dff2018-08-29 13:19:25 -0500824
825 # Also use the severity for hostboot errors
826 if eselSeverity and messageID == 'org.open_power.Host.Error.Event':
827 policyKey += '||' + eselSeverity
828
829 # if not in the table, fall back to the original key
830 if policyKey not in policyTable:
831 policyKey = policyKey.replace('||'+eselSeverity, '')
832
Justin Thalere34c43a2018-05-25 19:37:55 -0500833 if policyKey not in policyTable:
834 policyKey = messageID
Justin Thaler22b1bb52018-03-15 13:31:32 -0500835 else:
836 policyKey = messageID
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600837 else:
838 policyKey = messageID
839 event = {}
840 eventNum = str(count)
841 if policyKey in policyTable:
842 for pkey in policyTable[policyKey]:
843 if(type(policyTable[policyKey][pkey])== bool):
844 event[pkey] = boolToString(policyTable[policyKey][pkey])
845 else:
846 if (i2creadFail and pkey == 'Message'):
847 event[pkey] = policyTable[policyKey][pkey] + ' ' +i2cdevice
848 else:
849 event[pkey] = policyTable[policyKey][pkey]
850 event['timestamp'] = selEntries[key]['Timestamp']
851 event['resolved'] = bool(selEntries[key]['Resolved'])
852 if(hasEsel):
853 if args.devdebug:
854 event['eselParts'] = eselParts
855 event['raweSEL'] = esel
856 event['logNum'] = key.split('/')[-1]
857 eventDict['event' + eventNum] = event
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600858
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600859 else:
860 severity = str(selEntries[key]['Severity']).split('.')[-1]
861 if severity == 'Error':
862 severity = 'Critical'
863 eventDict['event'+eventNum] = {}
864 eventDict['event' + eventNum]['error'] = "error: Not found in policy table: " + policyKey
865 eventDict['event' + eventNum]['timestamp'] = selEntries[key]['Timestamp']
866 eventDict['event' + eventNum]['Severity'] = severity
867 if(hasEsel):
868 if args.devdebug:
869 eventDict['event' +eventNum]['eselParts'] = eselParts
870 eventDict['event' +eventNum]['raweSEL'] = esel
871 eventDict['event' +eventNum]['logNum'] = key.split('/')[-1]
872 eventDict['event' +eventNum]['resolved'] = bool(selEntries[key]['Resolved'])
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600873 count += 1
874 return eventDict
875
876
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600877def selDisplay(events, args):
Justin Thalere412dc22018-01-12 16:28:24 -0600878 """
879 displays alerts in human readable format
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600880
Justin Thalere412dc22018-01-12 16:28:24 -0600881 @param events: Dictionary containing events
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600882 @return:
883 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600884 activeAlerts = []
885 historyAlerts = []
886 sortedEntries = sortSELs(events)
887 logNumList = sortedEntries[0]
888 eventKeyDict = sortedEntries[1]
889 keylist = ['Entry', 'ID', 'Timestamp', 'Serviceable', 'Severity','Message']
890 if(args.devdebug):
891 colNames = ['Entry', 'ID', 'Timestamp', 'Serviceable', 'Severity','Message', 'eSEL contents']
892 keylist.append('eSEL')
893 else:
894 colNames = ['Entry', 'ID', 'Timestamp', 'Serviceable', 'Severity', 'Message']
895 for log in logNumList:
896 selDict = {}
897 alert = events[eventKeyDict[str(log)]]
898 if('error' in alert):
899 selDict['Entry'] = alert['logNum']
900 selDict['ID'] = 'Unknown'
901 selDict['Timestamp'] = datetime.datetime.fromtimestamp(int(alert['timestamp']/1000)).strftime("%Y-%m-%d %H:%M:%S")
902 msg = alert['error']
903 polMsg = msg.split("policy table:")[0]
904 msg = msg.split("policy table:")[1]
905 msgPieces = msg.split("||")
906 err = msgPieces[0]
907 if(err.find("org.open_power.")!=-1):
908 err = err.split("org.open_power.")[1]
909 elif(err.find("xyz.openbmc_project.")!=-1):
910 err = err.split("xyz.openbmc_project.")[1]
911 else:
912 err = msgPieces[0]
913 callout = ""
914 if len(msgPieces) >1:
915 callout = msgPieces[1]
916 if(callout.find("/org/open_power/")!=-1):
917 callout = callout.split("/org/open_power/")[1]
918 elif(callout.find("/xyz/openbmc_project/")!=-1):
919 callout = callout.split("/xyz/openbmc_project/")[1]
920 else:
921 callout = msgPieces[1]
922 selDict['Message'] = polMsg +"policy table: "+ err + "||" + callout
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600923 selDict['Serviceable'] = 'Unknown'
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600924 selDict['Severity'] = alert['Severity']
925 else:
926 selDict['Entry'] = alert['logNum']
927 selDict['ID'] = alert['CommonEventID']
928 selDict['Timestamp'] = datetime.datetime.fromtimestamp(int(alert['timestamp']/1000)).strftime("%Y-%m-%d %H:%M:%S")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600929 selDict['Message'] = alert['Message']
930 selDict['Serviceable'] = alert['Serviceable']
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600931 selDict['Severity'] = alert['Severity']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600932
933
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600934 eselOrder = ['refCode','signatureDescription', 'eselType', 'devdesc', 'calloutType', 'procedure']
935 if ('eselParts' in alert and args.devdebug):
936 eselOutput = ""
937 for item in eselOrder:
938 if item in alert['eselParts']:
939 eselOutput = eselOutput + item + ": " + alert['eselParts'][item] + " | "
940 selDict['eSEL'] = eselOutput
941 else:
942 if args.devdebug:
943 selDict['eSEL'] = "None"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600944
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600945 if not alert['resolved']:
946 activeAlerts.append(selDict)
947 else:
948 historyAlerts.append(selDict)
949 mergedOutput = activeAlerts + historyAlerts
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600950 colWidth = setColWidth(keylist, len(colNames), dict(enumerate(mergedOutput)), colNames)
951
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600952 output = ""
953 if(len(activeAlerts)>0):
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600954 row = ""
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600955 output +="----Active Alerts----\n"
956 for i in range(0, len(colNames)):
957 if i!=0: row =row + "| "
958 row = row + colNames[i].ljust(colWidth[i])
959 output += row + "\n"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600960
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600961 for i in range(0,len(activeAlerts)):
962 row = ""
963 for j in range(len(activeAlerts[i])):
964 if (j != 0): row = row + "| "
965 row = row + activeAlerts[i][keylist[j]].ljust(colWidth[j])
966 output += row + "\n"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600967
968 if(len(historyAlerts)>0):
969 row = ""
970 output+= "----Historical Alerts----\n"
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600971 for i in range(len(colNames)):
972 if i!=0: row =row + "| "
973 row = row + colNames[i].ljust(colWidth[i])
974 output += row + "\n"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600975
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600976 for i in range(0, len(historyAlerts)):
977 row = ""
978 for j in range(len(historyAlerts[i])):
979 if (j != 0): row = row + "| "
980 row = row + historyAlerts[i][keylist[j]].ljust(colWidth[j])
981 output += row + "\n"
982# print(events[eventKeyDict[str(log)]])
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600983 return output
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600984
Justin Thalere412dc22018-01-12 16:28:24 -0600985
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600986def selPrint(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -0600987 """
988 prints out all bmc alerts
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600989
Justin Thalere412dc22018-01-12 16:28:24 -0600990 @param host: string, the hostname or IP address of the bmc
991 @param args: contains additional arguments used by the fru sub command
992 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -0600993 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
994 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -0600995 if(args.policyTableLoc is None):
996 if os.path.exists('policyTable.json'):
997 ptableLoc = "policyTable.json"
998 elif os.path.exists('/opt/ibm/ras/lib/policyTable.json'):
999 ptableLoc = '/opt/ibm/ras/lib/policyTable.json'
1000 else:
1001 ptableLoc = 'lib/policyTable.json'
1002 else:
1003 ptableLoc = args.policyTableLoc
1004 policyTable = loadPolicyTable(ptableLoc)
1005 rawselEntries = ""
1006 if(hasattr(args, 'fileloc') and args.fileloc is not None):
1007 if os.path.exists(args.fileloc):
1008 with open(args.fileloc, 'r') as selFile:
1009 selLines = selFile.readlines()
1010 rawselEntries = ''.join(selLines)
1011 else:
1012 print("Error: File not found")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001013 sys.exit(1)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001014 else:
1015 rawselEntries = sel(host, args, session)
1016 loadFailed = False
1017 try:
1018 selEntries = json.loads(rawselEntries)
1019 except ValueError:
1020 loadFailed = True
1021 if loadFailed:
1022 cleanSels = json.dumps(rawselEntries).replace('\\n', '')
1023 #need to load json twice as original content was string escaped a second time
1024 selEntries = json.loads(json.loads(cleanSels))
1025 selEntries = selEntries['data']
Justin Thalere412dc22018-01-12 16:28:24 -06001026
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001027 if 'description' in selEntries:
1028 if(args.json):
1029 return("{\n\t\"numAlerts\": 0\n}")
1030 else:
1031 return("No log entries found")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001032
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001033 else:
1034 if(len(policyTable)>0):
1035 events = parseAlerts(policyTable, selEntries, args)
1036 if(args.json):
1037 events["numAlerts"] = len(events)
1038 retValue = str(json.dumps(events, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False))
1039 return retValue
1040 elif(hasattr(args, 'fullSel')):
1041 return events
1042 else:
1043 #get log numbers to order event entries sequentially
1044 return selDisplay(events, args)
1045 else:
1046 if(args.json):
1047 return selEntries
1048 else:
1049 print("error: Policy Table not found.")
1050 return selEntries
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001051
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001052def selList(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001053 """
1054 prints out all all bmc alerts, or only prints out the specified alerts
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001055
Justin Thalere412dc22018-01-12 16:28:24 -06001056 @param host: string, the hostname or IP address of the bmc
1057 @param args: contains additional arguments used by the fru sub command
1058 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001059 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1060 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001061 return(sel(host, args, session))
1062
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001063
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001064def selClear(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001065 """
1066 clears all alerts
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001067
Justin Thalere412dc22018-01-12 16:28:24 -06001068 @param host: string, the hostname or IP address of the bmc
1069 @param args: contains additional arguments used by the fru sub command
1070 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001071 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1072 """
Matt Spinler47b13e92019-01-04 14:58:53 -06001073 url="https://"+host+"/xyz/openbmc_project/logging/action/DeleteAll"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001074 data = "{\"data\": [] }"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001075
Justin Thalere412dc22018-01-12 16:28:24 -06001076 try:
Justin Thaler27197622019-01-23 14:42:11 -06001077 res = session.post(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001078 except(requests.exceptions.Timeout):
1079 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001080 if res.status_code == 200:
1081 return "The Alert Log has been cleared. Please allow a few minutes for the action to complete."
1082 else:
1083 print("Unable to clear the logs, trying to clear 1 at a time")
1084 sels = json.loads(sel(host, args, session))['data']
1085 for key in sels:
1086 if 'callout' not in key:
1087 logNum = key.split('/')[-1]
1088 url = "https://"+ host+ "/xyz/openbmc_project/logging/entry/"+logNum+"/action/Delete"
1089 try:
Justin Thaler27197622019-01-23 14:42:11 -06001090 session.post(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001091 except(requests.exceptions.Timeout):
1092 return connectionErrHandler(args.json, "Timeout", None)
1093 sys.exit(1)
1094 except(requests.exceptions.ConnectionError) as err:
1095 return connectionErrHandler(args.json, "ConnectionError", err)
1096 sys.exit(1)
1097 return ('Sel clearing complete')
1098
1099def selSetResolved(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001100 """
1101 sets a sel entry to resolved
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001102
Justin Thalere412dc22018-01-12 16:28:24 -06001103 @param host: string, the hostname or IP address of the bmc
1104 @param args: contains additional arguments used by the fru sub command
1105 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001106 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1107 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001108 url="https://"+host+"/xyz/openbmc_project/logging/entry/" + str(args.selNum) + "/attr/Resolved"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001109 data = "{\"data\": 1 }"
Justin Thalere412dc22018-01-12 16:28:24 -06001110 try:
Justin Thaler27197622019-01-23 14:42:11 -06001111 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001112 except(requests.exceptions.Timeout):
1113 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001114 if res.status_code == 200:
1115 return "Sel entry "+ str(args.selNum) +" is now set to resolved"
1116 else:
1117 return "Unable to set the alert to resolved"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001118
Justin Thalere412dc22018-01-12 16:28:24 -06001119def selResolveAll(host, args, session):
1120 """
1121 sets a sel entry to resolved
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001122
Justin Thalere412dc22018-01-12 16:28:24 -06001123 @param host: string, the hostname or IP address of the bmc
1124 @param args: contains additional arguments used by the fru sub command
1125 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001126 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1127 """
Justin Thalere412dc22018-01-12 16:28:24 -06001128 rawselEntries = sel(host, args, session)
1129 loadFailed = False
1130 try:
1131 selEntries = json.loads(rawselEntries)
1132 except ValueError:
1133 loadFailed = True
1134 if loadFailed:
1135 cleanSels = json.dumps(rawselEntries).replace('\\n', '')
1136 #need to load json twice as original content was string escaped a second time
1137 selEntries = json.loads(json.loads(cleanSels))
1138 selEntries = selEntries['data']
1139
1140 if 'description' in selEntries:
1141 if(args.json):
1142 return("{\n\t\"selsResolved\": 0\n}")
1143 else:
1144 return("No log entries found")
1145 else:
1146 d = vars(args)
1147 successlist = []
1148 failedlist = []
1149 for key in selEntries:
1150 if 'callout' not in key:
1151 d['selNum'] = key.split('/')[-1]
1152 resolved = selSetResolved(host,args,session)
1153 if 'Sel entry' in resolved:
1154 successlist.append(d['selNum'])
1155 else:
1156 failedlist.append(d['selNum'])
1157 output = ""
1158 successlist.sort()
1159 failedlist.sort()
1160 if len(successlist)>0:
1161 output = "Successfully resolved: " +', '.join(successlist) +"\n"
1162 if len(failedlist)>0:
1163 output += "Failed to resolve: " + ', '.join(failedlist) + "\n"
1164 return output
1165
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001166def chassisPower(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001167 """
1168 called by the chassis function. Controls the power state of the chassis, or gets the status
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001169
Justin Thalere412dc22018-01-12 16:28:24 -06001170 @param host: string, the hostname or IP address of the bmc
1171 @param args: contains additional arguments used by the fru sub command
1172 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001173 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1174 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001175 if(args.powcmd == 'on'):
Justin Thaler22b1bb52018-03-15 13:31:32 -05001176 if checkFWactivation(host, args, session):
1177 return ("Chassis Power control disabled during firmware activation")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001178 print("Attempting to Power on...:")
1179 url="https://"+host+"/xyz/openbmc_project/state/host0/attr/RequestedHostTransition"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001180 data = '{"data":"xyz.openbmc_project.State.Host.Transition.On"}'
Justin Thalere412dc22018-01-12 16:28:24 -06001181 try:
Justin Thaler27197622019-01-23 14:42:11 -06001182 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001183 except(requests.exceptions.Timeout):
1184 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001185 return res.text
Justin Thalere412dc22018-01-12 16:28:24 -06001186 elif(args.powcmd == 'softoff'):
Justin Thaler22b1bb52018-03-15 13:31:32 -05001187 if checkFWactivation(host, args, session):
1188 return ("Chassis Power control disabled during firmware activation")
Justin Thalere412dc22018-01-12 16:28:24 -06001189 print("Attempting to Power off gracefully...:")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001190 url="https://"+host+"/xyz/openbmc_project/state/host0/attr/RequestedHostTransition"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001191 data = '{"data":"xyz.openbmc_project.State.Host.Transition.Off"}'
Justin Thalere412dc22018-01-12 16:28:24 -06001192 try:
Justin Thaler27197622019-01-23 14:42:11 -06001193 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001194 except(requests.exceptions.Timeout):
1195 return(connectionErrHandler(args.json, "Timeout", None))
1196 return res.text
1197 elif(args.powcmd == 'hardoff'):
Justin Thaler22b1bb52018-03-15 13:31:32 -05001198 if checkFWactivation(host, args, session):
1199 return ("Chassis Power control disabled during firmware activation")
Justin Thalere412dc22018-01-12 16:28:24 -06001200 print("Attempting to Power off immediately...:")
1201 url="https://"+host+"/xyz/openbmc_project/state/chassis0/attr/RequestedPowerTransition"
Justin Thalere412dc22018-01-12 16:28:24 -06001202 data = '{"data":"xyz.openbmc_project.State.Chassis.Transition.Off"}'
1203 try:
Justin Thaler27197622019-01-23 14:42:11 -06001204 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001205 except(requests.exceptions.Timeout):
1206 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001207 return res.text
1208 elif(args.powcmd == 'status'):
1209 url="https://"+host+"/xyz/openbmc_project/state/chassis0/attr/CurrentPowerState"
Justin Thalere412dc22018-01-12 16:28:24 -06001210 try:
Justin Thaler27197622019-01-23 14:42:11 -06001211 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001212 except(requests.exceptions.Timeout):
1213 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001214 chassisState = json.loads(res.text)['data'].split('.')[-1]
1215 url="https://"+host+"/xyz/openbmc_project/state/host0/attr/CurrentHostState"
Justin Thalere412dc22018-01-12 16:28:24 -06001216 try:
Justin Thaler27197622019-01-23 14:42:11 -06001217 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001218 except(requests.exceptions.Timeout):
1219 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001220 hostState = json.loads(res.text)['data'].split('.')[-1]
1221 url="https://"+host+"/xyz/openbmc_project/state/bmc0/attr/CurrentBMCState"
Justin Thalere412dc22018-01-12 16:28:24 -06001222 try:
Justin Thaler27197622019-01-23 14:42:11 -06001223 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001224 except(requests.exceptions.Timeout):
1225 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001226 bmcState = json.loads(res.text)['data'].split('.')[-1]
1227 if(args.json):
1228 outDict = {"Chassis Power State" : chassisState, "Host Power State" : hostState, "BMC Power State":bmcState}
1229 return json.dumps(outDict, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False)
1230 else:
1231 return "Chassis Power State: " +chassisState + "\nHost Power State: " + hostState + "\nBMC Power State: " + bmcState
1232 else:
1233 return "Invalid chassis power command"
1234
Justin Thalere412dc22018-01-12 16:28:24 -06001235
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001236def chassisIdent(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001237 """
1238 called by the chassis function. Controls the identify led of the chassis. Sets or gets the state
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001239
Justin Thalere412dc22018-01-12 16:28:24 -06001240 @param host: string, the hostname or IP address of the bmc
1241 @param args: contains additional arguments used by the fru sub command
1242 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001243 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Justin Thalere412dc22018-01-12 16:28:24 -06001244 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001245 if(args.identcmd == 'on'):
1246 print("Attempting to turn identify light on...:")
1247 url="https://"+host+"/xyz/openbmc_project/led/groups/enclosure_identify/attr/Asserted"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001248 data = '{"data":true}'
Justin Thalere412dc22018-01-12 16:28:24 -06001249 try:
Justin Thaler27197622019-01-23 14:42:11 -06001250 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001251 except(requests.exceptions.Timeout):
1252 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001253 return res.text
1254 elif(args.identcmd == 'off'):
1255 print("Attempting to turn identify light off...:")
1256 url="https://"+host+"/xyz/openbmc_project/led/groups/enclosure_identify/attr/Asserted"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001257 data = '{"data":false}'
Justin Thalere412dc22018-01-12 16:28:24 -06001258 try:
Justin Thaler27197622019-01-23 14:42:11 -06001259 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001260 except(requests.exceptions.Timeout):
1261 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001262 return res.text
1263 elif(args.identcmd == 'status'):
1264 url="https://"+host+"/xyz/openbmc_project/led/groups/enclosure_identify"
Justin Thalere412dc22018-01-12 16:28:24 -06001265 try:
Justin Thaler27197622019-01-23 14:42:11 -06001266 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06001267 except(requests.exceptions.Timeout):
1268 return(connectionErrHandler(args.json, "Timeout", None))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001269 status = json.loads(res.text)['data']
1270 if(args.json):
1271 return status
1272 else:
1273 if status['Asserted'] == 0:
1274 return "Identify light is off"
1275 else:
1276 return "Identify light is blinking"
1277 else:
1278 return "Invalid chassis identify command"
1279
Justin Thalere412dc22018-01-12 16:28:24 -06001280
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001281def chassis(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001282 """
1283 controls the different chassis commands
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001284
Justin Thalere412dc22018-01-12 16:28:24 -06001285 @param host: string, the hostname or IP address of the bmc
1286 @param args: contains additional arguments used by the fru sub command
1287 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001288 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1289 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001290 if(hasattr(args, 'powcmd')):
1291 result = chassisPower(host,args,session)
1292 elif(hasattr(args, 'identcmd')):
1293 result = chassisIdent(host, args, session)
1294 else:
Justin Thaler22b1bb52018-03-15 13:31:32 -05001295 return "This feature is not yet implemented"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001296 return result
Justin Thalere412dc22018-01-12 16:28:24 -06001297
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001298def bmcDumpRetrieve(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001299 """
1300 Downloads a dump file from the bmc
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001301
Justin Thalere412dc22018-01-12 16:28:24 -06001302 @param host: string, the hostname or IP address of the bmc
1303 @param args: contains additional arguments used by the collectServiceData sub command
1304 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001305 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Justin Thalere412dc22018-01-12 16:28:24 -06001306 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001307 dumpNum = args.dumpNum
1308 if (args.dumpSaveLoc is not None):
1309 saveLoc = args.dumpSaveLoc
1310 else:
Justin Thalercf1deae2018-05-25 19:35:21 -05001311 saveLoc = tempfile.gettempdir()
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001312 url ='https://'+host+'/download/dump/' + str(dumpNum)
1313 try:
Justin Thaler27197622019-01-23 14:42:11 -06001314 r = session.get(url, headers=jsonHeader, stream=True, verify=False, timeout=baseTimeout)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001315 if (args.dumpSaveLoc is not None):
1316 if os.path.exists(saveLoc):
1317 if saveLoc[-1] != os.path.sep:
1318 saveLoc = saveLoc + os.path.sep
1319 filename = saveLoc + host+'-dump' + str(dumpNum) + '.tar.xz'
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001320
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001321 else:
1322 return 'Invalid save location specified'
1323 else:
Justin Thalercf1deae2018-05-25 19:35:21 -05001324 filename = tempfile.gettempdir()+os.sep + host+'-dump' + str(dumpNum) + '.tar.xz'
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001325
1326 with open(filename, 'wb') as f:
1327 for chunk in r.iter_content(chunk_size =1024):
1328 if chunk:
1329 f.write(chunk)
1330 return 'Saved as ' + filename
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001331
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001332 except(requests.exceptions.Timeout):
1333 return connectionErrHandler(args.json, "Timeout", None)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001334
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001335 except(requests.exceptions.ConnectionError) as err:
1336 return connectionErrHandler(args.json, "ConnectionError", err)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001337
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001338def bmcDumpList(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001339 """
1340 Lists the number of dump files on the bmc
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001341
Justin Thalere412dc22018-01-12 16:28:24 -06001342 @param host: string, the hostname or IP address of the bmc
1343 @param args: contains additional arguments used by the collectServiceData sub command
1344 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001345 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1346 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001347 url ='https://'+host+'/xyz/openbmc_project/dump/list'
1348 try:
Justin Thaler27197622019-01-23 14:42:11 -06001349 r = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thaler3a5771b2019-01-23 14:31:52 -06001350 dumpList = r.json()
1351 return dumpList
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001352 except(requests.exceptions.Timeout):
1353 return connectionErrHandler(args.json, "Timeout", None)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001354
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001355 except(requests.exceptions.ConnectionError) as err:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001356 return connectionErrHandler(args.json, "ConnectionError", err)
1357
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001358def bmcDumpDelete(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001359 """
1360 Deletes BMC dump files from the bmc
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001361
Justin Thalere412dc22018-01-12 16:28:24 -06001362 @param host: string, the hostname or IP address of the bmc
1363 @param args: contains additional arguments used by the collectServiceData sub command
1364 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001365 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Justin Thalere412dc22018-01-12 16:28:24 -06001366 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001367 dumpList = []
1368 successList = []
1369 failedList = []
1370 if args.dumpNum is not None:
1371 if isinstance(args.dumpNum, list):
1372 dumpList = args.dumpNum
1373 else:
1374 dumpList.append(args.dumpNum)
1375 for dumpNum in dumpList:
1376 url ='https://'+host+'/xyz/openbmc_project/dump/entry/'+str(dumpNum)+'/action/Delete'
1377 try:
Justin Thaler27197622019-01-23 14:42:11 -06001378 r = session.post(url, headers=jsonHeader, json = {"data": []}, verify=False, timeout=baseTimeout)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001379 if r.status_code == 200:
1380 successList.append(str(dumpNum))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001381 else:
1382 failedList.append(str(dumpNum))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001383 except(requests.exceptions.Timeout):
1384 return connectionErrHandler(args.json, "Timeout", None)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001385 except(requests.exceptions.ConnectionError) as err:
1386 return connectionErrHandler(args.json, "ConnectionError", err)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001387 output = "Successfully deleted dumps: " + ', '.join(successList)
1388 if(len(failedList)>0):
1389 output+= '\nFailed to delete dumps: ' + ', '.join(failedList)
1390 return output
1391 else:
1392 return 'You must specify an entry number to delete'
1393
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001394def bmcDumpDeleteAll(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001395 """
1396 Deletes All BMC dump files from the bmc
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001397
Justin Thalere412dc22018-01-12 16:28:24 -06001398 @param host: string, the hostname or IP address of the bmc
1399 @param args: contains additional arguments used by the collectServiceData sub command
1400 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001401 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Justin Thalere412dc22018-01-12 16:28:24 -06001402 """
1403 dumpResp = bmcDumpList(host, args, session)
1404 if 'FQPSPIN0000M' in dumpResp or 'FQPSPIN0001M'in dumpResp:
1405 return dumpResp
Justin Thaler3a5771b2019-01-23 14:31:52 -06001406 dumpList = dumpResp['data']
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001407 d = vars(args)
1408 dumpNums = []
1409 for dump in dumpList:
1410 if '/xyz/openbmc_project/dump/internal/manager' not in dump:
1411 dumpNums.append(int(dump.strip().split('/')[-1]))
1412 d['dumpNum'] = dumpNums
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001413
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001414 return bmcDumpDelete(host, args, session)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001415
Justin Thalere412dc22018-01-12 16:28:24 -06001416
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001417def bmcDumpCreate(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001418 """
1419 Creates a bmc dump file
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001420
Justin Thalere412dc22018-01-12 16:28:24 -06001421 @param host: string, the hostname or IP address of the bmc
1422 @param args: contains additional arguments used by the collectServiceData sub command
1423 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001424 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Justin Thalere412dc22018-01-12 16:28:24 -06001425 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001426 url = 'https://'+host+'/xyz/openbmc_project/dump/action/CreateDump'
1427 try:
Justin Thaler27197622019-01-23 14:42:11 -06001428 r = session.post(url, headers=jsonHeader, json = {"data": []}, verify=False, timeout=baseTimeout)
Matt Spinlereae05b02019-01-24 12:59:34 -06001429 if(r.status_code == 200 and not args.json):
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001430 return ('Dump successfully created')
Justin Thaler3a5771b2019-01-23 14:31:52 -06001431 elif(args.json):
1432 return r.json()
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001433 else:
1434 return ('Failed to create dump')
1435 except(requests.exceptions.Timeout):
1436 return connectionErrHandler(args.json, "Timeout", None)
1437 except(requests.exceptions.ConnectionError) as err:
1438 return connectionErrHandler(args.json, "ConnectionError", err)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001439
1440
Justin Thaler666cf342019-01-23 14:44:27 -06001441def csdDumpInitiate(host, args, session):
1442 """
1443 Starts the process of getting the current list of dumps then initiates the creation of one.
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001444
Justin Thaler666cf342019-01-23 14:44:27 -06001445 @param host: string, the hostname or IP address of the bmc
1446 @param args: contains additional arguments used by the collectServiceData sub command
1447 @param session: the active session to use
1448 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1449 """
1450 errorInfo = ""
1451 dumpcount = 0
1452 try:
1453 d = vars(args)
1454 d['json'] = True
1455 except Exception as e:
1456 errorInfo += "Failed to set the json flag to True \n Exception: {eInfo}\n".format(eInfo=e)
1457
1458 try:
1459 for i in range(3):
1460 dumpInfo = bmcDumpList(host, args, session)
1461 if 'data' in dumpInfo:
1462 dumpcount = len(dumpInfo['data'])
1463 break
1464 else:
1465 errorInfo+= "Dump List Message returned: " + json.dumps(dumpInfo,indent=0, separators=(',', ':')).replace('\n','') +"\n"
1466 except Exception as e:
1467 errorInfo+= "Failed to collect the list of dumps.\nException: {eInfo}\n".format(eInfo=e)
1468
1469 #Create a user initiated dump
1470 try:
1471 for i in range(3):
1472 dumpcreated = bmcDumpCreate(host, args, session)
1473 if 'message' in dumpcreated:
1474 if 'ok' in dumpcreated['message'].lower():
1475 break
1476 else:
1477 errorInfo+= "Dump create message returned: " + json.dumps(dumpInfo,indent=0, separators=(',', ':')).replace('\n','') +"\n"
1478 else:
1479 errorInfo+= "Dump create message returned: " + json.dumps(dumpInfo,indent=0, separators=(',', ':')).replace('\n','') +"\n"
1480 except Exception as e:
1481 errorInfo+= "Dump create exception encountered: {eInfo}\n".format(eInfo=e)
1482
1483 output = {}
1484 output['errors'] = errorInfo
1485 output['dumpcount'] = dumpcount
1486 return output
1487
1488def csdInventory(host, args,session, fileDir):
1489 """
1490 Collects the BMC inventory, retrying if necessary
1491
1492 @param host: string, the hostname or IP address of the bmc
1493 @param args: contains additional arguments used by the collectServiceData sub command
1494 @param session: the active session to use
1495 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1496 @param fileDir: string representation of the path to use for putting files created
1497 """
1498 errorInfo = "===========Inventory =============\n"
1499 output={}
1500 inventoryCollected = False
1501 try:
1502 for i in range(3):
1503 frulist = fruPrint(host, args, session)
1504 if 'Hardware' in frulist:
1505 inventoryCollected = True
1506 break
1507 else:
1508 errorInfo += json.dumps(frulist, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n'
1509 except Exception as e:
1510 errorInfo += "Inventory collection exception: {eInfo}\n".format(eInfo=e)
1511 if inventoryCollected:
1512 try:
1513 with open(fileDir +os.sep+'inventory.txt', 'w') as f:
1514 f.write(json.dumps(frulist, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n')
1515 print("Inventory collected and stored in " + fileDir + os.sep + "inventory.txt")
1516 output['fileLoc'] = fileDir+os.sep+'inventory.txt'
1517 except Exception as e:
1518 print("Failed to write inventory to file.")
1519 errorInfo += "Error writing inventory to the file. Exception: {eInfo}\n".format(eInfo=e)
1520
1521 output['errors'] = errorInfo
1522
1523 return output
1524
1525def csdSensors(host, args,session, fileDir):
1526 """
1527 Collects the BMC sensor readings, retrying if necessary
1528
1529 @param host: string, the hostname or IP address of the bmc
1530 @param args: contains additional arguments used by the collectServiceData sub command
1531 @param session: the active session to use
1532 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1533 @param fileDir: string representation of the path to use for putting files created
1534 """
1535 errorInfo = "===========Sensors =============\n"
1536 sensorsCollected = False
1537 output={}
1538 try:
1539 d = vars(args)
1540 d['json'] = False
1541 except Exception as e:
1542 errorInfo += "Failed to set the json flag to False \n Exception: {eInfo}\n".format(eInfo=e)
1543
1544 try:
1545 for i in range(3):
1546 sensorReadings = sensor(host, args, session)
1547 if 'OCC0' in sensorReadings:
1548 sensorsCollected = True
1549 break
1550 else:
1551 errorInfo += sensorReadings
1552 except Exception as e:
1553 errorInfo += "Sensor reading collection exception: {eInfo}\n".format(eInfo=e)
1554 if sensorsCollected:
1555 try:
1556 with open(fileDir +os.sep+'sensorReadings.txt', 'w') as f:
1557 f.write(sensorReadings)
1558 print("Sensor readings collected and stored in " + fileDir + os.sep+ "sensorReadings.txt")
1559 output['fileLoc'] = fileDir+os.sep+'sensorReadings.txt'
1560 except Exception as e:
1561 print("Failed to write sensor readings to file system.")
1562 errorInfo += "Error writing sensor readings to the file. Exception: {eInfo}\n".format(eInfo=e)
1563
1564 output['errors'] = errorInfo
1565 return output
1566
1567def csdLEDs(host,args, session, fileDir):
1568 """
1569 Collects the BMC LED status, retrying if necessary
1570
1571 @param host: string, the hostname or IP address of the bmc
1572 @param args: contains additional arguments used by the collectServiceData sub command
1573 @param session: the active session to use
1574 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1575 @param fileDir: string representation of the path to use for putting files created
1576 """
1577 errorInfo = "===========LEDs =============\n"
1578 ledsCollected = False
1579 output={}
1580 try:
1581 d = vars(args)
1582 d['json'] = True
1583 except Exception as e:
1584 errorInfo += "Failed to set the json flag to False \n Exception: {eInfo}\n".format(eInfo=e)
1585 try:
1586 url="https://"+host+"/xyz/openbmc_project/led/enumerate"
1587 httpHeader = {'Content-Type':'application/json'}
1588 for i in range(3):
1589 try:
1590 ledRes = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
1591 if ledRes.status_code == 200:
1592 ledsCollected = True
1593 leds = ledRes.json()['data']
1594 break
1595 else:
1596 errorInfo += ledRes.text
1597 except(requests.exceptions.Timeout):
1598 errorInfo+=json.dumps( connectionErrHandler(args.json, "Timeout", None), sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n'
1599 except(requests.exceptions.ConnectionError) as err:
1600 errorInfo += json.dumps(connectionErrHandler(args.json, "ConnectionError", err), sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n'
1601 except Exception as e:
1602 errorInfo += "LED status collection exception: {eInfo}\n".format(eInfo=e)
1603
1604 if ledsCollected:
1605 try:
1606 with open(fileDir +os.sep+'ledStatus.txt', 'w') as f:
1607 f.write(json.dumps(leds, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n')
1608 print("LED status collected and stored in " + fileDir + os.sep+ "ledStatus.txt")
1609 output['fileLoc'] = fileDir+os.sep+'ledStatus.txt'
1610 except Exception as e:
1611 print("Failed to write LED status to file system.")
1612 errorInfo += "Error writing LED status to the file. Exception: {eInfo}\n".format(eInfo=e)
1613
1614 output['errors'] = errorInfo
1615 return output
1616
1617def csdSelShortList(host, args, session, fileDir):
1618 """
1619 Collects the BMC log entries, retrying if necessary
1620
1621 @param host: string, the hostname or IP address of the bmc
1622 @param args: contains additional arguments used by the collectServiceData sub command
1623 @param session: the active session to use
1624 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1625 @param fileDir: string representation of the path to use for putting files created
1626 """
1627 errorInfo = "===========SEL Short List =============\n"
1628 selsCollected = False
1629 output={}
1630 try:
1631 d = vars(args)
1632 d['json'] = False
1633 except Exception as e:
1634 errorInfo += "Failed to set the json flag to False \n Exception: {eInfo}\n".format(eInfo=e)
1635
1636 try:
1637 for i in range(3):
1638 sels = selPrint(host,args,session)
1639 if '----Active Alerts----' in sels or 'No log entries found' in sels or '----Historical Alerts----' in sels:
1640 selsCollected = True
1641 break
1642 else:
1643 errorInfo += sels + '\n'
1644 except Exception as e:
1645 errorInfo += "SEL short list collection exception: {eInfo}\n".format(eInfo=e)
1646
1647 if selsCollected:
1648 try:
1649 with open(fileDir +os.sep+'SELshortlist.txt', 'w') as f:
1650 f.write(sels)
1651 print("SEL short list collected and stored in " + fileDir + os.sep+ "SELshortlist.txt")
1652 output['fileLoc'] = fileDir+os.sep+'SELshortlist.txt'
1653 except Exception as e:
1654 print("Failed to write SEL short list to file system.")
1655 errorInfo += "Error writing SEL short list to the file. Exception: {eInfo}\n".format(eInfo=e)
1656
1657 output['errors'] = errorInfo
1658 return output
1659
1660def csdParsedSels(host, args, session, fileDir):
1661 """
1662 Collects the BMC log entries, retrying if necessary
1663
1664 @param host: string, the hostname or IP address of the bmc
1665 @param args: contains additional arguments used by the collectServiceData sub command
1666 @param session: the active session to use
1667 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1668 @param fileDir: string representation of the path to use for putting files created
1669 """
1670 errorInfo = "===========SEL Parsed List =============\n"
1671 selsCollected = False
1672 output={}
1673 try:
1674 d = vars(args)
1675 d['json'] = True
1676 d['fullEsel'] = True
1677 except Exception as e:
1678 errorInfo += "Failed to set the json flag to True \n Exception: {eInfo}\n".format(eInfo=e)
1679
1680 try:
1681 for i in range(3):
1682 parsedfullsels = json.loads(selPrint(host,args,session))
1683 if 'numAlerts' in parsedfullsels:
1684 selsCollected = True
1685 break
1686 else:
1687 errorInfo += parsedfullsels + '\n'
1688 except Exception as e:
1689 errorInfo += "Parsed full SELs collection exception: {eInfo}\n".format(eInfo=e)
1690
1691 if selsCollected:
1692 try:
1693 sortedSELs = sortSELs(parsedfullsels)
1694 with open(fileDir +os.sep+'parsedSELs.txt', 'w') as f:
1695 for log in sortedSELs[0]:
1696 esel = ""
1697 parsedfullsels[sortedSELs[1][str(log)]]['timestamp'] = datetime.datetime.fromtimestamp(int(parsedfullsels[sortedSELs[1][str(log)]]['timestamp']/1000)).strftime("%Y-%m-%d %H:%M:%S")
1698 if ('raweSEL' in parsedfullsels[sortedSELs[1][str(log)]] and args.devdebug):
1699 esel = parsedfullsels[sortedSELs[1][str(log)]]['raweSEL']
1700 del parsedfullsels[sortedSELs[1][str(log)]]['raweSEL']
1701 f.write(json.dumps(parsedfullsels[sortedSELs[1][str(log)]],sort_keys=True, indent=4, separators=(',', ': ')))
1702 if(args.devdebug and esel != ""):
1703 f.write(parseESEL(args, esel))
1704 print("Parsed SELs collected and stored in " + fileDir + os.sep+ "parsedSELs.txt")
1705 output['fileLoc'] = fileDir+os.sep+'parsedSELs.txt'
1706 except Exception as e:
1707 print("Failed to write fully parsed SELs to file system.")
1708 errorInfo += "Error writing fully parsed SELs to the file. Exception: {eInfo}\n".format(eInfo=e)
1709
1710 output['errors'] = errorInfo
1711 return output
1712
1713def csdFullEnumeration(host, args, session, fileDir):
1714 """
1715 Collects a full enumeration of /xyz/openbmc_project/, retrying if necessary
1716
1717 @param host: string, the hostname or IP address of the bmc
1718 @param args: contains additional arguments used by the collectServiceData sub command
1719 @param session: the active session to use
1720 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1721 @param fileDir: string representation of the path to use for putting files created
1722 """
1723 errorInfo = "===========BMC Full Enumeration =============\n"
1724 bmcFullCollected = False
1725 output={}
1726 try:
1727 d = vars(args)
1728 d['json'] = True
1729 except Exception as e:
1730 errorInfo += "Failed to set the json flag to False \n Exception: {eInfo}\n".format(eInfo=e)
1731 try:
1732 print("Attempting to get a full BMC enumeration")
1733 url="https://"+host+"/xyz/openbmc_project/enumerate"
1734 httpHeader = {'Content-Type':'application/json'}
1735 for i in range(3):
1736 try:
1737 bmcRes = session.get(url, headers=jsonHeader, verify=False, timeout=180)
1738 if bmcRes.status_code == 200:
1739 bmcFullCollected = True
1740 fullEnumeration = bmcRes.json()
1741 break
1742 else:
1743 errorInfo += bmcRes.text
1744 except(requests.exceptions.Timeout):
1745 errorInfo+=json.dumps( connectionErrHandler(args.json, "Timeout", None), sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n'
1746 except(requests.exceptions.ConnectionError) as err:
1747 errorInfo += json.dumps(connectionErrHandler(args.json, "ConnectionError", err), sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n'
1748 except Exception as e:
1749 errorInfo += "RAW BMC data collection exception: {eInfo}\n".format(eInfo=e)
1750
1751 if bmcFullCollected:
1752 try:
1753 with open(fileDir +os.sep+'bmcFullRaw.txt', 'w') as f:
1754 f.write(json.dumps(fullEnumeration, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False) + '\n')
1755 print("RAW BMC data collected and saved into " + fileDir + os.sep+ "bmcFullRaw.txt")
1756 output['fileLoc'] = fileDir+os.sep+'bmcFullRaw.txt'
1757 except Exception as e:
1758 print("Failed to write RAW BMC data to file system.")
1759 errorInfo += "Error writing RAW BMC data collection to the file. Exception: {eInfo}\n".format(eInfo=e)
1760
1761 output['errors'] = errorInfo
1762 return output
1763
1764def csdCollectAllDumps(host, args, session, fileDir):
1765 """
1766 Collects all of the bmc dump files and stores them in fileDir
1767
1768 @param host: string, the hostname or IP address of the bmc
1769 @param args: contains additional arguments used by the collectServiceData sub command
1770 @param session: the active session to use
1771 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1772 @param fileDir: string representation of the path to use for putting files created
1773 """
1774
1775 errorInfo = "===========BMC Dump Collection =============\n"
1776 dumpListCollected = False
1777 output={}
1778 dumpList = {}
1779 try:
1780 d = vars(args)
1781 d['json'] = True
1782 d['dumpSaveLoc'] = fileDir
1783 except Exception as e:
1784 errorInfo += "Failed to set the json flag to True, or failed to set the dumpSave Location \n Exception: {eInfo}\n".format(eInfo=e)
1785
1786 print('Collecting bmc dump files')
1787
1788 try:
1789 for i in range(3):
1790 dumpResp = bmcDumpList(host, args, session)
1791 if 'message' in dumpResp:
1792 if 'ok' in dumpResp['message'].lower():
1793 dumpList = dumpResp['data']
1794 dumpListCollected = True
1795 break
1796 else:
1797 errorInfo += "Status was not OK when retrieving the list of dumps available. \n Response: \n{resp}\n".format(resp=dumpResp)
1798 else:
1799 errorInfo += "Invalid response received from the BMC while retrieving the list of dumps available.\n {resp}\n".format(resp=dumpResp)
1800 except Exception as e:
1801 errorInfo += "BMC dump list exception: {eInfo}\n".format(eInfo=e)
1802
1803 if dumpListCollected:
1804 output['fileList'] = []
1805 for dump in dumpList:
1806 try:
1807 if '/xyz/openbmc_project/dump/internal/manager' not in dump:
1808 d['dumpNum'] = int(dump.strip().split('/')[-1])
1809 print('retrieving dump file ' + str(d['dumpNum']))
1810 filename = bmcDumpRetrieve(host, args, session).split('Saved as ')[-1]
1811 output['fileList'].append(filename)
1812 except Exception as e:
1813 print("Unable to collect dump: {dumpInfo}".format(dumpInfo=dump))
1814 errorInfo += "Exception collecting a bmc dump {dumpInfo}\n {eInfo}\n".format(dumpInfo=dump, eInfo=e)
1815 output['errors'] = errorInfo
1816 return output
Justin Thalere412dc22018-01-12 16:28:24 -06001817
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001818def collectServiceData(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06001819 """
1820 Collects all data needed for service from the BMC
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001821
Justin Thalere412dc22018-01-12 16:28:24 -06001822 @param host: string, the hostname or IP address of the bmc
1823 @param args: contains additional arguments used by the collectServiceData sub command
1824 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001825 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Justin Thalere412dc22018-01-12 16:28:24 -06001826 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001827
Justin Thaler22b1bb52018-03-15 13:31:32 -05001828 global toolVersion
Justin Thaler666cf342019-01-23 14:44:27 -06001829 filelist = []
1830 errorInfo = ""
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001831
Justin Thaler666cf342019-01-23 14:44:27 -06001832 #get current number of bmc dumps and create a new bmc dump
1833 dumpInitdata = csdDumpInitiate(host, args, session)
1834 dumpcount = dumpInitdata['dumpcount']
1835 errorInfo += dumpInitdata['errors']
1836 #create the directory to put files
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001837 try:
1838 args.silent = True
Justin Thalercf1deae2018-05-25 19:35:21 -05001839 myDir = tempfile.gettempdir()+os.sep + host + "--" + datetime.datetime.now().strftime("%Y-%m-%d_%H.%M.%S")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001840 os.makedirs(myDir)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001841
Justin Thaler666cf342019-01-23 14:44:27 -06001842 except Exception as e:
1843 print('Unable to create the temporary directory for data collection. Ensure sufficient privileges to create temporary directory. Aborting.')
1844 return("Python exception: {eInfo}".format(eInfo = e))
1845
1846 #Collect Inventory
1847 inventoryData = csdInventory(host, args, session, myDir)
1848 if 'fileLoc' in inventoryData:
1849 filelist.append(inventoryData['fileLoc'])
1850 errorInfo += inventoryData['errors']
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001851 #Read all the sensor and OCC status
Justin Thaler666cf342019-01-23 14:44:27 -06001852 sensorData = csdSensors(host,args,session,myDir)
1853 if 'fileLoc' in sensorData:
1854 filelist.append(sensorData['fileLoc'])
1855 errorInfo += sensorData['errors']
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001856 #Collect all of the LEDs status
Justin Thaler666cf342019-01-23 14:44:27 -06001857 ledStatus = csdLEDs(host, args, session, myDir)
1858 if 'fileLoc' in ledStatus:
1859 filelist.append(ledStatus['fileLoc'])
1860 errorInfo += ledStatus['errors']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001861
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001862 #Collect the bmc logs
Justin Thaler666cf342019-01-23 14:44:27 -06001863 selShort = csdSelShortList(host, args, session, myDir)
1864 if 'fileLoc' in selShort:
1865 filelist.append(selShort['fileLoc'])
1866 errorInfo += selShort['errors']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001867
Justin Thaler666cf342019-01-23 14:44:27 -06001868 parsedSELs = csdParsedSels(host, args, session, myDir)
1869 if 'fileLoc' in parsedSELs:
1870 filelist.append(parsedSELs['fileLoc'])
1871 errorInfo += parsedSELs['errors']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001872
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001873 #collect RAW bmc enumeration
Justin Thaler666cf342019-01-23 14:44:27 -06001874 bmcRaw = csdFullEnumeration(host, args, session, myDir)
1875 if 'fileLoc' in bmcRaw:
1876 filelist.append(bmcRaw['fileLoc'])
1877 errorInfo += bmcRaw['errors']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001878
Justin Thaler666cf342019-01-23 14:44:27 -06001879 #wait for new dump to finish being created
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001880 waitingForNewDump = True
1881 count = 0;
Justin Thaler666cf342019-01-23 14:44:27 -06001882 print("Waiting for new BMC dump to finish being created.")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001883 while(waitingForNewDump):
Justin Thaler666cf342019-01-23 14:44:27 -06001884 dumpList = bmcDumpList(host, args, session)['data']
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001885 if len(dumpList) > dumpcount:
1886 waitingForNewDump = False
1887 break;
1888 elif(count>30):
1889 print("Timed out waiting for bmc to make a new dump file. Dump space may be full.")
1890 break;
1891 else:
1892 time.sleep(2)
1893 count += 1
Justin Thaler666cf342019-01-23 14:44:27 -06001894
1895 #collect all of the dump files
1896 getBMCDumps = csdCollectAllDumps(host, args, session, myDir)
1897 if 'fileList' in getBMCDumps:
1898 filelist+= getBMCDumps['fileList']
1899 errorInfo += getBMCDumps['errors']
1900
1901 #write the runtime errors to a file
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001902 try:
Justin Thaler666cf342019-01-23 14:44:27 -06001903 with open(myDir +os.sep+'openbmctoolRuntimeErrors.txt', 'w') as f:
1904 f.write(errorInfo)
1905 print("OpenBMC tool runtime errors collected and stored in " + myDir + os.sep+ "openbmctoolRuntimeErrors.txt")
1906 filelist.append(myDir+os.sep+'openbmctoolRuntimeErrors.txt')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001907 except Exception as e:
Justin Thaler666cf342019-01-23 14:44:27 -06001908 print("Failed to write OpenBMC tool runtime errors to file system.")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001909
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001910 #create the zip file
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001911 try:
Justin Thalercf1deae2018-05-25 19:35:21 -05001912 filename = myDir.split(tempfile.gettempdir()+os.sep)[-1] + "_" + toolVersion + '_openbmc.zip'
Justin Thaler666cf342019-01-23 14:44:27 -06001913 zf = zipfile.ZipFile(myDir+os.sep + filename, 'w')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001914 for myfile in filelist:
1915 zf.write(myfile, os.path.basename(myfile))
1916 zf.close()
Justin Thaler666cf342019-01-23 14:44:27 -06001917 print("Zip file with all collected data created and stored in: {fileInfo}".format(fileInfo=myDir+os.sep+filename))
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001918 except Exception as e:
1919 print("Failed to create zip file with collected information")
Justin Thaler666cf342019-01-23 14:44:27 -06001920 return "data collection finished"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06001921
Justin Thalere412dc22018-01-12 16:28:24 -06001922
1923def healthCheck(host, args, session):
1924 """
1925 runs a health check on the platform
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001926
Justin Thalere412dc22018-01-12 16:28:24 -06001927 @param host: string, the hostname or IP address of the bmc
1928 @param args: contains additional arguments used by the bmc sub command
1929 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001930 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
1931 """
Justin Thalere412dc22018-01-12 16:28:24 -06001932 #check fru status and get as json to easily work through
1933 d = vars(args)
1934 useJson = d['json']
1935 d['json'] = True
1936 d['verbose']= False
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001937
Justin Thalere412dc22018-01-12 16:28:24 -06001938 frus = json.loads(fruStatus(host, args, session))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001939
Justin Thalere412dc22018-01-12 16:28:24 -06001940 hwStatus= "OK"
1941 performanceStatus = "OK"
1942 for key in frus:
1943 if frus[key]["Functional"] == "No" and frus[key]["Present"] == "Yes":
1944 hwStatus= "Degraded"
Justin Thalerfb9c81c2018-07-16 11:14:37 -05001945 if("power_supply" in key or "powersupply" in key):
1946 gpuCount =0
1947 for comp in frus:
Justin Thalere412dc22018-01-12 16:28:24 -06001948 if "gv100card" in comp:
1949 gpuCount +=1
1950 if gpuCount > 4:
1951 hwStatus = "Critical"
1952 performanceStatus="Degraded"
1953 break;
1954 elif("fan" in key):
1955 hwStatus = "Degraded"
1956 else:
1957 performanceStatus = "Degraded"
1958 if useJson:
1959 output = {"Hardware Status": hwStatus, "Performance": performanceStatus}
1960 output = json.dumps(output, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False)
1961 else:
1962 output = ("Hardware Status: " + hwStatus +
1963 "\nPerformance: " +performanceStatus )
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06001964
1965
Justin Thalere412dc22018-01-12 16:28:24 -06001966 #SW407886: Clear the duplicate entries
1967 #collect the dups
1968 d['devdebug'] = False
1969 sels = json.loads(selPrint(host, args, session))
1970 logNums2Clr = []
1971 oldestLogNum={"logNum": "bogus" ,"key" : ""}
1972 count = 0
1973 if sels['numAlerts'] > 0:
1974 for key in sels:
1975 if "numAlerts" in key:
1976 continue
1977 try:
1978 if "slave@00:00/00:00:00:06/sbefifo1-dev0/occ1-dev0" in sels[key]['Message']:
1979 count += 1
1980 if count > 1:
1981 #preserve first occurrence
1982 if sels[key]['timestamp'] < sels[oldestLogNum['key']]['timestamp']:
1983 oldestLogNum['key']=key
1984 oldestLogNum['logNum'] = sels[key]['logNum']
1985 else:
1986 oldestLogNum['key']=key
1987 oldestLogNum['logNum'] = sels[key]['logNum']
1988 logNums2Clr.append(sels[key]['logNum'])
1989 except KeyError:
1990 continue
1991 if(count >0):
1992 logNums2Clr.remove(oldestLogNum['logNum'])
1993 #delete the dups
1994 if count >1:
Justin Thalere412dc22018-01-12 16:28:24 -06001995 data = "{\"data\": [] }"
1996 for logNum in logNums2Clr:
1997 url = "https://"+ host+ "/xyz/openbmc_project/logging/entry/"+logNum+"/action/Delete"
1998 try:
Justin Thaler27197622019-01-23 14:42:11 -06001999 session.post(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06002000 except(requests.exceptions.Timeout):
2001 deleteFailed = True
2002 except(requests.exceptions.ConnectionError) as err:
2003 deleteFailed = True
2004 #End of defect resolve code
2005 d['json'] = useJson
2006 return output
2007
2008
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002009
Justin Thalerf9aee3e2017-12-05 12:11:09 -06002010def bmc(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06002011 """
2012 handles various bmc level commands, currently bmc rebooting
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002013
Justin Thalere412dc22018-01-12 16:28:24 -06002014 @param host: string, the hostname or IP address of the bmc
2015 @param args: contains additional arguments used by the bmc sub command
2016 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002017 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
2018 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06002019 if(args.type is not None):
2020 return bmcReset(host, args, session)
Justin Thalere412dc22018-01-12 16:28:24 -06002021 if(args.info):
2022 return "Not implemented at this time"
2023
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002024
Justin Thalere412dc22018-01-12 16:28:24 -06002025
Justin Thalerf9aee3e2017-12-05 12:11:09 -06002026def bmcReset(host, args, session):
Justin Thalere412dc22018-01-12 16:28:24 -06002027 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002028 controls resetting the bmc. warm reset reboots the bmc, cold reset removes the configuration and reboots.
2029
Justin Thalere412dc22018-01-12 16:28:24 -06002030 @param host: string, the hostname or IP address of the bmc
2031 @param args: contains additional arguments used by the bmcReset sub command
2032 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002033 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
2034 """
Justin Thaler22b1bb52018-03-15 13:31:32 -05002035 if checkFWactivation(host, args, session):
2036 return ("BMC reset control disabled during firmware activation")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06002037 if(args.type == "warm"):
2038 print("\nAttempting to reboot the BMC...:")
2039 url="https://"+host+"/xyz/openbmc_project/state/bmc0/attr/RequestedBMCTransition"
Justin Thalere412dc22018-01-12 16:28:24 -06002040 data = '{"data":"xyz.openbmc_project.State.BMC.Transition.Reboot"}'
Justin Thaler27197622019-01-23 14:42:11 -06002041 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06002042 return res.text
2043 elif(args.type =="cold"):
Justin Thalere412dc22018-01-12 16:28:24 -06002044 print("\nAttempting to reboot the BMC...:")
2045 url="https://"+host+"/xyz/openbmc_project/state/bmc0/attr/RequestedBMCTransition"
Justin Thalere412dc22018-01-12 16:28:24 -06002046 data = '{"data":"xyz.openbmc_project.State.BMC.Transition.Reboot"}'
Justin Thaler27197622019-01-23 14:42:11 -06002047 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06002048 return res.text
Justin Thalerf9aee3e2017-12-05 12:11:09 -06002049 else:
2050 return "invalid command"
Justin Thalere412dc22018-01-12 16:28:24 -06002051
2052def gardClear(host, args, session):
2053 """
2054 clears the gard records from the bmc
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002055
Justin Thalere412dc22018-01-12 16:28:24 -06002056 @param host: string, the hostname or IP address of the bmc
2057 @param args: contains additional arguments used by the gardClear sub command
2058 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002059 """
Justin Thalere412dc22018-01-12 16:28:24 -06002060 url="https://"+host+"/org/open_power/control/gard/action/Reset"
Justin Thalere412dc22018-01-12 16:28:24 -06002061 data = '{"data":[]}'
2062 try:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002063
Justin Thaler27197622019-01-23 14:42:11 -06002064 res = session.post(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06002065 if res.status_code == 404:
2066 return "Command not supported by this firmware version"
2067 else:
2068 return res.text
2069 except(requests.exceptions.Timeout):
2070 return connectionErrHandler(args.json, "Timeout", None)
2071 except(requests.exceptions.ConnectionError) as err:
2072 return connectionErrHandler(args.json, "ConnectionError", err)
2073
2074def activateFWImage(host, args, session):
2075 """
2076 activates a firmware image on the bmc
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002077
Justin Thalere412dc22018-01-12 16:28:24 -06002078 @param host: string, the hostname or IP address of the bmc
2079 @param args: contains additional arguments used by the fwflash sub command
2080 @param session: the active session to use
2081 @param fwID: the unique ID of the fw image to activate
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002082 """
Justin Thalere412dc22018-01-12 16:28:24 -06002083 fwID = args.imageID
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002084
Justin Thalere412dc22018-01-12 16:28:24 -06002085 #determine the existing versions
Justin Thalere412dc22018-01-12 16:28:24 -06002086 url="https://"+host+"/xyz/openbmc_project/software/enumerate"
2087 try:
Justin Thaler27197622019-01-23 14:42:11 -06002088 resp = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06002089 except(requests.exceptions.Timeout):
2090 return connectionErrHandler(args.json, "Timeout", None)
2091 except(requests.exceptions.ConnectionError) as err:
2092 return connectionErrHandler(args.json, "ConnectionError", err)
2093 existingSoftware = json.loads(resp.text)['data']
2094 altVersionID = ''
2095 versionType = ''
2096 imageKey = '/xyz/openbmc_project/software/'+fwID
2097 if imageKey in existingSoftware:
2098 versionType = existingSoftware[imageKey]['Purpose']
2099 for key in existingSoftware:
2100 if imageKey == key:
2101 continue
2102 if 'Purpose' in existingSoftware[key]:
2103 if versionType == existingSoftware[key]['Purpose']:
2104 altVersionID = key.split('/')[-1]
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002105
2106
2107
2108
Justin Thalere412dc22018-01-12 16:28:24 -06002109 url="https://"+host+"/xyz/openbmc_project/software/"+ fwID + "/attr/Priority"
2110 url1="https://"+host+"/xyz/openbmc_project/software/"+ altVersionID + "/attr/Priority"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002111 data = "{\"data\": 0}"
Justin Thalere412dc22018-01-12 16:28:24 -06002112 data1 = "{\"data\": 1 }"
2113 try:
Justin Thaler27197622019-01-23 14:42:11 -06002114 resp = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
2115 resp1 = session.put(url1, headers=jsonHeader, data=data1, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06002116 except(requests.exceptions.Timeout):
2117 return connectionErrHandler(args.json, "Timeout", None)
2118 except(requests.exceptions.ConnectionError) as err:
2119 return connectionErrHandler(args.json, "ConnectionError", err)
2120 if(not args.json):
2121 if resp.status_code == 200 and resp1.status_code == 200:
Justin Thaler22b1bb52018-03-15 13:31:32 -05002122 return 'Firmware flash and activation completed. Please reboot the bmc and then boot the host OS for the changes to take effect. '
Justin Thalere412dc22018-01-12 16:28:24 -06002123 else:
2124 return "Firmware activation failed."
2125 else:
2126 return resp.text + resp1.text
Justin Thaler22b1bb52018-03-15 13:31:32 -05002127
2128def activateStatus(host, args, session):
2129 if checkFWactivation(host, args, session):
2130 return("Firmware is currently being activated. Do not reboot the BMC or start the Host OS")
2131 else:
2132 return("No firmware activations are pending")
2133
2134def extractFWimage(path, imageType):
2135 """
2136 extracts the bmc image and returns information about the package
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002137
Justin Thaler22b1bb52018-03-15 13:31:32 -05002138 @param path: the path and file name of the firmware image
2139 @param imageType: The type of image the user is trying to flash. Host or BMC
2140 @return: the image id associated with the package. returns an empty string on error.
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002141 """
Justin Thaler22b1bb52018-03-15 13:31:32 -05002142 f = tempfile.TemporaryFile()
2143 tmpDir = tempfile.gettempdir()
2144 newImageID = ""
2145 if os.path.exists(path):
2146 try:
2147 imageFile = tarfile.open(path,'r')
2148 contents = imageFile.getmembers()
2149 for tf in contents:
2150 if 'MANIFEST' in tf.name:
2151 imageFile.extract(tf.name, path=tmpDir)
2152 with open(tempfile.gettempdir() +os.sep+ tf.name, 'r') as imageInfo:
2153 for line in imageInfo:
2154 if 'purpose' in line:
2155 purpose = line.split('=')[1]
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002156 if imageType not in purpose.split('.')[-1]:
Justin Thaler22b1bb52018-03-15 13:31:32 -05002157 print('The specified image is not for ' + imageType)
2158 print('Please try again with the image for ' + imageType)
2159 return ""
2160 if 'version' == line.split('=')[0]:
2161 version = line.split('=')[1].strip().encode('utf-8')
2162 m = hashlib.sha512()
2163 m.update(version)
2164 newImageID = m.hexdigest()[:8]
2165 break
2166 try:
2167 os.remove(tempfile.gettempdir() +os.sep+ tf.name)
2168 except OSError:
2169 pass
2170 return newImageID
2171 except tarfile.ExtractError as e:
2172 print('Unable to extract information from the firmware file.')
2173 print('Ensure you have write access to the directory: ' + tmpDir)
2174 return newImageID
2175 except tarfile.TarError as e:
2176 print('This is not a valid firmware file.')
2177 return newImageID
2178 print("This is not a valid firmware file.")
2179 return newImageID
2180 else:
2181 print('The filename and path provided are not valid.')
2182 return newImageID
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002183
Justin Thaler22b1bb52018-03-15 13:31:32 -05002184def getAllFWImageIDs(fwInvDict):
2185 """
2186 gets a list of all the firmware image IDs
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002187
Justin Thaler22b1bb52018-03-15 13:31:32 -05002188 @param fwInvDict: the dictionary to search for FW image IDs
2189 @return: list containing string representation of the found image ids
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002190 """
Justin Thaler22b1bb52018-03-15 13:31:32 -05002191 idList = []
2192 for key in fwInvDict:
2193 if 'Version' in fwInvDict[key]:
2194 idList.append(key.split('/')[-1])
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002195 return idList
2196
Justin Thalere412dc22018-01-12 16:28:24 -06002197def fwFlash(host, args, session):
2198 """
2199 updates the bmc firmware and pnor firmware
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002200
Justin Thalere412dc22018-01-12 16:28:24 -06002201 @param host: string, the hostname or IP address of the bmc
2202 @param args: contains additional arguments used by the fwflash sub command
2203 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002204 """
Justin Thaler22b1bb52018-03-15 13:31:32 -05002205 d = vars(args)
Justin Thalere412dc22018-01-12 16:28:24 -06002206 if(args.type == 'bmc'):
2207 purp = 'BMC'
2208 else:
2209 purp = 'Host'
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002210
2211 #check power state of the machine. No concurrent FW updates allowed
Justin Thaler22b1bb52018-03-15 13:31:32 -05002212 d['powcmd'] = 'status'
2213 powerstate = chassisPower(host, args, session)
2214 if 'Chassis Power State: On' in powerstate:
2215 return("Aborting firmware update. Host is powered on. Please turn off the host and try again.")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002216
Justin Thaler22b1bb52018-03-15 13:31:32 -05002217 #determine the existing images on the bmc
Justin Thalere412dc22018-01-12 16:28:24 -06002218 url="https://"+host+"/xyz/openbmc_project/software/enumerate"
2219 try:
Justin Thaler27197622019-01-23 14:42:11 -06002220 resp = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thalere412dc22018-01-12 16:28:24 -06002221 except(requests.exceptions.Timeout):
2222 return connectionErrHandler(args.json, "Timeout", None)
2223 except(requests.exceptions.ConnectionError) as err:
2224 return connectionErrHandler(args.json, "ConnectionError", err)
2225 oldsoftware = json.loads(resp.text)['data']
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002226
Justin Thaler22b1bb52018-03-15 13:31:32 -05002227 #Extract the tar and get information from the manifest file
2228 newversionID = extractFWimage(args.fileloc, purp)
2229 if newversionID == "":
2230 return "Unable to verify FW image."
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002231
2232
Justin Thaler22b1bb52018-03-15 13:31:32 -05002233 #check if the new image is already on the bmc
2234 if newversionID not in getAllFWImageIDs(oldsoftware):
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002235
Justin Thaler22b1bb52018-03-15 13:31:32 -05002236 #upload the file
2237 httpHeader = {'Content-Type':'application/octet-stream'}
Matt Spinler220c3c42019-01-04 15:09:29 -06002238 httpHeader.update(xAuthHeader)
Justin Thaler22b1bb52018-03-15 13:31:32 -05002239 url="https://"+host+"/upload/image"
2240 data=open(args.fileloc,'rb').read()
2241 print("Uploading file to BMC")
Justin Thalere412dc22018-01-12 16:28:24 -06002242 try:
Justin Thaler22b1bb52018-03-15 13:31:32 -05002243 resp = session.post(url, headers=httpHeader, data=data, verify=False)
Justin Thalere412dc22018-01-12 16:28:24 -06002244 except(requests.exceptions.Timeout):
2245 return connectionErrHandler(args.json, "Timeout", None)
2246 except(requests.exceptions.ConnectionError) as err:
2247 return connectionErrHandler(args.json, "ConnectionError", err)
Justin Thaler22b1bb52018-03-15 13:31:32 -05002248 if resp.status_code != 200:
2249 return "Failed to upload the file to the bmc"
Justin Thalere412dc22018-01-12 16:28:24 -06002250 else:
Justin Thaler22b1bb52018-03-15 13:31:32 -05002251 print("Upload complete.")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002252
Justin Thaler22b1bb52018-03-15 13:31:32 -05002253 #verify bmc processed the image
2254 software ={}
2255 for i in range(0, 5):
Justin Thaler22b1bb52018-03-15 13:31:32 -05002256 url="https://"+host+"/xyz/openbmc_project/software/enumerate"
2257 try:
Justin Thaler27197622019-01-23 14:42:11 -06002258 resp = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thaler22b1bb52018-03-15 13:31:32 -05002259 except(requests.exceptions.Timeout):
2260 return connectionErrHandler(args.json, "Timeout", None)
2261 except(requests.exceptions.ConnectionError) as err:
2262 return connectionErrHandler(args.json, "ConnectionError", err)
2263 software = json.loads(resp.text)['data']
2264 #check if bmc is done processing the new image
2265 if (newversionID in getAllFWImageIDs(software)):
Justin Thalere412dc22018-01-12 16:28:24 -06002266 break
Justin Thaler22b1bb52018-03-15 13:31:32 -05002267 else:
2268 time.sleep(15)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002269
Justin Thaler22b1bb52018-03-15 13:31:32 -05002270 #activate the new image
2271 print("Activating new image: "+newversionID)
2272 url="https://"+host+"/xyz/openbmc_project/software/"+ newversionID + "/attr/RequestedActivation"
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002273 data = '{"data":"xyz.openbmc_project.Software.Activation.RequestedActivations.Active"}'
Justin Thaler22b1bb52018-03-15 13:31:32 -05002274 try:
Justin Thaler27197622019-01-23 14:42:11 -06002275 resp = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Justin Thaler22b1bb52018-03-15 13:31:32 -05002276 except(requests.exceptions.Timeout):
2277 return connectionErrHandler(args.json, "Timeout", None)
2278 except(requests.exceptions.ConnectionError) as err:
2279 return connectionErrHandler(args.json, "ConnectionError", err)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002280
Justin Thaler22b1bb52018-03-15 13:31:32 -05002281 #wait for the activation to complete, timeout after ~1 hour
2282 i=0
2283 while i < 360:
2284 url="https://"+host+"/xyz/openbmc_project/software/"+ newversionID
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002285 data = '{"data":"xyz.openbmc_project.Software.Activation.RequestedActivations.Active"}'
Justin Thaler22b1bb52018-03-15 13:31:32 -05002286 try:
Justin Thaler27197622019-01-23 14:42:11 -06002287 resp = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thaler22b1bb52018-03-15 13:31:32 -05002288 except(requests.exceptions.Timeout):
2289 return connectionErrHandler(args.json, "Timeout", None)
2290 except(requests.exceptions.ConnectionError) as err:
2291 return connectionErrHandler(args.json, "ConnectionError", err)
2292 fwInfo = json.loads(resp.text)['data']
2293 if 'Activating' not in fwInfo['Activation'] and 'Activating' not in fwInfo['RequestedActivation']:
2294 print('')
2295 break
2296 else:
2297 sys.stdout.write('.')
2298 sys.stdout.flush()
2299 time.sleep(10) #check every 10 seconds
2300 return "Firmware flash and activation completed. Please reboot the bmc and then boot the host OS for the changes to take effect. "
2301 else:
2302 print("This image has been found on the bmc. Activating image: " + newversionID)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002303
Justin Thaler22b1bb52018-03-15 13:31:32 -05002304 d['imageID'] = newversionID
2305 return activateFWImage(host, args, session)
Justin Thalere412dc22018-01-12 16:28:24 -06002306
Justin Thaler3d71d402018-07-24 14:35:39 -05002307def getFWInventoryAttributes(rawFWInvItem, ID):
2308 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002309 gets and lists all of the firmware in the system.
2310
Justin Thaler3d71d402018-07-24 14:35:39 -05002311 @return: returns a dictionary containing the image attributes
2312 """
2313 reqActivation = rawFWInvItem["RequestedActivation"].split('.')[-1]
2314 pendingActivation = ""
2315 if reqActivation == "None":
2316 pendingActivation = "No"
2317 else:
2318 pendingActivation = "Yes"
2319 firmwareAttr = {ID: {
2320 "Purpose": rawFWInvItem["Purpose"].split('.')[-1],
2321 "Version": rawFWInvItem["Version"],
2322 "RequestedActivation": pendingActivation,
2323 "ID": ID}}
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002324
Justin Thaler3d71d402018-07-24 14:35:39 -05002325 if "ExtendedVersion" in rawFWInvItem:
2326 firmwareAttr[ID]['ExtendedVersion'] = rawFWInvItem['ExtendedVersion'].split(',')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002327 else:
Justin Thaler3d71d402018-07-24 14:35:39 -05002328 firmwareAttr[ID]['ExtendedVersion'] = ""
2329 return firmwareAttr
2330
2331def parseFWdata(firmwareDict):
2332 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002333 creates a dictionary with parsed firmware data
2334
Justin Thaler3d71d402018-07-24 14:35:39 -05002335 @return: returns a dictionary containing the image attributes
2336 """
2337 firmwareInfoDict = {"Functional": {}, "Activated":{}, "NeedsActivated":{}}
2338 for key in firmwareDict['data']:
2339 #check for valid endpoint
2340 if "Purpose" in firmwareDict['data'][key]:
2341 id = key.split('/')[-1]
2342 if firmwareDict['data'][key]['Activation'].split('.')[-1] == "Active":
2343 fwActivated = True
2344 else:
2345 fwActivated = False
Justin Thalercb68e062019-03-26 19:04:52 -05002346 if 'Priority' in firmwareDict['data'][key]:
2347 if firmwareDict['data'][key]['Priority'] == 0:
2348 firmwareInfoDict['Functional'].update(getFWInventoryAttributes(firmwareDict['data'][key], id))
2349 elif firmwareDict['data'][key]['Priority'] >= 0 and fwActivated:
2350 firmwareInfoDict['Activated'].update(getFWInventoryAttributes(firmwareDict['data'][key], id))
2351 else:
2352 firmwareInfoDict['NeedsActivated'].update(getFWInventoryAttributes(firmwareDict['data'][key], id))
Justin Thaler3d71d402018-07-24 14:35:39 -05002353 else:
Justin Thalercb68e062019-03-26 19:04:52 -05002354 firmwareInfoDict['NeedsActivated'].update(getFWInventoryAttributes(firmwareDict['data'][key], id))
Justin Thaler3d71d402018-07-24 14:35:39 -05002355 emptySections = []
2356 for key in firmwareInfoDict:
2357 if len(firmwareInfoDict[key])<=0:
2358 emptySections.append(key)
2359 for key in emptySections:
2360 del firmwareInfoDict[key]
2361 return firmwareInfoDict
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002362
Justin Thaler3d71d402018-07-24 14:35:39 -05002363def displayFWInvenory(firmwareInfoDict, args):
2364 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002365 gets and lists all of the firmware in the system.
2366
Justin Thaler3d71d402018-07-24 14:35:39 -05002367 @return: returns a string containing all of the firmware information
2368 """
2369 output = ""
2370 if not args.json:
2371 for key in firmwareInfoDict:
2372 for subkey in firmwareInfoDict[key]:
2373 firmwareInfoDict[key][subkey]['ExtendedVersion'] = str(firmwareInfoDict[key][subkey]['ExtendedVersion'])
2374 if not args.verbose:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002375 output = "---Running Images---\n"
Justin Thaler3d71d402018-07-24 14:35:39 -05002376 colNames = ["Purpose", "Version", "ID"]
2377 keylist = ["Purpose", "Version", "ID"]
2378 output += tableDisplay(keylist, colNames, firmwareInfoDict["Functional"])
2379 if "Activated" in firmwareInfoDict:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002380 output += "\n---Available Images---\n"
Justin Thaler3d71d402018-07-24 14:35:39 -05002381 output += tableDisplay(keylist, colNames, firmwareInfoDict["Activated"])
2382 if "NeedsActivated" in firmwareInfoDict:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002383 output += "\n---Needs Activated Images---\n"
Justin Thaler3d71d402018-07-24 14:35:39 -05002384 output += tableDisplay(keylist, colNames, firmwareInfoDict["NeedsActivated"])
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002385
Justin Thaler3d71d402018-07-24 14:35:39 -05002386 else:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002387 output = "---Running Images---\n"
Justin Thaler3d71d402018-07-24 14:35:39 -05002388 colNames = ["Purpose", "Version", "ID", "Pending Activation", "Extended Version"]
2389 keylist = ["Purpose", "Version", "ID", "RequestedActivation", "ExtendedVersion"]
2390 output += tableDisplay(keylist, colNames, firmwareInfoDict["Functional"])
2391 if "Activated" in firmwareInfoDict:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002392 output += "\n---Available Images---\n"
Justin Thaler3d71d402018-07-24 14:35:39 -05002393 output += tableDisplay(keylist, colNames, firmwareInfoDict["Activated"])
2394 if "NeedsActivated" in firmwareInfoDict:
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002395 output += "\n---Needs Activated Images---\n"
Justin Thaler3d71d402018-07-24 14:35:39 -05002396 output += tableDisplay(keylist, colNames, firmwareInfoDict["NeedsActivated"])
2397 return output
2398 else:
2399 return str(json.dumps(firmwareInfoDict, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False))
2400
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002401def firmwareList(host, args, session):
Justin Thaler3d71d402018-07-24 14:35:39 -05002402 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002403 gets and lists all of the firmware in the system.
2404
Justin Thaler3d71d402018-07-24 14:35:39 -05002405 @return: returns a string containing all of the firmware information
2406 """
Justin Thaler3d71d402018-07-24 14:35:39 -05002407 url="https://{hostname}/xyz/openbmc_project/software/enumerate".format(hostname=host)
2408 try:
Justin Thaler27197622019-01-23 14:42:11 -06002409 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Justin Thaler3d71d402018-07-24 14:35:39 -05002410 except(requests.exceptions.Timeout):
2411 return(connectionErrHandler(args.json, "Timeout", None))
2412 firmwareDict = json.loads(res.text)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002413
Justin Thaler3d71d402018-07-24 14:35:39 -05002414 #sort the received information
2415 firmwareInfoDict = parseFWdata(firmwareDict)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002416
Justin Thaler3d71d402018-07-24 14:35:39 -05002417 #display the information
2418 return displayFWInvenory(firmwareInfoDict, args)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002419
2420
Adriana Kobylak5af2fad2018-11-08 12:33:43 -06002421def deleteFWVersion(host, args, session):
2422 """
2423 deletes a firmware version on the BMC
2424
2425 @param host: string, the hostname or IP address of the BMC
2426 @param args: contains additional arguments used by the fwflash sub command
2427 @param session: the active session to use
2428 @param fwID: the unique ID of the fw version to delete
2429 """
2430 fwID = args.versionID
2431
2432 print("Deleting version: "+fwID)
2433 url="https://"+host+"/xyz/openbmc_project/software/"+ fwID + "/action/Delete"
Adriana Kobylak5af2fad2018-11-08 12:33:43 -06002434 data = "{\"data\": [] }"
2435
2436 try:
Justin Thaler27197622019-01-23 14:42:11 -06002437 res = session.post(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Adriana Kobylak5af2fad2018-11-08 12:33:43 -06002438 except(requests.exceptions.Timeout):
2439 return(connectionErrHandler(args.json, "Timeout", None))
2440 if res.status_code == 200:
2441 return ('The firmware version has been deleted')
2442 else:
2443 return ('Unable to delete the specified firmware version')
2444
2445
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05002446def restLogging(host, args, session):
2447 """
2448 Called by the logging function. Turns REST API logging on/off.
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002449
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05002450 @param host: string, the hostname or IP address of the bmc
2451 @param args: contains additional arguments used by the logging sub command
2452 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002453 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05002454 """
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05002455 url="https://"+host+"/xyz/openbmc_project/logging/rest_api_logs/attr/Enabled"
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05002456
2457 if(args.rest_logging == 'on'):
2458 data = '{"data": 1}'
2459 elif(args.rest_logging == 'off'):
2460 data = '{"data": 0}'
2461 else:
2462 return "Invalid logging rest_api command"
2463
2464 try:
Justin Thaler27197622019-01-23 14:42:11 -06002465 res = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05002466 except(requests.exceptions.Timeout):
2467 return(connectionErrHandler(args.json, "Timeout", None))
2468 return res.text
2469
2470
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002471def remoteLogging(host, args, session):
2472 """
2473 Called by the logging function. View config information for/disable remote logging (rsyslog).
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002474
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002475 @param host: string, the hostname or IP address of the bmc
2476 @param args: contains additional arguments used by the logging sub command
2477 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002478 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002479 """
2480
2481 url="https://"+host+"/xyz/openbmc_project/logging/config/remote"
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002482
2483 try:
2484 if(args.remote_logging == 'view'):
Justin Thaler27197622019-01-23 14:42:11 -06002485 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002486 elif(args.remote_logging == 'disable'):
Justin Thaler27197622019-01-23 14:42:11 -06002487 res = session.put(url + '/attr/Port', headers=jsonHeader, json = {"data": 0}, verify=False, timeout=baseTimeout)
2488 res = session.put(url + '/attr/Address', headers=jsonHeader, json = {"data": ""}, verify=False, timeout=baseTimeout)
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002489 else:
2490 return "Invalid logging remote_logging command"
2491 except(requests.exceptions.Timeout):
2492 return(connectionErrHandler(args.json, "Timeout", None))
2493 return res.text
2494
2495
2496def remoteLoggingConfig(host, args, session):
2497 """
2498 Called by the logging function. Configures remote logging (rsyslog).
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002499
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002500 @param host: string, the hostname or IP address of the bmc
2501 @param args: contains additional arguments used by the logging sub command
2502 @param session: the active session to use
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06002503 @param args.json: boolean, if this flag is set to true, the output will be provided in json format for programmatic consumption
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002504 """
2505
2506 url="https://"+host+"/xyz/openbmc_project/logging/config/remote"
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002507
2508 try:
Justin Thaler27197622019-01-23 14:42:11 -06002509 res = session.put(url + '/attr/Port', headers=jsonHeader, json = {"data": args.port}, verify=False, timeout=baseTimeout)
2510 res = session.put(url + '/attr/Address', headers=jsonHeader, json = {"data": args.address}, verify=False, timeout=baseTimeout)
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002511 except(requests.exceptions.Timeout):
2512 return(connectionErrHandler(args.json, "Timeout", None))
2513 return res.text
2514
Marri Devender Rao82590dc2019-06-06 04:54:22 -05002515def redfishSupportPresent(host, session):
2516 url = "https://" + host + "/redfish/v1"
2517 try:
2518 resp = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
2519 except(requests.exceptions.Timeout):
2520 return False
2521 except(requests.exceptions.ConnectionError) as err:
2522 return False
2523 if resp.status_code != 200:
2524 return False
2525 else:
2526 return True
Ratan Gupta9166cd22018-10-01 18:09:40 +05302527
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002528def certificateUpdate(host, args, session):
2529 """
2530 Called by certificate management function. update server/client/authority certificates
2531 Example:
2532 certificate update server https -f cert.pem
2533 certificate update authority ldap -f Root-CA.pem
2534 certificate update client ldap -f cert.pem
2535 @param host: string, the hostname or IP address of the bmc
2536 @param args: contains additional arguments used by the certificate update sub command
2537 @param session: the active session to use
2538 """
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002539 httpHeader = {'Content-Type': 'application/octet-stream'}
Matt Spinler220c3c42019-01-04 15:09:29 -06002540 httpHeader.update(xAuthHeader)
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002541 data = open(args.fileloc, 'rb').read()
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002542 try:
Marri Devender Rao82590dc2019-06-06 04:54:22 -05002543 if redfishSupportPresent(host, session):
2544 url = "";
2545 if(args.type.lower() == 'server'):
2546 url = "https://" + host + \
2547 "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates"
2548 elif(args.type.lower() == 'client'):
2549 url = "https://" + host + \
2550 "/redfish/v1/AccountService/LDAP/Certificates"
2551 elif(args.type.lower() == 'authority'):
2552 url = "https://" + host + \
2553 "/redfish/v1/Managers/bmc/Truststore/Certificates"
2554 else:
2555 return "Unsupported certificate type"
2556 resp = session.post(url, headers=httpHeader, data=data,
2557 verify=False)
2558 else:
2559 url = "https://" + host + "/xyz/openbmc_project/certs/" + \
2560 args.type.lower() + "/" + args.service.lower()
2561 resp = session.put(url, headers=httpHeader, data=data, verify=False)
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002562 except(requests.exceptions.Timeout):
2563 return(connectionErrHandler(args.json, "Timeout", None))
2564 except(requests.exceptions.ConnectionError) as err:
2565 return connectionErrHandler(args.json, "ConnectionError", err)
2566 if resp.status_code != 200:
2567 print(resp.text)
2568 return "Failed to update the certificate"
2569 else:
Marri Devender Rao82590dc2019-06-06 04:54:22 -05002570 print("Update complete.")
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002571
2572def certificateDelete(host, args, session):
2573 """
2574 Called by certificate management function to delete certificate
2575 Example:
2576 certificate delete server https
2577 certificate delete authority ldap
2578 certificate delete client ldap
2579 @param host: string, the hostname or IP address of the bmc
2580 @param args: contains additional arguments used by the certificate delete sub command
2581 @param session: the active session to use
2582 """
Marri Devender Rao77e78682019-07-17 03:18:35 -05002583 if redfishSupportPresent(host, session):
2584 return "Not supported, please use certificate replace instead";
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002585 httpHeader = {'Content-Type': 'multipart/form-data'}
Matt Spinler220c3c42019-01-04 15:09:29 -06002586 httpHeader.update(xAuthHeader)
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05002587 url = "https://" + host + "/xyz/openbmc_project/certs/" + args.type.lower() + "/" + args.service.lower()
2588 print("Deleting certificate url=" + url)
2589 try:
2590 resp = session.delete(url, headers=httpHeader)
2591 except(requests.exceptions.Timeout):
2592 return(connectionErrHandler(args.json, "Timeout", None))
2593 except(requests.exceptions.ConnectionError) as err:
2594 return connectionErrHandler(args.json, "ConnectionError", err)
2595 if resp.status_code != 200:
2596 print(resp.text)
2597 return "Failed to delete the certificate"
2598 else:
Marri Devender Rao77e78682019-07-17 03:18:35 -05002599 print("Delete complete.")
Deepak Kodihalli02d53282018-09-18 06:53:31 -05002600
Marri Devender Raodfe81ad2019-07-01 05:38:09 -05002601def certificateReplace(host, args, session):
2602 """
2603 Called by certificate management function. replace server/client/
2604 authority certificates
2605 Example:
2606 certificate replace server https -f cert.pem
2607 certificate replace authority ldap -f Root-CA.pem
2608 certificate replace client ldap -f cert.pem
2609 @param host: string, the hostname or IP address of the bmc
2610 @param args: contains additional arguments used by the certificate
2611 replace sub command
2612 @param session: the active session to use
2613 """
2614 cert = open(args.fileloc, 'rb').read()
2615 try:
2616 if redfishSupportPresent(host, session):
2617 httpHeader = {'Content-Type': 'application/json'}
2618 httpHeader.update(xAuthHeader)
2619 url = "";
2620 if(args.type.lower() == 'server'):
2621 url = "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates/1"
2622 elif(args.type.lower() == 'client'):
2623 url = "/redfish/v1/AccountService/LDAP/Certificates/1"
2624 elif(args.type.lower() == 'authority'):
2625 url = "/redfish/v1/Managers/bmc/Truststore/Certificates/1"
2626 replaceUrl = "https://" + host + \
2627 "/redfish/v1/CertificateService/Actions/CertificateService.ReplaceCertificate"
2628 data ={"CertificateUri":{"@odata.id":url}, "CertificateType":"PEM",
2629 "CertificateString":cert}
2630 resp = session.post(replaceUrl, headers=httpHeader, json=data, verify=False)
2631 else:
2632 httpHeader = {'Content-Type': 'application/octet-stream'}
2633 httpHeader.update(xAuthHeader)
2634 url = "https://" + host + "/xyz/openbmc_project/certs/" + \
2635 args.type.lower() + "/" + args.service.lower()
2636 resp = session.delete(url, headers=httpHeader)
2637 resp = session.put(url, headers=httpHeader, data=cert, verify=False)
2638 except(requests.exceptions.Timeout):
2639 return(connectionErrHandler(args.json, "Timeout", None))
2640 except(requests.exceptions.ConnectionError) as err:
2641 return connectionErrHandler(args.json, "ConnectionError", err)
2642 if resp.status_code != 200:
2643 print(resp.text)
2644 return "Failed to replace the certificate"
2645 else:
2646 print("Replace complete.")
2647 return resp.text
2648
Ratan Gupta9166cd22018-10-01 18:09:40 +05302649def enableLDAP(host, args, session):
2650 """
2651 Called by the ldap function. Configures LDAP.
2652
2653 @param host: string, the hostname or IP address of the bmc
2654 @param args: contains additional arguments used by the ldap subcommand
2655 @param session: the active session to use
2656 @param args.json: boolean, if this flag is set to true, the output will
2657 be provided in json format for programmatic consumption
2658 """
2659
2660 url='https://'+host+'/xyz/openbmc_project/user/ldap/action/CreateConfig'
Ratan Gupta9166cd22018-10-01 18:09:40 +05302661 scope = {
2662 'sub' : 'xyz.openbmc_project.User.Ldap.Create.SearchScope.sub',
2663 'one' : 'xyz.openbmc_project.User.Ldap.Create.SearchScope.one',
2664 'base': 'xyz.openbmc_project.User.Ldap.Create.SearchScope.base'
2665 }
2666
2667 serverType = {
2668 'ActiveDirectory' : 'xyz.openbmc_project.User.Ldap.Create.Type.ActiveDirectory',
2669 'OpenLDAP' : 'xyz.openbmc_project.User.Ldap.Create.Type.OpenLdap'
2670 }
2671
2672 data = {"data": [args.uri, args.bindDN, args.baseDN, args.bindPassword, scope[args.scope], serverType[args.serverType]]}
2673
2674 try:
Justin Thaler27197622019-01-23 14:42:11 -06002675 res = session.post(url, headers=jsonHeader, json=data, verify=False, timeout=baseTimeout)
Ratan Gupta9166cd22018-10-01 18:09:40 +05302676 except(requests.exceptions.Timeout):
2677 return(connectionErrHandler(args.json, "Timeout", None))
2678 except(requests.exceptions.ConnectionError) as err:
2679 return connectionErrHandler(args.json, "ConnectionError", err)
2680
2681 return res.text
2682
2683
2684def disableLDAP(host, args, session):
2685 """
2686 Called by the ldap function. Deletes the LDAP Configuration.
2687
2688 @param host: string, the hostname or IP address of the bmc
2689 @param args: contains additional arguments used by the ldap subcommand
2690 @param session: the active session to use
2691 @param args.json: boolean, if this flag is set to true, the output
2692 will be provided in json format for programmatic consumption
2693 """
2694
2695 url='https://'+host+'/xyz/openbmc_project/user/ldap/config/action/delete'
Ratan Gupta9166cd22018-10-01 18:09:40 +05302696 data = {"data": []}
2697
2698 try:
Justin Thaler27197622019-01-23 14:42:11 -06002699 res = session.post(url, headers=jsonHeader, json=data, verify=False, timeout=baseTimeout)
Ratan Gupta9166cd22018-10-01 18:09:40 +05302700 except(requests.exceptions.Timeout):
2701 return(connectionErrHandler(args.json, "Timeout", None))
2702 except(requests.exceptions.ConnectionError) as err:
2703 return connectionErrHandler(args.json, "ConnectionError", err)
2704
2705 return res.text
2706
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002707
2708def enableDHCP(host, args, session):
2709
2710 """
2711 Called by the network function. Enables DHCP.
2712
2713 @param host: string, the hostname or IP address of the bmc
2714 @param args: contains additional arguments used by the ldap subcommand
2715 args.json: boolean, if this flag is set to true, the output
2716 will be provided in json format for programmatic consumption
2717 @param session: the active session to use
2718 """
2719
2720 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2721 "/attr/DHCPEnabled"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002722 data = "{\"data\": 1 }"
2723 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002724 res = session.put(url, headers=jsonHeader, data=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002725 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002726
2727 except(requests.exceptions.Timeout):
2728 return(connectionErrHandler(args.json, "Timeout", None))
2729 except(requests.exceptions.ConnectionError) as err:
2730 return connectionErrHandler(args.json, "ConnectionError", err)
2731 if res.status_code == 403:
2732 return "The specified Interface"+"("+args.Interface+")"+\
2733 " doesn't exist"
2734
2735 return res.text
2736
2737
2738def disableDHCP(host, args, session):
2739 """
2740 Called by the network function. Disables DHCP.
2741
2742 @param host: string, the hostname or IP address of the bmc
2743 @param args: contains additional arguments used by the ldap subcommand
2744 args.json: boolean, if this flag is set to true, the output
2745 will be provided in json format for programmatic consumption
2746 @param session: the active session to use
2747 """
2748
2749 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2750 "/attr/DHCPEnabled"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002751 data = "{\"data\": 0 }"
2752 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002753 res = session.put(url, headers=jsonHeader, data=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002754 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002755 except(requests.exceptions.Timeout):
2756 return(connectionErrHandler(args.json, "Timeout", None))
2757 except(requests.exceptions.ConnectionError) as err:
2758 return connectionErrHandler(args.json, "ConnectionError", err)
2759 if res.status_code == 403:
2760 return "The specified Interface"+"("+args.Interface+")"+\
2761 " doesn't exist"
2762 return res.text
2763
2764
2765def getHostname(host, args, session):
2766
2767 """
2768 Called by the network function. Prints out the Hostname.
2769
2770 @param host: string, the hostname or IP address of the bmc
2771 @param args: contains additional arguments used by the ldap subcommand
2772 args.json: boolean, if this flag is set to true, the output
2773 will be provided in json format for programmatic consumption
2774 @param session: the active session to use
2775 """
2776
2777 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/HostName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002778
2779 try:
Justin Thaler27197622019-01-23 14:42:11 -06002780 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002781 except(requests.exceptions.Timeout):
2782 return(connectionErrHandler(args.json, "Timeout", None))
2783 except(requests.exceptions.ConnectionError) as err:
2784 return connectionErrHandler(args.json, "ConnectionError", err)
2785
2786 return res.text
2787
2788
2789def setHostname(host, args, session):
2790 """
2791 Called by the network function. Sets the Hostname.
2792
2793 @param host: string, the hostname or IP address of the bmc
2794 @param args: contains additional arguments used by the ldap subcommand
2795 args.json: boolean, if this flag is set to true, the output
2796 will be provided in json format for programmatic consumption
2797 @param session: the active session to use
2798 """
2799
2800 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/HostName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002801
2802 data = {"data": args.HostName}
2803
2804 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002805 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002806 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002807 except(requests.exceptions.Timeout):
2808 return(connectionErrHandler(args.json, "Timeout", None))
2809 except(requests.exceptions.ConnectionError) as err:
2810 return connectionErrHandler(args.json, "ConnectionError", err)
2811
2812 return res.text
2813
2814
2815def getDomainName(host, args, session):
2816
2817 """
2818 Called by the network function. Prints out the DomainName.
2819
2820 @param host: string, the hostname or IP address of the bmc
2821 @param args: contains additional arguments used by the ldap subcommand
2822 args.json: boolean, if this flag is set to true, the output
2823 will be provided in json format for programmatic consumption
2824 @param session: the active session to use
2825 """
2826
2827 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2828 "/attr/DomainName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002829
2830 try:
Justin Thaler27197622019-01-23 14:42:11 -06002831 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002832 except(requests.exceptions.Timeout):
2833 return(connectionErrHandler(args.json, "Timeout", None))
2834 except(requests.exceptions.ConnectionError) as err:
2835 return connectionErrHandler(args.json, "ConnectionError", err)
2836 if res.status_code == 404:
2837 return "The specified Interface"+"("+args.Interface+")"+\
2838 " doesn't exist"
2839
2840 return res.text
2841
2842
2843def setDomainName(host, args, session):
2844 """
2845 Called by the network function. Sets the DomainName.
2846
2847 @param host: string, the hostname or IP address of the bmc
2848 @param args: contains additional arguments used by the ldap subcommand
2849 args.json: boolean, if this flag is set to true, the output
2850 will be provided in json format for programmatic consumption
2851 @param session: the active session to use
2852 """
2853
2854 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2855 "/attr/DomainName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002856
2857 data = {"data": args.DomainName.split(",")}
2858
2859 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002860 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002861 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002862 except(requests.exceptions.Timeout):
2863 return(connectionErrHandler(args.json, "Timeout", None))
2864 except(requests.exceptions.ConnectionError) as err:
2865 return connectionErrHandler(args.json, "ConnectionError", err)
2866 if res.status_code == 403:
2867 return "The specified Interface"+"("+args.Interface+")"+\
2868 " doesn't exist"
2869
2870 return res.text
2871
2872
2873def getMACAddress(host, args, session):
2874
2875 """
2876 Called by the network function. Prints out the MACAddress.
2877
2878 @param host: string, the hostname or IP address of the bmc
2879 @param args: contains additional arguments used by the ldap subcommand
2880 args.json: boolean, if this flag is set to true, the output
2881 will be provided in json format for programmatic consumption
2882 @param session: the active session to use
2883 """
2884
2885 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2886 "/attr/MACAddress"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002887
2888 try:
Justin Thaler27197622019-01-23 14:42:11 -06002889 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002890 except(requests.exceptions.Timeout):
2891 return(connectionErrHandler(args.json, "Timeout", None))
2892 except(requests.exceptions.ConnectionError) as err:
2893 return connectionErrHandler(args.json, "ConnectionError", err)
2894 if res.status_code == 404:
2895 return "The specified Interface"+"("+args.Interface+")"+\
2896 " doesn't exist"
2897
2898 return res.text
2899
2900
2901def setMACAddress(host, args, session):
2902 """
2903 Called by the network function. Sets the MACAddress.
2904
2905 @param host: string, the hostname or IP address of the bmc
2906 @param args: contains additional arguments used by the ldap subcommand
2907 args.json: boolean, if this flag is set to true, the output
2908 will be provided in json format for programmatic consumption
2909 @param session: the active session to use
2910 """
2911
2912 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2913 "/attr/MACAddress"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002914
2915 data = {"data": args.MACAddress}
2916
2917 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002918 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002919 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002920 except(requests.exceptions.Timeout):
2921 return(connectionErrHandler(args.json, "Timeout", None))
2922 except(requests.exceptions.ConnectionError) as err:
2923 return connectionErrHandler(args.json, "ConnectionError", err)
2924 if res.status_code == 403:
2925 return "The specified Interface"+"("+args.Interface+")"+\
2926 " doesn't exist"
2927
2928 return res.text
2929
2930
2931def getDefaultGateway(host, args, session):
2932
2933 """
2934 Called by the network function. Prints out the DefaultGateway.
2935
2936 @param host: string, the hostname or IP address of the bmc
2937 @param args: contains additional arguments used by the ldap subcommand
2938 args.json: boolean, if this flag is set to true, the output
2939 will be provided in json format for programmatic consumption
2940 @param session: the active session to use
2941 """
2942
2943 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/DefaultGateway"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002944
2945 try:
Justin Thaler27197622019-01-23 14:42:11 -06002946 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002947 except(requests.exceptions.Timeout):
2948 return(connectionErrHandler(args.json, "Timeout", None))
2949 except(requests.exceptions.ConnectionError) as err:
2950 return connectionErrHandler(args.json, "ConnectionError", err)
2951 if res.status_code == 404:
2952 return "Failed to get Default Gateway info!!"
2953
2954 return res.text
2955
2956
2957def setDefaultGateway(host, args, session):
2958 """
2959 Called by the network function. Sets the DefaultGateway.
2960
2961 @param host: string, the hostname or IP address of the bmc
2962 @param args: contains additional arguments used by the ldap subcommand
2963 args.json: boolean, if this flag is set to true, the output
2964 will be provided in json format for programmatic consumption
2965 @param session: the active session to use
2966 """
2967
2968 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/DefaultGateway"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002969
2970 data = {"data": args.DefaultGW}
2971
2972 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002973 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002974 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002975 except(requests.exceptions.Timeout):
2976 return(connectionErrHandler(args.json, "Timeout", None))
2977 except(requests.exceptions.ConnectionError) as err:
2978 return connectionErrHandler(args.json, "ConnectionError", err)
2979 if res.status_code == 403:
2980 return "Failed to set Default Gateway!!"
2981
2982 return res.text
2983
2984
2985def viewNWConfig(host, args, session):
2986 """
2987 Called by the ldap function. Prints out network configured properties
2988
2989 @param host: string, the hostname or IP address of the bmc
2990 @param args: contains additional arguments used by the ldap subcommand
2991 args.json: boolean, if this flag is set to true, the output
2992 will be provided in json format for programmatic consumption
2993 @param session: the active session to use
2994 @return returns LDAP's configured properties.
2995 """
2996 url = "https://"+host+"/xyz/openbmc_project/network/enumerate"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002997 try:
Justin Thaler27197622019-01-23 14:42:11 -06002998 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002999 except(requests.exceptions.Timeout):
3000 return(connectionErrHandler(args.json, "Timeout", None))
3001 except(requests.exceptions.ConnectionError) as err:
3002 return connectionErrHandler(args.json, "ConnectionError", err)
3003 except(requests.exceptions.RequestException) as err:
3004 return connectionErrHandler(args.json, "RequestException", err)
3005 if res.status_code == 404:
3006 return "LDAP server config has not been created"
3007 return res.text
3008
3009
3010def getDNS(host, args, session):
3011
3012 """
3013 Called by the network function. Prints out DNS servers on the interface
3014
3015 @param host: string, the hostname or IP address of the bmc
3016 @param args: contains additional arguments used by the ldap subcommand
3017 args.json: boolean, if this flag is set to true, the output
3018 will be provided in json format for programmatic consumption
3019 @param session: the active session to use
3020 """
3021
3022 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3023 + "/attr/Nameservers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003024
3025 try:
Justin Thaler27197622019-01-23 14:42:11 -06003026 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003027 except(requests.exceptions.Timeout):
3028 return(connectionErrHandler(args.json, "Timeout", None))
3029 except(requests.exceptions.ConnectionError) as err:
3030 return connectionErrHandler(args.json, "ConnectionError", err)
3031 if res.status_code == 404:
3032 return "The specified Interface"+"("+args.Interface+")" + \
3033 " doesn't exist"
3034
3035 return res.text
3036
3037
3038def setDNS(host, args, session):
3039 """
3040 Called by the network function. Sets DNS servers on the interface.
3041
3042 @param host: string, the hostname or IP address of the bmc
3043 @param args: contains additional arguments used by the ldap subcommand
3044 args.json: boolean, if this flag is set to true, the output
3045 will be provided in json format for programmatic consumption
3046 @param session: the active session to use
3047 """
3048
3049 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3050 + "/attr/Nameservers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003051
3052 data = {"data": args.DNSServers.split(",")}
3053
3054 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003055 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003056 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003057 except(requests.exceptions.Timeout):
3058 return(connectionErrHandler(args.json, "Timeout", None))
3059 except(requests.exceptions.ConnectionError) as err:
3060 return connectionErrHandler(args.json, "ConnectionError", err)
3061 if res.status_code == 403:
3062 return "The specified Interface"+"("+args.Interface+")" +\
3063 " doesn't exist"
3064
3065 return res.text
3066
3067
3068def getNTP(host, args, session):
3069
3070 """
3071 Called by the network function. Prints out NTP servers on the interface
3072
3073 @param host: string, the hostname or IP address of the bmc
3074 @param args: contains additional arguments used by the ldap subcommand
3075 args.json: boolean, if this flag is set to true, the output
3076 will be provided in json format for programmatic consumption
3077 @param session: the active session to use
3078 """
3079
3080 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3081 + "/attr/NTPServers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003082
3083 try:
Justin Thaler27197622019-01-23 14:42:11 -06003084 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003085 except(requests.exceptions.Timeout):
3086 return(connectionErrHandler(args.json, "Timeout", None))
3087 except(requests.exceptions.ConnectionError) as err:
3088 return connectionErrHandler(args.json, "ConnectionError", err)
3089 if res.status_code == 404:
3090 return "The specified Interface"+"("+args.Interface+")" + \
3091 " doesn't exist"
3092
3093 return res.text
3094
3095
3096def setNTP(host, args, session):
3097 """
3098 Called by the network function. Sets NTP servers on the interface.
3099
3100 @param host: string, the hostname or IP address of the bmc
3101 @param args: contains additional arguments used by the ldap subcommand
3102 args.json: boolean, if this flag is set to true, the output
3103 will be provided in json format for programmatic consumption
3104 @param session: the active session to use
3105 """
3106
3107 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3108 + "/attr/NTPServers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003109
3110 data = {"data": args.NTPServers.split(",")}
3111
3112 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003113 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003114 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003115 except(requests.exceptions.Timeout):
3116 return(connectionErrHandler(args.json, "Timeout", None))
3117 except(requests.exceptions.ConnectionError) as err:
3118 return connectionErrHandler(args.json, "ConnectionError", err)
3119 if res.status_code == 403:
3120 return "The specified Interface"+"("+args.Interface+")" +\
3121 " doesn't exist"
3122
3123 return res.text
3124
3125
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003126def addIP(host, args, session):
3127 """
3128 Called by the network function. Configures IP address on given interface
3129
3130 @param host: string, the hostname or IP address of the bmc
3131 @param args: contains additional arguments used by the ldap subcommand
3132 args.json: boolean, if this flag is set to true, the output
3133 will be provided in json format for programmatic consumption
3134 @param session: the active session to use
3135 """
3136
3137 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3138 + "/action/IP"
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003139 protocol = {
3140 'ipv4': 'xyz.openbmc_project.Network.IP.Protocol.IPv4',
3141 'ipv6': 'xyz.openbmc_project.Network.IP.Protocol.IPv6'
3142 }
3143
3144 data = {"data": [protocol[args.type], args.address, int(args.prefixLength),
3145 args.gateway]}
3146
3147 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003148 res = session.post(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003149 timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003150 except(requests.exceptions.Timeout):
3151 return(connectionErrHandler(args.json, "Timeout", None))
3152 except(requests.exceptions.ConnectionError) as err:
3153 return connectionErrHandler(args.json, "ConnectionError", err)
3154 if res.status_code == 404:
3155 return "The specified Interface" + "(" + args.Interface + ")" +\
3156 " doesn't exist"
3157
3158 return res.text
3159
3160
3161def getIP(host, args, session):
3162 """
3163 Called by the network function. Prints out IP address of given interface
3164
3165 @param host: string, the hostname or IP address of the bmc
3166 @param args: contains additional arguments used by the ldap subcommand
3167 args.json: boolean, if this flag is set to true, the output
3168 will be provided in json format for programmatic consumption
3169 @param session: the active session to use
3170 """
3171
3172 url = "https://" + host+"/xyz/openbmc_project/network/" + args.Interface +\
3173 "/enumerate"
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003174 try:
Justin Thaler27197622019-01-23 14:42:11 -06003175 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003176 except(requests.exceptions.Timeout):
3177 return(connectionErrHandler(args.json, "Timeout", None))
3178 except(requests.exceptions.ConnectionError) as err:
3179 return connectionErrHandler(args.json, "ConnectionError", err)
3180 if res.status_code == 404:
3181 return "The specified Interface" + "(" + args.Interface + ")" +\
3182 " doesn't exist"
3183
3184 return res.text
3185
3186
3187def deleteIP(host, args, session):
3188 """
3189 Called by the network function. Deletes the IP address from given Interface
3190
3191 @param host: string, the hostname or IP address of the bmc
3192 @param args: contains additional arguments used by the ldap subcommand
3193 @param session: the active session to use
3194 @param args.json: boolean, if this flag is set to true, the output
3195 will be provided in json format for programmatic consumption
3196 """
3197
3198 url = "https://"+host+"/xyz/openbmc_project/network/" + args.Interface+\
3199 "/enumerate"
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003200 data = {"data": []}
3201 try:
Justin Thaler27197622019-01-23 14:42:11 -06003202 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003203 except(requests.exceptions.Timeout):
3204 return(connectionErrHandler(args.json, "Timeout", None))
3205 except(requests.exceptions.ConnectionError) as err:
3206 return connectionErrHandler(args.json, "ConnectionError", err)
3207 if res.status_code == 404:
3208 return "The specified Interface" + "(" + args.Interface + ")" +\
3209 " doesn't exist"
3210 objDict = json.loads(res.text)
3211 if not objDict['data']:
3212 return "No object found for given address on given Interface"
3213
3214 for obj in objDict['data']:
3215 if args.address in objDict['data'][obj]['Address']:
3216 url = "https://"+host+obj+"/action/delete"
3217 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003218 res = session.post(url, headers=jsonHeader, json=data,
Justin Thaler27197622019-01-23 14:42:11 -06003219 verify=False, timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003220 except(requests.exceptions.Timeout):
3221 return(connectionErrHandler(args.json, "Timeout", None))
3222 except(requests.exceptions.ConnectionError) as err:
3223 return connectionErrHandler(args.json, "ConnectionError", err)
3224 return res.text
3225 else:
3226 continue
3227 return "No object found for given address on given Interface"
3228
3229
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003230def addVLAN(host, args, session):
3231 """
3232 Called by the network function. Creates VLAN on given interface.
3233
3234 @param host: string, the hostname or IP address of the bmc
3235 @param args: contains additional arguments used by the ldap subcommand
3236 args.json: boolean, if this flag is set to true, the output
3237 will be provided in json format for programmatic consumption
3238 @param session: the active session to use
3239 """
3240
3241 url = "https://" + host+"/xyz/openbmc_project/network/action/VLAN"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003242
3243 data = {"data": [args.Interface,args.Identifier]}
3244
3245 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003246 res = session.post(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003247 timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003248 except(requests.exceptions.Timeout):
3249 return(connectionErrHandler(args.json, "Timeout", None))
3250 except(requests.exceptions.ConnectionError) as err:
3251 return connectionErrHandler(args.json, "ConnectionError", err)
3252 if res.status_code == 400:
3253 return "The specified Interface" + "(" + args.Interface + ")" +\
3254 " doesn't exist"
3255
3256 return res.text
3257
3258
3259def deleteVLAN(host, args, session):
3260 """
3261 Called by the network function. Creates VLAN on given interface.
3262
3263 @param host: string, the hostname or IP address of the bmc
3264 @param args: contains additional arguments used by the ldap subcommand
3265 args.json: boolean, if this flag is set to true, the output
3266 will be provided in json format for programmatic consumption
3267 @param session: the active session to use
3268 """
3269
3270 url = "https://" + host+"/xyz/openbmc_project/network/"+args.Interface+"/action/delete"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003271 data = {"data": []}
3272
3273 try:
Justin Thaler27197622019-01-23 14:42:11 -06003274 res = session.post(url, headers=jsonHeader, json=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003275 except(requests.exceptions.Timeout):
3276 return(connectionErrHandler(args.json, "Timeout", None))
3277 except(requests.exceptions.ConnectionError) as err:
3278 return connectionErrHandler(args.json, "ConnectionError", err)
3279 if res.status_code == 404:
3280 return "The specified VLAN"+"("+args.Interface+"_"+args.Identifier\
3281 +")" +" doesn't exist"
3282
3283 return res.text
3284
3285
3286def viewDHCPConfig(host, args, session):
3287 """
3288 Called by the network function. Shows DHCP configured Properties.
3289
3290 @param host: string, the hostname or IP address of the bmc
3291 @param args: contains additional arguments used by the ldap subcommand
3292 args.json: boolean, if this flag is set to true, the output
3293 will be provided in json format for programmatic consumption
3294 @param session: the active session to use
3295 """
3296
3297 url="https://"+host+"/xyz/openbmc_project/network/config/dhcp"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003298
3299 try:
Justin Thaler27197622019-01-23 14:42:11 -06003300 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003301 except(requests.exceptions.Timeout):
3302 return(connectionErrHandler(args.json, "Timeout", None))
3303 except(requests.exceptions.ConnectionError) as err:
3304 return connectionErrHandler(args.json, "ConnectionError", err)
3305
3306 return res.text
3307
3308
3309def configureDHCP(host, args, session):
3310 """
3311 Called by the network function. Configures/updates DHCP Properties.
3312
3313 @param host: string, the hostname or IP address of the bmc
3314 @param args: contains additional arguments used by the ldap subcommand
3315 args.json: boolean, if this flag is set to true, the output
3316 will be provided in json format for programmatic consumption
3317 @param session: the active session to use
3318 """
3319
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003320
3321 try:
3322 url="https://"+host+"/xyz/openbmc_project/network/config/dhcp"
3323 if(args.DNSEnabled == True):
3324 data = '{"data": 1}'
3325 else:
3326 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003327 res = session.put(url + '/attr/DNSEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003328 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003329 if(args.HostNameEnabled == True):
3330 data = '{"data": 1}'
3331 else:
3332 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003333 res = session.put(url + '/attr/HostNameEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003334 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003335 if(args.NTPEnabled == True):
3336 data = '{"data": 1}'
3337 else:
3338 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003339 res = session.put(url + '/attr/NTPEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003340 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003341 if(args.SendHostNameEnabled == True):
3342 data = '{"data": 1}'
3343 else:
3344 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003345 res = session.put(url + '/attr/SendHostNameEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003346 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003347 except(requests.exceptions.Timeout):
3348 return(connectionErrHandler(args.json, "Timeout", None))
3349 except(requests.exceptions.ConnectionError) as err:
3350 return connectionErrHandler(args.json, "ConnectionError", err)
3351
3352 return res.text
3353
3354
3355def nwReset(host, args, session):
3356
3357 """
3358 Called by the network function. Resets networks setting to factory defaults.
3359
3360 @param host: string, the hostname or IP address of the bmc
3361 @param args: contains additional arguments used by the ldap subcommand
3362 args.json: boolean, if this flag is set to true, the output
3363 will be provided in json format for programmatic consumption
3364 @param session: the active session to use
3365 """
3366
3367 url = "https://"+host+"/xyz/openbmc_project/network/action/Reset"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003368 data = '{"data":[] }'
3369 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003370 res = session.post(url, headers=jsonHeader, data=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003371 timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003372
3373 except(requests.exceptions.Timeout):
3374 return(connectionErrHandler(args.json, "Timeout", None))
3375 except(requests.exceptions.ConnectionError) as err:
3376 return connectionErrHandler(args.json, "ConnectionError", err)
3377
3378 return res.text
3379
3380
Ratan Guptafeee6372018-10-17 23:25:51 +05303381def createPrivilegeMapping(host, args, session):
3382 """
3383 Called by the ldap function. Creates the group and the privilege mapping.
3384
3385 @param host: string, the hostname or IP address of the bmc
3386 @param args: contains additional arguments used by the ldap subcommand
3387 @param session: the active session to use
3388 @param args.json: boolean, if this flag is set to true, the output
3389 will be provided in json format for programmatic consumption
3390 """
3391
3392 url = 'https://'+host+'/xyz/openbmc_project/user/ldap/action/Create'
Ratan Guptafeee6372018-10-17 23:25:51 +05303393
3394 data = {"data": [args.groupName,args.privilege]}
3395
3396 try:
Justin Thaler27197622019-01-23 14:42:11 -06003397 res = session.post(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Ratan Guptafeee6372018-10-17 23:25:51 +05303398 except(requests.exceptions.Timeout):
3399 return(connectionErrHandler(args.json, "Timeout", None))
3400 except(requests.exceptions.ConnectionError) as err:
3401 return connectionErrHandler(args.json, "ConnectionError", err)
3402 return res.text
3403
3404def listPrivilegeMapping(host, args, session):
3405 """
3406 Called by the ldap function. Lists the group and the privilege mapping.
3407
3408 @param host: string, the hostname or IP address of the bmc
3409 @param args: contains additional arguments used by the ldap subcommand
3410 @param session: the active session to use
3411 @param args.json: boolean, if this flag is set to true, the output
3412 will be provided in json format for programmatic consumption
3413 """
3414 url = 'https://'+host+'/xyz/openbmc_project/user/ldap/enumerate'
Ratan Guptafeee6372018-10-17 23:25:51 +05303415 data = {"data": []}
3416
3417 try:
Justin Thaler27197622019-01-23 14:42:11 -06003418 res = session.get(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Ratan Guptafeee6372018-10-17 23:25:51 +05303419 except(requests.exceptions.Timeout):
3420 return(connectionErrHandler(args.json, "Timeout", None))
3421 except(requests.exceptions.ConnectionError) as err:
3422 return connectionErrHandler(args.json, "ConnectionError", err)
3423 return res.text
3424
3425def deletePrivilegeMapping(host, args, session):
3426 """
3427 Called by the ldap function. Deletes the mapping associated with the group.
3428
3429 @param host: string, the hostname or IP address of the bmc
3430 @param args: contains additional arguments used by the ldap subcommand
3431 @param session: the active session to use
3432 @param args.json: boolean, if this flag is set to true, the output
3433 will be provided in json format for programmatic consumption
3434 """
3435 (ldapNameSpaceObjects) = listPrivilegeMapping(host, args, session)
3436 ldapNameSpaceObjects = json.loads(ldapNameSpaceObjects)["data"]
3437 path = ''
3438
3439 # not interested in the config objet
3440 ldapNameSpaceObjects.pop('/xyz/openbmc_project/user/ldap/config', None)
3441
3442 # search for the object having the mapping for the given group
3443 for key,value in ldapNameSpaceObjects.items():
3444 if value['GroupName'] == args.groupName:
3445 path = key
3446 break
3447
3448 if path == '':
3449 return "No privilege mapping found for this group."
3450
3451 # delete the object
3452 url = 'https://'+host+path+'/action/delete'
Ratan Guptafeee6372018-10-17 23:25:51 +05303453 data = {"data": []}
3454
3455 try:
Justin Thaler27197622019-01-23 14:42:11 -06003456 res = session.post(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Ratan Guptafeee6372018-10-17 23:25:51 +05303457 except(requests.exceptions.Timeout):
3458 return(connectionErrHandler(args.json, "Timeout", None))
3459 except(requests.exceptions.ConnectionError) as err:
3460 return connectionErrHandler(args.json, "ConnectionError", err)
3461 return res.text
Ratan Gupta9166cd22018-10-01 18:09:40 +05303462
Sivas SRR78835272018-11-27 05:27:19 -06003463def deleteAllPrivilegeMapping(host, args, session):
3464 """
3465 Called by the ldap function. Deletes all the privilege mapping and group defined.
3466 @param host: string, the hostname or IP address of the bmc
3467 @param args: contains additional arguments used by the ldap subcommand
3468 @param session: the active session to use
3469 @param args.json: boolean, if this flag is set to true, the output
3470 will be provided in json format for programmatic consumption
3471 """
3472 ldapNameSpaceObjects = listPrivilegeMapping(host, args, session)
3473 ldapNameSpaceObjects = json.loads(ldapNameSpaceObjects)["data"]
3474 path = ''
3475
3476 # Remove the config object.
3477 ldapNameSpaceObjects.pop('/xyz/openbmc_project/user/ldap/config', None)
Sivas SRR78835272018-11-27 05:27:19 -06003478 data = {"data": []}
3479
3480 try:
3481 # search for GroupName property and delete if it is available.
3482 for path in ldapNameSpaceObjects.keys():
3483 # delete the object
3484 url = 'https://'+host+path+'/action/delete'
Justin Thaler27197622019-01-23 14:42:11 -06003485 res = session.post(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Sivas SRR78835272018-11-27 05:27:19 -06003486 except(requests.exceptions.Timeout):
3487 return(connectionErrHandler(args.json, "Timeout", None))
3488 except(requests.exceptions.ConnectionError) as err:
3489 return connectionErrHandler(args.json, "ConnectionError", err)
3490 return res.text
3491
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003492def viewLDAPConfig(host, args, session):
3493 """
3494 Called by the ldap function. Prints out LDAP's configured properties
3495
3496 @param host: string, the hostname or IP address of the bmc
3497 @param args: contains additional arguments used by the ldap subcommand
3498 args.json: boolean, if this flag is set to true, the output
3499 will be provided in json format for programmatic consumption
3500 @param session: the active session to use
3501 @return returns LDAP's configured properties.
3502 """
3503 url = "https://"+host+"/xyz/openbmc_project/user/ldap/config"
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003504 try:
Justin Thaler27197622019-01-23 14:42:11 -06003505 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003506 except(requests.exceptions.Timeout):
3507 return(connectionErrHandler(args.json, "Timeout", None))
3508 except(requests.exceptions.ConnectionError) as err:
3509 return connectionErrHandler(args.json, "ConnectionError", err)
3510 except(requests.exceptions.RequestException) as err:
3511 return connectionErrHandler(args.json, "RequestException", err)
3512 if res.status_code == 404:
3513 return "LDAP server config has not been created"
3514 return res.text
3515
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003516def str2bool(v):
3517 if v.lower() in ('yes', 'true', 't', 'y', '1'):
3518 return True
3519 elif v.lower() in ('no', 'false', 'f', 'n', '0'):
3520 return False
3521 else:
3522 raise argparse.ArgumentTypeError('Boolean value expected.')
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003523
Matt Spinler7d426c22018-09-24 14:42:07 -05003524def localUsers(host, args, session):
3525 """
3526 Enables and disables local BMC users.
3527
3528 @param host: string, the hostname or IP address of the bmc
3529 @param args: contains additional arguments used by the logging sub command
3530 @param session: the active session to use
3531 """
3532
Matt Spinler7d426c22018-09-24 14:42:07 -05003533 url="https://{hostname}/xyz/openbmc_project/user/enumerate".format(hostname=host)
3534 try:
Justin Thaler27197622019-01-23 14:42:11 -06003535 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Matt Spinler7d426c22018-09-24 14:42:07 -05003536 except(requests.exceptions.Timeout):
3537 return(connectionErrHandler(args.json, "Timeout", None))
3538 usersDict = json.loads(res.text)
3539
3540 if not usersDict['data']:
3541 return "No users found"
3542
3543 output = ""
3544 for user in usersDict['data']:
Matt Spinler015adc22018-10-23 14:30:19 -05003545
3546 # Skip LDAP and another non-local users
3547 if 'UserEnabled' not in usersDict['data'][user]:
3548 continue
3549
Matt Spinler7d426c22018-09-24 14:42:07 -05003550 name = user.split('/')[-1]
3551 url = "https://{hostname}{user}/attr/UserEnabled".format(hostname=host, user=user)
3552
3553 if args.local_users == "queryenabled":
3554 try:
Justin Thaler27197622019-01-23 14:42:11 -06003555 res = session.get(url, headers=jsonHeader,verify=False, timeout=baseTimeout)
Matt Spinler7d426c22018-09-24 14:42:07 -05003556 except(requests.exceptions.Timeout):
3557 return(connectionErrHandler(args.json, "Timeout", None))
3558
3559 result = json.loads(res.text)
3560 output += ("User: {name} Enabled: {result}\n").format(name=name, result=result['data'])
3561
3562 elif args.local_users in ["enableall", "disableall"]:
3563 action = ""
3564 if args.local_users == "enableall":
3565 data = '{"data": true}'
3566 action = "Enabling"
3567 else:
3568 data = '{"data": false}'
3569 action = "Disabling"
3570
3571 output += "{action} {name}\n".format(action=action, name=name)
3572
3573 try:
Justin Thaler27197622019-01-23 14:42:11 -06003574 resp = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Matt Spinler7d426c22018-09-24 14:42:07 -05003575 except(requests.exceptions.Timeout):
3576 return connectionErrHandler(args.json, "Timeout", None)
3577 except(requests.exceptions.ConnectionError) as err:
3578 return connectionErrHandler(args.json, "ConnectionError", err)
3579 else:
3580 return "Invalid local users argument"
3581
3582 return output
3583
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003584def setPassword(host, args, session):
3585 """
3586 Set local user password
3587 @param host: string, the hostname or IP address of the bmc
3588 @param args: contains additional arguments used by the logging sub
3589 command
3590 @param session: the active session to use
3591 @param args.json: boolean, if this flag is set to true, the output
3592 will be provided in json format for programmatic consumption
3593 @return: Session object
3594 """
3595 url = "https://" + host + "/xyz/openbmc_project/user/" + args.user + \
3596 "/action/SetPassword"
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003597 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003598 res = session.post(url, headers=jsonHeader,
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003599 json={"data": [args.password]}, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003600 timeout=baseTimeout)
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003601 except(requests.exceptions.Timeout):
3602 return(connectionErrHandler(args.json, "Timeout", None))
3603 except(requests.exceptions.ConnectionError) as err:
3604 return connectionErrHandler(args.json, "ConnectionError", err)
3605 except(requests.exceptions.RequestException) as err:
3606 return connectionErrHandler(args.json, "RequestException", err)
3607 return res.text
3608
Matthew Barth368e83c2019-02-01 13:48:25 -06003609
3610def getThermalZones(host, args, session):
3611 """
3612 Get the available thermal control zones
3613 @param host: string, the hostname or IP address of the bmc
3614 @param args: contains additional arguments used to get the thermal
3615 control zones
3616 @param session: the active session to use
3617 @return: Session object
3618 """
3619 url = "https://" + host + "/xyz/openbmc_project/control/thermal/enumerate"
3620
3621 try:
3622 res = session.get(url, headers=jsonHeader, verify=False, timeout=30)
3623 except(requests.exceptions.Timeout):
3624 return(connectionErrHandler(args.json, "Timeout", None))
3625 except(requests.exceptions.ConnectionError) as err:
3626 return connectionErrHandler(args.json, "ConnectionError", err)
3627 except(requests.exceptions.RequestException) as err:
3628 return connectionErrHandler(args.json, "RequestException", err)
3629
3630 if (res.status_code == 404):
3631 return "No thermal control zones found or system is in a" + \
3632 " powered off state"
3633
3634 zonesDict = json.loads(res.text)
3635 if not zonesDict['data']:
3636 return "No thermal control zones found"
3637 for zone in zonesDict['data']:
3638 z = ",".join(str(zone.split('/')[-1]) for zone in zonesDict['data'])
3639
3640 return "Zones: [ " + z + " ]"
3641
3642
3643def getThermalMode(host, args, session):
3644 """
3645 Get thermal control mode
3646 @param host: string, the hostname or IP address of the bmc
3647 @param args: contains additional arguments used to get the thermal
3648 control mode
3649 @param session: the active session to use
3650 @param args.zone: the zone to get the mode on
3651 @return: Session object
3652 """
3653 url = "https://" + host + "/xyz/openbmc_project/control/thermal/" + \
3654 args.zone
3655
3656 try:
3657 res = session.get(url, headers=jsonHeader, verify=False, timeout=30)
3658 except(requests.exceptions.Timeout):
3659 return(connectionErrHandler(args.json, "Timeout", None))
3660 except(requests.exceptions.ConnectionError) as err:
3661 return connectionErrHandler(args.json, "ConnectionError", err)
3662 except(requests.exceptions.RequestException) as err:
3663 return connectionErrHandler(args.json, "RequestException", err)
3664
3665 if (res.status_code == 404):
3666 return "Thermal control zone(" + args.zone + ") not found or" + \
3667 " system is in a powered off state"
3668
3669 propsDict = json.loads(res.text)
3670 if not propsDict['data']:
3671 return "No thermal control properties found on zone(" + args.zone + ")"
3672 curMode = "Current"
3673 supModes = "Supported"
3674 result = "\n"
3675 for prop in propsDict['data']:
3676 if (prop.casefold() == curMode.casefold()):
3677 result += curMode + " Mode: " + propsDict['data'][curMode] + "\n"
3678 if (prop.casefold() == supModes.casefold()):
3679 s = ", ".join(str(sup) for sup in propsDict['data'][supModes])
3680 result += supModes + " Modes: [ " + s + " ]\n"
3681
3682 return result
3683
3684def setThermalMode(host, args, session):
3685 """
3686 Set thermal control mode
3687 @param host: string, the hostname or IP address of the bmc
3688 @param args: contains additional arguments used for setting the thermal
3689 control mode
3690 @param session: the active session to use
3691 @param args.zone: the zone to set the mode on
3692 @param args.mode: the mode to enable
3693 @return: Session object
3694 """
3695 url = "https://" + host + "/xyz/openbmc_project/control/thermal/" + \
3696 args.zone + "/attr/Current"
3697
3698 # Check args.mode against supported modes using `getThermalMode` output
3699 modes = getThermalMode(host, args, session)
3700 modes = os.linesep.join([m for m in modes.splitlines() if m])
3701 modes = modes.replace("\n", ";").strip()
3702 modesDict = dict(m.split(': ') for m in modes.split(';'))
3703 sModes = ''.join(s for s in modesDict['Supported Modes'] if s not in '[ ]')
3704 if args.mode.casefold() not in \
3705 (m.casefold() for m in sModes.split(',')) or not args.mode:
3706 result = ("Unsupported mode('" + args.mode + "') given, " +
3707 "select a supported mode: \n" +
3708 getThermalMode(host, args, session))
3709 return result
3710
3711 data = '{"data":"' + args.mode + '"}'
3712 try:
3713 res = session.get(url, headers=jsonHeader, verify=False, timeout=30)
3714 except(requests.exceptions.Timeout):
3715 return(connectionErrHandler(args.json, "Timeout", None))
3716 except(requests.exceptions.ConnectionError) as err:
3717 return connectionErrHandler(args.json, "ConnectionError", err)
3718 except(requests.exceptions.RequestException) as err:
3719 return connectionErrHandler(args.json, "RequestException", err)
3720
3721 if (data and res.status_code != 404):
3722 try:
3723 res = session.put(url, headers=jsonHeader,
3724 data=data, verify=False,
3725 timeout=30)
3726 except(requests.exceptions.Timeout):
3727 return(connectionErrHandler(args.json, "Timeout", None))
3728 except(requests.exceptions.ConnectionError) as err:
3729 return connectionErrHandler(args.json, "ConnectionError", err)
3730 except(requests.exceptions.RequestException) as err:
3731 return connectionErrHandler(args.json, "RequestException", err)
3732
3733 if res.status_code == 403:
3734 return "The specified thermal control zone(" + args.zone + ")" + \
3735 " does not exist"
3736
3737 return res.text
3738 else:
3739 return "Setting thermal control mode(" + args.mode + ")" + \
3740 " not supported or operation not available(system powered off?)"
3741
3742
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003743def createCommandParser():
Justin Thalere412dc22018-01-12 16:28:24 -06003744 """
3745 creates the parser for the command line along with help for each command and subcommand
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003746
Justin Thalere412dc22018-01-12 16:28:24 -06003747 @return: returns the parser for the command line
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003748 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003749 parser = argparse.ArgumentParser(description='Process arguments')
Justin Thalere412dc22018-01-12 16:28:24 -06003750 parser.add_argument("-H", "--host", help='A hostname or IP for the BMC')
3751 parser.add_argument("-U", "--user", help='The username to login with')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003752 group = parser.add_mutually_exclusive_group()
3753 group.add_argument("-A", "--askpw", action='store_true', help='prompt for password')
3754 group.add_argument("-P", "--PW", help='Provide the password in-line')
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05003755 group.add_argument("-E", "--PWenvvar", action='store_true', help='Get password from envvar OPENBMCTOOL_PASSWORD')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003756 parser.add_argument('-j', '--json', action='store_true', help='output json data only')
3757 parser.add_argument('-t', '--policyTableLoc', help='The location of the policy table to parse alerts')
3758 parser.add_argument('-c', '--CerFormat', action='store_true', help=argparse.SUPPRESS)
3759 parser.add_argument('-T', '--procTime', action='store_true', help= argparse.SUPPRESS)
Justin Thalere412dc22018-01-12 16:28:24 -06003760 parser.add_argument('-V', '--version', action='store_true', help='Display the version number of the openbmctool')
3761 subparsers = parser.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003762
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003763 #fru command
3764 parser_inv = subparsers.add_parser("fru", help='Work with platform inventory')
Justin Thalere412dc22018-01-12 16:28:24 -06003765 inv_subparser = parser_inv.add_subparsers(title='subcommands', description='valid inventory actions', help="valid inventory actions", dest='command')
Justin Thaler53bf2f12018-07-16 14:05:32 -05003766 inv_subparser.required = True
3767 #fru print
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003768 inv_print = inv_subparser.add_parser("print", help="prints out a list of all FRUs")
3769 inv_print.set_defaults(func=fruPrint)
3770 #fru list [0....n]
3771 inv_list = inv_subparser.add_parser("list", help="print out details on selected FRUs. Specifying no items will list the entire inventory")
3772 inv_list.add_argument('items', nargs='?', help="print out details on selected FRUs. Specifying no items will list the entire inventory")
3773 inv_list.set_defaults(func=fruList)
3774 #fru status
3775 inv_status = inv_subparser.add_parser("status", help="prints out the status of all FRUs")
Justin Thalere412dc22018-01-12 16:28:24 -06003776 inv_status.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003777 inv_status.set_defaults(func=fruStatus)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003778
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003779 #sensors command
3780 parser_sens = subparsers.add_parser("sensors", help="Work with platform sensors")
Justin Thalere412dc22018-01-12 16:28:24 -06003781 sens_subparser=parser_sens.add_subparsers(title='subcommands', description='valid sensor actions', help='valid sensor actions', dest='command')
Justin Thaler53bf2f12018-07-16 14:05:32 -05003782 sens_subparser.required = True
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003783 #sensor print
3784 sens_print= sens_subparser.add_parser('print', help="prints out a list of all Sensors.")
3785 sens_print.set_defaults(func=sensor)
3786 #sensor list[0...n]
3787 sens_list=sens_subparser.add_parser("list", help="Lists all Sensors in the platform. Specify a sensor for full details. ")
3788 sens_list.add_argument("sensNum", nargs='?', help="The Sensor number to get full details on" )
3789 sens_list.set_defaults(func=sensor)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003790
Matthew Barth368e83c2019-02-01 13:48:25 -06003791 #thermal control commands
3792 parser_therm = subparsers.add_parser("thermal", help="Work with thermal control parameters")
3793 therm_subparser=parser_therm.add_subparsers(title='subcommands', description='Thermal control actions to work with', help='Valid thermal control actions to work with', dest='command')
3794 #thermal control zones
3795 parser_thermZones = therm_subparser.add_parser("zones", help="Get a list of available thermal control zones")
3796 parser_thermZones.set_defaults(func=getThermalZones)
3797 #thermal control modes
3798 parser_thermMode = therm_subparser.add_parser("modes", help="Work with thermal control modes")
3799 thermMode_sub = parser_thermMode.add_subparsers(title='subactions', description='Work with thermal control modes', help="Work with thermal control modes")
3800 #get thermal control mode
3801 parser_getThermMode = thermMode_sub.add_parser("get", help="Get current and supported thermal control modes")
3802 parser_getThermMode.add_argument('-z', '--zone', required=True, help='Thermal zone to work with')
3803 parser_getThermMode.set_defaults(func=getThermalMode)
3804 #set thermal control mode
3805 parser_setThermMode = thermMode_sub.add_parser("set", help="Set the thermal control mode")
3806 parser_setThermMode.add_argument('-z', '--zone', required=True, help='Thermal zone to work with')
3807 parser_setThermMode.add_argument('-m', '--mode', required=True, help='The supported thermal control mode')
3808 parser_setThermMode.set_defaults(func=setThermalMode)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003809
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003810 #sel command
3811 parser_sel = subparsers.add_parser("sel", help="Work with platform alerts")
Justin Thalere412dc22018-01-12 16:28:24 -06003812 sel_subparser = parser_sel.add_subparsers(title='subcommands', description='valid SEL actions', help = 'valid SEL actions', dest='command')
Justin Thaler53bf2f12018-07-16 14:05:32 -05003813 sel_subparser.required = True
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003814 #sel print
3815 sel_print = sel_subparser.add_parser("print", help="prints out a list of all sels in a condensed list")
3816 sel_print.add_argument('-d', '--devdebug', action='store_true', help=argparse.SUPPRESS)
3817 sel_print.add_argument('-v', '--verbose', action='store_true', help="Changes the output to being very verbose")
3818 sel_print.add_argument('-f', '--fileloc', help='Parse a file instead of the BMC output')
3819 sel_print.set_defaults(func=selPrint)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003820
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003821 #sel list
3822 sel_list = sel_subparser.add_parser("list", help="Lists all SELs in the platform. Specifying a specific number will pull all the details for that individual SEL")
3823 sel_list.add_argument("selNum", nargs='?', type=int, help="The SEL entry to get details on")
3824 sel_list.set_defaults(func=selList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003825
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003826 sel_get = sel_subparser.add_parser("get", help="Gets the verbose details of a specified SEL entry")
3827 sel_get.add_argument('selNum', type=int, help="the number of the SEL entry to get")
3828 sel_get.set_defaults(func=selList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003829
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003830 sel_clear = sel_subparser.add_parser("clear", help="Clears all entries from the SEL")
3831 sel_clear.set_defaults(func=selClear)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003832
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003833 sel_setResolved = sel_subparser.add_parser("resolve", help="Sets the sel entry to resolved")
Justin Thalere412dc22018-01-12 16:28:24 -06003834 sel_setResolved.add_argument('-n', '--selNum', type=int, help="the number of the SEL entry to resolve")
3835 sel_ResolveAll_sub = sel_setResolved.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
3836 sel_ResolveAll = sel_ResolveAll_sub.add_parser('all', help='Resolve all SEL entries')
3837 sel_ResolveAll.set_defaults(func=selResolveAll)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003838 sel_setResolved.set_defaults(func=selSetResolved)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003839
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003840 parser_chassis = subparsers.add_parser("chassis", help="Work with chassis power and status")
Justin Thalere412dc22018-01-12 16:28:24 -06003841 chas_sub = parser_chassis.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003842
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003843 parser_chassis.add_argument('status', action='store_true', help='Returns the current status of the platform')
3844 parser_chassis.set_defaults(func=chassis)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003845
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003846 parser_chasPower = chas_sub.add_parser("power", help="Turn the chassis on or off, check the power state")
Justin Thalere412dc22018-01-12 16:28:24 -06003847 parser_chasPower.add_argument('powcmd', choices=['on','softoff', 'hardoff', 'status'], help='The value for the power command. on, off, or status')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003848 parser_chasPower.set_defaults(func=chassisPower)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003849
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003850 #control the chassis identify led
3851 parser_chasIdent = chas_sub.add_parser("identify", help="Control the chassis identify led")
3852 parser_chasIdent.add_argument('identcmd', choices=['on', 'off', 'status'], help='The control option for the led: on, off, blink, status')
3853 parser_chasIdent.set_defaults(func=chassisIdent)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003854
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003855 #collect service data
3856 parser_servData = subparsers.add_parser("collect_service_data", help="Collect all bmc data needed for service")
3857 parser_servData.add_argument('-d', '--devdebug', action='store_true', help=argparse.SUPPRESS)
3858 parser_servData.set_defaults(func=collectServiceData)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003859
Justin Thalere412dc22018-01-12 16:28:24 -06003860 #system quick health check
3861 parser_healthChk = subparsers.add_parser("health_check", help="Work with platform sensors")
3862 parser_healthChk.set_defaults(func=healthCheck)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003863
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003864 #work with bmc dumps
3865 parser_bmcdump = subparsers.add_parser("dump", help="Work with bmc dump files")
Justin Thalere412dc22018-01-12 16:28:24 -06003866 bmcDump_sub = parser_bmcdump.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thaler53bf2f12018-07-16 14:05:32 -05003867 bmcDump_sub.required = True
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003868 dump_Create = bmcDump_sub.add_parser('create', help="Create a bmc dump")
3869 dump_Create.set_defaults(func=bmcDumpCreate)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003870
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003871 dump_list = bmcDump_sub.add_parser('list', help="list all bmc dump files")
3872 dump_list.set_defaults(func=bmcDumpList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003873
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003874 parserdumpdelete = bmcDump_sub.add_parser('delete', help="Delete bmc dump files")
3875 parserdumpdelete.add_argument("-n", "--dumpNum", nargs='*', type=int, help="The Dump entry to delete")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003876 parserdumpdelete.set_defaults(func=bmcDumpDelete)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003877
Justin Thalere412dc22018-01-12 16:28:24 -06003878 bmcDumpDelsub = parserdumpdelete.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003879 deleteAllDumps = bmcDumpDelsub.add_parser('all', help='Delete all bmc dump files')
3880 deleteAllDumps.set_defaults(func=bmcDumpDeleteAll)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003881
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003882 parser_dumpretrieve = bmcDump_sub.add_parser('retrieve', help='Retrieve a dump file')
3883 parser_dumpretrieve.add_argument("dumpNum", type=int, help="The Dump entry to delete")
3884 parser_dumpretrieve.add_argument("-s", "--dumpSaveLoc", help="The location to save the bmc dump file")
3885 parser_dumpretrieve.set_defaults(func=bmcDumpRetrieve)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003886
Justin Thaler22b1bb52018-03-15 13:31:32 -05003887 #bmc command for reseting the bmc
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003888 parser_bmc = subparsers.add_parser('bmc', help="Work with the bmc")
Justin Thalere412dc22018-01-12 16:28:24 -06003889 bmc_sub = parser_bmc.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003890 parser_BMCReset = bmc_sub.add_parser('reset', help='Reset the bmc' )
3891 parser_BMCReset.add_argument('type', choices=['warm','cold'], help="Warm: Reboot the BMC, Cold: CLEAR config and reboot bmc")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003892 parser_bmc.add_argument('info', action='store_true', help="Displays information about the BMC hardware, including device revision, firmware revision, IPMI version supported, manufacturer ID, and information on additional device support.")
3893 parser_bmc.set_defaults(func=bmc)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003894
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003895 #add alias to the bmc command
3896 parser_mc = subparsers.add_parser('mc', help="Work with the management controller")
Justin Thalere412dc22018-01-12 16:28:24 -06003897 mc_sub = parser_mc.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003898 parser_MCReset = mc_sub.add_parser('reset', help='Reset the bmc' )
3899 parser_MCReset.add_argument('type', choices=['warm','cold'], help="Reboot the BMC")
3900 #parser_MCReset.add_argument('cold', action='store_true', help="Reboot the BMC and CLEAR the configuration")
3901 parser_mc.add_argument('info', action='store_true', help="Displays information about the BMC hardware, including device revision, firmware revision, IPMI version supported, manufacturer ID, and information on additional device support.")
Justin Thalere412dc22018-01-12 16:28:24 -06003902 parser_MCReset.set_defaults(func=bmcReset)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003903 parser_mc.set_defaults(func=bmc)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003904
Justin Thalere412dc22018-01-12 16:28:24 -06003905 #gard clear
3906 parser_gc = subparsers.add_parser("gardclear", help="Used to clear gard records")
3907 parser_gc.set_defaults(func=gardClear)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003908
Justin Thalere412dc22018-01-12 16:28:24 -06003909 #firmware_flash
3910 parser_fw = subparsers.add_parser("firmware", help="Work with the system firmware")
3911 fwflash_subproc = parser_fw.add_subparsers(title='subcommands', description='valid firmware commands', help='sub-command help', dest='command')
Justin Thaler53bf2f12018-07-16 14:05:32 -05003912 fwflash_subproc.required = True
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003913
Justin Thalere412dc22018-01-12 16:28:24 -06003914 fwflash = fwflash_subproc.add_parser('flash', help="Flash the system firmware")
3915 fwflash.add_argument('type', choices=['bmc', 'pnor'], help="image type to flash")
3916 fwflash.add_argument('-f', '--fileloc', required=True, help="The absolute path to the firmware image")
3917 fwflash.set_defaults(func=fwFlash)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003918
Justin Thaler22b1bb52018-03-15 13:31:32 -05003919 fwActivate = fwflash_subproc.add_parser('activate', help="Activate existing image on the bmc")
Justin Thalere412dc22018-01-12 16:28:24 -06003920 fwActivate.add_argument('imageID', help="The image ID to activate from the firmware list. Ex: 63c95399")
3921 fwActivate.set_defaults(func=activateFWImage)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003922
Justin Thaler22b1bb52018-03-15 13:31:32 -05003923 fwActivateStatus = fwflash_subproc.add_parser('activation_status', help="Check Status of activations")
3924 fwActivateStatus.set_defaults(func=activateStatus)
3925
Justin Thaler3d71d402018-07-24 14:35:39 -05003926 fwList = fwflash_subproc.add_parser('list', help="List all of the installed firmware")
3927 fwList.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
3928 fwList.set_defaults(func=firmwareList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003929
Justin Thaler3d71d402018-07-24 14:35:39 -05003930 fwprint = fwflash_subproc.add_parser('print', help="List all of the installed firmware")
3931 fwprint.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
3932 fwprint.set_defaults(func=firmwareList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003933
Adriana Kobylak5af2fad2018-11-08 12:33:43 -06003934 fwDelete = fwflash_subproc.add_parser('delete', help="Delete an existing firmware version")
3935 fwDelete.add_argument('versionID', help="The version ID to delete from the firmware list. Ex: 63c95399")
3936 fwDelete.set_defaults(func=deleteFWVersion)
3937
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05003938 #logging
3939 parser_logging = subparsers.add_parser("logging", help="logging controls")
3940 logging_sub = parser_logging.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003941
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05003942 #turn rest api logging on/off
3943 parser_rest_logging = logging_sub.add_parser("rest_api", help="turn rest api logging on/off")
3944 parser_rest_logging.add_argument('rest_logging', choices=['on', 'off'], help='The control option for rest logging: on, off')
3945 parser_rest_logging.set_defaults(func=restLogging)
Deepak Kodihalli02d53282018-09-18 06:53:31 -05003946
3947 #remote logging
3948 parser_remote_logging = logging_sub.add_parser("remote_logging", help="Remote logging (rsyslog) commands")
3949 parser_remote_logging.add_argument('remote_logging', choices=['view', 'disable'], help='Remote logging (rsyslog) commands')
3950 parser_remote_logging.set_defaults(func=remoteLogging)
3951
3952 #configure remote logging
3953 parser_remote_logging_config = logging_sub.add_parser("remote_logging_config", help="Configure remote logging (rsyslog)")
3954 parser_remote_logging_config.add_argument("-a", "--address", required=True, help="Set IP address of rsyslog server")
3955 parser_remote_logging_config.add_argument("-p", "--port", required=True, type=int, help="Set Port of rsyslog server")
3956 parser_remote_logging_config.set_defaults(func=remoteLoggingConfig)
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05003957
3958 #certificate management
3959 parser_cert = subparsers.add_parser("certificate", help="Certificate management")
3960 certMgmt_subproc = parser_cert.add_subparsers(title='subcommands', description='valid certificate commands', help='sub-command help', dest='command')
3961
3962 certUpdate = certMgmt_subproc.add_parser('update', help="Update the certificate")
3963 certUpdate.add_argument('type', choices=['server', 'client', 'authority'], help="certificate type to update")
3964 certUpdate.add_argument('service', choices=['https', 'ldap'], help="Service to update")
3965 certUpdate.add_argument('-f', '--fileloc', required=True, help="The absolute path to the certificate file")
3966 certUpdate.set_defaults(func=certificateUpdate)
3967
3968 certDelete = certMgmt_subproc.add_parser('delete', help="Delete the certificate")
3969 certDelete.add_argument('type', choices=['server', 'client', 'authority'], help="certificate type to delete")
3970 certDelete.add_argument('service', choices=['https', 'ldap'], help="Service to delete the certificate")
3971 certDelete.set_defaults(func=certificateDelete)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003972
Marri Devender Raodfe81ad2019-07-01 05:38:09 -05003973 certReplace = certMgmt_subproc.add_parser('replace',
3974 help="Replace the certificate")
3975 certReplace.add_argument('type', choices=['server', 'client', 'authority'],
3976 help="certificate type to replace")
3977 certReplace.add_argument('service', choices=['https', 'ldap'],
3978 help="Service to replace the certificate")
3979 certReplace.add_argument('-f', '--fileloc', required=True,
3980 help="The absolute path to the certificate file")
3981 certReplace.set_defaults(func=certificateReplace)
3982
Matt Spinler7d426c22018-09-24 14:42:07 -05003983 # local users
3984 parser_users = subparsers.add_parser("local_users", help="Work with local users")
3985 parser_users.add_argument('local_users', choices=['disableall','enableall', 'queryenabled'], help="Disable, enable or query local user accounts")
3986 parser_users.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
3987 parser_users.set_defaults(func=localUsers)
3988
Ratan Gupta9166cd22018-10-01 18:09:40 +05303989 #LDAP
3990 parser_ldap = subparsers.add_parser("ldap", help="LDAP controls")
3991 ldap_sub = parser_ldap.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
3992
3993 #configure and enable LDAP
3994 parser_ldap_config = ldap_sub.add_parser("enable", help="Configure and enables the LDAP")
3995 parser_ldap_config.add_argument("-a", "--uri", required=True, help="Set LDAP server URI")
3996 parser_ldap_config.add_argument("-B", "--bindDN", required=True, help="Set the bind DN of the LDAP server")
3997 parser_ldap_config.add_argument("-b", "--baseDN", required=True, help="Set the base DN of the LDAP server")
3998 parser_ldap_config.add_argument("-p", "--bindPassword", required=True, help="Set the bind password of the LDAP server")
3999 parser_ldap_config.add_argument("-S", "--scope", choices=['sub','one', 'base'],
4000 help='Specifies the search scope:subtree, one level or base object.')
4001 parser_ldap_config.add_argument("-t", "--serverType", choices=['ActiveDirectory','OpenLDAP'],
4002 help='Specifies the configured server is ActiveDirectory(AD) or OpenLdap')
4003 parser_ldap_config.set_defaults(func=enableLDAP)
4004
4005 # disable LDAP
4006 parser_disable_ldap = ldap_sub.add_parser("disable", help="disables the LDAP")
4007 parser_disable_ldap.set_defaults(func=disableLDAP)
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06004008 # view-config
4009 parser_ldap_config = \
4010 ldap_sub.add_parser("view-config", help="prints out a list of all \
4011 LDAPS's configured properties")
4012 parser_ldap_config.set_defaults(func=viewLDAPConfig)
Ratan Gupta9166cd22018-10-01 18:09:40 +05304013
Ratan Guptafeee6372018-10-17 23:25:51 +05304014 #create group privilege mapping
4015 parser_ldap_mapper = ldap_sub.add_parser("privilege-mapper", help="LDAP group privilege controls")
4016 parser_ldap_mapper_sub = parser_ldap_mapper.add_subparsers(title='subcommands', description='valid subcommands',
4017 help="sub-command help", dest='command')
4018
4019 parser_ldap_mapper_create = parser_ldap_mapper_sub.add_parser("create", help="Create mapping of ldap group and privilege")
4020 parser_ldap_mapper_create.add_argument("-g","--groupName",required=True,help="Group Name")
4021 parser_ldap_mapper_create.add_argument("-p","--privilege",choices=['priv-admin','priv-user'],required=True,help="Privilege")
4022 parser_ldap_mapper_create.set_defaults(func=createPrivilegeMapping)
4023
4024 #list group privilege mapping
4025 parser_ldap_mapper_list = parser_ldap_mapper_sub.add_parser("list",help="List privilege mapping")
4026 parser_ldap_mapper_list.set_defaults(func=listPrivilegeMapping)
4027
4028 #delete group privilege mapping
4029 parser_ldap_mapper_delete = parser_ldap_mapper_sub.add_parser("delete",help="Delete privilege mapping")
4030 parser_ldap_mapper_delete.add_argument("-g","--groupName",required=True,help="Group Name")
4031 parser_ldap_mapper_delete.set_defaults(func=deletePrivilegeMapping)
4032
Sivas SRR78835272018-11-27 05:27:19 -06004033 #deleteAll group privilege mapping
4034 parser_ldap_mapper_delete = parser_ldap_mapper_sub.add_parser("purge",help="Delete All privilege mapping")
4035 parser_ldap_mapper_delete.set_defaults(func=deleteAllPrivilegeMapping)
4036
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06004037 # set local user password
4038 parser_set_password = subparsers.add_parser("set_password",
4039 help="Set password of local user")
4040 parser_set_password.add_argument( "-p", "--password", required=True,
4041 help="Password of local user")
4042 parser_set_password.set_defaults(func=setPassword)
4043
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004044 # network
4045 parser_nw = subparsers.add_parser("network", help="network controls")
4046 nw_sub = parser_nw.add_subparsers(title='subcommands',
4047 description='valid subcommands',
4048 help="sub-command help",
4049 dest='command')
4050
4051 # enable DHCP
4052 parser_enable_dhcp = nw_sub.add_parser("enableDHCP",
4053 help="enables the DHCP on given "
4054 "Interface")
4055 parser_enable_dhcp.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004056 help="Name of the ethernet interface(it can"
4057 "be obtained by the "
4058 "command:network view-config)"
4059 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004060 parser_enable_dhcp.set_defaults(func=enableDHCP)
4061
4062 # disable DHCP
4063 parser_disable_dhcp = nw_sub.add_parser("disableDHCP",
4064 help="disables the DHCP on given "
4065 "Interface")
4066 parser_disable_dhcp.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004067 help="Name of the ethernet interface(it can"
4068 "be obtained by the "
4069 "command:network view-config)"
4070 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004071 parser_disable_dhcp.set_defaults(func=disableDHCP)
4072
4073 # get HostName
4074 parser_gethostname = nw_sub.add_parser("getHostName",
4075 help="prints out HostName")
4076 parser_gethostname.set_defaults(func=getHostname)
4077
4078 # set HostName
4079 parser_sethostname = nw_sub.add_parser("setHostName", help="sets HostName")
4080 parser_sethostname.add_argument("-H", "--HostName", required=True,
4081 help="A HostName for the BMC")
4082 parser_sethostname.set_defaults(func=setHostname)
4083
4084 # get domainname
4085 parser_getdomainname = nw_sub.add_parser("getDomainName",
4086 help="prints out DomainName of "
4087 "given Interface")
4088 parser_getdomainname.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004089 help="Name of the ethernet interface(it "
4090 "can be obtained by the "
4091 "command:network view-config)"
4092 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004093 parser_getdomainname.set_defaults(func=getDomainName)
4094
4095 # set domainname
4096 parser_setdomainname = nw_sub.add_parser("setDomainName",
4097 help="sets DomainName of given "
4098 "Interface")
4099 parser_setdomainname.add_argument("-D", "--DomainName", required=True,
4100 help="Ex: DomainName=Domain1,Domain2,...")
4101 parser_setdomainname.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004102 help="Name of the ethernet interface(it "
4103 "can be obtained by the "
4104 "command:network view-config)"
4105 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004106 parser_setdomainname.set_defaults(func=setDomainName)
4107
4108 # get MACAddress
4109 parser_getmacaddress = nw_sub.add_parser("getMACAddress",
4110 help="prints out MACAddress the "
4111 "given Interface")
4112 parser_getmacaddress.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004113 help="Name of the ethernet interface(it "
4114 "can be obtained by the "
4115 "command:network view-config)"
4116 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004117 parser_getmacaddress.set_defaults(func=getMACAddress)
4118
4119 # set MACAddress
4120 parser_setmacaddress = nw_sub.add_parser("setMACAddress",
4121 help="sets MACAddress")
4122 parser_setmacaddress.add_argument("-MA", "--MACAddress", required=True,
4123 help="A MACAddress for the given "
4124 "Interface")
4125 parser_setmacaddress.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004126 help="Name of the ethernet interface(it can"
4127 "be obtained by the "
4128 "command:network view-config)"
4129 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004130 parser_setmacaddress.set_defaults(func=setMACAddress)
4131
4132 # get DefaultGW
4133 parser_getdefaultgw = nw_sub.add_parser("getDefaultGW",
4134 help="prints out DefaultGateway "
4135 "the BMC")
4136 parser_getdefaultgw.set_defaults(func=getDefaultGateway)
4137
4138 # set DefaultGW
4139 parser_setdefaultgw = nw_sub.add_parser("setDefaultGW",
4140 help="sets DefaultGW")
4141 parser_setdefaultgw.add_argument("-GW", "--DefaultGW", required=True,
4142 help="A DefaultGateway for the BMC")
4143 parser_setdefaultgw.set_defaults(func=setDefaultGateway)
4144
4145 # view network Config
4146 parser_ldap_config = nw_sub.add_parser("view-config", help="prints out a "
4147 "list of all network's configured "
4148 "properties")
4149 parser_ldap_config.set_defaults(func=viewNWConfig)
4150
4151 # get DNS
4152 parser_getDNS = nw_sub.add_parser("getDNS",
4153 help="prints out DNS servers on the "
4154 "given interface")
4155 parser_getDNS.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004156 help="Name of the ethernet interface(it can"
4157 "be obtained by the "
4158 "command:network view-config)"
4159 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004160 parser_getDNS.set_defaults(func=getDNS)
4161
4162 # set DNS
4163 parser_setDNS = nw_sub.add_parser("setDNS",
4164 help="sets DNS servers on the given "
4165 "interface")
4166 parser_setDNS.add_argument("-d", "--DNSServers", required=True,
4167 help="Ex: DNSSERVERS=DNS1,DNS2,...")
4168 parser_setDNS.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004169 help="Name of the ethernet interface(it can"
4170 "be obtained by the "
4171 "command:network view-config)"
4172 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004173 parser_setDNS.set_defaults(func=setDNS)
4174
4175 # get NTP
4176 parser_getNTP = nw_sub.add_parser("getNTP",
4177 help="prints out NTP servers on the "
4178 "given interface")
4179 parser_getNTP.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004180 help="Name of the ethernet interface(it can"
4181 "be obtained by the "
4182 "command:network view-config)"
4183 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004184 parser_getNTP.set_defaults(func=getNTP)
4185
4186 # set NTP
4187 parser_setNTP = nw_sub.add_parser("setNTP",
4188 help="sets NTP servers on the given "
4189 "interface")
4190 parser_setNTP.add_argument("-N", "--NTPServers", required=True,
4191 help="Ex: NTPSERVERS=NTP1,NTP2,...")
4192 parser_setNTP.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004193 help="Name of the ethernet interface(it can"
4194 "be obtained by the "
4195 "command:network view-config)"
4196 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004197 parser_setNTP.set_defaults(func=setNTP)
4198
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004199 # configure IP
4200 parser_ip_config = nw_sub.add_parser("addIP", help="Sets IP address to"
4201 "given interface")
4202 parser_ip_config.add_argument("-a", "--address", required=True,
4203 help="IP address of given interface")
4204 parser_ip_config.add_argument("-gw", "--gateway", required=False, default='',
4205 help="The gateway for given interface")
4206 parser_ip_config.add_argument("-l", "--prefixLength", required=True,
4207 help="The prefixLength of IP address")
4208 parser_ip_config.add_argument("-p", "--type", choices=['ipv4', 'ipv6'],
4209 help="The protocol type of the given"
4210 "IP address")
4211 parser_ip_config.add_argument("-I", "--Interface", required=True,
4212 help="Name of the ethernet interface(it can"
4213 "be obtained by the "
4214 "command:network view-config)"
4215 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4216 parser_ip_config.set_defaults(func=addIP)
4217
4218 # getIP
4219 parser_getIP = nw_sub.add_parser("getIP", help="prints out IP address"
4220 "of given interface")
4221 parser_getIP.add_argument("-I", "--Interface", required=True,
4222 help="Name of the ethernet interface(it can"
4223 "be obtained by the command:network view-config)"
4224 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4225 parser_getIP.set_defaults(func=getIP)
4226
4227 # rmIP
4228 parser_rmIP = nw_sub.add_parser("rmIP", help="deletes IP address"
4229 "of given interface")
4230 parser_rmIP.add_argument("-a", "--address", required=True,
4231 help="IP address to remove form given Interface")
4232 parser_rmIP.add_argument("-I", "--Interface", required=True,
4233 help="Name of the ethernet interface(it can"
4234 "be obtained by the command:network view-config)"
4235 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4236 parser_rmIP.set_defaults(func=deleteIP)
4237
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06004238 # add VLAN
4239 parser_create_vlan = nw_sub.add_parser("addVLAN", help="enables VLAN "
4240 "on given interface with given "
4241 "VLAN Identifier")
4242 parser_create_vlan.add_argument("-I", "--Interface", required=True,
4243 choices=['eth0', 'eth1'],
4244 help="Name of the ethernet interface")
4245 parser_create_vlan.add_argument("-n", "--Identifier", required=True,
4246 help="VLAN Identifier")
4247 parser_create_vlan.set_defaults(func=addVLAN)
4248
4249 # delete VLAN
4250 parser_delete_vlan = nw_sub.add_parser("deleteVLAN", help="disables VLAN "
4251 "on given interface with given "
4252 "VLAN Identifier")
4253 parser_delete_vlan.add_argument("-I", "--Interface", required=True,
4254 help="Name of the ethernet interface(it can"
4255 "be obtained by the "
4256 "command:network view-config)"
4257 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4258 parser_delete_vlan.set_defaults(func=deleteVLAN)
4259
4260 # viewDHCPConfig
4261 parser_viewDHCPConfig = nw_sub.add_parser("viewDHCPConfig",
4262 help="Shows DHCP configured "
4263 "Properties")
4264 parser_viewDHCPConfig.set_defaults(func=viewDHCPConfig)
4265
4266 # configureDHCP
4267 parser_configDHCP = nw_sub.add_parser("configureDHCP",
4268 help="Configures/updates DHCP "
4269 "Properties")
4270 parser_configDHCP.add_argument("-d", "--DNSEnabled", type=str2bool,
4271 required=True, help="Sets DNSEnabled property")
4272 parser_configDHCP.add_argument("-n", "--HostNameEnabled", type=str2bool,
4273 required=True,
4274 help="Sets HostNameEnabled property")
4275 parser_configDHCP.add_argument("-t", "--NTPEnabled", type=str2bool,
4276 required=True,
4277 help="Sets NTPEnabled property")
4278 parser_configDHCP.add_argument("-s", "--SendHostNameEnabled", type=str2bool,
4279 required=True,
4280 help="Sets SendHostNameEnabled property")
4281 parser_configDHCP.set_defaults(func=configureDHCP)
4282
4283 # network factory reset
4284 parser_nw_reset = nw_sub.add_parser("nwReset",
4285 help="Resets networks setting to "
4286 "factory defaults. "
4287 "note:Reset settings will be applied "
4288 "after BMC reboot")
4289 parser_nw_reset.set_defaults(func=nwReset)
4290
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004291 return parser
4292
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004293def main(argv=None):
Justin Thalere412dc22018-01-12 16:28:24 -06004294 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004295 main function for running the command line utility as a sub application
4296 """
4297 global toolVersion
Marri Devender Rao82590dc2019-06-06 04:54:22 -05004298 toolVersion = "1.15"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004299 parser = createCommandParser()
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004300 args = parser.parse_args(argv)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004301
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004302 totTimeStart = int(round(time.time()*1000))
4303
4304 if(sys.version_info < (3,0)):
4305 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
4306 if sys.version_info >= (3,0):
4307 requests.packages.urllib3.disable_warnings(requests.packages.urllib3.exceptions.InsecureRequestWarning)
Justin Thalere412dc22018-01-12 16:28:24 -06004308 if (args.version):
Justin Thaler22b1bb52018-03-15 13:31:32 -05004309 print("Version: "+ toolVersion)
Justin Thalere412dc22018-01-12 16:28:24 -06004310 sys.exit(0)
4311 if (hasattr(args, 'fileloc') and args.fileloc is not None and 'print' in args.command):
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004312 mysess = None
Justin Thalere412dc22018-01-12 16:28:24 -06004313 print(selPrint('N/A', args, mysess))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004314 else:
Justin Thalere412dc22018-01-12 16:28:24 -06004315 if(hasattr(args, 'host') and hasattr(args,'user')):
4316 if (args.askpw):
4317 pw = getpass.getpass()
4318 elif(args.PW is not None):
4319 pw = args.PW
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05004320 elif(args.PWenvvar):
4321 pw = os.environ['OPENBMCTOOL_PASSWORD']
Justin Thalere412dc22018-01-12 16:28:24 -06004322 else:
4323 print("You must specify a password")
4324 sys.exit()
4325 logintimeStart = int(round(time.time()*1000))
4326 mysess = login(args.host, args.user, pw, args.json)
Justin Thalera9415b42018-05-25 19:40:13 -05004327 if(sys.version_info < (3,0)):
4328 if isinstance(mysess, basestring):
4329 print(mysess)
4330 sys.exit(1)
4331 elif sys.version_info >= (3,0):
4332 if isinstance(mysess, str):
4333 print(mysess)
4334 sys.exit(1)
Justin Thalere412dc22018-01-12 16:28:24 -06004335 logintimeStop = int(round(time.time()*1000))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004336
4337 commandTimeStart = int(round(time.time()*1000))
Justin Thalere412dc22018-01-12 16:28:24 -06004338 output = args.func(args.host, args, mysess)
4339 commandTimeStop = int(round(time.time()*1000))
Justin Thaler761484a2019-03-26 19:20:23 -05004340 if isinstance(output, dict):
4341 print(json.dumps(output, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False))
4342 else:
4343 print(output)
Justin Thalere412dc22018-01-12 16:28:24 -06004344 if (mysess is not None):
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004345 logout(args.host, args.user, pw, mysess, args.json)
4346 if(args.procTime):
Justin Thalere412dc22018-01-12 16:28:24 -06004347 print("Total time: " + str(int(round(time.time()*1000))- totTimeStart))
4348 print("loginTime: " + str(logintimeStop - logintimeStart))
4349 print("command Time: " + str(commandTimeStop - commandTimeStart))
4350 else:
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05004351 print("usage:\n"
4352 " OPENBMCTOOL_PASSWORD=secret # if using -E\n"
4353 " openbmctool.py [-h] -H HOST -U USER {-A | -P PW | -E} [-j]\n" +
Justin Thalere412dc22018-01-12 16:28:24 -06004354 "\t[-t POLICYTABLELOC] [-V]\n" +
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05004355 "\t{fru,sensors,sel,chassis,collect_service_data, \
4356 health_check,dump,bmc,mc,gardclear,firmware,logging}\n" +
Justin Thalere412dc22018-01-12 16:28:24 -06004357 "\t...\n" +
4358 "openbmctool.py: error: the following arguments are required: -H/--host, -U/--user")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004359 sys.exit()
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004360
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004361if __name__ == '__main__':
Justin Thalere412dc22018-01-12 16:28:24 -06004362 """
4363 main function when called from the command line
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004364
4365 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004366 import sys
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004367
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004368 isTTY = sys.stdout.isatty()
4369 assert sys.version_info >= (2,7)
4370 main()