Configuring Dedicated Publisher Queue Sets and Worker Sets

Dedicated Publisher Queue Sets and Worker Sets provide a way of completely separating the publishing of distinct types of data. This prevents the publishing of one category from impacting the publishing of another and allows separate management of both.

When you configure a Dedicated Publisher Queue Set, you are essentially creating independent route to publish a specific category of data. If the data that you are publishing needs translation, you can configure a Dedicated Worker Set together with the Dedicated Publisher Queue Set. If you do not need translation, or want to use all workers to process jobs from any Publisher Queue Set, configure only Dedicated Publisher Queue Sets.

For more information, see Using Dedicated Publish Queues.

The configuration of a Dedicated Publisher Queue Set provides a way to separate the publishing of different types of data. For example, a WTDocument take a short time to publish, while CAD documents can often take a while. By configuring a Dedicated Publisher Queue Set to publish WTDocuments, you can avoid backlogs in the publishing queues.

To configure a Dedicated Publisher Queue Set, follow the steps below:

1. Create new Publisher Queue Sets by adding the set names to the publish.publishqueue.setnames property in the wvs.properties file.

2. Adjust the Windchill configuration in the wt.properties file to allow for the additional queues:

a. Increase the value of the wt.queue.max.processQueues, if the new number of Windchill queues exceeds the current value.

b. Set these properties to false for all new numbered Publisher Queues in order to retain the completed Windchill Queue Entries and related Publish Job Details logs (as seen in the WVS Job Monitor).

3. Configure WVS to use the new Publisher Queue Sets. This is best achieved by writing a custom class and method that sets the Publisher Queue Priority and Set, along with the Name and Description of the representation to create. The class and method to use is then defined by the property publish.publishqueue.priorities.filtermethod in the wvs.properties file.

4. Restart the Windchill Method Servers in order to reload the updated wvs.properties settings.

Refer to “Submitting Publish Jobs to Dedicated Publish Queues with Specific Priority” under Using Dedicated Publish Queues.

By default, WVS has no predefined Worker Sets. All workers are implicitly members of the “DEFAULT” Worker Set.

The creation of a Dedicated Worker Set allows you to allocate workers to a logical Worker Set. This Worker Sets can then be configured to process specific categories of jobs or type of publication. They can also be mapped to a specific or multiple Publisher Queue Sets.

1. Use the Worker Agent Administration Configure Wizard Add Worker button to create the required workers.

2. Assign the Worker to Worker Sets by manually editing the Worker Agent agent.ini file and adding the queueset parameter to each. For example, in the agent.ini file for each Worker Set configuration, add Worker Set configuration, add queueset=<QueuesetName> parameter.

• Workers can be members of multiple Worker Sets.

• The queueset parameter is a space separated list of worker typeset names.

• If a worker has no queueset parameter defined, this implies that it is part of the DEFAULT Worker Queue Set.

• You can set the queueset parameter to DEFAULT if it to be used by the default Publisher Queue Set and is part of a list of Worker Queue Sets.

3. Configure which Publish Jobs are assigned to each Worker Set by writing a custom class and method that determines the Worker Set based on your own business rules. The class and method for WVS to use is then defined by setting the publish.publishqueue.usesetworkers.filtermethod property in the wvs.properties file.

Refer to Using Dedicated Publish Queues in the Windchill Help Center for more information.

4. Restart the Windchill Method Servers in order to reload the updated wvs.properties and agent.ini settings.

If you have defined Dedicated Publisher Queue Sets and have implemented the custom filter to submit publish jobs of a certain category to it, you can dedicate a similarly named Worker Set to it by using the property

in the wvs.properties file, where <SetName> is the Publisher Queue Set Name and <WorkerType> is a space separated list of Worker types that must be mapped to it.

For example, the following property setting maps Publisher Queue Set name CAD to Worker Set Name CAD for the PROE and UG Worker Types only.

For more information on configuring Dedicated Publisher Queue Sets and Worker Sets, refer to Tech Support knowledge base articles CS132318 and CS80629.