Device Configuration Properties

To view and edit device configuration properties at the root level:

  1. From the Navigation bar, select Infrastructure.
  2. In the tree view, click Details.
  3. Select Configuration Properties.

To view and edit device configuration properties that are set at a specific device class, navigate to that class, click Details, and then select Configuration Properties.

You can also view and edit device configuration at the individual device level. Select the device from the device list, and then select Configuration Properties from the left panel.

The following table lists device configuration properties.

Device Configuration Properties
Property Name Property Type Description
zCiscoACEUseSSL boolean Whether to use SSL when connecting to ACE XML API.
zCiscoNXAPIInterval int Value in seconds of the rediscovery interval using the Cisco NX-API protocol. Default value is 300.
zCiscoRemodelEventClassKeys lines Allows you to modify the list of SNMP traps that will cause Zenoss to schedule an immediate remodeling of the device from which the trap was sent.
zCiscoUCSCIMCEventsInterval int Event collection interval in seconds. Default is 60.
zCiscoUCSCIMCPerfInterval int Metric collection interval in seconds. Default is 300.
zCiscoUCSManagerPassword password UCS Manager username password
zCiscoUCSManagerPerfInterval int Seconds between UCS Manager statistics collections. Default value is 300.
zCiscoUCSManagerPort int Port used to connect to the UCS Manager or CIMC XML APIs. Default is 443 and typically should not be changed.
zCiscoUCSManagerUseSSL boolean Whether to use SSL when connecting to the UCS Manager or CIMC XML APIs. Default is true and typically should not be changed.
zCiscoUCSManagerUser string UCS Manager username
zCollectorClientTimeout int Allows you to set the timeout time of the collector client in seconds
zCollectorDecoding string Converts incoming characters to Unicode.
zCollectorLogChanges boolean Indicates whether to log changes.
zCommandCommandTimeout float Specifies the time to wait for a command to complete.
zCommandExistanceTest string DEPRECATED - No longer used.
zCommandLoginTimeout float Specifies the time to wait for a login prompt.
zCommandLoginTries int Sets the number of times to attempt login.
zCommandPassword password Specifies the password to use when performing command logins and SSH.
zCommandPath string Sets the default path where ZenCommand plug-ins are installed on the local Resource Manager box (or on a remote box where SSH is used to run the command).
zCommandPort int Specifies the port to connect to when performing command collection.
zCommandProtocol string Establishes the protocol to use when performing command collection. Possible values are SSH and telnet.
zCommandSearchPath lines Sets the path to search for any commands.
zCommandUsername string Specifies the user name to use when performing command collection and SSH.
zControlCenterHost string Control Center Host Name. Defaults to device name.
zControlCenterModelCycle int Control Center Modeling inteval. Defaults to 3600s.
zControlCenterPassword password Control Center username password
zControlCenterPerfCycle int Control Center Performance Collection interval. Defaults to 300s.
zControlCenterPort int Port for Control Center. Defaults to HTTPS TCP/443
zControlCenterUser string Control Center username
zDBInstances *** ***instancecredentials. This setting is only relevant when the zenoss.winrm.WinMSSQL modeler plugin is enabled. Multiple instances can be specified to monitor multiple SQL Server instances per server. The default instance is MSSQLSERVER. Fill in the user and password to use SQL authentication. Leave the user and password blank to use Windows authentication.
zDeviceTemplates lines Sets the templates associated with this device. Linked by name.
zEnablePassword boolean True or False to specify use of password for Cisco routers.
zFileSystemMapIgnoreNames string Sets a regular expression of file system names to ignore.
zFileSystemMapIgnoreTypes lines Do not use.
zFileSystemSizeOffset int SNMP typically reports the total space available to privileged users. Resource Manager (like the dfcommand) reports capacity based on the space available to non-privileged users. The value of zFileSystemSizeOffset should be the fraction of the total space that is available to non-privileged users. The default reserved value is 5% of total space, so zFileSystemSizeOffset is preset to .95. If the reserved portion is different than 5%, then adjust the value of zFileSystemSizeOffset accordingly. The fraction should be set according to the value ( Used + Avail) / Sizewhen the df -PkHcommand is run at the command line.
zHardDiskMapMatch string Regular expression that uses the disk ID in the diskstats output to filter disk activity statistics for inclusion in performance monitoring.
zIcon lines Specifies the icon to represent the device wherever device icon is shown, such as on the network map and device status page.
zIdiomPassword password IDIOM API password for Cisco IDS/IPS devices.
zIdiomUsername string IDIOM API username for Cisco IDS/IPS devices.
zIfDescription boolean Shows the interface description field in the interface list.
zInterfaceMapIgnoreDescriptions string Filters out interfaces based on description.
zInterfaceMapIgnoreNames string Filters out interfaces that should not be discovered. If you want to use an expression to define this property, note that only Python regular expressions are valid.
zInterfaceMapIgnoreTypes string Filters out interface maps that should not be discovered.
zIpServiceMapMaxPort int Specifies the highest port to scan. The default is 1024.
zJBossJmxManagementAuthenticate boolean DEPRECATED - No longer used.
zJBossJmxManagementPassword password JMX password
zJBossJmxManagementPort int The port number used to gather JMX information
zJBossJmxManagementUsername string JMX username for authentication.
zJmxAuthenticate boolean True or False to enable/disable authentication.
zJmxManagementPort int Port that enables JMX management
zJmxPassword password JMX username password
zJmxUsername string JMX username
zKeyPath string Sets the path to the SSH key for device access.
zLDAPBaseDN string The Base Distinguished Name for your LDAP server. Typically this is the organization's domain name (for example, dc=foobar,dc=com)
zLDAPBindDN string The Distinguished Name to use for binding to the LDAP server, if authentication is required.
zLDAPBindPassword string The password to use for binding to the LDAP server, if authentication is required.
zLDOMsAutodiscover boolean Specify true or false for autodiscovery of LDOMs.
zLTMVirtualServerIgnoreNames string Regular expression that can be used to prevent matching LTM Virtual Servers from being modeled.
zLinks string Specifies a place to enter any links associated with the device.
zLocalInterfaceNames string Regular expression that uses interface name to determine whether the IP addresses on an interface should be incorporated into the network map. For instance, a loopback interface "lo" might be excluded.
zLocalIpAddresses string Specifies IP addresses that should be excluded from the network map (for example. 127.x addresses). If you have addresses that you reuse for connections between clustered machines they might be added here as well.
zMaxOIDPerRequest int Sets the maximum number of OIDs to be sent by the SNMP collection daemons when querying information. Some devices have small buffers for handling this information so the number should be lowered.
zMySQLConnectionString string Enables setting the path, type and credentials for the MySQL connections. For example: Path: /server/Linux/devices/localhost.localdomain, Type: miltilnecredentials, MYSQL connection credentials: User Password Port
zMySqlPassword password MySQL user password
zMySqlPort string MySQL connection port
zMySqlTimeout int MySQL timeout. Default value is 30s.
zMySqlUsername string MySQL username
zNetAppSSL boolean Boolean true or false to enable SSL use with the NetApp Monitor.
zNmapPortscanOptions string Options used on nmap when scanning ports. Used in IpServiceMap.
zPingMonitorIgnore boolean Whether or not to ping the device.
zProdStateThreshold int Production state threshold at which Resource Manager will begin to monitor a device.
zPropertyMonitorInterval int Polling interval of the configured property data sources. System-wide setting. Default is 300s.
zPythonClass string DO NOT USE
zRancidGroup string RANCID group attribute. Controls what router.db file the device is written to. Can be set at the device class or device level. Default is router on the /Network/Router/Cisco class.
zRancidRoot string File system directory where RANCID is installed. It may be NFS mounted from the RANCID server. Default is /opt/rancid
zRancidType string RANCID type attribute. Controls what device type is written to the router.db file. Can be set at the device class or device level. Default is cisco on the /Network/Router/Cisco class.
zRancidUrl string Base URL
zRouteMapCollectOnlyIndirect boolean Only collect routes that are indirectly connected to the device.
zRouteMapCollectOnlyLocal boolean Only collect local routes. (These usually are manually configured rather than learned through a routing protocol.)
zRouteMapMaxRoutes int Sets maximum number of routes to collect. Default value is 500.
zSnmpAuthPassword password The shared private key used for authentication. Must be at least 8 characters long.
zSnmpAuthType string Use "MD5" or "SHA" signatures to authenticate SNMP requests
zSnmpCollectionInterval int Defines, in seconds, how often the system collects performance information for each device.
zSnmpCommunities lines Array of SNMP community strings that ZenModeler uses when collecting SNMP information. When you set this property, communities are tried in order; the first in the list that is successful is used as zSnmpCommunity. If none is successful, then the current value of zSnmpCommunity is used. The default value for the entire system is "public."
zSnmpCommunity string Community string to be used when collecting SNMP information. If it is different than what is found by ZenModeler, it will be set on the modeled device.
zSnmpContext string Configures zSNMP context to map logical network entity such as a topology or protocol instance.
zSnmpDiscoveryPorts int List of UDP ports to try when performing SNMP discovery. Defaults to 161 if not set.
zSnmpEngineId string SNMPv3 engine ID for the device. Will be discovered when SNMPv3 is used.
zSnmpMonitorIgnore boolean Whether or not to ignore monitoring SNMP on a device.
zSnmpPort int Port that the SNMP agent listens on.
zSnmpPrivPassword password The shared private key used for encrypting SNMP requests. Must be at least 8 characters long.
zSnmpPrivType string "DES" or "AES" cryptographic algorithms.
zSnmpSecurityName string The Security Name (user) to use when making SNMPv3 requests.
zSnmpTimeout float Timeout time in seconds for an SNMP request
zSnmpTries int Amount of tries to collect SNMP data
zSnmpVer string SNMP version used. Valid values are v2c, v1
zSshConcurrentSessions int Maximum number of sessions supported by the remote device's MAX_SESSIONS parameter. Common values for AIX are 2 or 10.
zStatusConnectTimeout float The amount of time that the zenstatus daemon should wait before marking an IP service down.
zSugarCRMBase - DEPRECATED - No longer used.
zSugarCRMPassword password Password for the zSugarCRMUsername user.
zSugarCRMTestAccount - DEPRECATED - No longer used.
zSugarCRMUsername string Username allowed to log in to the Sugar CRM server.
zSysedgeDiskMapIgnoreNames string Regular expression used by zenoss.snmp.SysedgeDiskMap modeler plugin. Disks with matching names will not be modeled.
zTelnetEnable boolean When logging into a Cisco device issue the enable command to enable access during command collection.
zTelnetEnableRegex string Regular expression to match the enable prompt.
zTelnetLoginRegex string Regular expression to match the login prompt.
zTelnetPasswordRegex string Regular expression to match the password prompt.
zTelnetPromptTimeout float Time to wait for the telnet prompt to return.
zTelnetSuccessRegexList lines List of regular expressions to match the command prompt.
zTelnetTermLength boolean On a Cisco device, set term length to Zero.
zTomcatJ2EEApplicationName string Used to construct MBean names for a specific application deployed on Tomcat, typically used for JSP and Servlet statistics.
zTomcatJ2EEServerName string Used to construct MBean names for a specific application deployed on Tomcat, typically used for JSP and Servlet statistics.
zTomcatJmxManagementAuthenticate - DEPRECATED - No longer used.
zTomcatJmxManagementPassword password JMX password.
zTomcatJmxManagementPort int The port number used to gather JMX information.
zTomcatJmxManagementUsername string JMX username for authentication.
zTomcatListenHost string The hostname on which Tomcat is listening for web requests. This is used to construct MBean names
zTomcatListenPort string The Tomcat connector, which is a port and protocol (http, jk...) that Tomcat is listening on. This is used to construct MBean names that monitor bytes, error and requests on that connector.
zTomcatServletName string Specific Servlet name to monitor.
zTomcatServletUri string URI of Servlet to monitor.
zTomcatWebAppUri string URI path for a Tomcat web application. Used to construct MBean names.
zVCloudPassword password Password for the zVCloudUsername user.
zVCloudPort int Value of the cell port number
zVCloudUsername string Username for the cell in the form username@organization. For example, if you want to define the cell administrator, enter administrator@system.
zVSphereEndpointHost string vSphere host name
zVSphereEndpointPassword password vSphere username password
zVSphereEndpointPort int Port that is used to connect to vSphere Endpoint.
zVSphereEndpointUseSsl boolean vSphere boolean true or false for SSL use
zVSphereEndpointUser string vSphere username
zVSphereHostCollectionClusterWhitelist lines The whitelist filters the hosts that are monitored, based on cluster names.
zVSphereHostPingBlacklist lines List of regular expressions to control which management IP address to ping (matches against hostname:nicname:ip).
zVSphereHostPingWhitelist lines List of regular expressions to control which management IP address to ping (matches against hostname:nicname:ip).
zVSphereHostSystemPassword password Password that is used to access ESX hosts via ssh and API.
zVSphereHostSystemUser string User name that is used to access ESX hosts via ssh and API.
zVSphereLUNContextMetric boolean Controls whether to use LUN-specific metric names when storing performance data.

Note: The default value is False. Changing the value to True causes historical metrics to become inaccessible. For more information, contact Zenoss Support.

zVSphereModelCache lines vSphere model cache
zVSphereModelIgnore lines vSphere model ignore
zVSphereModelMpIndexObjs int Advanced tuning parameter. For more information, contact Zenoss Support.
zVSphereModelMpLevel int Advanced tuning parameter. For more information, contact Zenoss Support.
zVSphereModelMpObjs int Advanced tuning parameter. For more information, contact Zenoss Support.
zVSpherePerfDelayCollectionMinutes int Value of how long to lag performance data collection. Default value is 0.
zVSpherePerfMaxAgeMinutes int Default value is 28 minutes.
zVSpherePerfParallelQueries int Default value is 6.
zVSpherePerfQueryChunkSize int Value of how many performance requests to make at a time. Default value is 250.
zVSpherePerfQueryRaw20 boolean Default value is true.
zVSpherePerfQueryTimeout int Default value is 200.
zVSpherePerfQueryVcChunkSize int Default value is 64.
zVSpherePerfQueryVcRaw20 boolean Default value is false.
zVSpherePerfRecoveryMinutes int Default value is 240 minutes.
zVSpherePerfTimeoutRecoveryMinutes int When a timeout error occurs in querying a specific metric, it is "blacklisted" for this number of minutes before it is retried. This action avoids repeated errors due to attempts to query a metric that is not working properly. The default is one hour. If gaps appear in the graphs, you can safely lower the value.
zVSphereVMContextMetric boolean Controls whether to use VM-specific metric names when storing performance data.

