MDR-Management

casm1401
HID_CMDB_MDR_Management
The MDR Launcher is an open integration tool that lets you view data in a management data repository (MDR) from a CA CMDB web page. MDR Launcher lets you obtain additional details about a CI and to gain control over it (if the MDR supports such control).
Manage Federated CI Mappings
A single CI can be associated to multiple MDRs, with each MDR having a federated_asset_id that identifies the CI. While it is not necessary for the federated_asset_id to be unique among MDRs, a federated_asset_id must be unique within each MDR.
Each MDR is identified uniquely by its combination of MDR class and MDR name.
To view the CI in a particular MDR context, click Launch. The target MDR is launched in the context of the CI that was open.
View an MDR Location for a CI
You can display the MDR location for a CI.
  • CI Name
    Identifies the configuration item.
  • Federated Asset ID
    Specifies the string that the source MDR uses to identify this CI. The MDR software typically determines this identifier. CMDBf Viewer uses the UUID.
  • MDR Name
    Identifies the MDR.
  • Active
    Denotes whether this mapping is active or not. You can inactivate mappings but not delete them.
Manage MDRs
Before you can associate a CI with an MDR, define the MDR to CA SDM.
To define a new MDR, follow these steps:
  1. On the MDR List, click Create New.
    The Create New MDR Definition page appears.
  2. Enter the definition for the new MDR.
  3. Click Save.
    The MDR definition is saved.
When you associate a CI with an MDR, the Add MDR button does not appear until the CI is first saved and then edited.
Manage an MDR Definition
You can create, view, and edit an MDR definition. The MDR Definition page provides the following settings:
  • Tenant
    Identifies the tenant owner of this MDR (if multi-tenancy is installed).
  • Button Name
    Defines the MDR button label that appears on the CI Detail page. This name is unique for each MDR. Required for “launch in context” and for CMDBf Viewer.
  • MDR Name
    Specifies the data that is sent in the mdr_name field in XML. While this string can be anything that the MDR chooses to send to CA CMDB, typically it is the hostname of the source. This name together with the mdr_class create a unique name for the MDR. 
    CA APM MDRs must specify an MDR name of APM and MDR class of GLOBAL. Required for “launch in context", CMDBf Viewer and GRLoader.
  • MDR Class
    Specifies the data that is sent in the mdr_class field in the XML. While this name can be anything, it must together with the mdr_name field create a unique identifier for the MDR. Global MDRs are defined with an MDR Class of “GLOBAL”. 
    Cohesion MDRs must specify an MDR class of COHESION, which automatically sets the Path, Parameters and "URL to be Launched" fields to the required Cohesion launch-in-context values. CA APM MDRs must specify an MDR class of "GLOBAL", which automatically sets the Path, Parameters and "URL to be Launched" fields to the required CA APM launch-in-context values. Required for CMDBf Viewer. CMDBf Endpoint sets to "cmdbf" for all federated MDRs.
  • Active
    Denotes this MDR definition as active or inactive. Inactive MDR definitions are logically deleted, but they can be made active again by using the Search utility.
  • Owner
    The contact responsible for this MDR.
  • Description
    A freeform text field.
  • Hostname
    The host name, DNS name or IP address of the host, which contains the web server which hosts the web page that is launched. Required for “launch in context”.
  • Port
    The TCP/IP port used by the MDR web server to serve up web pages. Port 8080 is the default. Required for “launch in context”.
  • Path
    The portion of the URL that precedes the question mark (?) character. This information can be obtained from the MDR documentation. For mdr_class of Cohesion, the value is set automatically to CAisd/html/cmdb_cohesion.html and cannot be changed. For mdr_name of UAPM and mdr_class of GLOBAL, the value is set automatically to apm/frmObject.aspx and cannot be changed.
  • Parameters
    The portion of the URL that follows the question mark (?) character. This information can be obtained from the MDR documentation. For mdr_class of Cohesion, the value is set automatically to hostname={hostname}+port={port}+family={family}+name={name}+secret={password}+federated_asset_id={federated_asset_id} and cannot be changed. For mdr_name of UAPM and mdr_class of GLOBAL, the value is set automatically to ObjectID=cmdb_asset_id}&obj=11&FUNCTION=1&WinID=OBFRASSET{cmdb_asset_id}&WinContainerID= and cannot be changed.
  • Userid
    The user ID to logon to the MDR (if necessary). This value is substituted into the URL wherever {userid} is found.
  • Shared Secret
    Specifies information that is shared between CA CMDB and the MDR. This value is substituted into the URL wherever {password} is found. For Cohesion MDRs, the value must match the value of the “com.cendura.security.oneclickauth.secret”. For more information about creating a shared secret, see "Integrating with CA CMDB" in the
    CA Cohesion ACM Implementation Guide
    . Required for CMDBf Viewer.
  • CMDBf Namespace
    Specifies the MDR namespace that is passed to the query by CMDBf Viewer. If you use CA CMDB as an MDR provider, the value is "http://cmdb.ca.com/r1". For external MDRs, consult the MDR documentation. Required if MDR Class is cmdbf.
  • CMDBf Timeout
    (Optional) Specifies time limit for CMDBf endpoint query. Default is ten (10) seconds. Only applies when MDR Class is cmdbf.
  • URL to be Launched
    Default value of http://{hostname}:{port}/{path}?{parameters}. For some MDRs, it can be overridden if necessary to accommodate MDR-specific requirements. Required for "launch in context". For mdr_name of UAPM and mdr_class of GLOBAL, the value is http://{hostname}:{port}/{path}?{parameters}
    For mdr_class of Cohesion the default value is:
    http://cmdb_hostname:cmdb_port/{path}?{parameters}
    where:
    cmdb_hostname
    is the host name, DNS name or IP address of the CA CMDB web server. Defaults to the current hostname that is currently accessing the CA CMDB web server.
    cmdb_port
    is the TCP/IP port of the CMDB web server. Defaults to the current port number used to access the CA CMDB web server.
    : If you have enabled SSL support for Cohesion, set the URL to:
    http://hostname:port/{path}?{parameters}+https=yes
    For information about enabling CA Cohesion ACM HTTPS support, see the Cohesion online help topic Creating the HTTPS Certificate and Enabling HTTPS.
  • CMDBf Endpoint
    Specifies the MDR Query Service endpoint for CMDBf Viewer. Required if MDR Class is cmdbf.