MDS Trigger Commands

The mds-servicegroup-add(1) command in the Aggregator Framework is used to configure the Trigger Registration Service to collect information from various sources. In addition, the Trigger Service has three command-line clients

1. Create a new trigger - mds-trigger-create

Synopsis

mds-trigger-create [options] -b baseURL monitoredURL

Description

This command creates a new trigger.

Table 1. mds-trigger-create options

-b baseURL

Specify the trigger service's base URL (everything in the Trigger Service URL up to the service name). This option is used instead of the customary -s or -e options because this client communicates with more than one trigger-related service.

monitoredURL

Specify the URL of the service to be monitored; this should be the same as the address of a service registered to the Trigger Registry Service's service group.

Example

The first command creates a new trigger on the server triggerhost.org to monitor the information in the default Index Server running in the same Globus container. The second command creates a new trigger on the server triggerhost.org to monitor the information in an Index Server running on the server otherhost.org

   mds-trigger-create -b https://triggerhost.org:8443/wsrf/services \
      https://triggerhost.org:8443/wsrf/services/DefaultIndexService

   mds-trigger-create -b https://triggerhost.org:8443/wsrf/services \
      https://otherhost.org:8443/wsrf/services/DefaultIndexService

2. View information about existing trggers - mds-trigger-view

Synopsis

mds-trigger-view [options] -b baseURL [TriggerID]

Description

This displays information about triggers.

Table 2. mds-trigger-view options

-b baseURL

Specify the trigger service's base URL (everything in the Trigger Service URL up to the service name). This option is used instead of the customary -s or -e options because this client communicates with more than one trigger-related service.

TriggerID

If a Trigger ID is specified, detailed information about the specified trigger will be displayed; if not, summary information about all triggers will be displayed.

Example

The first command displays summary information about all triggers known to the Trigger Service; the second displays detailed information about one trigger

   mds-trigger-view -b https://triggerhost.org:8443/wsrf/services

   mds-trigger-view -b https://triggerhost.org:8443/wsrf/services \
      546aae00-418b-11dd-a5ea-ebfac2dfbbee

3. Modify a trgger - mds-trigger-edit

Synopsis

mds-trigger-edit [options] -b baseURL TriggerID Parameter=Value

Description

This command is used to modify trigger parameters, in order to change the trigger conditions, actions, status (enabled or disabled), etc.

Table 3. mds-trigger-edit options

-b baseURL

Specify the trigger service's base URL (everything in the Trigger Service URL up to the service name). This option is used instead of the customary -s or -e options because this client communicates with more than one trigger-related service.

TriggerID

The identifier of the trigger to be modified

Param=value

Set the named parameter to the specified value. The parameter can be any writable Trigger Service resource property

Examples

The first command enables a trigger; the second command disables it.

   mds-trigger-edit -b https://triggerhost.org:8443/wsrf/services \
      546aae00-418b-11dd-a5ea-ebfac2dfbbee \
      TriggerStatus=enabled

   mds-trigger-edit -b https://triggerhost.org:8443/wsrf/services \
      546aae00-418b-11dd-a5ea-ebfac2dfbbee \
      TriggerStatus=disabled

Change the trigger condition (matching rule) so that the trigger fires if there are no Index Service entries.

   mds-trigger-edit -b https://triggerhost.org:8443/wsrf/services \
      546aae00-418b-11dd-a5ea-ebfac2dfbbee \
      MatchingRule="count(//*[local-name()='Entry'])=0"

Change the trigger action.

   mds-trigger-edit -b https://triggerhost.org:8443/wsrf/services \
      546aae00-418b-11dd-a5ea-ebfac2dfbbee \
      ActionScript=trigger-action-input-default