Package ZenModel :: Module Device :: Class Device
[hide private]
[frames] | no frames]

Class Device

source code

                                                   object --+            
                                                            |            
                                    ZenModelBase.ZenModelBase --+        
                                                                |        
Products.ZenRelations.RelationshipManager.RelationshipManager --+        
                                                                |        
                                      ExtensionClass.Base --+   |        
                                                            |   |        
                                       OFS.History.Historical --+        
                                                                |        
                                                   object --+   |        
                                                            |   |        
                                          ZenPacker.ZenPacker --+        
                                                                |        
                                            ZenModelRM.ZenModelRM --+    
                                                                    |    
                                  DeviceResultInt.DeviceResultInt --+    
                                                                    |    
                                                       object --+   |    
                                                                |   |    
                                              EventView.EventView --+    
                                                                    |    
                                                       object --+   |    
                                                                |   |    
                                                  RRDView.RRDView --+    
                                                                    |    
                                          ManagedEntity.ManagedEntity --+
                                                                        |
                                              Commandable.Commandable --+
                                                                        |
                                                           object --+   |
                                                                    |   |
                                                    Lockable.Lockable --+
                                                                        |
                          MaintenanceWindowable.MaintenanceWindowable --+
                                                                        |
                        AdministrativeRoleable.AdministrativeRoleable --+
                                                                        |
                                              ZenMenuable.ZenMenuable --+
                                                                        |
                                                                       Device

Device is a base class that represents the idea of a single computer system that is made up of software running on hardware. It currently must be IP enabled but maybe this will change.

Instance Methods [hide private]
 
__init__(self, id, buildRelations=True) source code
 
isTempDevice(self) source code
 
changeDeviceClass(self, deviceClassPath, REQUEST=None)
Wrapper for DeviceClass.moveDevices.
source code
 
getRRDTemplate(self)
DEPRECATED
source code
list
>>> from Products.ZenModel.Device import manage_addDevice
>>> manage_addDevice(devices, 'test')
>>> devices.test.getRRDTemplates()
[<RRDTemplate at /zport/dmd/Devices/rrdTemplates/Device>]
getRRDTemplates(self)
Returns all the templates bound to this Device
source code
 
getRRDNames(self) source code
list
getDataSourceOptions(self)
Returns the available DataSource options.
source code
int
sysUpTime(self)
Returns the cached sysUpTime for this device
source code
string
availability(self, *args, **kw)
Returns the uptime of this device
source code
 
__getattr__(self, name)
Override from object to handle lastPollSnmpUpTime and snmpLastCollection
source code
 
_setPropValue(self, id, value)
Override from PropertyManager to handle checks and ip creation
source code
 
applyDataMap(self, datamap, relname="", compname="", modname="")
Apply a datamap passed as a list of dicts through XML-RPC.
source code
 
path(self)
Return a sequence of path tuples suitable for indexing by a MultiPathIndex.
source code
list
traceRoute(self, target, ippath=None)
Trace the route to target using our routing table.
source code
 
getMonitoredComponents(self, collector=None, type=None)
Return list of monitored DeviceComponents on this device.
source code
list
getDeviceComponents(self, monitored=None, collector=None, type=None)
Return list of all DeviceComponents on this device.
source code
 
getDeviceComponentsNoIndexGen(self)
Return a list of all device components by walking relations.
source code
SnmpConnInfo object
getSnmpConnInfo(self)
Returns an object containing SNMP Connection Info
source code
string
getHWManufacturerName(self)
DEPRECATED - Return the hardware manufacturer name of this device.
source code
string
getHWProductName(self)
Return the hardware product name of this device.
source code
string
getHWProductKey(self)
DEPRECATED - Return the productKey of the device hardware.
source code
string
getOSManufacturerName(self)
DEPRECATED - Return the OS manufacturer name of this device.
source code
string
getOSProductName(self)
DEPRECATED - Return the OS product name of this device.
source code
string
getOSProductKey(self)
DEPRECATED - Return the productKey of the device OS.
source code
 
setOSProductKey(self, prodKey, manufacturer="Unknown")
Set the productKey of the device OS.
source code
string
getHWTag(self)
DEPRECATED - Return the tag of the device HW.
source code
 
setHWTag(self, assettag)
Set the asset tag of the device hardware.
source code
 
setHWProductKey(self, prodKey, manufacturer="Unknown")
Set the productKey of the device hardware.
source code
 
setHWSerialNumber(self, number)
Set the hardware serial number.
source code
string
getHWSerialNumber(self)
DEPRECATED - Return the hardware serial number.
source code
 
followNextHopIps(self)
Return the ips that our indirect routs point to which aren't currently connected to devices.
source code
string
getLocationName(self)
Return the full location name ie /Location/SubLocation/Rack
source code
string
getLocationLink(self)
Return a link to the device's location.
source code
list
getSystemNames(self)
Return the system names for this device
source code
string
getSystemNamesString(self, sep=', ')
Return the system names for this device as a string
source code
list
getDeviceGroupNames(self)
Return the device group names for this device
source code
PerformanceMonitor
getPerformanceServer(self)
Return the device performance server
source code
string
getPerformanceServerName(self)
Return the device performance server name
source code
 
getNetworkRoot(self)
Return the network root object
source code
DateTime
getLastChange(self)
Return DateTime of last change detected on this device.
source code
string
getLastChangeString(self)
Return date string of last change detected on this device.
source code
DateTime
getSnmpLastCollection(self)
Return DateTime of last SNMP collection on this device.
source code
string
getSnmpLastCollectionString(self)
Return date string of last SNMP collection on this device.
source code
string
setManageIp(self, ip="", REQUEST=None)
Set the manage IP, if IP is not passed perform DNS lookup.
source code
string
getManageIp(self)
Return the management ip for this device.
source code
IpAddress
getManageIpObj(self)
DEPRECATED - Return the management ipobject for this device.
source code
IpInterface
getManageInterface(self)
Return the management interface of a device based on its manageIp.
source code
string
uptimeStr(self)
Return the SNMP uptime
source code
list
getPeerDeviceClassNames(self)
Build a list of all device paths that have the python class pyclass
source code
 
manage_snmpCommunity(self)
Reset the snmp community using the zSnmpCommunities variable.
source code
 
manage_editDevice(self, tag="", serialNumber="", zSnmpCommunity="", zSnmpPort=161, zSnmpVer="", rackSlot="", productionState=1000, comments="", hwManufacturer="", hwProductName="", osManufacturer="", osProductName="", locationPath="", groupPaths=[], systemPaths=[], performanceMonitor="localhost", priority=3, zProperties=None, REQUEST=None)
Edit the device relation and attributes.
source code
boolean
monitorDevice(self)
Returns true if the device production state >= zProdStateThreshold.
source code
boolean
snmpMonitorDevice(self)
Returns true if the device is subject to SNMP monitoring
source code
string
getProductionStateString(self)
Return the prodstate as a string.
source code
int
getPriority(self)
Return the numeric device priority.
source code
string
getPriorityString(self)
Return the device priority as a string.
source code
string
getPingStatusString(self)
Return the pingStatus as a string
source code
string
getSnmpStatusString(self)
Return the snmpStatus as a string
source code
 
setProdState(self, state, maintWindowChange=False, REQUEST=None)
Set the device's production state.
source code
 
setPriority(self, priority, REQUEST=None)
Set the device's priority
source code
 
setLastChange(self, value=None)
Set the changed datetime for this device.
source code
 
setSnmpLastCollection(self, value=None)
Set the last time snmp collection occurred.
source code
 
addManufacturer(self, newHWManufacturerName=None, newSWManufacturerName=None, REQUEST=None)
DEPRECATED - Add either a hardware or software manufacturer to the database.
source code
 
setHWProduct(self, newHWProductName=None, hwManufacturer=None, REQUEST=None)
DEPRECATED - Adds a new hardware product
source code
 
setOSProduct(self, newOSProductName=None, osManufacturer=None, REQUEST=None)
DEPRECATED Adds a new os product
source code
 
setLocation(self, locationPath, REQUEST=None)
Set the location of a device.
source code
 
addLocation(self, newLocationPath, REQUEST=None)
DEPRECATED Add a new location and relate it to this device
source code
 
setPerformanceMonitor(self, performanceMonitor, newPerformanceMonitor=None, REQUEST=None)
Set the performance monitor for this device.
source code
 
setGroups(self, groupPaths)
Set the list of groups for this device based on a list of paths
source code
 
addDeviceGroup(self, newDeviceGroupPath, REQUEST=None)
DEPRECATED? Add a device group to the database and this device
source code
 