Note: The default value is False. Changing the value to True causes historical metrics to become inaccessible. For more information, contact Zenoss Support.

zVSpherePerfWindowSize int DEPRECATED - No longer used.
zWBEMPassword password WBEM password
zWBEMPort int Value of the WBEM port number. Default value is 5989.
zWBEMUseSSL boolean True or false value to use SSL. Default value is true.
zWBEMUsername string WBEM username
zWebLogicJmxManagementAuthenticate - DEPRECATED - No longer used.
zWebLogicJmxManagementPassword password JMX password
zWebLogicJmxManagementPort int The port number used to gather JMX information
zWebLogicJmxManagementUsername string JMX username for authentication
zWebTxAgent string Default value is ZenWebTx/1.0.
zWebTxPassword password WebTx password
zWebTxRealm string WebTx realm
zWebTxUser string WebTx user
zWebsphereAuthRealm string Used for HTTP basic authentication. This field is not required, and is empty by default.
zWebsphereNode string Used by the provided template to build the queries for the data to collect. You must supply a value for this field. For example: serverA
zWebspherePassword password Used for HTTP basic authentication. This field is not required, and is empty by default.
zWebsphereServer string Used by the provided template to build the xpath queries for the data to collect. You must supply a value for this field. For example: serverAB, There is no default value.
zWebsphereURLPath string Path to the PMI servlet on a WebSphere instance. The default value is the default path on a WebSphere installation: wasPerTool/servlet/perfservlet
zWebsphereUser string Used for HTTP basic authentication. This field is not required, and is empty by default.
zWinKDC string IP address or Fully Qualified Domain Name of a valid Windows domain controller. Must be set if domain authentication is used.
zWinKeyTabFilePath string This property is currently used and reserved for future use when keytab files are supported.
zWinPerfmonInterval int Interval, in seconds, at which Windows Perfmon datapoints will be collected. Default value is 300. It is possible to override the collection interval for individual counters.
zWinRMPassword password Password for the user defined by zWinRMUser
zWinRMPort int The port on which the Windows server is listening for WinRM or WS-Management connections. Default value is 5985. It is uncommon for this to be configured as anything else.
zWinRMServerName string

