blob: 225d97ef75a83e101480f34f33580863ee03573f [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
Marri Devender Rao34646402019-07-01 05:46:03 -05002649def certificateDisplay(host, args, session):
2650 """
2651 Called by certificate management function. display server/client/
2652 authority certificates
2653 Example:
2654 certificate display server
2655 certificate display authority
2656 certificate display client
2657 @param host: string, the hostname or IP address of the bmc
2658 @param args: contains additional arguments used by the certificate
2659 display sub command
2660 @param session: the active session to use
2661 """
2662 if not redfishSupportPresent(host, session):
2663 return "Not supported";
2664
2665 httpHeader = {'Content-Type': 'application/octet-stream'}
2666 httpHeader.update(xAuthHeader)
2667 if(args.type.lower() == 'server'):
2668 url = "https://" + host + \
2669 "/redfish/v1/Managers/bmc/NetworkProtocol/HTTPS/Certificates/1"
2670 elif(args.type.lower() == 'client'):
2671 url = "https://" + host + \
2672 "/redfish/v1/AccountService/LDAP/Certificates/1"
2673 elif(args.type.lower() == 'authority'):
2674 url = "https://" + host + \
2675 "/redfish/v1/Managers/bmc/Truststore/Certificates/1"
2676 try:
2677 resp = session.get(url, headers=httpHeader, verify=False)
2678 except(requests.exceptions.Timeout):
2679 return(connectionErrHandler(args.json, "Timeout", None))
2680 except(requests.exceptions.ConnectionError) as err:
2681 return connectionErrHandler(args.json, "ConnectionError", err)
2682 if resp.status_code != 200:
2683 print(resp.text)
2684 return "Failed to display the certificate"
2685 else:
2686 print("Display complete.")
2687 return resp.text
2688
Ratan Gupta9166cd22018-10-01 18:09:40 +05302689def enableLDAP(host, args, session):
2690 """
2691 Called by the ldap function. Configures LDAP.
2692
2693 @param host: string, the hostname or IP address of the bmc
2694 @param args: contains additional arguments used by the ldap subcommand
2695 @param session: the active session to use
2696 @param args.json: boolean, if this flag is set to true, the output will
2697 be provided in json format for programmatic consumption
2698 """
2699
2700 url='https://'+host+'/xyz/openbmc_project/user/ldap/action/CreateConfig'
Ratan Gupta9166cd22018-10-01 18:09:40 +05302701 scope = {
2702 'sub' : 'xyz.openbmc_project.User.Ldap.Create.SearchScope.sub',
2703 'one' : 'xyz.openbmc_project.User.Ldap.Create.SearchScope.one',
2704 'base': 'xyz.openbmc_project.User.Ldap.Create.SearchScope.base'
2705 }
2706
2707 serverType = {
2708 'ActiveDirectory' : 'xyz.openbmc_project.User.Ldap.Create.Type.ActiveDirectory',
2709 'OpenLDAP' : 'xyz.openbmc_project.User.Ldap.Create.Type.OpenLdap'
2710 }
2711
2712 data = {"data": [args.uri, args.bindDN, args.baseDN, args.bindPassword, scope[args.scope], serverType[args.serverType]]}
2713
2714 try:
Justin Thaler27197622019-01-23 14:42:11 -06002715 res = session.post(url, headers=jsonHeader, json=data, verify=False, timeout=baseTimeout)
Ratan Gupta9166cd22018-10-01 18:09:40 +05302716 except(requests.exceptions.Timeout):
2717 return(connectionErrHandler(args.json, "Timeout", None))
2718 except(requests.exceptions.ConnectionError) as err:
2719 return connectionErrHandler(args.json, "ConnectionError", err)
2720
2721 return res.text
2722
2723
2724def disableLDAP(host, args, session):
2725 """
2726 Called by the ldap function. Deletes the LDAP Configuration.
2727
2728 @param host: string, the hostname or IP address of the bmc
2729 @param args: contains additional arguments used by the ldap subcommand
2730 @param session: the active session to use
2731 @param args.json: boolean, if this flag is set to true, the output
2732 will be provided in json format for programmatic consumption
2733 """
2734
2735 url='https://'+host+'/xyz/openbmc_project/user/ldap/config/action/delete'
Ratan Gupta9166cd22018-10-01 18:09:40 +05302736 data = {"data": []}
2737
2738 try:
Justin Thaler27197622019-01-23 14:42:11 -06002739 res = session.post(url, headers=jsonHeader, json=data, verify=False, timeout=baseTimeout)
Ratan Gupta9166cd22018-10-01 18:09:40 +05302740 except(requests.exceptions.Timeout):
2741 return(connectionErrHandler(args.json, "Timeout", None))
2742 except(requests.exceptions.ConnectionError) as err:
2743 return connectionErrHandler(args.json, "ConnectionError", err)
2744
2745 return res.text
2746
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002747
2748def enableDHCP(host, args, session):
2749
2750 """
2751 Called by the network function. Enables DHCP.
2752
2753 @param host: string, the hostname or IP address of the bmc
2754 @param args: contains additional arguments used by the ldap subcommand
2755 args.json: boolean, if this flag is set to true, the output
2756 will be provided in json format for programmatic consumption
2757 @param session: the active session to use
2758 """
2759
2760 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2761 "/attr/DHCPEnabled"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002762 data = "{\"data\": 1 }"
2763 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002764 res = session.put(url, headers=jsonHeader, data=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002765 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002766
2767 except(requests.exceptions.Timeout):
2768 return(connectionErrHandler(args.json, "Timeout", None))
2769 except(requests.exceptions.ConnectionError) as err:
2770 return connectionErrHandler(args.json, "ConnectionError", err)
2771 if res.status_code == 403:
2772 return "The specified Interface"+"("+args.Interface+")"+\
2773 " doesn't exist"
2774
2775 return res.text
2776
2777
2778def disableDHCP(host, args, session):
2779 """
2780 Called by the network function. Disables DHCP.
2781
2782 @param host: string, the hostname or IP address of the bmc
2783 @param args: contains additional arguments used by the ldap subcommand
2784 args.json: boolean, if this flag is set to true, the output
2785 will be provided in json format for programmatic consumption
2786 @param session: the active session to use
2787 """
2788
2789 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2790 "/attr/DHCPEnabled"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002791 data = "{\"data\": 0 }"
2792 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002793 res = session.put(url, headers=jsonHeader, data=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002794 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002795 except(requests.exceptions.Timeout):
2796 return(connectionErrHandler(args.json, "Timeout", None))
2797 except(requests.exceptions.ConnectionError) as err:
2798 return connectionErrHandler(args.json, "ConnectionError", err)
2799 if res.status_code == 403:
2800 return "The specified Interface"+"("+args.Interface+")"+\
2801 " doesn't exist"
2802 return res.text
2803
2804
2805def getHostname(host, args, session):
2806
2807 """
2808 Called by the network function. Prints out the Hostname.
2809
2810 @param host: string, the hostname or IP address of the bmc
2811 @param args: contains additional arguments used by the ldap subcommand
2812 args.json: boolean, if this flag is set to true, the output
2813 will be provided in json format for programmatic consumption
2814 @param session: the active session to use
2815 """
2816
2817 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/HostName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002818
2819 try:
Justin Thaler27197622019-01-23 14:42:11 -06002820 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002821 except(requests.exceptions.Timeout):
2822 return(connectionErrHandler(args.json, "Timeout", None))
2823 except(requests.exceptions.ConnectionError) as err:
2824 return connectionErrHandler(args.json, "ConnectionError", err)
2825
2826 return res.text
2827
2828
2829def setHostname(host, args, session):
2830 """
2831 Called by the network function. Sets the Hostname.
2832
2833 @param host: string, the hostname or IP address of the bmc
2834 @param args: contains additional arguments used by the ldap subcommand
2835 args.json: boolean, if this flag is set to true, the output
2836 will be provided in json format for programmatic consumption
2837 @param session: the active session to use
2838 """
2839
2840 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/HostName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002841
2842 data = {"data": args.HostName}
2843
2844 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002845 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002846 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002847 except(requests.exceptions.Timeout):
2848 return(connectionErrHandler(args.json, "Timeout", None))
2849 except(requests.exceptions.ConnectionError) as err:
2850 return connectionErrHandler(args.json, "ConnectionError", err)
2851
2852 return res.text
2853
2854
2855def getDomainName(host, args, session):
2856
2857 """
2858 Called by the network function. Prints out the DomainName.
2859
2860 @param host: string, the hostname or IP address of the bmc
2861 @param args: contains additional arguments used by the ldap subcommand
2862 args.json: boolean, if this flag is set to true, the output
2863 will be provided in json format for programmatic consumption
2864 @param session: the active session to use
2865 """
2866
2867 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2868 "/attr/DomainName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002869
2870 try:
Justin Thaler27197622019-01-23 14:42:11 -06002871 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002872 except(requests.exceptions.Timeout):
2873 return(connectionErrHandler(args.json, "Timeout", None))
2874 except(requests.exceptions.ConnectionError) as err:
2875 return connectionErrHandler(args.json, "ConnectionError", err)
2876 if res.status_code == 404:
2877 return "The specified Interface"+"("+args.Interface+")"+\
2878 " doesn't exist"
2879
2880 return res.text
2881
2882
2883def setDomainName(host, args, session):
2884 """
2885 Called by the network function. Sets the DomainName.
2886
2887 @param host: string, the hostname or IP address of the bmc
2888 @param args: contains additional arguments used by the ldap subcommand
2889 args.json: boolean, if this flag is set to true, the output
2890 will be provided in json format for programmatic consumption
2891 @param session: the active session to use
2892 """
2893
2894 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2895 "/attr/DomainName"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002896
2897 data = {"data": args.DomainName.split(",")}
2898
2899 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002900 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002901 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002902 except(requests.exceptions.Timeout):
2903 return(connectionErrHandler(args.json, "Timeout", None))
2904 except(requests.exceptions.ConnectionError) as err:
2905 return connectionErrHandler(args.json, "ConnectionError", err)
2906 if res.status_code == 403:
2907 return "The specified Interface"+"("+args.Interface+")"+\
2908 " doesn't exist"
2909
2910 return res.text
2911
2912
2913def getMACAddress(host, args, session):
2914
2915 """
2916 Called by the network function. Prints out the MACAddress.
2917
2918 @param host: string, the hostname or IP address of the bmc
2919 @param args: contains additional arguments used by the ldap subcommand
2920 args.json: boolean, if this flag is set to true, the output
2921 will be provided in json format for programmatic consumption
2922 @param session: the active session to use
2923 """
2924
2925 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2926 "/attr/MACAddress"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002927
2928 try:
Justin Thaler27197622019-01-23 14:42:11 -06002929 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002930 except(requests.exceptions.Timeout):
2931 return(connectionErrHandler(args.json, "Timeout", None))
2932 except(requests.exceptions.ConnectionError) as err:
2933 return connectionErrHandler(args.json, "ConnectionError", err)
2934 if res.status_code == 404:
2935 return "The specified Interface"+"("+args.Interface+")"+\
2936 " doesn't exist"
2937
2938 return res.text
2939
2940
2941def setMACAddress(host, args, session):
2942 """
2943 Called by the network function. Sets the MACAddress.
2944
2945 @param host: string, the hostname or IP address of the bmc
2946 @param args: contains additional arguments used by the ldap subcommand
2947 args.json: boolean, if this flag is set to true, the output
2948 will be provided in json format for programmatic consumption
2949 @param session: the active session to use
2950 """
2951
2952 url = "https://"+host+"/xyz/openbmc_project/network/"+args.Interface+\
2953 "/attr/MACAddress"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002954
2955 data = {"data": args.MACAddress}
2956
2957 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06002958 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06002959 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002960 except(requests.exceptions.Timeout):
2961 return(connectionErrHandler(args.json, "Timeout", None))
2962 except(requests.exceptions.ConnectionError) as err:
2963 return connectionErrHandler(args.json, "ConnectionError", err)
2964 if res.status_code == 403:
2965 return "The specified Interface"+"("+args.Interface+")"+\
2966 " doesn't exist"
2967
2968 return res.text
2969
2970
2971def getDefaultGateway(host, args, session):
2972
2973 """
2974 Called by the network function. Prints out the DefaultGateway.
2975
2976 @param host: string, the hostname or IP address of the bmc
2977 @param args: contains additional arguments used by the ldap subcommand
2978 args.json: boolean, if this flag is set to true, the output
2979 will be provided in json format for programmatic consumption
2980 @param session: the active session to use
2981 """
2982
2983 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/DefaultGateway"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002984
2985 try:
Justin Thaler27197622019-01-23 14:42:11 -06002986 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06002987 except(requests.exceptions.Timeout):
2988 return(connectionErrHandler(args.json, "Timeout", None))
2989 except(requests.exceptions.ConnectionError) as err:
2990 return connectionErrHandler(args.json, "ConnectionError", err)
2991 if res.status_code == 404:
2992 return "Failed to get Default Gateway info!!"
2993
2994 return res.text
2995
2996
2997def setDefaultGateway(host, args, session):
2998 """
2999 Called by the network function. Sets the DefaultGateway.
3000
3001 @param host: string, the hostname or IP address of the bmc
3002 @param args: contains additional arguments used by the ldap subcommand
3003 args.json: boolean, if this flag is set to true, the output
3004 will be provided in json format for programmatic consumption
3005 @param session: the active session to use
3006 """
3007
3008 url = "https://"+host+"/xyz/openbmc_project/network/config/attr/DefaultGateway"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003009
3010 data = {"data": args.DefaultGW}
3011
3012 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003013 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003014 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003015 except(requests.exceptions.Timeout):
3016 return(connectionErrHandler(args.json, "Timeout", None))
3017 except(requests.exceptions.ConnectionError) as err:
3018 return connectionErrHandler(args.json, "ConnectionError", err)
3019 if res.status_code == 403:
3020 return "Failed to set Default Gateway!!"
3021
3022 return res.text
3023
3024
3025def viewNWConfig(host, args, session):
3026 """
3027 Called by the ldap function. Prints out network configured properties
3028
3029 @param host: string, the hostname or IP address of the bmc
3030 @param args: contains additional arguments used by the ldap subcommand
3031 args.json: boolean, if this flag is set to true, the output
3032 will be provided in json format for programmatic consumption
3033 @param session: the active session to use
3034 @return returns LDAP's configured properties.
3035 """
3036 url = "https://"+host+"/xyz/openbmc_project/network/enumerate"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003037 try:
Justin Thaler27197622019-01-23 14:42:11 -06003038 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003039 except(requests.exceptions.Timeout):
3040 return(connectionErrHandler(args.json, "Timeout", None))
3041 except(requests.exceptions.ConnectionError) as err:
3042 return connectionErrHandler(args.json, "ConnectionError", err)
3043 except(requests.exceptions.RequestException) as err:
3044 return connectionErrHandler(args.json, "RequestException", err)
3045 if res.status_code == 404:
3046 return "LDAP server config has not been created"
3047 return res.text
3048
3049
3050def getDNS(host, args, session):
3051
3052 """
3053 Called by the network function. Prints out DNS servers on the interface
3054
3055 @param host: string, the hostname or IP address of the bmc
3056 @param args: contains additional arguments used by the ldap subcommand
3057 args.json: boolean, if this flag is set to true, the output
3058 will be provided in json format for programmatic consumption
3059 @param session: the active session to use
3060 """
3061
3062 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3063 + "/attr/Nameservers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003064
3065 try:
Justin Thaler27197622019-01-23 14:42:11 -06003066 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003067 except(requests.exceptions.Timeout):
3068 return(connectionErrHandler(args.json, "Timeout", None))
3069 except(requests.exceptions.ConnectionError) as err:
3070 return connectionErrHandler(args.json, "ConnectionError", err)
3071 if res.status_code == 404:
3072 return "The specified Interface"+"("+args.Interface+")" + \
3073 " doesn't exist"
3074
3075 return res.text
3076
3077
3078def setDNS(host, args, session):
3079 """
3080 Called by the network function. Sets DNS servers on the interface.
3081
3082 @param host: string, the hostname or IP address of the bmc
3083 @param args: contains additional arguments used by the ldap subcommand
3084 args.json: boolean, if this flag is set to true, the output
3085 will be provided in json format for programmatic consumption
3086 @param session: the active session to use
3087 """
3088
3089 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3090 + "/attr/Nameservers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003091
3092 data = {"data": args.DNSServers.split(",")}
3093
3094 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003095 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003096 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003097 except(requests.exceptions.Timeout):
3098 return(connectionErrHandler(args.json, "Timeout", None))
3099 except(requests.exceptions.ConnectionError) as err:
3100 return connectionErrHandler(args.json, "ConnectionError", err)
3101 if res.status_code == 403:
3102 return "The specified Interface"+"("+args.Interface+")" +\
3103 " doesn't exist"
3104
3105 return res.text
3106
3107
3108def getNTP(host, args, session):
3109
3110 """
3111 Called by the network function. Prints out NTP servers on the interface
3112
3113 @param host: string, the hostname or IP address of the bmc
3114 @param args: contains additional arguments used by the ldap subcommand
3115 args.json: boolean, if this flag is set to true, the output
3116 will be provided in json format for programmatic consumption
3117 @param session: the active session to use
3118 """
3119
3120 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3121 + "/attr/NTPServers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003122
3123 try:
Justin Thaler27197622019-01-23 14:42:11 -06003124 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003125 except(requests.exceptions.Timeout):
3126 return(connectionErrHandler(args.json, "Timeout", None))
3127 except(requests.exceptions.ConnectionError) as err:
3128 return connectionErrHandler(args.json, "ConnectionError", err)
3129 if res.status_code == 404:
3130 return "The specified Interface"+"("+args.Interface+")" + \
3131 " doesn't exist"
3132
3133 return res.text
3134
3135
3136def setNTP(host, args, session):
3137 """
3138 Called by the network function. Sets NTP servers on the interface.
3139
3140 @param host: string, the hostname or IP address of the bmc
3141 @param args: contains additional arguments used by the ldap subcommand
3142 args.json: boolean, if this flag is set to true, the output
3143 will be provided in json format for programmatic consumption
3144 @param session: the active session to use
3145 """
3146
3147 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3148 + "/attr/NTPServers"
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003149
3150 data = {"data": args.NTPServers.split(",")}
3151
3152 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003153 res = session.put(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003154 timeout=baseTimeout)
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06003155 except(requests.exceptions.Timeout):
3156 return(connectionErrHandler(args.json, "Timeout", None))
3157 except(requests.exceptions.ConnectionError) as err:
3158 return connectionErrHandler(args.json, "ConnectionError", err)
3159 if res.status_code == 403:
3160 return "The specified Interface"+"("+args.Interface+")" +\
3161 " doesn't exist"
3162
3163 return res.text
3164
3165
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003166def addIP(host, args, session):
3167 """
3168 Called by the network function. Configures IP address on given interface
3169
3170 @param host: string, the hostname or IP address of the bmc
3171 @param args: contains additional arguments used by the ldap subcommand
3172 args.json: boolean, if this flag is set to true, the output
3173 will be provided in json format for programmatic consumption
3174 @param session: the active session to use
3175 """
3176
3177 url = "https://" + host + "/xyz/openbmc_project/network/" + args.Interface\
3178 + "/action/IP"
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003179 protocol = {
3180 'ipv4': 'xyz.openbmc_project.Network.IP.Protocol.IPv4',
3181 'ipv6': 'xyz.openbmc_project.Network.IP.Protocol.IPv6'
3182 }
3183
3184 data = {"data": [protocol[args.type], args.address, int(args.prefixLength),
3185 args.gateway]}
3186
3187 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003188 res = session.post(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003189 timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003190 except(requests.exceptions.Timeout):
3191 return(connectionErrHandler(args.json, "Timeout", None))
3192 except(requests.exceptions.ConnectionError) as err:
3193 return connectionErrHandler(args.json, "ConnectionError", err)
3194 if res.status_code == 404:
3195 return "The specified Interface" + "(" + args.Interface + ")" +\
3196 " doesn't exist"
3197
3198 return res.text
3199
3200
3201def getIP(host, args, session):
3202 """
3203 Called by the network function. Prints out IP address of given interface
3204
3205 @param host: string, the hostname or IP address of the bmc
3206 @param args: contains additional arguments used by the ldap subcommand
3207 args.json: boolean, if this flag is set to true, the output
3208 will be provided in json format for programmatic consumption
3209 @param session: the active session to use
3210 """
3211
3212 url = "https://" + host+"/xyz/openbmc_project/network/" + args.Interface +\
3213 "/enumerate"
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003214 try:
Justin Thaler27197622019-01-23 14:42:11 -06003215 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003216 except(requests.exceptions.Timeout):
3217 return(connectionErrHandler(args.json, "Timeout", None))
3218 except(requests.exceptions.ConnectionError) as err:
3219 return connectionErrHandler(args.json, "ConnectionError", err)
3220 if res.status_code == 404:
3221 return "The specified Interface" + "(" + args.Interface + ")" +\
3222 " doesn't exist"
3223
3224 return res.text
3225
3226
3227def deleteIP(host, args, session):
3228 """
3229 Called by the network function. Deletes the IP address from given Interface
3230
3231 @param host: string, the hostname or IP address of the bmc
3232 @param args: contains additional arguments used by the ldap subcommand
3233 @param session: the active session to use
3234 @param args.json: boolean, if this flag is set to true, the output
3235 will be provided in json format for programmatic consumption
3236 """
3237
3238 url = "https://"+host+"/xyz/openbmc_project/network/" + args.Interface+\
3239 "/enumerate"
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003240 data = {"data": []}
3241 try:
Justin Thaler27197622019-01-23 14:42:11 -06003242 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003243 except(requests.exceptions.Timeout):
3244 return(connectionErrHandler(args.json, "Timeout", None))
3245 except(requests.exceptions.ConnectionError) as err:
3246 return connectionErrHandler(args.json, "ConnectionError", err)
3247 if res.status_code == 404:
3248 return "The specified Interface" + "(" + args.Interface + ")" +\
3249 " doesn't exist"
3250 objDict = json.loads(res.text)
3251 if not objDict['data']:
3252 return "No object found for given address on given Interface"
3253
3254 for obj in objDict['data']:
3255 if args.address in objDict['data'][obj]['Address']:
3256 url = "https://"+host+obj+"/action/delete"
3257 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003258 res = session.post(url, headers=jsonHeader, json=data,
Justin Thaler27197622019-01-23 14:42:11 -06003259 verify=False, timeout=baseTimeout)
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06003260 except(requests.exceptions.Timeout):
3261 return(connectionErrHandler(args.json, "Timeout", None))
3262 except(requests.exceptions.ConnectionError) as err:
3263 return connectionErrHandler(args.json, "ConnectionError", err)
3264 return res.text
3265 else:
3266 continue
3267 return "No object found for given address on given Interface"
3268
3269
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003270def addVLAN(host, args, session):
3271 """
3272 Called by the network function. Creates VLAN on given interface.
3273
3274 @param host: string, the hostname or IP address of the bmc
3275 @param args: contains additional arguments used by the ldap subcommand
3276 args.json: boolean, if this flag is set to true, the output
3277 will be provided in json format for programmatic consumption
3278 @param session: the active session to use
3279 """
3280
3281 url = "https://" + host+"/xyz/openbmc_project/network/action/VLAN"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003282
3283 data = {"data": [args.Interface,args.Identifier]}
3284
3285 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003286 res = session.post(url, headers=jsonHeader, json=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003287 timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003288 except(requests.exceptions.Timeout):
3289 return(connectionErrHandler(args.json, "Timeout", None))
3290 except(requests.exceptions.ConnectionError) as err:
3291 return connectionErrHandler(args.json, "ConnectionError", err)
3292 if res.status_code == 400:
3293 return "The specified Interface" + "(" + args.Interface + ")" +\
3294 " doesn't exist"
3295
3296 return res.text
3297
3298
3299def deleteVLAN(host, args, session):
3300 """
3301 Called by the network function. Creates VLAN on given interface.
3302
3303 @param host: string, the hostname or IP address of the bmc
3304 @param args: contains additional arguments used by the ldap subcommand
3305 args.json: boolean, if this flag is set to true, the output
3306 will be provided in json format for programmatic consumption
3307 @param session: the active session to use
3308 """
3309
3310 url = "https://" + host+"/xyz/openbmc_project/network/"+args.Interface+"/action/delete"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003311 data = {"data": []}
3312
3313 try:
Justin Thaler27197622019-01-23 14:42:11 -06003314 res = session.post(url, headers=jsonHeader, json=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003315 except(requests.exceptions.Timeout):
3316 return(connectionErrHandler(args.json, "Timeout", None))
3317 except(requests.exceptions.ConnectionError) as err:
3318 return connectionErrHandler(args.json, "ConnectionError", err)
3319 if res.status_code == 404:
3320 return "The specified VLAN"+"("+args.Interface+"_"+args.Identifier\
3321 +")" +" doesn't exist"
3322
3323 return res.text
3324
3325
3326def viewDHCPConfig(host, args, session):
3327 """
3328 Called by the network function. Shows DHCP configured Properties.
3329
3330 @param host: string, the hostname or IP address of the bmc
3331 @param args: contains additional arguments used by the ldap subcommand
3332 args.json: boolean, if this flag is set to true, the output
3333 will be provided in json format for programmatic consumption
3334 @param session: the active session to use
3335 """
3336
3337 url="https://"+host+"/xyz/openbmc_project/network/config/dhcp"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003338
3339 try:
Justin Thaler27197622019-01-23 14:42:11 -06003340 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003341 except(requests.exceptions.Timeout):
3342 return(connectionErrHandler(args.json, "Timeout", None))
3343 except(requests.exceptions.ConnectionError) as err:
3344 return connectionErrHandler(args.json, "ConnectionError", err)
3345
3346 return res.text
3347
3348
3349def configureDHCP(host, args, session):
3350 """
3351 Called by the network function. Configures/updates DHCP Properties.
3352
3353 @param host: string, the hostname or IP address of the bmc
3354 @param args: contains additional arguments used by the ldap subcommand
3355 args.json: boolean, if this flag is set to true, the output
3356 will be provided in json format for programmatic consumption
3357 @param session: the active session to use
3358 """
3359
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003360
3361 try:
3362 url="https://"+host+"/xyz/openbmc_project/network/config/dhcp"
3363 if(args.DNSEnabled == True):
3364 data = '{"data": 1}'
3365 else:
3366 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003367 res = session.put(url + '/attr/DNSEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003368 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003369 if(args.HostNameEnabled == True):
3370 data = '{"data": 1}'
3371 else:
3372 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003373 res = session.put(url + '/attr/HostNameEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003374 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003375 if(args.NTPEnabled == True):
3376 data = '{"data": 1}'
3377 else:
3378 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003379 res = session.put(url + '/attr/NTPEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003380 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003381 if(args.SendHostNameEnabled == True):
3382 data = '{"data": 1}'
3383 else:
3384 data = '{"data": 0}'
Matt Spinler220c3c42019-01-04 15:09:29 -06003385 res = session.put(url + '/attr/SendHostNameEnabled', headers=jsonHeader,
Justin Thaler27197622019-01-23 14:42:11 -06003386 data=data, verify=False, timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003387 except(requests.exceptions.Timeout):
3388 return(connectionErrHandler(args.json, "Timeout", None))
3389 except(requests.exceptions.ConnectionError) as err:
3390 return connectionErrHandler(args.json, "ConnectionError", err)
3391
3392 return res.text
3393
3394
3395def nwReset(host, args, session):
3396
3397 """
3398 Called by the network function. Resets networks setting to factory defaults.
3399
3400 @param host: string, the hostname or IP address of the bmc
3401 @param args: contains additional arguments used by the ldap subcommand
3402 args.json: boolean, if this flag is set to true, the output
3403 will be provided in json format for programmatic consumption
3404 @param session: the active session to use
3405 """
3406
3407 url = "https://"+host+"/xyz/openbmc_project/network/action/Reset"
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003408 data = '{"data":[] }'
3409 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003410 res = session.post(url, headers=jsonHeader, data=data, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003411 timeout=baseTimeout)
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003412
3413 except(requests.exceptions.Timeout):
3414 return(connectionErrHandler(args.json, "Timeout", None))
3415 except(requests.exceptions.ConnectionError) as err:
3416 return connectionErrHandler(args.json, "ConnectionError", err)
3417
3418 return res.text
3419
3420
Ratan Guptafeee6372018-10-17 23:25:51 +05303421def createPrivilegeMapping(host, args, session):
3422 """
3423 Called by the ldap function. Creates the group and the privilege mapping.
3424
3425 @param host: string, the hostname or IP address of the bmc
3426 @param args: contains additional arguments used by the ldap subcommand
3427 @param session: the active session to use
3428 @param args.json: boolean, if this flag is set to true, the output
3429 will be provided in json format for programmatic consumption
3430 """
3431
3432 url = 'https://'+host+'/xyz/openbmc_project/user/ldap/action/Create'
Ratan Guptafeee6372018-10-17 23:25:51 +05303433
3434 data = {"data": [args.groupName,args.privilege]}
3435
3436 try:
Justin Thaler27197622019-01-23 14:42:11 -06003437 res = session.post(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Ratan Guptafeee6372018-10-17 23:25:51 +05303438 except(requests.exceptions.Timeout):
3439 return(connectionErrHandler(args.json, "Timeout", None))
3440 except(requests.exceptions.ConnectionError) as err:
3441 return connectionErrHandler(args.json, "ConnectionError", err)
3442 return res.text
3443
3444def listPrivilegeMapping(host, args, session):
3445 """
3446 Called by the ldap function. Lists the group and the privilege mapping.
3447
3448 @param host: string, the hostname or IP address of the bmc
3449 @param args: contains additional arguments used by the ldap subcommand
3450 @param session: the active session to use
3451 @param args.json: boolean, if this flag is set to true, the output
3452 will be provided in json format for programmatic consumption
3453 """
3454 url = 'https://'+host+'/xyz/openbmc_project/user/ldap/enumerate'
Ratan Guptafeee6372018-10-17 23:25:51 +05303455 data = {"data": []}
3456
3457 try:
Justin Thaler27197622019-01-23 14:42:11 -06003458 res = session.get(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Ratan Guptafeee6372018-10-17 23:25:51 +05303459 except(requests.exceptions.Timeout):
3460 return(connectionErrHandler(args.json, "Timeout", None))
3461 except(requests.exceptions.ConnectionError) as err:
3462 return connectionErrHandler(args.json, "ConnectionError", err)
3463 return res.text
3464
3465def deletePrivilegeMapping(host, args, session):
3466 """
3467 Called by the ldap function. Deletes the mapping associated with the group.
3468
3469 @param host: string, the hostname or IP address of the bmc
3470 @param args: contains additional arguments used by the ldap subcommand
3471 @param session: the active session to use
3472 @param args.json: boolean, if this flag is set to true, the output
3473 will be provided in json format for programmatic consumption
3474 """
3475 (ldapNameSpaceObjects) = listPrivilegeMapping(host, args, session)
3476 ldapNameSpaceObjects = json.loads(ldapNameSpaceObjects)["data"]
3477 path = ''
3478
3479 # not interested in the config objet
3480 ldapNameSpaceObjects.pop('/xyz/openbmc_project/user/ldap/config', None)
3481
3482 # search for the object having the mapping for the given group
3483 for key,value in ldapNameSpaceObjects.items():
3484 if value['GroupName'] == args.groupName:
3485 path = key
3486 break
3487
3488 if path == '':
3489 return "No privilege mapping found for this group."
3490
3491 # delete the object
3492 url = 'https://'+host+path+'/action/delete'
Ratan Guptafeee6372018-10-17 23:25:51 +05303493 data = {"data": []}
3494
3495 try:
Justin Thaler27197622019-01-23 14:42:11 -06003496 res = session.post(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Ratan Guptafeee6372018-10-17 23:25:51 +05303497 except(requests.exceptions.Timeout):
3498 return(connectionErrHandler(args.json, "Timeout", None))
3499 except(requests.exceptions.ConnectionError) as err:
3500 return connectionErrHandler(args.json, "ConnectionError", err)
3501 return res.text
Ratan Gupta9166cd22018-10-01 18:09:40 +05303502
Sivas SRR78835272018-11-27 05:27:19 -06003503def deleteAllPrivilegeMapping(host, args, session):
3504 """
3505 Called by the ldap function. Deletes all the privilege mapping and group defined.
3506 @param host: string, the hostname or IP address of the bmc
3507 @param args: contains additional arguments used by the ldap subcommand
3508 @param session: the active session to use
3509 @param args.json: boolean, if this flag is set to true, the output
3510 will be provided in json format for programmatic consumption
3511 """
3512 ldapNameSpaceObjects = listPrivilegeMapping(host, args, session)
3513 ldapNameSpaceObjects = json.loads(ldapNameSpaceObjects)["data"]
3514 path = ''
3515
3516 # Remove the config object.
3517 ldapNameSpaceObjects.pop('/xyz/openbmc_project/user/ldap/config', None)
Sivas SRR78835272018-11-27 05:27:19 -06003518 data = {"data": []}
3519
3520 try:
3521 # search for GroupName property and delete if it is available.
3522 for path in ldapNameSpaceObjects.keys():
3523 # delete the object
3524 url = 'https://'+host+path+'/action/delete'
Justin Thaler27197622019-01-23 14:42:11 -06003525 res = session.post(url, headers=jsonHeader, json = data, verify=False, timeout=baseTimeout)
Sivas SRR78835272018-11-27 05:27:19 -06003526 except(requests.exceptions.Timeout):
3527 return(connectionErrHandler(args.json, "Timeout", None))
3528 except(requests.exceptions.ConnectionError) as err:
3529 return connectionErrHandler(args.json, "ConnectionError", err)
3530 return res.text
3531
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003532def viewLDAPConfig(host, args, session):
3533 """
3534 Called by the ldap function. Prints out LDAP's configured properties
3535
3536 @param host: string, the hostname or IP address of the bmc
3537 @param args: contains additional arguments used by the ldap subcommand
3538 args.json: boolean, if this flag is set to true, the output
3539 will be provided in json format for programmatic consumption
3540 @param session: the active session to use
3541 @return returns LDAP's configured properties.
3542 """
3543 url = "https://"+host+"/xyz/openbmc_project/user/ldap/config"
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003544 try:
Justin Thaler27197622019-01-23 14:42:11 -06003545 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003546 except(requests.exceptions.Timeout):
3547 return(connectionErrHandler(args.json, "Timeout", None))
3548 except(requests.exceptions.ConnectionError) as err:
3549 return connectionErrHandler(args.json, "ConnectionError", err)
3550 except(requests.exceptions.RequestException) as err:
3551 return connectionErrHandler(args.json, "RequestException", err)
3552 if res.status_code == 404:
3553 return "LDAP server config has not been created"
3554 return res.text
3555
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06003556def str2bool(v):
3557 if v.lower() in ('yes', 'true', 't', 'y', '1'):
3558 return True
3559 elif v.lower() in ('no', 'false', 'f', 'n', '0'):
3560 return False
3561 else:
3562 raise argparse.ArgumentTypeError('Boolean value expected.')
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06003563
Matt Spinler7d426c22018-09-24 14:42:07 -05003564def localUsers(host, args, session):
3565 """
3566 Enables and disables local BMC users.
3567
3568 @param host: string, the hostname or IP address of the bmc
3569 @param args: contains additional arguments used by the logging sub command
3570 @param session: the active session to use
3571 """
3572
Matt Spinler7d426c22018-09-24 14:42:07 -05003573 url="https://{hostname}/xyz/openbmc_project/user/enumerate".format(hostname=host)
3574 try:
Justin Thaler27197622019-01-23 14:42:11 -06003575 res = session.get(url, headers=jsonHeader, verify=False, timeout=baseTimeout)
Matt Spinler7d426c22018-09-24 14:42:07 -05003576 except(requests.exceptions.Timeout):
3577 return(connectionErrHandler(args.json, "Timeout", None))
3578 usersDict = json.loads(res.text)
3579
3580 if not usersDict['data']:
3581 return "No users found"
3582
3583 output = ""
3584 for user in usersDict['data']:
Matt Spinler015adc22018-10-23 14:30:19 -05003585
3586 # Skip LDAP and another non-local users
3587 if 'UserEnabled' not in usersDict['data'][user]:
3588 continue
3589
Matt Spinler7d426c22018-09-24 14:42:07 -05003590 name = user.split('/')[-1]
3591 url = "https://{hostname}{user}/attr/UserEnabled".format(hostname=host, user=user)
3592
3593 if args.local_users == "queryenabled":
3594 try:
Justin Thaler27197622019-01-23 14:42:11 -06003595 res = session.get(url, headers=jsonHeader,verify=False, timeout=baseTimeout)
Matt Spinler7d426c22018-09-24 14:42:07 -05003596 except(requests.exceptions.Timeout):
3597 return(connectionErrHandler(args.json, "Timeout", None))
3598
3599 result = json.loads(res.text)
3600 output += ("User: {name} Enabled: {result}\n").format(name=name, result=result['data'])
3601
3602 elif args.local_users in ["enableall", "disableall"]:
3603 action = ""
3604 if args.local_users == "enableall":
3605 data = '{"data": true}'
3606 action = "Enabling"
3607 else:
3608 data = '{"data": false}'
3609 action = "Disabling"
3610
3611 output += "{action} {name}\n".format(action=action, name=name)
3612
3613 try:
Justin Thaler27197622019-01-23 14:42:11 -06003614 resp = session.put(url, headers=jsonHeader, data=data, verify=False, timeout=baseTimeout)
Matt Spinler7d426c22018-09-24 14:42:07 -05003615 except(requests.exceptions.Timeout):
3616 return connectionErrHandler(args.json, "Timeout", None)
3617 except(requests.exceptions.ConnectionError) as err:
3618 return connectionErrHandler(args.json, "ConnectionError", err)
3619 else:
3620 return "Invalid local users argument"
3621
3622 return output
3623
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003624def setPassword(host, args, session):
3625 """
3626 Set local user password
3627 @param host: string, the hostname or IP address of the bmc
3628 @param args: contains additional arguments used by the logging sub
3629 command
3630 @param session: the active session to use
3631 @param args.json: boolean, if this flag is set to true, the output
3632 will be provided in json format for programmatic consumption
3633 @return: Session object
3634 """
3635 url = "https://" + host + "/xyz/openbmc_project/user/" + args.user + \
3636 "/action/SetPassword"
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003637 try:
Matt Spinler220c3c42019-01-04 15:09:29 -06003638 res = session.post(url, headers=jsonHeader,
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003639 json={"data": [args.password]}, verify=False,
Justin Thaler27197622019-01-23 14:42:11 -06003640 timeout=baseTimeout)
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06003641 except(requests.exceptions.Timeout):
3642 return(connectionErrHandler(args.json, "Timeout", None))
3643 except(requests.exceptions.ConnectionError) as err:
3644 return connectionErrHandler(args.json, "ConnectionError", err)
3645 except(requests.exceptions.RequestException) as err:
3646 return connectionErrHandler(args.json, "RequestException", err)
3647 return res.text
3648
Matthew Barth368e83c2019-02-01 13:48:25 -06003649
3650def getThermalZones(host, args, session):
3651 """
3652 Get the available thermal control zones
3653 @param host: string, the hostname or IP address of the bmc
3654 @param args: contains additional arguments used to get the thermal
3655 control zones
3656 @param session: the active session to use
3657 @return: Session object
3658 """
3659 url = "https://" + host + "/xyz/openbmc_project/control/thermal/enumerate"
3660
3661 try:
3662 res = session.get(url, headers=jsonHeader, verify=False, timeout=30)
3663 except(requests.exceptions.Timeout):
3664 return(connectionErrHandler(args.json, "Timeout", None))
3665 except(requests.exceptions.ConnectionError) as err:
3666 return connectionErrHandler(args.json, "ConnectionError", err)
3667 except(requests.exceptions.RequestException) as err:
3668 return connectionErrHandler(args.json, "RequestException", err)
3669
3670 if (res.status_code == 404):
3671 return "No thermal control zones found or system is in a" + \
3672 " powered off state"
3673
3674 zonesDict = json.loads(res.text)
3675 if not zonesDict['data']:
3676 return "No thermal control zones found"
3677 for zone in zonesDict['data']:
3678 z = ",".join(str(zone.split('/')[-1]) for zone in zonesDict['data'])
3679
3680 return "Zones: [ " + z + " ]"
3681
3682
3683def getThermalMode(host, args, session):
3684 """
3685 Get thermal control mode
3686 @param host: string, the hostname or IP address of the bmc
3687 @param args: contains additional arguments used to get the thermal
3688 control mode
3689 @param session: the active session to use
3690 @param args.zone: the zone to get the mode on
3691 @return: Session object
3692 """
3693 url = "https://" + host + "/xyz/openbmc_project/control/thermal/" + \
3694 args.zone
3695
3696 try:
3697 res = session.get(url, headers=jsonHeader, verify=False, timeout=30)
3698 except(requests.exceptions.Timeout):
3699 return(connectionErrHandler(args.json, "Timeout", None))
3700 except(requests.exceptions.ConnectionError) as err:
3701 return connectionErrHandler(args.json, "ConnectionError", err)
3702 except(requests.exceptions.RequestException) as err:
3703 return connectionErrHandler(args.json, "RequestException", err)
3704
3705 if (res.status_code == 404):
3706 return "Thermal control zone(" + args.zone + ") not found or" + \
3707 " system is in a powered off state"
3708
3709 propsDict = json.loads(res.text)
3710 if not propsDict['data']:
3711 return "No thermal control properties found on zone(" + args.zone + ")"
3712 curMode = "Current"
3713 supModes = "Supported"
3714 result = "\n"
3715 for prop in propsDict['data']:
3716 if (prop.casefold() == curMode.casefold()):
3717 result += curMode + " Mode: " + propsDict['data'][curMode] + "\n"
3718 if (prop.casefold() == supModes.casefold()):
3719 s = ", ".join(str(sup) for sup in propsDict['data'][supModes])
3720 result += supModes + " Modes: [ " + s + " ]\n"
3721
3722 return result
3723
3724def setThermalMode(host, args, session):
3725 """
3726 Set thermal control mode
3727 @param host: string, the hostname or IP address of the bmc
3728 @param args: contains additional arguments used for setting the thermal
3729 control mode
3730 @param session: the active session to use
3731 @param args.zone: the zone to set the mode on
3732 @param args.mode: the mode to enable
3733 @return: Session object
3734 """
3735 url = "https://" + host + "/xyz/openbmc_project/control/thermal/" + \
3736 args.zone + "/attr/Current"
3737
3738 # Check args.mode against supported modes using `getThermalMode` output
3739 modes = getThermalMode(host, args, session)
3740 modes = os.linesep.join([m for m in modes.splitlines() if m])
3741 modes = modes.replace("\n", ";").strip()
3742 modesDict = dict(m.split(': ') for m in modes.split(';'))
3743 sModes = ''.join(s for s in modesDict['Supported Modes'] if s not in '[ ]')
3744 if args.mode.casefold() not in \
3745 (m.casefold() for m in sModes.split(',')) or not args.mode:
3746 result = ("Unsupported mode('" + args.mode + "') given, " +
3747 "select a supported mode: \n" +
3748 getThermalMode(host, args, session))
3749 return result
3750
3751 data = '{"data":"' + args.mode + '"}'
3752 try:
3753 res = session.get(url, headers=jsonHeader, verify=False, timeout=30)
3754 except(requests.exceptions.Timeout):
3755 return(connectionErrHandler(args.json, "Timeout", None))
3756 except(requests.exceptions.ConnectionError) as err:
3757 return connectionErrHandler(args.json, "ConnectionError", err)
3758 except(requests.exceptions.RequestException) as err:
3759 return connectionErrHandler(args.json, "RequestException", err)
3760
3761 if (data and res.status_code != 404):
3762 try:
3763 res = session.put(url, headers=jsonHeader,
3764 data=data, verify=False,
3765 timeout=30)
3766 except(requests.exceptions.Timeout):
3767 return(connectionErrHandler(args.json, "Timeout", None))
3768 except(requests.exceptions.ConnectionError) as err:
3769 return connectionErrHandler(args.json, "ConnectionError", err)
3770 except(requests.exceptions.RequestException) as err:
3771 return connectionErrHandler(args.json, "RequestException", err)
3772
3773 if res.status_code == 403:
3774 return "The specified thermal control zone(" + args.zone + ")" + \
3775 " does not exist"
3776
3777 return res.text
3778 else:
3779 return "Setting thermal control mode(" + args.mode + ")" + \
3780 " not supported or operation not available(system powered off?)"
3781
3782
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003783def createCommandParser():
Justin Thalere412dc22018-01-12 16:28:24 -06003784 """
3785 creates the parser for the command line along with help for each command and subcommand
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003786
Justin Thalere412dc22018-01-12 16:28:24 -06003787 @return: returns the parser for the command line
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003788 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003789 parser = argparse.ArgumentParser(description='Process arguments')
Justin Thalere412dc22018-01-12 16:28:24 -06003790 parser.add_argument("-H", "--host", help='A hostname or IP for the BMC')
3791 parser.add_argument("-U", "--user", help='The username to login with')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003792 group = parser.add_mutually_exclusive_group()
3793 group.add_argument("-A", "--askpw", action='store_true', help='prompt for password')
3794 group.add_argument("-P", "--PW", help='Provide the password in-line')
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05003795 group.add_argument("-E", "--PWenvvar", action='store_true', help='Get password from envvar OPENBMCTOOL_PASSWORD')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003796 parser.add_argument('-j', '--json', action='store_true', help='output json data only')
3797 parser.add_argument('-t', '--policyTableLoc', help='The location of the policy table to parse alerts')
3798 parser.add_argument('-c', '--CerFormat', action='store_true', help=argparse.SUPPRESS)
3799 parser.add_argument('-T', '--procTime', action='store_true', help= argparse.SUPPRESS)
Justin Thalere412dc22018-01-12 16:28:24 -06003800 parser.add_argument('-V', '--version', action='store_true', help='Display the version number of the openbmctool')
3801 subparsers = parser.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003802
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003803 #fru command
3804 parser_inv = subparsers.add_parser("fru", help='Work with platform inventory')
Justin Thalere412dc22018-01-12 16:28:24 -06003805 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 -05003806 inv_subparser.required = True
3807 #fru print
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003808 inv_print = inv_subparser.add_parser("print", help="prints out a list of all FRUs")
3809 inv_print.set_defaults(func=fruPrint)
3810 #fru list [0....n]
3811 inv_list = inv_subparser.add_parser("list", help="print out details on selected FRUs. Specifying no items will list the entire inventory")
3812 inv_list.add_argument('items', nargs='?', help="print out details on selected FRUs. Specifying no items will list the entire inventory")
3813 inv_list.set_defaults(func=fruList)
3814 #fru status
3815 inv_status = inv_subparser.add_parser("status", help="prints out the status of all FRUs")
Justin Thalere412dc22018-01-12 16:28:24 -06003816 inv_status.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003817 inv_status.set_defaults(func=fruStatus)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003818
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003819 #sensors command
3820 parser_sens = subparsers.add_parser("sensors", help="Work with platform sensors")
Justin Thalere412dc22018-01-12 16:28:24 -06003821 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 -05003822 sens_subparser.required = True
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003823 #sensor print
3824 sens_print= sens_subparser.add_parser('print', help="prints out a list of all Sensors.")
3825 sens_print.set_defaults(func=sensor)
3826 #sensor list[0...n]
3827 sens_list=sens_subparser.add_parser("list", help="Lists all Sensors in the platform. Specify a sensor for full details. ")
3828 sens_list.add_argument("sensNum", nargs='?', help="The Sensor number to get full details on" )
3829 sens_list.set_defaults(func=sensor)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003830
Matthew Barth368e83c2019-02-01 13:48:25 -06003831 #thermal control commands
3832 parser_therm = subparsers.add_parser("thermal", help="Work with thermal control parameters")
3833 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')
3834 #thermal control zones
3835 parser_thermZones = therm_subparser.add_parser("zones", help="Get a list of available thermal control zones")
3836 parser_thermZones.set_defaults(func=getThermalZones)
3837 #thermal control modes
3838 parser_thermMode = therm_subparser.add_parser("modes", help="Work with thermal control modes")
3839 thermMode_sub = parser_thermMode.add_subparsers(title='subactions', description='Work with thermal control modes', help="Work with thermal control modes")
3840 #get thermal control mode
3841 parser_getThermMode = thermMode_sub.add_parser("get", help="Get current and supported thermal control modes")
3842 parser_getThermMode.add_argument('-z', '--zone', required=True, help='Thermal zone to work with')
3843 parser_getThermMode.set_defaults(func=getThermalMode)
3844 #set thermal control mode
3845 parser_setThermMode = thermMode_sub.add_parser("set", help="Set the thermal control mode")
3846 parser_setThermMode.add_argument('-z', '--zone', required=True, help='Thermal zone to work with')
3847 parser_setThermMode.add_argument('-m', '--mode', required=True, help='The supported thermal control mode')
3848 parser_setThermMode.set_defaults(func=setThermalMode)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003849
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003850 #sel command
3851 parser_sel = subparsers.add_parser("sel", help="Work with platform alerts")
Justin Thalere412dc22018-01-12 16:28:24 -06003852 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 -05003853 sel_subparser.required = True
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003854 #sel print
3855 sel_print = sel_subparser.add_parser("print", help="prints out a list of all sels in a condensed list")
3856 sel_print.add_argument('-d', '--devdebug', action='store_true', help=argparse.SUPPRESS)
3857 sel_print.add_argument('-v', '--verbose', action='store_true', help="Changes the output to being very verbose")
3858 sel_print.add_argument('-f', '--fileloc', help='Parse a file instead of the BMC output')
3859 sel_print.set_defaults(func=selPrint)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003860
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003861 #sel list
3862 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")
3863 sel_list.add_argument("selNum", nargs='?', type=int, help="The SEL entry to get details on")
3864 sel_list.set_defaults(func=selList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003865
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003866 sel_get = sel_subparser.add_parser("get", help="Gets the verbose details of a specified SEL entry")
3867 sel_get.add_argument('selNum', type=int, help="the number of the SEL entry to get")
3868 sel_get.set_defaults(func=selList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003869
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003870 sel_clear = sel_subparser.add_parser("clear", help="Clears all entries from the SEL")
3871 sel_clear.set_defaults(func=selClear)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003872
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003873 sel_setResolved = sel_subparser.add_parser("resolve", help="Sets the sel entry to resolved")
Justin Thalere412dc22018-01-12 16:28:24 -06003874 sel_setResolved.add_argument('-n', '--selNum', type=int, help="the number of the SEL entry to resolve")
3875 sel_ResolveAll_sub = sel_setResolved.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
3876 sel_ResolveAll = sel_ResolveAll_sub.add_parser('all', help='Resolve all SEL entries')
3877 sel_ResolveAll.set_defaults(func=selResolveAll)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003878 sel_setResolved.set_defaults(func=selSetResolved)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003879
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003880 parser_chassis = subparsers.add_parser("chassis", help="Work with chassis power and status")
Justin Thalere412dc22018-01-12 16:28:24 -06003881 chas_sub = parser_chassis.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003882
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003883 parser_chassis.add_argument('status', action='store_true', help='Returns the current status of the platform')
3884 parser_chassis.set_defaults(func=chassis)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003885
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003886 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 -06003887 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 -06003888 parser_chasPower.set_defaults(func=chassisPower)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003889
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003890 #control the chassis identify led
3891 parser_chasIdent = chas_sub.add_parser("identify", help="Control the chassis identify led")
3892 parser_chasIdent.add_argument('identcmd', choices=['on', 'off', 'status'], help='The control option for the led: on, off, blink, status')
3893 parser_chasIdent.set_defaults(func=chassisIdent)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003894
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003895 #collect service data
3896 parser_servData = subparsers.add_parser("collect_service_data", help="Collect all bmc data needed for service")
3897 parser_servData.add_argument('-d', '--devdebug', action='store_true', help=argparse.SUPPRESS)
3898 parser_servData.set_defaults(func=collectServiceData)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003899
Justin Thalere412dc22018-01-12 16:28:24 -06003900 #system quick health check
3901 parser_healthChk = subparsers.add_parser("health_check", help="Work with platform sensors")
3902 parser_healthChk.set_defaults(func=healthCheck)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003903
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003904 #work with bmc dumps
3905 parser_bmcdump = subparsers.add_parser("dump", help="Work with bmc dump files")
Justin Thalere412dc22018-01-12 16:28:24 -06003906 bmcDump_sub = parser_bmcdump.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thaler53bf2f12018-07-16 14:05:32 -05003907 bmcDump_sub.required = True
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003908 dump_Create = bmcDump_sub.add_parser('create', help="Create a bmc dump")
3909 dump_Create.set_defaults(func=bmcDumpCreate)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003910
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003911 dump_list = bmcDump_sub.add_parser('list', help="list all bmc dump files")
3912 dump_list.set_defaults(func=bmcDumpList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003913
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003914 parserdumpdelete = bmcDump_sub.add_parser('delete', help="Delete bmc dump files")
3915 parserdumpdelete.add_argument("-n", "--dumpNum", nargs='*', type=int, help="The Dump entry to delete")
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003916 parserdumpdelete.set_defaults(func=bmcDumpDelete)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003917
Justin Thalere412dc22018-01-12 16:28:24 -06003918 bmcDumpDelsub = parserdumpdelete.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003919 deleteAllDumps = bmcDumpDelsub.add_parser('all', help='Delete all bmc dump files')
3920 deleteAllDumps.set_defaults(func=bmcDumpDeleteAll)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003921
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003922 parser_dumpretrieve = bmcDump_sub.add_parser('retrieve', help='Retrieve a dump file')
3923 parser_dumpretrieve.add_argument("dumpNum", type=int, help="The Dump entry to delete")
3924 parser_dumpretrieve.add_argument("-s", "--dumpSaveLoc", help="The location to save the bmc dump file")
3925 parser_dumpretrieve.set_defaults(func=bmcDumpRetrieve)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003926
Justin Thaler22b1bb52018-03-15 13:31:32 -05003927 #bmc command for reseting the bmc
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003928 parser_bmc = subparsers.add_parser('bmc', help="Work with the bmc")
Justin Thalere412dc22018-01-12 16:28:24 -06003929 bmc_sub = parser_bmc.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003930 parser_BMCReset = bmc_sub.add_parser('reset', help='Reset the bmc' )
3931 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 -06003932 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.")
3933 parser_bmc.set_defaults(func=bmc)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003934
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003935 #add alias to the bmc command
3936 parser_mc = subparsers.add_parser('mc', help="Work with the management controller")
Justin Thalere412dc22018-01-12 16:28:24 -06003937 mc_sub = parser_mc.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003938 parser_MCReset = mc_sub.add_parser('reset', help='Reset the bmc' )
3939 parser_MCReset.add_argument('type', choices=['warm','cold'], help="Reboot the BMC")
3940 #parser_MCReset.add_argument('cold', action='store_true', help="Reboot the BMC and CLEAR the configuration")
3941 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 -06003942 parser_MCReset.set_defaults(func=bmcReset)
Justin Thalerf9aee3e2017-12-05 12:11:09 -06003943 parser_mc.set_defaults(func=bmc)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003944
Justin Thalere412dc22018-01-12 16:28:24 -06003945 #gard clear
3946 parser_gc = subparsers.add_parser("gardclear", help="Used to clear gard records")
3947 parser_gc.set_defaults(func=gardClear)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003948
Justin Thalere412dc22018-01-12 16:28:24 -06003949 #firmware_flash
3950 parser_fw = subparsers.add_parser("firmware", help="Work with the system firmware")
3951 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 -05003952 fwflash_subproc.required = True
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003953
Justin Thalere412dc22018-01-12 16:28:24 -06003954 fwflash = fwflash_subproc.add_parser('flash', help="Flash the system firmware")
3955 fwflash.add_argument('type', choices=['bmc', 'pnor'], help="image type to flash")
3956 fwflash.add_argument('-f', '--fileloc', required=True, help="The absolute path to the firmware image")
3957 fwflash.set_defaults(func=fwFlash)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003958
Justin Thaler22b1bb52018-03-15 13:31:32 -05003959 fwActivate = fwflash_subproc.add_parser('activate', help="Activate existing image on the bmc")
Justin Thalere412dc22018-01-12 16:28:24 -06003960 fwActivate.add_argument('imageID', help="The image ID to activate from the firmware list. Ex: 63c95399")
3961 fwActivate.set_defaults(func=activateFWImage)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003962
Justin Thaler22b1bb52018-03-15 13:31:32 -05003963 fwActivateStatus = fwflash_subproc.add_parser('activation_status', help="Check Status of activations")
3964 fwActivateStatus.set_defaults(func=activateStatus)
3965
Justin Thaler3d71d402018-07-24 14:35:39 -05003966 fwList = fwflash_subproc.add_parser('list', help="List all of the installed firmware")
3967 fwList.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
3968 fwList.set_defaults(func=firmwareList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003969
Justin Thaler3d71d402018-07-24 14:35:39 -05003970 fwprint = fwflash_subproc.add_parser('print', help="List all of the installed firmware")
3971 fwprint.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
3972 fwprint.set_defaults(func=firmwareList)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003973
Adriana Kobylak5af2fad2018-11-08 12:33:43 -06003974 fwDelete = fwflash_subproc.add_parser('delete', help="Delete an existing firmware version")
3975 fwDelete.add_argument('versionID', help="The version ID to delete from the firmware list. Ex: 63c95399")
3976 fwDelete.set_defaults(func=deleteFWVersion)
3977
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05003978 #logging
3979 parser_logging = subparsers.add_parser("logging", help="logging controls")
3980 logging_sub = parser_logging.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06003981
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05003982 #turn rest api logging on/off
3983 parser_rest_logging = logging_sub.add_parser("rest_api", help="turn rest api logging on/off")
3984 parser_rest_logging.add_argument('rest_logging', choices=['on', 'off'], help='The control option for rest logging: on, off')
3985 parser_rest_logging.set_defaults(func=restLogging)
Deepak Kodihalli02d53282018-09-18 06:53:31 -05003986
3987 #remote logging
3988 parser_remote_logging = logging_sub.add_parser("remote_logging", help="Remote logging (rsyslog) commands")
3989 parser_remote_logging.add_argument('remote_logging', choices=['view', 'disable'], help='Remote logging (rsyslog) commands')
3990 parser_remote_logging.set_defaults(func=remoteLogging)
3991
3992 #configure remote logging
3993 parser_remote_logging_config = logging_sub.add_parser("remote_logging_config", help="Configure remote logging (rsyslog)")
3994 parser_remote_logging_config.add_argument("-a", "--address", required=True, help="Set IP address of rsyslog server")
3995 parser_remote_logging_config.add_argument("-p", "--port", required=True, type=int, help="Set Port of rsyslog server")
3996 parser_remote_logging_config.set_defaults(func=remoteLoggingConfig)
Dhruvaraj Subhashchandran64e7f6f2018-10-02 03:42:14 -05003997
3998 #certificate management
3999 parser_cert = subparsers.add_parser("certificate", help="Certificate management")
4000 certMgmt_subproc = parser_cert.add_subparsers(title='subcommands', description='valid certificate commands', help='sub-command help', dest='command')
4001
4002 certUpdate = certMgmt_subproc.add_parser('update', help="Update the certificate")
4003 certUpdate.add_argument('type', choices=['server', 'client', 'authority'], help="certificate type to update")
4004 certUpdate.add_argument('service', choices=['https', 'ldap'], help="Service to update")
4005 certUpdate.add_argument('-f', '--fileloc', required=True, help="The absolute path to the certificate file")
4006 certUpdate.set_defaults(func=certificateUpdate)
4007
4008 certDelete = certMgmt_subproc.add_parser('delete', help="Delete the certificate")
4009 certDelete.add_argument('type', choices=['server', 'client', 'authority'], help="certificate type to delete")
4010 certDelete.add_argument('service', choices=['https', 'ldap'], help="Service to delete the certificate")
4011 certDelete.set_defaults(func=certificateDelete)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004012
Marri Devender Raodfe81ad2019-07-01 05:38:09 -05004013 certReplace = certMgmt_subproc.add_parser('replace',
4014 help="Replace the certificate")
4015 certReplace.add_argument('type', choices=['server', 'client', 'authority'],
4016 help="certificate type to replace")
4017 certReplace.add_argument('service', choices=['https', 'ldap'],
4018 help="Service to replace the certificate")
4019 certReplace.add_argument('-f', '--fileloc', required=True,
4020 help="The absolute path to the certificate file")
4021 certReplace.set_defaults(func=certificateReplace)
4022
Marri Devender Rao34646402019-07-01 05:46:03 -05004023 certDisplay = certMgmt_subproc.add_parser('display',
4024 help="Print the certificate")
4025 certDisplay.add_argument('type', choices=['server', 'client', 'authority'],
4026 help="certificate type to display")
4027 certDisplay.set_defaults(func=certificateDisplay)
4028
Matt Spinler7d426c22018-09-24 14:42:07 -05004029 # local users
4030 parser_users = subparsers.add_parser("local_users", help="Work with local users")
4031 parser_users.add_argument('local_users', choices=['disableall','enableall', 'queryenabled'], help="Disable, enable or query local user accounts")
4032 parser_users.add_argument('-v', '--verbose', action='store_true', help='Verbose output')
4033 parser_users.set_defaults(func=localUsers)
4034
Ratan Gupta9166cd22018-10-01 18:09:40 +05304035 #LDAP
4036 parser_ldap = subparsers.add_parser("ldap", help="LDAP controls")
4037 ldap_sub = parser_ldap.add_subparsers(title='subcommands', description='valid subcommands',help="sub-command help", dest='command')
4038
4039 #configure and enable LDAP
4040 parser_ldap_config = ldap_sub.add_parser("enable", help="Configure and enables the LDAP")
4041 parser_ldap_config.add_argument("-a", "--uri", required=True, help="Set LDAP server URI")
4042 parser_ldap_config.add_argument("-B", "--bindDN", required=True, help="Set the bind DN of the LDAP server")
4043 parser_ldap_config.add_argument("-b", "--baseDN", required=True, help="Set the base DN of the LDAP server")
4044 parser_ldap_config.add_argument("-p", "--bindPassword", required=True, help="Set the bind password of the LDAP server")
4045 parser_ldap_config.add_argument("-S", "--scope", choices=['sub','one', 'base'],
4046 help='Specifies the search scope:subtree, one level or base object.')
4047 parser_ldap_config.add_argument("-t", "--serverType", choices=['ActiveDirectory','OpenLDAP'],
4048 help='Specifies the configured server is ActiveDirectory(AD) or OpenLdap')
4049 parser_ldap_config.set_defaults(func=enableLDAP)
4050
4051 # disable LDAP
4052 parser_disable_ldap = ldap_sub.add_parser("disable", help="disables the LDAP")
4053 parser_disable_ldap.set_defaults(func=disableLDAP)
Nagaraju Goruganti7d1fe172018-11-13 06:09:29 -06004054 # view-config
4055 parser_ldap_config = \
4056 ldap_sub.add_parser("view-config", help="prints out a list of all \
4057 LDAPS's configured properties")
4058 parser_ldap_config.set_defaults(func=viewLDAPConfig)
Ratan Gupta9166cd22018-10-01 18:09:40 +05304059
Ratan Guptafeee6372018-10-17 23:25:51 +05304060 #create group privilege mapping
4061 parser_ldap_mapper = ldap_sub.add_parser("privilege-mapper", help="LDAP group privilege controls")
4062 parser_ldap_mapper_sub = parser_ldap_mapper.add_subparsers(title='subcommands', description='valid subcommands',
4063 help="sub-command help", dest='command')
4064
4065 parser_ldap_mapper_create = parser_ldap_mapper_sub.add_parser("create", help="Create mapping of ldap group and privilege")
4066 parser_ldap_mapper_create.add_argument("-g","--groupName",required=True,help="Group Name")
4067 parser_ldap_mapper_create.add_argument("-p","--privilege",choices=['priv-admin','priv-user'],required=True,help="Privilege")
4068 parser_ldap_mapper_create.set_defaults(func=createPrivilegeMapping)
4069
4070 #list group privilege mapping
4071 parser_ldap_mapper_list = parser_ldap_mapper_sub.add_parser("list",help="List privilege mapping")
4072 parser_ldap_mapper_list.set_defaults(func=listPrivilegeMapping)
4073
4074 #delete group privilege mapping
4075 parser_ldap_mapper_delete = parser_ldap_mapper_sub.add_parser("delete",help="Delete privilege mapping")
4076 parser_ldap_mapper_delete.add_argument("-g","--groupName",required=True,help="Group Name")
4077 parser_ldap_mapper_delete.set_defaults(func=deletePrivilegeMapping)
4078
Sivas SRR78835272018-11-27 05:27:19 -06004079 #deleteAll group privilege mapping
4080 parser_ldap_mapper_delete = parser_ldap_mapper_sub.add_parser("purge",help="Delete All privilege mapping")
4081 parser_ldap_mapper_delete.set_defaults(func=deleteAllPrivilegeMapping)
4082
Marri Devender Rao2c2a5162018-11-05 08:57:11 -06004083 # set local user password
4084 parser_set_password = subparsers.add_parser("set_password",
4085 help="Set password of local user")
4086 parser_set_password.add_argument( "-p", "--password", required=True,
4087 help="Password of local user")
4088 parser_set_password.set_defaults(func=setPassword)
4089
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004090 # network
4091 parser_nw = subparsers.add_parser("network", help="network controls")
4092 nw_sub = parser_nw.add_subparsers(title='subcommands',
4093 description='valid subcommands',
4094 help="sub-command help",
4095 dest='command')
4096
4097 # enable DHCP
4098 parser_enable_dhcp = nw_sub.add_parser("enableDHCP",
4099 help="enables the DHCP on given "
4100 "Interface")
4101 parser_enable_dhcp.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004102 help="Name of the ethernet interface(it can"
4103 "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_enable_dhcp.set_defaults(func=enableDHCP)
4107
4108 # disable DHCP
4109 parser_disable_dhcp = nw_sub.add_parser("disableDHCP",
4110 help="disables the DHCP on given "
4111 "Interface")
4112 parser_disable_dhcp.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004113 help="Name of the ethernet interface(it can"
4114 "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_disable_dhcp.set_defaults(func=disableDHCP)
4118
4119 # get HostName
4120 parser_gethostname = nw_sub.add_parser("getHostName",
4121 help="prints out HostName")
4122 parser_gethostname.set_defaults(func=getHostname)
4123
4124 # set HostName
4125 parser_sethostname = nw_sub.add_parser("setHostName", help="sets HostName")
4126 parser_sethostname.add_argument("-H", "--HostName", required=True,
4127 help="A HostName for the BMC")
4128 parser_sethostname.set_defaults(func=setHostname)
4129
4130 # get domainname
4131 parser_getdomainname = nw_sub.add_parser("getDomainName",
4132 help="prints out DomainName of "
4133 "given Interface")
4134 parser_getdomainname.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004135 help="Name of the ethernet interface(it "
4136 "can be obtained by the "
4137 "command:network view-config)"
4138 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004139 parser_getdomainname.set_defaults(func=getDomainName)
4140
4141 # set domainname
4142 parser_setdomainname = nw_sub.add_parser("setDomainName",
4143 help="sets DomainName of given "
4144 "Interface")
4145 parser_setdomainname.add_argument("-D", "--DomainName", required=True,
4146 help="Ex: DomainName=Domain1,Domain2,...")
4147 parser_setdomainname.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004148 help="Name of the ethernet interface(it "
4149 "can be obtained by the "
4150 "command:network view-config)"
4151 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004152 parser_setdomainname.set_defaults(func=setDomainName)
4153
4154 # get MACAddress
4155 parser_getmacaddress = nw_sub.add_parser("getMACAddress",
4156 help="prints out MACAddress the "
4157 "given Interface")
4158 parser_getmacaddress.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004159 help="Name of the ethernet interface(it "
4160 "can be obtained by the "
4161 "command:network view-config)"
4162 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004163 parser_getmacaddress.set_defaults(func=getMACAddress)
4164
4165 # set MACAddress
4166 parser_setmacaddress = nw_sub.add_parser("setMACAddress",
4167 help="sets MACAddress")
4168 parser_setmacaddress.add_argument("-MA", "--MACAddress", required=True,
4169 help="A MACAddress for the given "
4170 "Interface")
4171 parser_setmacaddress.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004172 help="Name of the ethernet interface(it can"
4173 "be obtained by the "
4174 "command:network view-config)"
4175 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004176 parser_setmacaddress.set_defaults(func=setMACAddress)
4177
4178 # get DefaultGW
4179 parser_getdefaultgw = nw_sub.add_parser("getDefaultGW",
4180 help="prints out DefaultGateway "
4181 "the BMC")
4182 parser_getdefaultgw.set_defaults(func=getDefaultGateway)
4183
4184 # set DefaultGW
4185 parser_setdefaultgw = nw_sub.add_parser("setDefaultGW",
4186 help="sets DefaultGW")
4187 parser_setdefaultgw.add_argument("-GW", "--DefaultGW", required=True,
4188 help="A DefaultGateway for the BMC")
4189 parser_setdefaultgw.set_defaults(func=setDefaultGateway)
4190
4191 # view network Config
4192 parser_ldap_config = nw_sub.add_parser("view-config", help="prints out a "
4193 "list of all network's configured "
4194 "properties")
4195 parser_ldap_config.set_defaults(func=viewNWConfig)
4196
4197 # get DNS
4198 parser_getDNS = nw_sub.add_parser("getDNS",
4199 help="prints out DNS servers on the "
4200 "given interface")
4201 parser_getDNS.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004202 help="Name of the ethernet interface(it can"
4203 "be obtained by the "
4204 "command:network view-config)"
4205 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004206 parser_getDNS.set_defaults(func=getDNS)
4207
4208 # set DNS
4209 parser_setDNS = nw_sub.add_parser("setDNS",
4210 help="sets DNS servers on the given "
4211 "interface")
4212 parser_setDNS.add_argument("-d", "--DNSServers", required=True,
4213 help="Ex: DNSSERVERS=DNS1,DNS2,...")
4214 parser_setDNS.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004215 help="Name of the ethernet interface(it can"
4216 "be obtained by the "
4217 "command:network view-config)"
4218 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004219 parser_setDNS.set_defaults(func=setDNS)
4220
4221 # get NTP
4222 parser_getNTP = nw_sub.add_parser("getNTP",
4223 help="prints out NTP servers on the "
4224 "given interface")
4225 parser_getNTP.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004226 help="Name of the ethernet interface(it can"
4227 "be obtained by the "
4228 "command:network view-config)"
4229 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004230 parser_getNTP.set_defaults(func=getNTP)
4231
4232 # set NTP
4233 parser_setNTP = nw_sub.add_parser("setNTP",
4234 help="sets NTP servers on the given "
4235 "interface")
4236 parser_setNTP.add_argument("-N", "--NTPServers", required=True,
4237 help="Ex: NTPSERVERS=NTP1,NTP2,...")
4238 parser_setNTP.add_argument("-I", "--Interface", required=True,
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004239 help="Name of the ethernet interface(it can"
4240 "be obtained by the "
4241 "command:network view-config)"
4242 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
Nagaraju Goruganti9908bcf2018-11-14 22:07:25 -06004243 parser_setNTP.set_defaults(func=setNTP)
4244
Nagaraju Goruganti97a20602018-11-16 03:06:08 -06004245 # configure IP
4246 parser_ip_config = nw_sub.add_parser("addIP", help="Sets IP address to"
4247 "given interface")
4248 parser_ip_config.add_argument("-a", "--address", required=True,
4249 help="IP address of given interface")
4250 parser_ip_config.add_argument("-gw", "--gateway", required=False, default='',
4251 help="The gateway for given interface")
4252 parser_ip_config.add_argument("-l", "--prefixLength", required=True,
4253 help="The prefixLength of IP address")
4254 parser_ip_config.add_argument("-p", "--type", choices=['ipv4', 'ipv6'],
4255 help="The protocol type of the given"
4256 "IP address")
4257 parser_ip_config.add_argument("-I", "--Interface", required=True,
4258 help="Name of the ethernet interface(it can"
4259 "be obtained by the "
4260 "command:network view-config)"
4261 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4262 parser_ip_config.set_defaults(func=addIP)
4263
4264 # getIP
4265 parser_getIP = nw_sub.add_parser("getIP", help="prints out IP address"
4266 "of given interface")
4267 parser_getIP.add_argument("-I", "--Interface", required=True,
4268 help="Name of the ethernet interface(it can"
4269 "be obtained by the command:network view-config)"
4270 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4271 parser_getIP.set_defaults(func=getIP)
4272
4273 # rmIP
4274 parser_rmIP = nw_sub.add_parser("rmIP", help="deletes IP address"
4275 "of given interface")
4276 parser_rmIP.add_argument("-a", "--address", required=True,
4277 help="IP address to remove form given Interface")
4278 parser_rmIP.add_argument("-I", "--Interface", required=True,
4279 help="Name of the ethernet interface(it can"
4280 "be obtained by the command:network view-config)"
4281 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4282 parser_rmIP.set_defaults(func=deleteIP)
4283
Nagaraju Gorugantif21d43c2018-11-19 10:47:19 -06004284 # add VLAN
4285 parser_create_vlan = nw_sub.add_parser("addVLAN", help="enables VLAN "
4286 "on given interface with given "
4287 "VLAN Identifier")
4288 parser_create_vlan.add_argument("-I", "--Interface", required=True,
4289 choices=['eth0', 'eth1'],
4290 help="Name of the ethernet interface")
4291 parser_create_vlan.add_argument("-n", "--Identifier", required=True,
4292 help="VLAN Identifier")
4293 parser_create_vlan.set_defaults(func=addVLAN)
4294
4295 # delete VLAN
4296 parser_delete_vlan = nw_sub.add_parser("deleteVLAN", help="disables VLAN "
4297 "on given interface with given "
4298 "VLAN Identifier")
4299 parser_delete_vlan.add_argument("-I", "--Interface", required=True,
4300 help="Name of the ethernet interface(it can"
4301 "be obtained by the "
4302 "command:network view-config)"
4303 "Ex: eth0 or eth1 or VLAN(VLAN=eth0_50 etc)")
4304 parser_delete_vlan.set_defaults(func=deleteVLAN)
4305
4306 # viewDHCPConfig
4307 parser_viewDHCPConfig = nw_sub.add_parser("viewDHCPConfig",
4308 help="Shows DHCP configured "
4309 "Properties")
4310 parser_viewDHCPConfig.set_defaults(func=viewDHCPConfig)
4311
4312 # configureDHCP
4313 parser_configDHCP = nw_sub.add_parser("configureDHCP",
4314 help="Configures/updates DHCP "
4315 "Properties")
4316 parser_configDHCP.add_argument("-d", "--DNSEnabled", type=str2bool,
4317 required=True, help="Sets DNSEnabled property")
4318 parser_configDHCP.add_argument("-n", "--HostNameEnabled", type=str2bool,
4319 required=True,
4320 help="Sets HostNameEnabled property")
4321 parser_configDHCP.add_argument("-t", "--NTPEnabled", type=str2bool,
4322 required=True,
4323 help="Sets NTPEnabled property")
4324 parser_configDHCP.add_argument("-s", "--SendHostNameEnabled", type=str2bool,
4325 required=True,
4326 help="Sets SendHostNameEnabled property")
4327 parser_configDHCP.set_defaults(func=configureDHCP)
4328
4329 # network factory reset
4330 parser_nw_reset = nw_sub.add_parser("nwReset",
4331 help="Resets networks setting to "
4332 "factory defaults. "
4333 "note:Reset settings will be applied "
4334 "after BMC reboot")
4335 parser_nw_reset.set_defaults(func=nwReset)
4336
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004337 return parser
4338
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004339def main(argv=None):
Justin Thalere412dc22018-01-12 16:28:24 -06004340 """
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004341 main function for running the command line utility as a sub application
4342 """
4343 global toolVersion
Marri Devender Rao82590dc2019-06-06 04:54:22 -05004344 toolVersion = "1.15"
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004345 parser = createCommandParser()
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004346 args = parser.parse_args(argv)
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004347
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004348 totTimeStart = int(round(time.time()*1000))
4349
4350 if(sys.version_info < (3,0)):
4351 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
4352 if sys.version_info >= (3,0):
4353 requests.packages.urllib3.disable_warnings(requests.packages.urllib3.exceptions.InsecureRequestWarning)
Justin Thalere412dc22018-01-12 16:28:24 -06004354 if (args.version):
Justin Thaler22b1bb52018-03-15 13:31:32 -05004355 print("Version: "+ toolVersion)
Justin Thalere412dc22018-01-12 16:28:24 -06004356 sys.exit(0)
4357 if (hasattr(args, 'fileloc') and args.fileloc is not None and 'print' in args.command):
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004358 mysess = None
Justin Thalere412dc22018-01-12 16:28:24 -06004359 print(selPrint('N/A', args, mysess))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004360 else:
Justin Thalere412dc22018-01-12 16:28:24 -06004361 if(hasattr(args, 'host') and hasattr(args,'user')):
4362 if (args.askpw):
4363 pw = getpass.getpass()
4364 elif(args.PW is not None):
4365 pw = args.PW
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05004366 elif(args.PWenvvar):
4367 pw = os.environ['OPENBMCTOOL_PASSWORD']
Justin Thalere412dc22018-01-12 16:28:24 -06004368 else:
4369 print("You must specify a password")
4370 sys.exit()
4371 logintimeStart = int(round(time.time()*1000))
4372 mysess = login(args.host, args.user, pw, args.json)
Justin Thalera9415b42018-05-25 19:40:13 -05004373 if(sys.version_info < (3,0)):
4374 if isinstance(mysess, basestring):
4375 print(mysess)
4376 sys.exit(1)
4377 elif sys.version_info >= (3,0):
4378 if isinstance(mysess, str):
4379 print(mysess)
4380 sys.exit(1)
Justin Thalere412dc22018-01-12 16:28:24 -06004381 logintimeStop = int(round(time.time()*1000))
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004382
4383 commandTimeStart = int(round(time.time()*1000))
Justin Thalere412dc22018-01-12 16:28:24 -06004384 output = args.func(args.host, args, mysess)
4385 commandTimeStop = int(round(time.time()*1000))
Justin Thaler761484a2019-03-26 19:20:23 -05004386 if isinstance(output, dict):
4387 print(json.dumps(output, sort_keys=True, indent=4, separators=(',', ': '), ensure_ascii=False))
4388 else:
4389 print(output)
Justin Thalere412dc22018-01-12 16:28:24 -06004390 if (mysess is not None):
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004391 logout(args.host, args.user, pw, mysess, args.json)
4392 if(args.procTime):
Justin Thalere412dc22018-01-12 16:28:24 -06004393 print("Total time: " + str(int(round(time.time()*1000))- totTimeStart))
4394 print("loginTime: " + str(logintimeStop - logintimeStart))
4395 print("command Time: " + str(commandTimeStop - commandTimeStart))
4396 else:
Joseph Reynoldsa2d54c52019-06-11 22:02:57 -05004397 print("usage:\n"
4398 " OPENBMCTOOL_PASSWORD=secret # if using -E\n"
4399 " openbmctool.py [-h] -H HOST -U USER {-A | -P PW | -E} [-j]\n" +
Justin Thalere412dc22018-01-12 16:28:24 -06004400 "\t[-t POLICYTABLELOC] [-V]\n" +
Deepak Kodihalli22d4df02018-09-18 06:52:43 -05004401 "\t{fru,sensors,sel,chassis,collect_service_data, \
4402 health_check,dump,bmc,mc,gardclear,firmware,logging}\n" +
Justin Thalere412dc22018-01-12 16:28:24 -06004403 "\t...\n" +
4404 "openbmctool.py: error: the following arguments are required: -H/--host, -U/--user")
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004405 sys.exit()
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004406
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004407if __name__ == '__main__':
Justin Thalere412dc22018-01-12 16:28:24 -06004408 """
4409 main function when called from the command line
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004410
4411 """
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004412 import sys
Nagaraju Gorugantic1a00af2018-11-07 00:52:11 -06004413
Justin Thalerf9aee3e2017-12-05 12:11:09 -06004414 isTTY = sys.stdout.isatty()
4415 assert sys.version_info >= (2,7)
4416 main()