setSystems(self, systemPaths)
Set a list of systems to this device using their system paths
source code
 
addSystem(self, newSystemPath, REQUEST=None)
DEPRECATED? Add a systems to this device using its system path
source code
 
setTerminalServer(self, termservername)
Set the terminal server of this device
source code
 
_setRelations(self, relName, objGetter, relPaths)
Set related objects to this device
source code
HTML output
getExpandedLinks(self)
Return the expanded zComment property
source code
 
device(self)
Support DeviceResultInt mixin class.
source code
boolean
pastSnmpMaxFailures(self)
Returns true if the device has more SNMP failures than maxFailures on its status mon.
source code
 
getLastPollSnmpUpTime(self)
Get the value of the snmpUpTime status object
source code
 
setLastPollSnmpUpTime(self, value)
Set the value of the snmpUpTime status object
source code
 
snmpAgeCheck(self, hours)
Returns True if SNMP data was collected more than 24 hours ago
source code
 
applyProductContext(self)
Apply zProperties inherited from Product Contexts.
source code
 
_applyProdContext(self, context)
Apply zProperties taken for the product context passed in.
source code
 
collectDevice(self, setlog=True, REQUEST=None, generateEvents=False)
Collect the configuration of this device AKA Model Device
source code
 
deleteDevice(self, deleteStatus=False, deleteHistory=False, deletePerf=False, REQUEST=None)
Delete device from the database
source code
 
manage_deleteHeartbeat(self, REQUEST=None)
Delete this device's heartbeats.
source code
 
renameDevice(self, newId=None, REQUEST=None)
Rename device from the DMD
source code
 
renameDeviceInEvents(self, old, new)
update the device column in the status and history tables for rows associated with this device
source code
 
renameDeviceInPerformance(self, old, new)
Rename the directory that holds performance data for this device.
source code
 
manage_afterAdd(self, item, container)
Device only propagates afterAdd if it is the added object.
source code
 
manage_afterClone(self, item)
DEPRECATED
source code
 
manage_beforeDelete(self, item, container)
Device only propagates beforeDelete if we are being deleted or copied.
source code
 
unindex_ips(self)
IpAddresses aren't contained underneath Device, so manage_beforeDelete won't propagate.
source code
 
cacheComponents(self)
Read current RRD values for all of a device's components
source code
 
getUserCommandTargets(self)
Called by Commandable.doCommand() to ascertain objects on which a UserCommand should be executed.
source code
 
getUserCommandEnvironment(self)
Returns the tales environment used to evaluate the command
source code
 
getUrlForUserCommands(self)
Returns a URL to redirect to after a command has executed used by Commandable
source code
 
getHTMLEventSummary(self, severity=4)
Returns HTML Event Summary of a device
source code
 
getDataForJSON(self, minSeverity=0)
Returns data ready for serialization
source code
 
exportXmlHook(self, ofile, ignorerels)
Add export of our child objects.
source code
 
zenPropertyOptions(self, propname)
Returns a list of possible options for a given zProperty
source code
 
pushConfig(self, REQUEST=None)
This will result in a push of all the devices to live collectors
source code
 
bindTemplates(self, ids=(), REQUEST=None)
This will bind available templates to the zDeviceTemplates
source code
 
removeZDeviceTemplates(self, REQUEST=None)
Deletes the local zProperty, zDeviceTemplates
source code
 
addLocalTemplate(self, id, REQUEST=None)
Create a local template on a device
source code
 
getAvailableTemplates(self)
Returns all available templates for this device
source code
 
getLinks(self, OSI_layer='3')
Returns all Links on this Device's interfaces
source code
 
getXMLEdges(self, depth=3, filter="/", start=())
Gets XML
source code
HTML text
getPrettyLink(self)
Gets a link to this device, plus an icon
source code
 
updateProcesses(self, relmaps)
Uses ProcessClasses to create processes to monitor
source code

Inherited from ZenModelRM.ZenModelRM: changePythonClass, creator, editableDeviceList, findChild, getCreatedTimeString, getDmdKey, getModificationTimeString, getSubObjects, getTreeItems, getZenRootNode, index_object, primarySortKey, reindex_all, rename, unindex_object, viewName, zmanage_addProperty, zmanage_delObjects, zmanage_delProperties, zmanage_editProperties, zmanage_exportObject, zmanage_importObject, zmanage_importObjects

