Triggering the UDDI Federation
When you trigger a federation, you activate the federation of objects from a source UDDI registry to one or more target registries, as defined in the federation's configuration file. If you wish to run the federation on a regular basis, for example once per hour or once daily, you can use the scheduling mechanism provided by the operating system to trigger the federation at the appropriate time intervals.
The federation has to be triggered from the machine where the CentraSite instance is located. Hence, with CentraSite as the target registry, the federation will be triggered from the target machine.
To trigger a federation, use a command of the following form:
CentraSiteCommand trigger Federation [-url <CENTRASITE-URL>] [-user <USER-ID>]
[-password <PASSWORD>] -file <CONFIG-FILE>
The following table describes the complete set of input parameters that you can use with the trigger Federation utility:
Parameter | Description |
-url | The URL of the CentraSite registry. This is needed for connection to the Federation service running in CentraSite. The default value is http://localhost:53307/ if this parameter is not provided. |
-user | The user ID of a user on the source machine who has the permissions to access the required objects on the source machine. |
-password | The password of the user identified by the parameter -user. |
-file | The absolute or relative path to the XML configuration file. If relative, the path should be relative to the location from where the command is executed. |
For example:
CentraSiteCommand trigger Federation -user AdminUser
-password ABCXYZ123 -file C:\Federation1.xml
If the configuration file contains the user and password information in the sourceRegistryDetail, you can omit these from the command line. If you supply the user and password values on the command line and also in the configuration file, the values on the command line will be used.
On Windows, you can use the Task Scheduler to trigger the federation at regular intervals. The Task Scheduler is available under Start > All Programs > Accessories > System Tools > Task Scheduler. In the Task Scheduler, supply the following values:
The command to be activated, for example:
C:\SoftwareAG\CentraSite\utilities\CentraSiteCommand.cmd
If the path contains blank characters, you need to enclose the value in double quotes.
The parameters of the command, for example
trigger Federation -user AdminUser -password ABCXYZ123 -file C:\Federation1.xml
The times when the command should be activated.
On Linux and UNIX, you can use the operating system's cron facility to trigger the federation at regular intervals.