This property should only be used in conjunction with domain authentication when the DNS PTR record for a monitored server's managed IP address does not resolve to the name by which the server is known in Active Directory. For example, if myserver1 is known as myserver1.ad.example.com by Active Directory and is being managed by IP address 192.51.100.21, but 192.51.100.21 resolves to www.example.com, you will have to set zWinRMServerName to myserver1.ad.example.com for domain authentication to work.

If many Windows servers in your environment don't have DNS PTR records that match Active Directory, it is recommended that you set the name of the Zenoss device to be the fully-qualified Active Directory name and set zWinRMServerName to ${here/titleOrId} at the /Server/Microsoft/Windows device class. This avoids the necessity of setting zWinRMServerName on every device.

It is recommended to leave zWinRMServerName blank if local authentication is used, or DNS PTR records match Active Directory. This allows Zenoss to not rely on DNS resolution while monitoring, and avoids the overhead of configuring zWinRMServerName.

zWinRMUser string The syntax used for zWinRMUser controls whether Zenoss will attempt Windows local authentication or domain (kerberos) authentication. If the value of zWinRMUser is username, local Windows authentication will be used. If zWinRMUser is username@example.com, domain authentication will be used. The zWinKDC and potentially the zWinRMServerName properties become important.
zWinScheme string This must be set to either http or https. Default value is http.
zWinTrustedKDC string Windows Trusted KDC
zWinTrustedRealm string Windows Trusted Realm