Inherited from ZenModelBase.ZenModelBase: __call__, __hash__, all_meta_types, aqBaseHasAttr, breadCrumbs, callZenScreen, checkRemotePerm, checkValidId, createHierarchyObj, custPropertyIds, custPropertyMap, getBreadCrumbUrlPath, getDmd, getDmdObj, getDmdRoot, getHierarchyObj, getIconPath, getIdLink, getNowString, getObjByPath, getPrimaryDmdId, getUnusedId, getZ, getZopeObj, helpLink, isLocalName, manage_deleteObjects, prepId, saveCustProperties, todayDate, urlLink, view, visibleCustPropertyMap, yesterdayDate, zenScreenUrl, zenpathjoin, zenpathsplit, zentinelTabs

Inherited from OFS.History.Historical: manage_afterHistoryCopy, manage_beforeHistoryCopy, manage_change_history, manage_historicalComparison, manage_historyCompare, manage_historyCopy

Inherited from ZenPacker.ZenPacker: addToZenPack, eligiblePacks, findObject

Inherited from DeviceResultInt.DeviceResultInt: getDeviceClassName, getDeviceClassPath, getDeviceIp, getDeviceIpAddress, getDeviceLink, getDeviceMacaddress, getDeviceName, getDeviceUrl, getPingStatus, getPingStatusNumber, getProdState, getSnmpStatus, getSnmpStatusNumber, isResultLockedFromDeletion, isResultLockedFromUpdates, sendEventWhenResultBlocked

Inherited from EventView.EventView: convertEventField, getEventDetail, getEventDetailFromStatusOrHistory, getEventHistory, getEventManager, getEventOwnerList, getEventSummary, getStatus, getStatusCssClass, getStatusImgSrc, getStatusString, manage_ackBatchEvents, manage_ackEvents, manage_addLogMessage, manage_createEventMap, manage_deleteBatchEvents, manage_deleteEvents, manage_setEventStates, manage_undeleteBatchEvents, manage_undeleteEvents

Inherited from RRDView.RRDView: cacheRRDValue, fetchRRDValue, fetchRRDValues, fullRRDPath, getDefaultGraphDefs, getGraphDef, getGraphDefUrl, getRRDContextData, getRRDDataPoint, getRRDDataPoints, getRRDFileName, getRRDPaths, getRRDSum, getRRDTemplateByName, getRRDTemplateName, getRRDValue, getRRDValues, getThresholdInstances, getThresholds, makeLocalRRDTemplate, removeLocalRRDTemplate, rrdPath, snmpIgnore

Inherited from Commandable.Commandable: compile, doCommandForTarget, getAqChainForUserCommands, getUserCommand, getUserCommandIds, getUserCommands, manage_addUserCommand, manage_deleteUserCommand, manage_doUserCommand, manage_editUserCommand, redirectToUserCommands, write

Inherited from Lockable.Lockable: getNextLockableParent, isLockedFromDeletion, isLockedFromUpdates, isUnlocked, lockFromDeletion, lockFromUpdates, lockStatus, lockWarning, sendEventWhenBlocked, setSendEventWhenBlockedFlag, unlock, unsetSendEventWhenBlockedFlag

Inherited from object: __delattr__, __getattribute__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __str__

Inherited from MaintenanceWindowable.MaintenanceWindowable: getMaintenanceWindows, manage_addMaintenanceWindow, manage_deleteMaintenanceWindow

Inherited from AdministrativeRoleable.AdministrativeRoleable: getAdministrativeRoles, manage_addAdministrativeRole, manage_deleteAdministrativeRole, manage_editAdministrativeRoles, manage_listAdministrativeRoles, setAdminLocalRoles

Inherited from ZenMenuable.ZenMenuable: buildMenus, getMenus, manage_addItemsToZenMenu, manage_addZenMenu, manage_addZenMenuItem, manage_deleteZenMenu, manage_deleteZenMenuItem, manage_saveMenuItemOrdering

