Version 9.6 SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT
 —  Run-Time Targets  —

Creating and Managing Target Types

This section discusses the following topics:

The Target Type Definition File

A target type definition file is required in order to create a target type. CentraSite provides a target type definition file for webMethods Mediator and one for the webMethods Insight. If you are using a third-party target type, you must provide the appropriate target type definition file.

The Target Type Definition File for webMethods Mediator

CentraSite provides a target type definition file for webMethods Mediator, named webMethodsESB-TargetType.jar, which contains references to the following files. It is not necessary to edit the target type definition file.

File Description
TargetType.xml

Specifies the target type name, description and format of the run-time policies that the target type expects the receive. The following format is supported:

  • WS-PolicyAttachment: The target type expects to receive run-time policies attached to services as WS-PolicyAttachments (that is, policies attached to the service as a UDDI Object with a Local/Remote Policy Reference).

EventType.xml A descriptor file that describes the format in XML for mapping the predefined event attributes to the SNMP Traps defined in the MIB file. This file is optional, but if you omit it, CentraSite will not be able to capture events.
webMethodsESB.xsl A transformation file that transforms the policy from CentraSite format to a format that can be consumed by Mediator. The CentraSite format is a custom native representation of the Common Effective Policy (not WS-Policy format).

You can view this file from the target type list in the CentraSite Control user interface (see Managing the Mediator Target Type).

webMethodsESB.mib A run-time events configuration file that contains the SNMP Traps metadata and Object Identifiers (OIDs) for the event types and their attributes. CentraSite uses this file to capture run-time events that have occurred in Mediator. This file is optional. However, if you omit this file, CentraSite will not be able to capture events.

You can view this file from the target type list in the CentraSite Control user interface (see Managing the Mediator Target Type).

MANIFEST.MF Describes the contents of the jar file. The manifest file is used to identify resources.

The Target Type Definition File for webMethods Insight

CentraSite provides a target type definition file for webMethods Insight, named InsightTargetType.jar, which contains references to the following files. It is not necessary to edit the target type definition file.

File Description
TargetType.xml

Specifies the target type name and description.
EventType.xml

Note:
This file is currently not functional.

A descriptor file that describes the format in XML for mapping the predefined event attributes to the SNMP Traps defined in the MIB file. This file is optional. However, if you omit this file, CentraSite will not be able to capture events.
Insight.xsl

Note:
This file is currently not functional.

A transformation file that transforms the policy assets (i.e., the rogue assets) from the CentraSite format to a format that can be consumed by Insight.

You can view this file from the target type list in the CentraSite Control user interface (see Managing the webMethods Insight Target Type).

Insight.mib

Note:
This file is currently not functional.

A run-time events configuration file that contains the SNMP Traps metadata and Object Identifiers (OIDs) for the event types and their attributes. CentraSite uses this file to capture run-time events that have occurred in Insight Server. This file is optional. However, if you omit this file, CentraSite will not be able to capture events.

You can view this file from the target type list in the CentraSite Control user interface (see Managing the webMethods Insight Target Type).

MANIFEST.MF Describes the contents of the jar file. The manifest file is used to identify resources.

Target Type Definition Files for Third-Party Target Types

If you are using a third-party target type, you must provide a target type definition file that contains references to the following files.

File Description
<TargetTypeName>.xml

Specifies the target type name, description and format of the run-time policies that the target type expects the receive. The following format is supported:

  • WS-Policy Attachment: The target type expects to receive run-time policies attached to services as WS-PolicyAttachments (i.e., attached to the service as a UDDI Object with a Local/Remote Policy Reference).

Note:
The Include policy inline with WSDL format is not supported in this release.

EventType.xml A descriptor file that describes the format in XML for mapping the predefined event attributes to the SNMP Traps defined in the MIB file. This file is optional. However, if you omit this file, CentraSite will not be able to capture events.
<TargetTypeName>.xsl Should transform the policy from CentraSite format to a format that can be consumed by your target type. You can either:

  • Use a custom .xsl or .xslt file to transform the policies

    —OR—

  • Pass the policies to the policy enforcement engine unchanged, and in your policy enforcement engine, you should transform the policy details into your target-specific format.

<TargetTypeName>.mib A run-time events configuration file that contains the SNMP Traps metadata and Object Identifiers (OIDs) for the event types and their attributes. CentraSite uses this file to capture run-time events that have occurred in your target.

This file is optional. However, if you omit this file, CentraSite will not be able to capture events.

MANIFEST.MF Should describe the contents of the jar file. The manifest file is used to identify resources.

Note:
If you omit the MIB file and the descriptor file, and you later decide to add them, you must delete the original target type and create a new one.

