| | |
- compareKernel(kernelVersion)
- Checks if kernel version is newer then given version
Args: kernelVersion - The kernel version string to compare
Returns: -1, 0, 1
-1 if Installed kernel version older than kernelVerion
0 if Installed kernel version equals kernelVerion
1 if Installed kernel version newer than kernelVerion
Example:
KERNEL_VERSION = '3.0.93'
INSTALLED_VERSION = SUSE.compareKernel(KERNEL_VERSION)
if( INSTALLED_VERSION < 0 ):
Core.updateStatus(Core.CRIT, "Bug detected in kernel version " + KERNEL_VERSION + " or before, update server for fixes")
else:
Core.updateStatus(Core.IGNORE, "Bug fixes applied for " + KERNEL_VERSION)
- compareRPM(package, versionString)
- Compares the versionString to the installed package's version
Args: package - RPM package name
versionString - RPM package version string to compare against
Returns: -1, 0, 1
-1 if RPM_NAME older than RPM_VERSION
0 if RPM_NAME equals RPM_VERSION
1 if RPM_NAME newer than RPM_VERSION
Example:
RPM_NAME = 'mypackage'
RPM_VERSION = '1.1.0'
if( SUSE.packageInstalled(RPM_NAME) ):
INSTALLED_VERSION = SUSE.compareRPM(RPM_NAME, RPM_VERSION)
if( INSTALLED_VERSION <= 0 ):
Core.updateStatus(Core.CRIT, "Bug detected in " + RPM_VERSION + ", update server for fixes")
else:
Core.updateStatus(Core.IGNORE, "Bug fixes applied for " + RPM_VERSION)
else:
Core.updateStatus(Core.ERROR, "ERROR: " + RPM_NAME + " not installed")
- getDriverInfo(DRIVER_NAME)
- Gets information about the specified kernel driver
Args: DRIVER_NAME - The kernel driver name on which you want details
Returns: Dictionary with keys
name (String) - The kernel driver name
loaded (Boolean) - True if loaded, otherwise False
filename (String) - The driver filename
version (String) - The driver's version string
license (String) - The driver's license string
description (String) - Description of the driver
srcversion (String) - The driver's source version
supported (String) - Support status string, usually yes or no
vermagic (String) - Version magic string
Example:
DRIVER_NAME = 'zapi'
DRIVER_INFO = SUSE.getDriverInfo(DRIVER_NAME)
if( DRIVER_INFO['loaded'] ):
Core.updateStatus(STATUS_IGNORE, "Package " + RPM_INFO['name'] + str(RPM_INFO['version']) + " is installed")
else:
Core.updateStatus(STATUS_WARNING, "Package " + RPM_INFO['name'] + str(RPM_INFO['version']) + " is missing, install it")
- getHostInfo()
- Gets information about the server
Args: None
Returns: Dictionary with keys
Hostname (String) - The hostname of the server analyzed
KernelVersion (String) - The running kernel version
Architecture (String)
Distro (String) - The name of the distribution
DistroVersion (Int) - The major distribution version number
DistroPatchLevel (Int) - The distribution service patch level
OES (Boolean) - True if OES installed, False if no OES found
OESDistro (String) The name of the OES distribution
OESVersion (Int) - The major OES version number
OESPatchLevel (Int) - The OES service patch level
Example:
import re
SERVER = SUSE.getHostInfo()
SLE = re.compile("SUSE Linux Enterprise Server", re.IGNORECASE)
if SLE.search(SERVER['Distro']):
if( SERVER['DistroVersion'] >= 11 and SERVER['DistroVersion'] < 12 ):
Core.updateStatus(Core.WARN, "SLES" + str(SERVER['DistroVersion']) + "SP" + str(SERVER['DistroPatchLevel']) + ": Testing required")
else:
Core.updateStatus(Core.IGNORE, "SLES" + str(SERVER['DistroVersion']) + "SP" + str(SERVER['DistroPatchLevel']) + ": No Testing Needed")
else:
Core.updateStatus(Core.ERROR, SERVER['Distro'] + ": Invalid Distribution for Test Case")
- getRpmInfo(PackageName)
- Retrieves RPM package information from supportconfig files using the specified PackageName
Args: PackageName - RPM package name on which you want details
Returns: Dictionary with keys
name (String) - The RPM package name
version (String) - The RPM package version string
vendor (String) - The RPM vendor
installTime (String) - The date and time the package was installed
Example:
RPM_NAME = 'kernel-xen'
RPM_INFO = SUSE.getRpmInfo(RPM_NAME)
if( len(RPM_INFO) > 0 ):
Core.updateStatus(STATUS_IGNORE, "Package " + RPM_INFO['name'] + str(RPM_INFO['version']) + " is installed")
else:
Core.updateStatus(STATUS_WARNING, "Package " + RPM_INFO['name'] + str(RPM_INFO['version']) + " is missing, install it")
- getScInfo()
- Gets information about the supportconfig archive itself
Args: None
Returns: Dictionary with keys
envValue (String) - Environment value
kernelValue (Integer) - Kernel number based on its version
cmdline (String) - Supportconfig's command line arguments
config (String) - Supportconfig configuration options
version (String) - Supportconfig version
scriptDate (String) - Supportconfig script date
Example:
REQUIRED_VERSION = '2.25-173';
SC_INFO = SUSE.getSCInfo();
if( Core.compareVersions(SC_INFO['version'], REQUIRED_VERSION) >= 0 ):
Core.updateStatus(Core.IGNORE, "Supportconfig v" + str(SC_INFO['version']) + " meets minimum requirement")
else:
Core.updateStatus(Core.WARN, "Supportconfig v" + str(SC_INFO['version']) + " NOT sufficient, " + str(REQUIRED_VERSION) + " or higher needed")
- getServiceDInfo(SERVICE_NAME)
- Returns a dictionary of systemd service information for SERVICE_NAME
Args: SERVICE_NAME - Name of systemd service
Returns: Dictionary with keys corresponding to systemctl show SERVICE_NAME
output.
Example:
SERVICE = 'cups.service'
SERVICE_INFO = SUSE.getServiceDInfo(SERVICE)
if( SERVICE_INFO['SubState'] == 'running' ):
Core.updateStatus(Core.IGNORE, "Service is running: " + str(SERVICE_NAME));
else:
Core.updateStatus(Core.WARN, "Service is down: " + str(SERVICE_NAME));
- getServiceInfo(SERVICE_NAME)
- Returns a dictionary of system service information for SERVICE_NAME
Args: SERVICE_NAME - Name of System V service
Returns: Dictionary with keys
Name (String) - System V service name
Running (Integer) - -1=Unknown, 0=Unused or Dead, 1=Running
BootLevels (String) - A list of runlevel numbers in which the service is
turned on for boot. An empty string means the service is turned off at
boot for all runlevels.
RunLevel (String) - The current system runlevel
OnForRunLevel (Bool) - False=Service is turned off for the current runlevel, True=Service is turned on for the current runlevel
Known (Bool) - True=The service is found in the service table, False=The service is not known and only partial information may be included.
Example:
SERVICE = 'cups'
SERVICE_INFO = SUSE.getServiceInfo(SERVICE)
if( SERVICE_INFO['Running'] > 0 ):
Core.updateStatus(Core.IGNORE, "Service is running: " + str(SERVICE_NAME));
else:
Core.updateStatus(Core.WARN, "Service is down: " + str(SERVICE_NAME));
- packageInstalled(PackageName)
- The PackageName is installed on the server
Args: PackageName - The RPM package name to check if installed
Returns: True or False
True PackageName is installed
False PackageName is NOT installed
Example:
PACKAGE_NAME = 'bind'
if ( SUSE.packageInstalled(PACKAGE_NAME) ):
Core.updateStatus(Core.WARN, "The package " + PACKAGE_NAME + " is installed")
else:
Core.updateStatus(Core.IGNORE, "The package " + PACKAGE_NAME + " is NOT installed")
- securityAnnouncementPackageCheck(NAME, MAIN, LTSS, SEVERITY, TAG, PACKAGES)
- Specialty function for SUSE Security Announcements (http://lists.opensuse.org/opensuse-security-announce/) that checks the versions of the listed PACKAGES and displays a uniform output string. If any one of the packages listed is less than the fixed version in the PACKAGES dictionary, a hit is triggered. The MAIN is optional. If the MAIN package is installed the other PACKAGES are checked, otherwise no packages are checked. If MAIN is missing, all PACKAGES are checked.
Args: NAME (String) - The display name of the package group being checked
MAIN (String) - The MAIN package that must be present as a condition of checking the others; leave blank to check all PACKAGES
LTSS (Boolean) - True if an LTSS package, False if not
SEVERITY (String) - The severity of the security announcement (ie 'Critical', 'Important', etc)
TAG (String) - The specific security announcement tag (ie SUSE-SU-2012:0000-0)
PACKAGES (Dictionary) - A dictionary of package names for keys and their fixed version number for values
Returns: True if at least one from PACKAGES was installed, False if no PACKAGES were installed
Example:
LTSS = False
NAME = 'Firefox'
MAIN = 'MozillaFirefox'
SEVERITY = 'Important'
TAG = 'SUSE-SU-2012:0000-0'
PACKAGES = {}
SERVER = SUSE.getHostInfo()
if ( SERVER['DistroVersion'] == 11 and SERVER['DistroPatchLevel'] == 3 ):
PACKAGES = {
'libfreebl3': '3.16.1-0.8.1',
'MozillaFirefox': '24.6.0esr-0.8.1',
'MozillaFirefox-translations': '24.6.0esr-0.8.1',
'mozilla-nspr': '4.10.6-0.3.1',
'mozilla-nss': '3.16.1-0.8.1',
}
SUSE.securityAnnouncementPackageCheck(NAME, MAIN, LTSS, SEVERITY, TAG, PACKAGES)
else:
Core.updateStatus(Core.ERROR, "ERROR: " + NAME + " Security Announcement: Outside the distribution scope")
- serviceDHealth(SERVICE_NAME)
- Reports the health of the specified systemd service
Args: SERVICE_NAME
Returns: N/A
Example:
PACKAGE = "cups"
SERVICE = "cups.service"
if( SUSE.packageInstalled(PACKAGE) ):
SUSE.serviceDHealth(SERVICE)
else:
Core.updateStatus(Core.ERROR, "Basic Service Health; Package Not Installed: " + str(PACKAGE))
|