Managing Web Content Syndicators and Subscribers using DXClient
The section provides information about using the DXClient process to automate the management of Web Content Manager Syndicators, Subscribers, and get-syndication reports. For more information on the process and settings of the Web Content Manager Syndicators and Subscribers, see How to manage syndicators and subscribers.
Managing syndicators
The manage-syndicator command is used to enable or disable the syndicator using the provided input.
-
Command description
This command invokes the manage-syndicator tool inside the DXClient. It is used to enable or disable the syndicator.
dxclient manage-syndicator
-
Help command
This command shows the help document on the manage-syndicator command usage:
dxclient manage-syndicator -h
-
Command options
Use this attribute to specify the hostname of the target server.
-hostname <value>
Use this attribute to specify the protocol with which to connect to the server.
-dxProtocol <value>
Use this attribute to specify the port on which to connect to the server(for Kubernetes Environment dxPort is 443)
-dxPort <value>
Use this attribute to specify the username that is required for authenticating with the server.
-dxUsername <value>
Use this attribute to specify the password that is required for authenticating with the server.
-dxPassword <value>
Use this attribute to specify the path to the contenthandler servlet on the DX server (example: /wps/mycontenthandler).
-contenthandlerPath <value>
Use this attribute to specify the UUID of the syndicator instance.
-UUID <value>
Use true or false to enable or disable the syndicator.
-enable <value>
The options that are passed through the command line override the default values.
Example
dxclient manage-syndicator -dxProtocol <dxProtocol> -hostname <host-name> -dxPort <dxPort> -dxUsername <dxUsername> -dxPassword <dxPassword> -contenthandlerPath <contenthandlerPath> -UUID <UUID> -enable <enable>
Manage-syndicator get-syndication-report
The manage-syndicator get-syndication-report command is used to fetch the failed reports of the syndicator.
-
Command description
This command invokes the
syndicator-faileditems
tool inside the DXClient, which is used to fetch the failed reports.dxclient manage-syndicator get-syndication-report
-
Help command
This command shows the help document on the manage-syndicator get-syndication-report command usage:
dxclient manage-syndicator get-syndication-report -h
-
Command options
Use this attribute to specify the hostname of the target server
-hostname <value>
Use this attribute to specify the protocol with which to connect to the server
-dxProtocol <value>
Use this attribute to specify the port on which to connect to the server (for Kubernetes Environment, dxPort is 443)
-dxPort <value>
Use this attribute to specify the username that is required for authenticating with the server
-dxUsername <value>
Use this attribute to specify the password that is required for authenticating with the server
-dxPassword <value>
Use this attribute to specify the path to the contenthandler servlet on the DX server (for example, /wps/mycontenthandler)
-contenthandlerPath <value>
Use this attribute to specify the UUID of the syndicator instance
-UUID <value>
The options that are passed through the command line override the default values.
-
Example usage with UUID:
dxclient manage-syndicator get-syndication-report -dxProtocol <dxProtocol> -hostname <host-name> -dxPort <dxPort> -dxUsername <dxUsername> -dxPassword <dxPassword> -contenthandlerPath <contenthandlerPath> -UUID <UUID>
-
Example usage without UUID:
dxclient manage-syndicator get-syndication-report -dxProtocol <dxProtocol> -hostname <host-name> -dxPort <dxPort> -dxUsername <dxUsername> -dxPassword <dxPassword> -contenthandlerPath <contenthandlerPath>
Note
If UUID of a syndicator is specified, then the command provides the report for only the particular syndicator that is present in the target DX Server; otherwise, it provides the failure report for all syndicators.
Managing subscribers
The manage-subscriber command is used to enable or disable the subscriber using the provided input.
-
Command description
This command invokes the manage-subscriber tool inside the DXClient. It is used to enable/disable the subscriber.
dxclient manage-subscriber
-
Help command
This command shows the help document on the manage-syndicator command usage:
dxclient manage-subscriber -h
-
Command options
Use this attribute to specify the hostname of the target server.
-hostname <value>
Use this attribute to specify the protocol with which to connect to the server.
-dxProtocol <value>
Use this attribute to specify the port on which to connect to the server (for Kubernetes Environment dxPort is 443).
-dxPort <value>
Use this attribute to specify the username that is required for authenticating with the server.
-dxUsername <value>
Use this attribute to specify the password that is required for authenticating with the server.
-dxPassword <value>
Use this attribute to specify the path to the contenthandler servlet on the DX server (for example, /wps/mycontenthandler).
-contenthandlerPath <value>
Use this attribute to specify the UUID of the subscriber instance.
-UUID <value>
Use this attribute to specify the enable or disable the subscriber instance. Use true or false to enable or disable the subscriber.
-enable <value>
The options passed through command line overrides the default values.
Example
dxclient manage-subscriber -dxProtocol <dxProtocol> -hostname <host-name> -dxPort <dxPort> -dxUsername <dxUsername> -dxPassword <dxPassword> -contenthandlerPath <contenthandlerPath> -UUID <UUID> -enable <enable>
Create Syndication Relation
The create-syndication-relation
command is used to create the syndication relation between syndicator and subscriber in the DX server.
-
Command description
Use the
create-syndication-relation
to create syndication relation:dxclient create-syndication-relation
-
Help command
This command shows the help information for
create-syndication-relation
command usage:dxclient create-syndication-relation -h
-
Command options
Use this attribute to specify the protocol with which to connect to the DX server:
-dxProtocol <value>
Use this attribute to specify the hostname of the target DX server:
-hostname <value>
Use this attribute to specify the port on which to connect to the DX server (for Kubernetes Environment, dxPort is 443):
-dxPort <value>
Use this attribute to specify the username to authenticate with the DX server
-dxUsername <value>
Use this attribute to specify the password for the user in the "dxUsername" attribute
-dxPassword <value>
The path to the contenthandler servlet on the Script Application server:
-contenthandlerPath <value>
Syndicator URL of target server, for example, http(s)://host:port/wps/wcm:
-syndicatorUrl <value>
Use this attribute to specify the new syndicator name:
-syndicatorName <value>
Use this attribute to specify the new subscriber name:
-subscriberName <value>
Use this attribute to specify the Credential Vault Name of source server:
-vaultSlotName <value>
Whether the syndicator/subscriber pair is enabled on creation: isEnabled (default is true):
-isEnabled <value>
Whether the syndicator/subscriber pair is updateAfterCreation : updateAfterCreation (default is true):
-updateAfterCreation <value>
The libraries to syndicate eg. all-items,liveItems,liveProjectsItem,all-items,published-items and all-items-and-versions:
-syndicationType <value>
Use this attribute to specify the Libraries Name of target Server:
-webContentLibraries <value>
Use this attribute to specify the Subscriber URL, for example, http(s)://host:port/wps/wcm:
-subscriberURL <value>
Use this attribute to specify the Syndicator/subscriber mode:
-mode <value>
Use this attribute to specify the Credential Vault Name:
-syndicatorVaultSlotName <value>
Use this attribute to specify the path to the context root on the DX server (for example, /wps):
-dxContextRoot <value>
Use this attribute to specify the path to the Virtual portal Context:
-virtualPortalContext <value>
Log files from command execution can be found in the logs directory of the DXClient installation.
Example
dxclient create-syndication-relation -dxProtocol <dxProtocol> -hostname <hostname> -dxPort <dxPort> -contenthandlerPath <contenthandlerPath> -dxUsername <dxUsername>
-dxPassword <dxPassword> -syndicatorUrl <syndicatorUrl> -syndicatorName <syndicatorName> -subscriberName <subscriberName> -vaultSlotName <vaultSlotName>
-isEnabled <isEnabled> -updateAfterCreation <updateAfterCreation> -syndicationType <syndicationType> -webContentLibraries <webContentLibraries> -subscriberURL <subscriberURL>
-mode <mode> -syndicatorVaultSlotName <syndicatorVaultSlotName> -dxContextRoot <dxContextRoot> -virtualPortalContext <virtualPortalContext>