DINA JMX

The following JMX operations apply to DINA version 1.1 and later:

Device cache operations: Device cache operations
Group lock service operations: Group lock service operations
Job status operations: Job status operations
Zone transfer operations: Zone transfer operations
Group manager operations: Group manager operations
DINA retention service operations: DINA retention service operations
Database thread pool metrics: Database thread pool metrics
Health check endpoint

Table 1 Device cache operations
Operation	Description	Endpoint
listCache	List cached devices (MacIDs).	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/updateCache
updateCache	Initiates an incremental update on the cache.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/updateCache
resetActiveDeviceCache ("emptyCache" in DINA 1.0.x)	Empties the cache of active devices and resets the last update value.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/resetActiveDeviceCache
rebuildCache	Rebuilds the contents of the cache by clearing active devices, and fetching them again from DMS. The update on MacID ↔ ESN mappings is still incremental.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/rebuildCache
clearMacIdEsnMapping	Clears all MacId-ESN mapping information.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/clearMacIdEsnMapping
clearEsnMacIdMapping	Clears all ESN-MacId mapping information.	http://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/clearEsnMacIdMapping
getDeviceByEsn	Fetch device for given ESN.	http://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/getDeviceByEsn/<esn>
getDeviceByMac	Fetch device for given MacID	http://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DeviceCacheManager/getDeviceByMac/<macId>

Table 2 Group lock service operations
Operation	Description	Endpoint
lock	Locks a group. Valid value for lock type: GROUP_MANAGEMENT DOWNLOAD_JOB	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=GroupLockService/lock/<groupId>/<lockType>/lockId>
isLocked	Checks if a group is locked.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=GroupLockService/isLocked/<groupId>
getLockCount	Total number of group locks returned.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=GroupLockService/getLockCount
releaseLock	Releases a lock from a group.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=GroupLockService/releaseLock/<groupId>
releaseAllLocks	Removes all group locks.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=GroupLockService/releaseAllLocks

Table 3 Job status operations
Operations	Description	Endpoint
getJobExecutionStatus	Get status and summary for a job execution.	https:/dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getJobExecutionStatus/<jobId>/<jobExecId>
getAllJobExecHistory	Get job execution history for a job id.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getAllJobExecHistory/<jobId>
getJobExecutionHistoryByUpgradeId	Get Job Execution history for a Upgrade Id.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getJobExecutionHistoryByUpgradeId/<upgradeId>
getJobById	Get job by job Id.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getJobById/<jobId>
getJobsList	Get jobs list by correltaionId and jobType.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getJobsList/<jobType>/<correlationId>
getActiveJobsList	Get active jobs with running jobExecutionHistory.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getJobsList/
getDevicesMap	Get Device Task Status and macIds against each device task status from job_device_status table for a job exec id.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getActiveJobsList
getStageUpdateHistoryByUpgradeId	Get Stage Update History By Upgrade Id.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/getStageUpdateHistoryByUpgradeId/<upgradeId>
triggerJobDeviceStatusUpdatePersistence	Trigger a persistence task that saves the content of the job device status ignite queue to the database.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/triggerJobDeviceStatusUpdatePersistence
triggerStageUpdatePersistence	Trigger a persistence task that saves the content of the stage update ignite queue to the database.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/triggerStageUpdatePersistence
triggerAgentDownloadCleanup	Trigger the scheduled job that cleans up expired agent download tasks using a given timeout in minutes.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/triggerAgentDownloadCleanup/<timeoutMinutes>
peekStageUpdateDeviceCacheQueue	Get the first element from the stage update result queue without removing it.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/peekStageUpdateDeviceCacheQueue
peekJobDeviceStatusCacheQueue	Get the first element from the job device status queue without removing it.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/peekJobDeviceStatusCacheQueue
addToStageUpdateDeviceCacheQueue	Add an element to the stage update result queue of ignite.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/addToStageUpdateDeviceCacheQueue/ <upgradeId>/<stageId>/<stageCompleted>/<totalCount>/<failedCount>/<runningCount>/<successCount>
addToJobDeviceStatusCacheQueue	Add an element to the job device status queue of ignite.	https://<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/addToJobDeviceStatusCacheQueue/ <joId>/<deviceTaskStatus>/<longMacId>/<jobExecId>
findDeviceInJobDeviceStatus	Query Job device statuses by the given Ids (job id, job exec id, long mac id).	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaJobStatus/findDeviceInJobDeviceStatus/ <jobId>/<jobExecId>/<longMacId>

Table 4 Zone transfer operations
Operations	Description	Endpoint
startIncrementalZoneTransfer	Start incremental DNS zone transfer.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DnsZoneTransfer/startIncrementalZoneTransfer
getDnsCacheEntry	Lookup macId in DNS cache.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DnsZoneTransfer/getDnsCacheEntry/<NoColonMacId>

Table 5 Group manager operations
Operations	Description	Endpoint
deleteGroups	Delete groups from database.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=GroupManager/deleteGroups/<commaSeparatedGroups>

Table 6 DINA retention service operations
Operation	Description	Endpoint
purgeJobData	Purge job table records on the basis of purge period (days) provided in the URL.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaDataRetention/purgeJobData/1
purgeGroupRelatedRecords	Purge dina_group and group_device table records on the basis of purge period (days) provided in the URL.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaDataRetention/purgeGroupData/1
purgeStageUpdateHistory	Purge stage_update_history table records on the basis of purge period provided in the URL.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaDataRetention/purgeStageUpdateData/1
purgeJobExecutionHistory	Purge job_execution_history table records on the basis of purge period provided in the URL.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaDataRetention/purgeJobExecutionHistory/1
purgeCommandStatus	Purge command_status table and job_device_status records on the basis of purge period (i.e days) provided in the URL.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DinaDataRetention/purgeCommandStatus/1

Table 7 Database thread pool metrics
Operation	Description	Endpoint
getMaxConnections	Get the maximum number of connections.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DataBaseMetrics/getMaxConnections
getCurrentConnections	Get the number of connections currently in use.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DataBaseMetrics/getCurrentConnections
getAvailableConnections	Get the number of connections available.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DataBaseMetrics/getAvailableConnections
getDatSourcePoolStatistics	Get a summary of the thread statistics.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DataBaseMetrics/getDatSourcePoolStatistics
getThreadSummary	Get an HTML report of the currently active connections.	https://dina01.<host-name>:<dina-port>/jolokia/exec/ssn:name=DataBaseMetrics/getThreadSummary