Top of page

Creating Third-Party Target Types

As mentioned earlier, CentraSite provides two target types by default: webMethods Mediator and webMethods Insight.

You can create additional target types for any third-party target type that has been integrated with your CentraSite registry/repository as follows.

Start of instruction setTo create a target type

  1. In CentraSite Control, go to Operations > Target Types to display the target type list.

  2. Click the Add Target Type button.

  3. In the Add Target Type dialog box, specify the following field:

    In this field... Specify...
    Target Type Definition File The appropriate target type definition file for your target type. Use the Browse button to search for the appropriate target type definition file (a JAR file) in your local file system, or type its name in the field.

    For more information, see The Target Type Definition File for Third-Party Target Types.

    Note:
    You do not need to specify the name of the target type. Its name is defined in the target type definition file, and CentraSite obtains the name from there.

  4. Click OK to save the new target type to the CentraSite registry/repository.

Top of page

Managing the Mediator Target Type

Use the following procedure to view, edit or delete the Mediator target type.

Start of instruction setTo view, edit or delete the Mediator target type

  1. In CentraSite Control, go to Operations > Target Types to display the target type list.

  2. Click webMethods Integration Server to display the target type details.

    The following fields and columns are displayed:

    Field or Column Description
    Target Type JAR File

    The default target type definition file for webMethods Mediator is webMethodsESB-TargetType.jar. To view the file, click its hyperlinked name. There is no need to modify this file.

    For more information about the target type definition file, see The Target Type Definition File.

    Transformation File

    The transformation file, webMethodsESB.xsl, that is contained in the target type definition JAR file. To view the file, click its hyperlinked name. There is no need to modify this file.

    For more information about the transformation file, see The Target Type Definition File.

    Policy Format

    (Read-only.) The format for representing run-time policies. The value of this field is obtained from the target type definition file.

    • WS-Policy Attachment: (Default.) The target type expects to receive run-time policies attached to services as WS-PolicyAttachments (i.e., attached to the service as a UDDI Object with a Local/Remote Policy Reference).

    Note:
    The Include policy inline with WSDL format is not supported for webMethods Mediator in this release.

    Target Type MIB File

    The run-time events configuration file, webMethodsESB.mib, that is contained in the target type definition JAR file. This file is a run-time events configuration file that contains the SNMP Traps metadata and Object Identifiers (OIDs) for CentraSite's predefined event types and their attributes. CentraSite uses this file to capture the run-time events that have occurred in Mediator. To view the file, click its hyperlinked name.

    Note:
    If you create additional, custom run-time event types, you must ensure that the MIB file contains the SNMP Traps metadata and Object Identifiers for the custom events. For more information, see Run-Time Events and Key Performance Indicator (KPI) Metrics in the section Run-Time Governance Reference.

    Event Type

    Select a run-time event type to view the attributes that CentraSite uses to display events. These attributes are defined in the target type MIB file.

    The Object Identifier of the selected event type is shown in the Object ID field. The Object Identifier is defined in the target type MIB file.

    Attribute Name (Read-only.) The attributes of the selected event type, which are defined in the target type MIB file.
    Object ID (Read-only.) The object identifiers of the attributes, which are defined in the target type MIB file.
    Type (Read-only.) The types of the attributes, which are defined in the target type MIB file.

  3. To delete the target type (which removes it from the CentraSite registry/repository permanently), select the check box next to the target type in the target type list and then click Delete.

    Notes:

    1. You cannot delete the target type if there are any Mediator targets defined in your CentraSite registry/repository.
    2. If you delete a target type, and then create another target type with an EventType.xml file that has the same mappings as the deleted target type, you must restart CentraSite.
    3. You are not allowed to delete target types for which you do not have the required permission.

Top of page

Managing the webMethods Insight Target Type

Use the following procedure to view, edit or delete the webMethods Insight target type.

