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 URI (file: or http:) of the configuration file. |
For example:
CentraSiteCommand trigger Federation -user "AdminUser" -password "ABCXYZ123" -file "C:\Federation1.xml"
See the section Users and Access
Rights below for more information. 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.