Creating a Custom Component › Import a Custom Component

Import a Custom Component

After you import your custom component into Data Aggregator, a new component is available to support a custom metric family.

Data Aggregator provides a web service to support the import of a new component. Use any REST client. We recommend using the RESTClient with CA Performance Management. If you do not have it installed, you can get the RESTClient GUI JAR file from http://code.google.com/p/rest-client/.

When using the RESTClient, consider the following information:

• To launch it, double-click the JAR file.
• When you POST XML, make sure that the Charset is set to UTF-8.

  To view and verify this setting, click the Edit Content-Type & Charset button.

• You can also auto-indent the Response Body, as follows:
  1. Click Options on the Tools menu.
  2. Select the Etc. tab.
  3. Select Auto-indent Response Body and click OK.

Follow these steps:

1. Enter http://da-hostname:8581/typecatalog/components as the URL.
2. Select POST as the Method.
3. Select 'application/xml' as the 'Body Content-type' in the Body settings.

   Important! Failing to set the Content-type results in a 404 error.

4. Copy and paste your custom component XML into the Body field.
5. Run the method.

   Your custom component is imported. If no errors occur, the Status field in the HTTP Response section displays:

   HTTP/1.1 200 OK
   

   Note: Any other return code indicates that an error occurred while updating your custom component. Fix the error and retry updating the component by doing another POST.

   Important! To avoid possible data loss, always back up your deploy directory each time you create or update a vendor certification, metric family, or component.