Class Variables [hide private]
  meta_type = 'Device'
  portal_type = 'Device'
  event_key = 'Device'
  default_catalog = "deviceSearch"
  relationshipManagerPathRestriction = '/Devices'
  manageIp = ""
  productionState = 1000
  preMWProductionState = 1000
  snmpAgent = ""
  snmpDescr = ""
  snmpOid = ""
  snmpContact = ""
  snmpSysName = ""
  snmpLocation = ""
  rackSlot = ""
  comments = ""
  sysedgeLicenseMode = ""
  priority = 3
  _temp_device = False
  _properties = ManagedEntity._properties+({'id': 'manageIp', 't...
  _relations = ManagedEntity._relations+(("deviceClass", ToOne(T...
  factory_type_information = {'id': 'Device', 'meta_type': 'Devi...
  security = ClassSecurityInfo()

Inherited from ManagedEntity.ManagedEntity: monitor, snmpindex

Inherited from ZenModelRM.ZenModelRM: isInTree

Inherited from ZenModelBase.ZenModelBase: index_html, sub_meta_types

Inherited from OFS.History.Historical: HistoricalRevisions, __ac_permissions__, manage_change_history_page, manage_options

Inherited from OFS.History.Historical (private): _manage_historyComparePage

Inherited from Commandable.Commandable: defaultTimeout

Inherited from Lockable.Lockable: modelerLock, sendEventWhenBlockedFlag

Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self, id, buildRelations=True)
(Constructor)

source code 
Overrides: ZenModelRM.ZenModelRM.__init__

changeDeviceClass(self, deviceClassPath, REQUEST=None)

source code 
Wrapper for DeviceClass.moveDevices. The primary reason to use this method instead of that one is that this one redirects the user to the device in the web interface instead of the new device class.
Parameters:
  • deviceClassPath (string) - device class in DMD path
  • REQUEST (Zope REQUEST object) - Zope REQUEST object

getRRDTemplate(self)

source code 
DEPRECATED
Overrides: RRDView.RRDView.getRRDTemplate

getRRDTemplates(self)

source code 
Returns all the templates bound to this Device
Returns: list
>>> from Products.ZenModel.Device import manage_addDevice
>>> manage_addDevice(devices, 'test')
>>> devices.test.getRRDTemplates()
[<RRDTemplate at /zport/dmd/Devices/rrdTemplates/Device>]
Overrides: RRDView.RRDView.getRRDTemplates

getRRDNames(self)

source code 
Overrides: RRDView.RRDView.getRRDNames

getDataSourceOptions(self)

source code 
Returns the available DataSource options. DataSource options are used to populate the dropdown when adding a new DataSource and is a string. See RRDTemplate.RRDTemplate.getDataSourceOptions for more information.
Returns: list
[(displayName, dsOption),]

availability(self, *args, **kw)

source code 
Returns the uptime of this device
Returns: string

To Do: Performance enhancement: Should move import outside of method

__getattr__(self, name)
(Qualification operator)

source code 
Override from object to handle lastPollSnmpUpTime and snmpLastCollection

To Do: Not sure this is needed, see getLastPollSnmpUpTime and getSnmpLastCollection

_setPropValue(self, id, value)

source code 
Override from PropertyManager to handle checks and ip creation

To Do: Not sure this is needed, see setSnmpLastCollection

traceRoute(self, target, ippath=None)

source code 
Trace the route to target using our routing table. Wrapper method of OperatingSystem.traceRoute
Parameters:
  • target (string) - Device name
  • ippath (list) - IP addesses
Returns: list
IP Addresses

getMonitoredComponents(self, collector=None, type=None)

source code 
Return list of monitored DeviceComponents on this device. Wrapper method for getDeviceComponents

getDeviceComponents(self, monitored=None, collector=None, type=None)

source code 
Return list of all DeviceComponents on this device.
Returns: list

Permission: ZEN_VIEW

getDeviceComponentsNoIndexGen(self)

source code 
Return a list of all device components by walking relations. This is much slower then the normal getDeviceComponents method which uses the component index. It is used when rebuilding the device indexes.

getHWManufacturerName(self)

source code 
DEPRECATED - Return the hardware manufacturer name of this device.
Returns: string

To Do: Remove this method and remove the call from testDevice.py

getHWProductKey(self)

source code 
DEPRECATED - Return the productKey of the device hardware.
Returns: string

To Do: Remove this method and remove the call from testDevice.py

getOSManufacturerName(self)

source code 
DEPRECATED - Return the OS manufacturer name of this device.
Returns: string

To Do: Remove this method and remove the call from testDevice.py

getOSProductName(self)

source code 
DEPRECATED - Return the OS product name of this device.
Returns: string

To Do: Remove this method and remove the call from testDevice.py

getOSProductKey(self)

source code 
DEPRECATED - Return the productKey of the device OS.
Returns: string

To Do: Remove this method and remove the call from testDevice.py

getHWTag(self)

source code 
DEPRECATED - Return the tag of the device HW.
Returns: string

To Do: remove this method and remove the call from testDevice.py

getHWSerialNumber(self)

source code 
DEPRECATED - Return the hardware serial number.
Returns: string

To Do: Remove this method and remove the call from testDevice.py

followNextHopIps(self)

source code 
Return the ips that our indirect routs point to which aren't currently connected to devices.

To Do: Can be moved to zendisc.py

getLocationName(self)

source code 
Return the full location name ie /Location/SubLocation/Rack
Returns: string

Permission: ZEN_VIEW

getLocationLink(self)

source code 
Return a link to the device's location.
Returns: string

Permission: ZEN_VIEW

getSystemNames(self)

source code 
Return the system names for this device
Returns: list

Permission: ZEN_VIEW

getSystemNamesString(self, sep=', ')

source code 
Return the system names for this device as a string
Returns: string

Permission: ZEN_VIEW

getDeviceGroupNames(self)

source code 
Return the device group names for this device
Returns: list

Permission: ZEN_VIEW

getPerformanceServer(self)

source code 
Return the device performance server
Returns: PerformanceMonitor

Permission: ZEN_VIEW

getPerformanceServerName(self)

source code 
Return the device performance server name
Returns: string

Permission: ZEN_VIEW

getLastChange(self)

source code 
Return DateTime of last change detected on this device.
Returns: DateTime

Permission: ZEN_VIEW

getLastChangeString(self)

source code 
Return date string of last change detected on this device.
Returns: string

Permission: ZEN_VIEW

getSnmpLastCollection(self)

source code 
Return DateTime of last SNMP collection on this device.
Returns: DateTime

Permission: ZEN_VIEW

getSnmpLastCollectionString(self)

source code 
Return date string of last SNMP collection on this device.
Returns: string

Permission: ZEN_VIEW

setManageIp(self, ip="", REQUEST=None)

source code 
Set the manage IP, if IP is not passed perform DNS lookup.
Returns: string

Permission: ZEN_ADMIN_DEVICE

getManageIp(self)

source code 
Return the management ip for this device.
Returns: string

Permission: ZEN_VIEW

getManageIpObj(self)

source code 
DEPRECATED - Return the management ipobject for this device.
Returns: IpAddress

To Do: This method may not be called anywhere, remove it.

getManageInterface(self)

source code 
Return the management interface of a device based on its manageIp.
Returns: IpInterface

Permission: ZEN_VIEW

uptimeStr(self)

source code 
Return the SNMP uptime
Returns: string

Permission: ZEN_VIEW

manage_snmpCommunity(self)

source code 
Reset the snmp community using the zSnmpCommunities variable.

Permission: ZEN_CHANGE_DEVICE

manage_editDevice(self, tag="", serialNumber="", zSnmpCommunity="", zSnmpPort=161, zSnmpVer="", rackSlot="", productionState=1000, comments="", hwManufacturer="", hwProductName="", osManufacturer="", osProductName="", locationPath="", groupPaths=[], systemPaths=[], performanceMonitor="localhost", priority=3, zProperties=None, REQUEST=None)

source code 
Edit the device relation and attributes.
Parameters:
  • locationPath (string) - path to a Location
  • groupPaths (list) - paths to DeviceGroups
  • systemPaths (list) - paths to Systems
  • performanceMonitor (string) - name of PerformanceMonitor

Permission: ZEN_CHANGE_DEVICE

setProdState(self, state, maintWindowChange=False, REQUEST=None)

source code 
Set the device's production state.
Parameters:
  • state (int) - new production state
  • maintWindowChange (boolean) - are we resetting state from inside a MW?

Permission: ZEN_CHANGE_DEVICE

setPriority(self, priority, REQUEST=None)

source code 
Set the device's priority

Permission: ZEN_CHANGE_DEVICE

setLastChange(self, value=None)

source code 
Set the changed datetime for this device.
Parameters:
  • value (float) - secs since the epoch, default is now

Permission: ZEN_CHANGE_DEVICE

setSnmpLastCollection(self, value=None)

source code 
Set the last time snmp collection occurred.
Parameters:
  • value (float) - secs since the epoch, default is now

Permission: ZEN_CHANGE_DEVICE

addManufacturer(self, newHWManufacturerName=None, newSWManufacturerName=None, REQUEST=None)

source code 
DEPRECATED - Add either a hardware or software manufacturer to the database.

Permission: ZEN_CHANGE_DEVICE

To Do: Doesn't really do work on a device object. Already exists on ZDeviceLoader

setHWProduct(self, newHWProductName=None, hwManufacturer=None, REQUEST=None)

source code 
DEPRECATED - Adds a new hardware product

Permission: ZEN_CHANGE_DEVICE

To Do: Doesn't really do work on a device object. Already exists on ZDeviceLoader

setOSProduct(self, newOSProductName=None, osManufacturer=None, REQUEST=None)

source code 
DEPRECATED Adds a new os product

Permission: ZEN_CHANGE_DEVICE

To Do: Doesn't really do work on a device object. Already exists on ZDeviceLoader

setLocation(self, locationPath, REQUEST=None)

source code 
Set the location of a device. If the location is new it will be created.

Permission: ZEN_CHANGE_DEVICE

addLocation(self, newLocationPath, REQUEST=None)

source code 
DEPRECATED Add a new location and relate it to this device

To Do: Doesn't really do work on a device object. Already exists on ZDeviceLoader

setPerformanceMonitor(self, performanceMonitor, newPerformanceMonitor=None, REQUEST=None)

source code 
Set the performance monitor for this device. If newPerformanceMonitor is passed in create it

Permission: ZEN_CHANGE_DEVICE

setGroups(self, groupPaths)

source code 
Set the list of groups for this device based on a list of paths

Permission: ZEN_CHANGE_DEVICE

addDeviceGroup(self, newDeviceGroupPath, REQUEST=None)

source code 
DEPRECATED? Add a device group to the database and this device

Permission: ZEN_CHANGE_DEVICE

To Do: Already exists on ZDeviceLoader

setSystems(self, systemPaths)

source code 
Set a list of systems to this device using their system paths

Permission: ZEN_CHANGE_DEVICE

addSystem(self, newSystemPath, REQUEST=None)

source code 
DEPRECATED? Add a systems to this device using its system path

Permission: ZEN_CHANGE_DEVICE

To Do: Already exists on ZDeviceLoader

setTerminalServer(self, termservername)

source code 
Set the terminal server of this device
Parameters:
  • termservername - device name of terminal server

Permission: ZEN_CHANGE_DEVICE

_setRelations(self, relName, objGetter, relPaths)

source code 
Set related objects to this device
Parameters:
  • relName - name of the relation to set
  • objGetter - method to get the relation
  • relPaths - list of relationship paths

device(self)

source code 
Support DeviceResultInt mixin class. Returns itself
Overrides: ManagedEntity.ManagedEntity.device

Permission: ZEN_VIEW

getLastPollSnmpUpTime(self)

source code 
Get the value of the snmpUpTime status object

Permission: ZEN_MANAGE_DEVICE_STATUS

setLastPollSnmpUpTime(self, value)

source code 
Set the value of the snmpUpTime status object

Permission: ZEN_MANAGE_DEVICE_STATUS

_applyProdContext(self, context)

source code 
Apply zProperties taken for the product context passed in.
Parameters:
  • context - list of tuples returned from getProductContext on a MEProduct.

collectDevice(self, setlog=True, REQUEST=None, generateEvents=False)

source code 
Collect the configuration of this device AKA Model Device
Parameters:
  • setlog - If true, set up the output log of this process

Permission: ZEN_MANAGE_DEVICE

To Do: generateEvents param is not being used.

deleteDevice(self, deleteStatus=False, deleteHistory=False, deletePerf=False, REQUEST=None)

source code 

Delete device from the database

NB: deleteHistory is disabled for the 2.2 release. In some circumstances it was causing many subprocesses to be spawned and creating a gridlock situation.

Permission: ZEN_ADMIN_DEVICE

manage_deleteHeartbeat(self, REQUEST=None)

source code 
Delete this device's heartbeats.
Overrides: EventView.EventView.manage_deleteHeartbeat

Permission: ZEN_MANAGE_DEVICE

renameDevice(self, newId=None, REQUEST=None)

source code 
Rename device from the DMD
Parameters:
  • newId (string) - new name
  • REQUEST (Zope REQUEST object) - Zope REQUEST object

Permission: ZEN_ADMIN_DEVICE

renameDeviceInPerformance(self, old, new)

source code 
Rename the directory that holds performance data for this device.
Parameters:
  • old (string) - old performance directory name
  • new (string) - new performance directory name

manage_beforeDelete(self, item, container)

source code 
Device only propagates beforeDelete if we are being deleted or copied. Moving and renaming don't propagate.

unindex_ips(self)

source code 
IpAddresses aren't contained underneath Device, so manage_beforeDelete won't propagate. Thus we must remove those links explicitly.

getUserCommandTargets(self)

source code 
Called by Commandable.doCommand() to ascertain objects on which a UserCommand should be executed.
Overrides: Commandable.Commandable.getUserCommandTargets

getUserCommandEnvironment(self)

source code 
Returns the tales environment used to evaluate the command
Overrides: Commandable.Commandable.getUserCommandEnvironment

getUrlForUserCommands(self)

source code 
Returns a URL to redirect to after a command has executed used by Commandable
Overrides: Commandable.Commandable.getUrlForUserCommands

pushConfig(self, REQUEST=None)

source code 
This will result in a push of all the devices to live collectors

Permission: ZEN_MANAGE_DEVICE

bindTemplates(self, ids=(), REQUEST=None)

source code 
This will bind available templates to the zDeviceTemplates

Permission: ZEN_EDIT_LOCAL_TEMPLATES

removeZDeviceTemplates(self, REQUEST=None)

source code 
Deletes the local zProperty, zDeviceTemplates

Permission: ZEN_EDIT_LOCAL_TEMPLATES

addLocalTemplate(self, id, REQUEST=None)

source code 
Create a local template on a device

Permission: ZEN_EDIT_LOCAL_TEMPLATES

getLinks(self, OSI_layer='3')

source code 
Returns all Links on this Device's interfaces

Permission: ZEN_VIEW

getPrettyLink(self)

source code 
Gets a link to this device, plus an icon
Returns: HTML text

Permission: ZEN_VIEW


Class Variable Details [hide private]

_properties

Value:
ManagedEntity._properties+({'id': 'manageIp', 'type': 'string', 'mode'\
: 'w'}, {'id': 'productionState', 'type': 'keyedselection', 'mode': 'w\
', 'select_variable': 'getProdStateConversions', 'setter': 'setProdSta\
te'}, {'id': 'preMWProductionState', 'type': 'keyedselection', 'mode':\
 'w', 'select_variable': 'getProdStateConversions', 'setter': 'setProd\
State'}, {'id': 'snmpAgent', 'type': 'string', 'mode': 'w'}, {'id': 's\
nmpDescr', 'type': 'string', 'mode': ''}, {'id': 'snmpOid', 'type': 's\
tring', 'mode': ''}, {'id': 'snmpContact', 'type': 'string', 'mode': '\
...

_relations

Value:
ManagedEntity._relations+(("deviceClass", ToOne(ToManyCont, "Products.\
ZenModel.DeviceClass", "devices")), ("perfServer", ToOne(ToMany, "Prod\
ucts.ZenModel.PerformanceConf", "devices")), ("location", ToOne(ToMany\
, "Products.ZenModel.Location", "devices")), ("systems", ToMany(ToMany\
, "Products.ZenModel.System", "devices")), ("groups", ToMany(ToMany, "\
Products.ZenModel.DeviceGroup", "devices")), ("maintenanceWindows", To\
ManyCont(ToOne, "Products.ZenModel.MaintenanceWindow", "productionStat\
e")), ("adminRoles", ToManyCont(ToOne, "Products.ZenModel.Administrati\
...

factory_type_information

Value:
{'id': 'Device', 'meta_type': 'Device', 'description': """Base class f\
or all devices""", 'icon': 'Device_icon.gif', 'product': 'ZenModel', '\
factory': 'manage_addDevice', 'immediate_view': 'deviceStatus', 'actio\
ns':({'id': 'status', 'name': 'Status', 'action': 'deviceStatus', 'per\
missions':(ZEN_VIEW,)}, {'id': 'osdetail', 'name': 'OS', 'action': 'de\
viceOsDetail', 'permissions':(ZEN_VIEW,)}, {'id': 'hwdetail', 'name': \
'Hardware', 'action': 'deviceHardwareDetail', 'permissions':(ZEN_VIEW,\
)}, {'id': 'swdetail', 'name': 'Software', 'action': 'deviceSoftwareDe\
...