Start of instruction setTo view, edit or delete the webMethods Insight target type

  1. In CentraSite Control, go to Operations > Target Types to display the target type list.

  2. Click Insight to display the target type's details.

    The following fields and columns are displayed:

    Field or Column Description
    Target Type JAR File

    The default target type definition file for webMethods Mediator is InsightTargetType.jar. To view the file, click its hyperlinked name.

    For more information about the target type definition file, see The Target Type Definition File.

    Transformation File

    Note:
    This file is currently not functional.

    The transformation file, Insight.xsl, that is contained in the target type definition JAR file. To view the file, click its hyperlinked name.

    For more information about the transformation file, see The Target Type Definition File.

    Target Type MIB File

    Note:
    This file is currently not functional.

    The MIB file, Insight.mib, that is contained in the target type definition JAR file. This file is a run-time events configuration file that contains the SNMP Traps metadata and Object Identifiers (OIDs) for CentraSite's predefined event types and their attributes. CentraSite uses this file to capture the run-time events that have occurred. To view the file, click its hyperlinked name.

    Note:
    If you create additional, custom run-time event types, you must ensure that the MIB file contains the SNMP Traps metadata and Object Identifiers for the custom events. For more information, see Run-Time Events and Key Performance Indicator (KPI) Metrics in the section Run-Time Governance Reference.

    Event Type

    Note:
    This file is currently not functional.

    Select a run-time event type to view the attributes that CentraSite uses to display events. These attributes are defined in the target type MIB file.

    The Object Identifier of the selected event type is shown in the Object ID field. The Object Identifier is defined in the target type MIB file.

    Attribute Name

    Note:
    This column is currently not functional.

    (Read-only.) The attributes of the selected event type, which are defined in the target type MIB file.
    Object ID

    Note:
    This column is currently not functional.

    (Read-only.) The object identifiers of the attributes, which are defined in the target type MIB file.
    Type

    Note:
    This column is currently not functional.

    (Read-only.) The types of the attributes, which are defined in the target type MIB file.

  3. To delete the target type (which removes it from the CentraSite registry/repository permanently), select the check box next to the target type in the target type list and then click Delete.

    Notes:

    1. You cannot delete the target type if there are any Insight targets defined in your CentraSite registry/repository.
    2. If you delete a target type, and then create another target type with an EventType.xml file that has the same mappings as the deleted target type, you must restart CentraSite.
    3. you are not allowed to delete target types for which you do not have the required permission.

Top of page

Managing Third-Party Target Types

Use the following procedure to view, edit or delete a third-party target type.

Start of instruction setTo view, edit or delete the Mediator target type

  1. In CentraSite Control, go to Operations > Target Types to display the target type list.

  2. Click the target type name to display its details.

    The following fields and columns are displayed:

    Field or Column Description
    Target Type JAR File

    The default target type definition file that was specified when the target type was created. To view the file, click its hyperlinked name. If you want to use a different target type definition file (a JAR file), use the Browse button to search for the appropriate file in your local file system.

    For more information about the target type definition file, see The Target Type Definition File for Third-Party Target Types.

    Transformation File

    The transformation file (an .xsl or .xslt file) that is contained in the target type definition JAR file. To view the file, click its hyperlinked name. If you want to use a different transformation file, use the Browse button to search for the appropriate file.

    For more information about the transformation file, see The Target Type Definition File for Third-Party Target Types.

    Policy Format

    (Read-only.) The format for representing run-time policies. The value of this field is obtained from the target type definition file.

    • WS-Policy Attachment: The target type expects to receive run-time policies attached to services as WS-PolicyAttachments (i.e., attached to the service as a UDDI Object with a Local/Remote Policy Reference).

    • Include policy inline with WSDL: The target type expects to receive run-time policies that are defined within the service's WSDL.

    Target Type MIB File

    The MIB file that is contained in the target type definition JAR file. This file is a run-time events configuration file that contains the SNMP Traps metadata and Object Identifiers (OIDs) for the event types and their attributes. CentraSite uses this file to capture the run-time events that have occurred in the target. To view the file, click its hyperlinked name.

    Note:
    The MIB file that CentraSite provides for webMethods Mediator contains SNMP Traps metadata and Object Identifiers for a set of predefined event types which you can copy into your MIB file. For more information, see Run-Time Events and Key Performance Indicator (KPI) Metrics in the section Run-Time Governance Reference.

    Event Type

    Select a run-time event type to view the attributes that CentraSite uses to display events. These attributes are defined in the target type MIB file.

    The Object Identifier of the selected event type is shown in the Object ID field. The Object Identifier is defined in the target type MIB file.

    Attribute Name (Read-only.) The attributes of the selected event type, which are defined in the target type MIB file.
    Object ID (Read-only.) The object identifiers of the attributes, which are defined in the target type MIB file.
    Type (Read-only.) The types of the attributes, which are defined in the target type MIB file.

  3. To delete a target type (which removes it from the CentraSite registry/repository permanently), select the check box next to the target type in the target type list and then click Delete.

    Notes:

    1. You cannot delete a target type if there are any targets of that type defined in your CentraSite registry/repository.
    2. If you delete a target type, and then create another target type with an EventType.xml file that has the same mappings as the deleted target type, you must restart CentraSite.
    3. You are not allowed to delete target types for which you do not have the required permission.

Top of page

 www.softwareag.com  Copyright © 2005-2014 Software AG, Darmstadt, Germany.   SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT