Filter
Top Products
3-47
User Guide for Resource Manager Essentials 4.1
OL-11714-01
Chapter 3 Adding and Troubleshooting Devices Using Device Management
Device List Manipulation Service
Device List Manipulation Service
The Device List Manipulation Service (DLMS) allows other network management systems to
manipulate Device and Credential Repository devices. You can perform the following, using DLMS:
• Add devices (See Adding Devices to Device Credentials Using DLMS)
• List the RME devices and their status (See Listing the Devices and Their Status Using DLMS)
• Get the device credentials data (See Getting the Device Credentials Data)
• Set the device credentials data (See Setting the Device Credentials Using DLMS)
• Get the device IP address (See Getting the Device IP Address.)
You perform these operations by sending HTTP requests to a special URL. The URL identifies a servlet
that accepts the request and authenticates the requesting user's identity and credentials before
authorizing the information exchange. The servlet then parses the request, which is encoded in XML,
performs the operations, and returns the results in either XML or CSV format (CSV version 3.0).
You must ensure that your HTTP client can create, write, and read sockets.
Create the code to call the following Device List Manipulation Service URL, and pass in the content of
the XML file using the HTTP POST method (you can use either Java or PERL):
http://CiscoWorks-host:port/rme/com.cisco.nm.rmeng.inventory.servlet.DeviceListService
Where,
• CiscoWorks_host is the CiscoWorks server hostname.
• The default CiscoWorks port is 1741
To enable secured connection through HTTPS for DLMS, you must configure cmf-app.conf
(NMSROOT\MDC\Apache\conf) to allow HTTPS access for the servlet
rme/com.cisco.nm.rmeng.inventory.servlet.DeviceListService:
To configure cmf-app.conf:
Step 1 Add the following text as one line to the file:
SetEnvIf Request_URI /rme/com.cisco.nm.rmeng.inventory.servlet.DeviceListService
allow_https
Step 2 Restart the daemons.
HTTPS access is now enabled.
Create the code to call the following Device List Manipulation Service URL, and pass in the content of
the XML file using the HTTPS POST method (you can use either Java or PERL):
https://CiscoWorks_host
:port/rme/com.cisco.nm.rmeng.inventory.servlet.DeviceListService
Where,
• CiscoWorks_host is the CiscoWorks server hostname.
• The default CiscoWorks port is 1741