1. Configure the Conversion Processes
Scenario/Problem: You need to modify the number of conversion processes on each server running Word Services.
Solution: Use the ActiveProcesses
parameter with the Set-SPWordConversionServiceApplication
cmdlet.
The ActiveProcesses
parameter
determines the how many active conversion processes can occur on each
server running the Word Services service application. The default value
is 8 processes. The valid entries range from 1
to 1000
. Listing 1 shows a sample modification of the active conversion processes.
Listing 1. Setting the Active Conversion Processes
Set-SPWordConversionServiceApplication
-Identity "Word Automation Services" -ActiveProcesses 5
Tip
The default identity of the Word Service application is “Word Automation Services.” To find the correct name or GUID, use Get-SPServiceApplication
.
2. Configure Conversion Throughput
Scenario/Problem: You need to configure the throughput for the Word Services conversions.
Solution: Use the TimerJobFrequency
and ConversionsPerInstance
parameters with the Set-SPWordConversionServiceApplication
cmdlet.
The conversion throughput parameters TimerJobFrequency
and ConversionsPerInstance
correspond to the Word Services configuration settings, as shown in Figure 1.
Figure 1. Conversion throughput configuration settings in Central Administration.
Tip
To get to these properties, from Central
Admin, click on the Manage Service Applications link under Application
Management. Locate the Word Services entry and highlight the connection
(the indented instance) and then click on the Properties button from
the top ribbon bar.
The TimerJobFrequency
parameter
determines how often the conversion process should be started using the
corresponding service timer job. The default is 15 minutes, and the
valid range can be any number of minutes between 1
and 59
.
The ConversionsPerInstance
parameter determines how many conversions can be processed per instance. The number of instances can be configured using the ActiveProcesses
parameter, as explained in the previous section. The default value is 12 conversions.
Listing 2 shows a sample command line for setting the conversion throughput values.
Listing 2. Setting the Conversion Throughput Values
Set-SPWordConversionServiceApplication
-Identity "Word Automation Services"
-TimerJobFrequency 5 -ConversionsPerInstance 100
The values for
throughput should be modified based on usage of Word Services within
your organization. Heavy usage might warrant more frequent timer job
execution. Increasing the number of minutes for the timer might may
warrant an increase in conversions per instance; however, increasing
these values could cause performance issues. Use these values along
with the active processes to balance the usage and optimize throughput.