Version 9.6	SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT

This section discusses the following topics:

• Creating Mediator Targets or Third-Party PEP Targets

• Creating Insight Targets

• Managing Mediator or Third-Party Targets

• Deploying and Undeploying Virtual Services from the Mediator Target's Detail Page

• Managing Insight Targets

• Changing the Organization of a Target

Creating Mediator Targets or Third-Party PEP Targets

Use the following procedure to create a target and save it to the CentraSite registry/repository.

Important:
Do not define multiple Mediator targets that point to the same Mediator instance, but are accessible from different ports. If you do this, the real effect is that all targets would be the same.

To create a target

1. If you are creating a third-party PEP target, ensure that the target type has been created, as described in Creating and Managing Target Types.

2. In CentraSite Control, go to Operations > Targets to display the target list.

3. On the Targets tab, click Add Target to open the Add Target wizard.

4. In panel 1, complete the following fields:

   In this field...	Specify...
   Name	A name for the new target. Target names can contain alphanumeric characters, but cannot contain spaces or special characters (except underscores (_) and hyphens (-). When defining a Mediator target, you must also specify this identical target name in Mediator. To do this, in the Integration Server Administrator, go to Solutions > Mediator > Administration > CentraSite Communication and specify this name in the Target Name field. Notes: You cannot change the target name after the target is added to CentraSite. A target name does not need to be unique within the registry/repository. However, to reduce ambiguity, you should avoid giving multiple targets the same name. As a best practice, we recommend that you adopt appropriate naming conventions to ensure that targets are distinctly named within your organization.
   Description	Optional. A description for the new target. This description appears when a user displays a list of targets in the user interface.
   Organization	Choose the organization to which the target will be added. (The drop-down list will contain the list of organizations to which you are permitted to add targets.)
   Type	Select webMethods Integration Server (Mediator) or a third-party target type. Note: It is not possible to change the target type after the target has been created.

5. Click Next.

6. In panel 2, complete the following fields:

   In this field...	Specify...
   Deployment Endpoint	Optional. The URL of the endpoint for the target's deployment service. If you are using webMethods Integration Server (Mediator) as your target type, specify the URL of the webMethods Mediator's deployment service directory as follows: http://<Host>:<Port>/ws/mediator.integration:Deployer The URL can be HTTP or HTTPS.
   User	Optional. The Integration Server user who is permitted to deploy assets to this target. By default, only a member of the Integration Server's Administrator group is permitted to deploy assets to this target. Note: This note explains how to permit other users to deploy assets to this target. Mediator exposes several Web service operations to allow CentraSite to manage deployed assets. This Web service is invoked by CentraSite any time a user deploys or undeploys a virtual service or consumer application to Mediator. The User and Password fields identify an Integration Server user who is permitted to execute the Integration Server services associated with Mediator's deployer service. After installation, only members of the Integration Server's "Administrator" group are permitted to invoke these services. However, administrators have the flexibility to allow their own users or groups to invoke them. Access to these services is controlled by an ACL, called MediatorDeployer. Initially, only the predefined "Administrator" group is assigned to this ACL. An Integration Server administrator can remove this group and add other groups or individual users. For example, you can create your own deployer group, (e.g., "MyDeployers") and add Integration Server user IDs to this group. Then, the user must update the MediatorDeployer ACL by removing the "Administrator" group and adding the "MyDeployers" group. Now, in the User and Password fields on this screen, you can specify any user ID that belongs to the "MyDeployers" group.
   Password	Optional. The password of the Integration Server user who is permitted to deployment assets to this target. The password of this user is by default manage.

7. Click Finish to save the new target to the CentraSite registry/repository.

8. To enable CentraSite to receive information about run-time events from the target, you must configure CentraSite's Event Receiver. The Event Receiver is a data collector that collects the run-time event data from the target. For details, see Run-Time Events and Key Performance Indicator (KPI) Metrics in the section Run-Time Governance Reference.

Creating Insight Targets

Use the following procedure to create a webMethods Insight target and save it to the CentraSite registry/repository.

To create a target

1. In CentraSite Control, go to Operations > Targets to display the target list.

2. Click Add Target and specify the following fields in the wizard.

   In this field...	Specify...
   Name	A name for the new target. Target names can contain alphanumeric characters, but cannot contain spaces or special characters (except underscores (_) and hyphens (-). Note: Specify the target name with care. You cannot change the target name after the target is added to the CentraSite. Note: A target name does not need to be unique within the registry/repository. However, to reduce ambiguity, you should avoid giving multiple targets the same name. As a best practice, we recommend that you adopt appropriate naming conventions to ensure that targets are distinctly named within your organization.
   Description	Optional. A description for the new target. This description appears when a user displays a list of targets in the user interface.
   Organization	Choose the organization to which the target will be added. (The drop-down list will contain the list of organizations to which you are permitted to add targets.)
   Type	Select Insight. Note: It is not possible to change the target type after the target has been created.

3. Click Next.

4. In panel 2, complete the following fields:

   In this field...	Specify...
   Deployment Endpoint	Optional. The URL of the endpoint for the target's deployment service. If you are using webMethods Integration Server as your target type, specify the URL of the webMethods Mediator's deployment service directory as follows: http://<Host>:<Port>/ws/mediator.integration:Deployer The URL can be HTTP or HTTPS.
   User	Optional. The user ID of the Integration Server user to be used for the deployment operation. The default user ID is "Administrator".
   Password	Optional. The password of the Integration Server user to be used for the deployment operation. The default password is "manage".

5. Click Finish to save the new target to the CentraSite registry/repository.

Managing Mediator or Third-Party Targets

Use the following procedure to:

• View, edit or delete Mediator or third-party targets, or change the Organization to which the target belongs.

• Deploy, undeploy or redeploy virtual services to Mediator targets.

• View the run-time events that occur in a target after you have deployed services to the target.

To manage a Mediator or third-party target

1. In CentraSite Control, go to Operations > Targets to display the target list.

   The target list displays the name, description and target type of each target that exists in your instance of CentraSite.

2. Expand the plus button next to the Name column to display a list of all services that are deployed (or are pending deployment or have failed deployment) to each target. Icons indicate the services' deployment status.

   Icon	Description
   	Service is deployed to the Mediator target.
   	Deployment failed.

3. To delete one or more targets (which removes the target(s) from the CentraSite registry/repository permanently), select the target(s) to delete and choose the Actions > Delete menu entry.

   Notes:

   1. You cannot delete a target if any service in your CentraSite registry/repository currently uses the target.
   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 targets for which you do not have the required permission.

4. To modify a target, click the target name to display the Target Details page.

5. In the Target Information section of the details page, you can:

   • Modify the target's description.

   • Delete the target (which removes it from the CentraSite registry/repository permanently) by choosing the Actions > Delete menu entry.

   • Change the Organization to which the target belongs. For details, see Changing the Organization of a Target.

   You cannot modify the target's Name or Type properties.

6. You can use the Configuration profile in the details page to edit the Deployment Endpoint and user credentials of the Integration Server that would be used for the deployment operation. For information about these fields, see Creating Mediator Targets or Third-Party PEP Targets.

7. The Services profile enables you to deploy, undeploy or redeploy services. For details, see Virtual Services in CentraSite Control.

8. The Events profile enables you to view the run-time events that occur in the target after you have deployed services to the target. You use this profile the same way you use the Operations > Events > Events List page (for information, see Virtual Services in CentraSite Control).

Deploying and Undeploying Virtual Services from the Mediator Target's Detail Page

You can deploy, undeploy and redeploy virtual service(s) from the targets' detail pages. For more information, see the section Virtual Services in CentraSite Control.

Important:
Before you deploy virtual services to a target, ensure that the target's specified deployment URL is active and the user credentials of Integration Server are valid. To check this, go to the Target Details page and click the Check Connection button. If the connection is not active and valid, activate the deployment endpoint and modify the user credentials as required.

Managing Insight Targets

Use the following procedure to:

• View, edit or delete webMethods Insight targets, or change the Organization to which the target belongs.

• Deploy, undeploy or redeploy services to a target.

• View the run-time events that occur in a target after you have deployed services to the target.

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

To manage an Insight target

1. In CentraSite Control, go to Operations > Targets to display the target list.

   The target list displays the name, description and target type of each target that exists in your instance of CentraSite.

2. Expand the plus button next to the Name column to display a list of all services that are deployed (or are pending deployment or have failed deployment) to each target. Icons indicate the services' deployment status.

   Icon	Description
   	Service is deployed to the target.
   	Deployment failed.

3. To delete one or more targets (which removes the target(s) from the CentraSite registry/repository permanently), select the target(s) to delete and choose the Actions > Delete menu entry.

   Notes:

   1. The target's performance metrics and event information are not deleted when you delete the target. This information is deleted only when you delete a service and the built-in action "Delete RuntimeEvents and RuntimeMetrics" is set to true. For details about this action, see the section Built-In Design/Change-Time Actions Reference.
   2. You are not allowed to delete targets for which you do not have the required permission.

4. To modify an Insight target, click the target name to display the Target Details page.

5. In the Target Information section of the details page, you can:

   • Modify the target's description.

   • Delete the target (which removes it from the CentraSite registry/repository permanently) by choosing the Actions > Delete menu entry.

   • Change the Organization to which the target belongs. For details, see Changing the Organization of a Target.

   You cannot modify the target's Name or Type properties.

6. You can use the Configuration profile in the details page to edit the Deployment Endpoint and user credentials of the Integration Server that would be used for the deployment operation. For information about these fields, see Creating Insight Targets.

7. The Services profile enables you to deploy, undeploy or redeploy services.

8. The Events profile enables you to view the run-time events that occur in the target after you have deployed services to the target. You use this profile the same way you use the Operations > Events > Events List page (for information, see Viewing Run-Time Events and Metrics in the section Run-Time Governance Reference).

Changing the Organization of a Target

In CentraSite, there are two concepts of ownership. A target belongs to a particular user (known as the target's owner) and it also belongs to a particular organization. The owner of a target has special access rights to the target and serves as the target's main point of contact. The target's organization determines whose rules of governance apply to the target. Consequently, when you change a target's organizational ownership, you are in effect placing the target under the governance of a different organization.

The organization to which a target belongs is shown in the Organization attribute on the Target's Details page.

A target's Organization attribute is specified when a user adds the target to the CentraSite.

After a target is created, it is sometimes necessary to change its organization. For example, you might need to transfer ownership of a target to another organization when you want to delete the organization to which the target belongs and when multiple services are deployed to the target. When you want to delete an organization, for example, you might want to transfer the target with multiple deployed services to another organization.

Who Can Change Organization of a Target?

To change the organization of a target, you must be the CentraSite Administrator.

What Happens During a Change of Organization?

When you change the ownership of a target, CentraSite modifies the target's Organization attribute in the way you specify. Additionally, CentraSite:

• Records the ownership change in the audit log.

• Triggers the Default Move Handler policy by an OnMove event.

Policy that is Triggered During an Organization Change

CentraSite treats an organization change as an update to the target. Thus, changing the organization of a target triggers the execution of Default Move Handler policy. If the policy fails, the organization of the asset is not changed.

Note:
When you transfer a target to a different organization, CentraSite applies the policies of the receiving organization to the target.

How to Change Organization of a Target

This section provides procedures for transferring targets to a different organization. (Note that it contains procedures for transferring a single target and for transferring multiple targets.)

To Change the Organization of an Individual Target

Use the following procedure to transfer a target to a specified organization.

To change the organization of an individual target

1. In CentraSite Control, display the Details page for the target.

2. On the Details page, choose the Actions > Change Organization menu entry.

3. In the Change Organization dialog box, select the organization to which you want to transfer ownership of the target.

4. Click OK.

To Change the Organization of Multiple Targets (Bulk Transfer)

Use the following procedure to transfer multiple targets to a specified organization.

Important:
You are not allowed to transfer ownership of targets for which you do not have permission.

To change the organization for multiple targets

1. In CentraSite Control, go to Operations > Targets to display the targets list.

2. Select the targets.

3. Choose the Actions > Change Organization menu entry.

4. In the Change Organization dialog box, select the organization to which you want to transfer ownership of the targets.

5. Click OK.

www.softwareag.com

Copyright © 2005-2014 Software AG, Darmstadt, Germany.

SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT