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.
Use the trigger Federation to trigger a federation instantly.
The syntax for the command is:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd trigger Federation [-url <CENTRASITE-URL>] [-user <USER-ID>] [-password <PASSWORD>] -file <CONFIG-FILE>
The input parameters are:
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 registered CentraSite user. For example, a user who has the CentraSite Administrator role. |
-password | The password for the registered CentraSite 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. |
Example:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd trigger Federation -user AdminUser -password ABCXYZ123 -file C:\Federation1.xml
The response to this command could be:
Executing the command : trigger Federation
Successfully executed the command : trigger Federation
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.
