This documentation supports the 20.02 version of BMC CMDB.

To view an earlier version, select the version from the Product version menu.

Enabling BMC CMDB web services 1

To work with the CMDB Web Services infrastructure, you must understand how to locate and configure your CMDB Web Services. To make your own web services available for consumption, you must understand how to publish your web services to the CMDB Web Services registry

All CMDB Web Services, including BMC CMDB, Remedy AR System, and other web services, must manage their registrations during their life cycle.

When published with the WSRegistryAPI, each BMC web service is published to the registry with the following information:

  • Service Name — the name of the service
  • Service Version — the official version of the service
  • Business Name — the name of the business entity
  • Application Name — the name of the Application area, such as BMC Remedy IT Service Management
  • Service Description — a description for the service
  • Access Point URL — Specifies the URL of the service access endpoint
  • WSDL URL — Specifies the URL of the service web services description language (WSDL)

When you register your CMDB Web Services, you must specify a URL for the access point and, optionally, a URL for the WSDL. The access point URL is formatted as follows:

https://<hostname>:<portNumber>/<servicePortName>


Where

Description

hostname

Server computer name.

portnumber

Server port number.

service_port_name

The service port name format depends on the type of Web Service implementation that you have. The following service port name values are provided as an example:

  • atriumclasses_porttype
  • atriuminstances_porttype
  • atriumdatasets_porttype
  • atriumquery_porttype
  • atriumgraphwalk_porttype
  • atriumreconciliation_porttype
  • atriumnormalization_porttype
  • atriumbusinessobjects_porttype
  • atriumbusinessimpact_porttype
  • atriumversions_porttype
  • atriumclassicfederation_porttype
  • atriumclassicreconciliation_porttype
  • atriumserviceconfig_porttype

For example, to specify the URL for the versions web service:

http://goldserver:9090/atriumversions_porttype

The WSDL URL is formatted as follows:

https://<hostname>:<portNumber>/<servicePortName>?wsdl 

For example, to specify the URL for the versions Web Service WSDL:

http://goldserver:9090/atriumversions_porttype?wsdl

Configuring CMDB Web Services

The Remedy AR System Registry form and its workflow provide an interface to the CMDB Web Services Registry, thereby simplifying the registry process. A web service is registered by creating a request in the form and enabling it. Changing a setting removes the registration. If the registry is unavailable, the workflow attempts to register or deregister the web service later. The form also reports whether the web service is registered.


Note

Before you can register a web service, the Java plug-in server must be installed and operating, and you must configure a connection to the CMDB Web Services Registry in the WS Registry Integration tab of the Remedy AR System Administration: Server Information form. For details, see  Configuring the Web Services Registry integration


To register a Remedy ITSM suite web service

  1. Log into Remedy ITSM suite application.
  2. From the Applications menu, select AR System Administration > AR System Administration console.
  3. Select System > General >Web Services Registry.
  4. In theRemedy AR System Web Services Registrysearch for services using the following criteria:
    • BMC in the Business Name field
    • Yes for Publish to Registry?
    • Yes for Recommended Value
      The list of Remedy ITSM suite services that are shipped with the product is returned.

  5. Select a registry from the list. The fields of the form are populated with information about this registry.
    1. Make the following updates in the Build WSDL URL section:
    2. If you want the WSDL URL to be built and displayed in the WSDL URL field, ensure that Yes is selected for the Build WSDL URL field.
    3. In the Web Server Address field, replace WebServerAddress with the URL of the web server that provides the WSDL. Include the port number if required. The syntax is http:<webServer>:<port>. As you update this field, if you selected *Yes* for the Build WSDL URL field, the WSDL URL is built and displayed in the WSDL URL field.
    4. In the ARServer field, enter the name of the Remedy Action Request System server that hosts the web service.
  6. Make the following updates in the Build End Point URL section:
    • If you want the end point URL to be built and displayed in the End Point URL field, ensure that Yes is selected for the Build End Point URL field.
  7. In the Web Server Address field for the end point URL, replace webServerAddress with the URL of the web server that provides the end point URL. Include the port number if required. The syntax is http://<webServer>:<port>. As you update this field, if you selected *Yes* for the Build End Point URL field, the end point URL is built and displayed in the End Point URL field.
  8. In the ARServer field, enter the name of the BMC Remedy AR System Server that hosts the end point URL for the web service.
  9. For the Publish to Registry field, select Yes.
  10. Save the form.
  11. Complete step 4 through step 8 for all the Remedy ITSM suite services returned in your search.


Was this page helpful? Yes No Submitting... Thank you

Comments