Spotfire.Dxp.Worker.Automation.config file
This configuration file is used for configurations that are specific to Automation Services .
For information on working with this file, see Manually editing the service configuration files.
Setting | Default value | Description |
---|---|---|
<Spotfire.Dxp.Automation>
|
||
<automation>
|
||
maxWaitTimeForTaskBackgroundJobToFinishSeconds
|
180 | The number of seconds to wait for background thread execution to finish after the task finished executing. |
maxConcurrentJobs
|
-1 | The number of jobs that are allowed to
execute in parallel. If 0 or less, this is set to the number of CPU cores on
the machine.
Note: The
number of executing jobs can be less than the specified value if the service
instance is exhausted. For more information, see
WebPlayer_AverageCpuLoadExhaustedLimit in
Spotfire.Dxp.Worker.Host.exe.config
file.
|
failJobIfNotificationServiceReportErrors
|
False | Set to "True" to make jobs fail when errors are reported on background threads by the notification service. For example, failing data functions and TERR scripts only report errors using the notification service, and in those cases, you might want the whole job to fail. |
useKerberos
|
False | Set to "True" to run Automation Services
jobs as a specific Windows account when delegated Kerberos is enabled in the
environment. If set to "False", jobs will be run using the node manager service
account.
To specify the Windows account, add the following section:
|
customAccount
|
" " | To use an existing account instead of
automationservices@SPOTFIRESYSTEM, enter the username of the account, including
the domain, here (useKerberos must be false).
|
</automation>
|
||
</Spotfire.Dxp.Automation>
|
||
<Spotfire.Dxp.Automation.Framework>
|
||
<security>
|
||
allowDeleteOfFilesModifiedLastMinutes
|
30 | The Send Email task can delete files after they have been sent. To avoid deleting files that should be kept, only files that have been created and modified in the timeframe specified in this setting can be deleted. The default value is 30 minutes. If set to "0", no files can be deleted. If set to "-1", all files can be deleted. |
<allowedFilePaths>
|
||
allowAll
|
True | By default, Automation Services tasks can
read files from, and write files to any directory in the file system. Set this
to
False to only allow tasks to read from and
write to directories specified in the
section.
Note: To be
able to restrict the allowed paths for custom tasks, the custom tasks must use
the validation function in the Automation Services API.
|
<add path=""/>
|
Add an
<add path=""/> row for each directory
the Automation Services tasks should be allowed to read from and write to.
Paths can be relative to the Automation Service installation directory on the
node, local paths, or network paths. For example:
Note: Added
allowed paths are compared to all directories and files starting with what was
added. For example, if you add
C:\Temp as an allowed path, both the
directory
C:\Temp\ and a file called
C:\Tempfile.txt would be allowed. If
you want to make sure that only a specific folder is allowed, add a backslash
at the end, for example
C:\Temp\.
|
|
</allowedFilePaths>
|
||
</security>
|
||
</Spotfire.Dxp.Automation.Framework>
|
||
<spotfire.dxp.automation.tasks>
|
||
<smtp>
|
||
port
|
25 | The port to use when connecting to the SMTP server. |
useTls
|
False | Set to "True" to use Transport Layer Security (TLS) when connecting to the SMTP server. |
timeoutSeconds
|
100 | The maximum number of seconds before the Send command times out. |
useWindowsDefaultCredentials
|
False | Set to "True" to use the windows credentials of the account that executes the node manager when accessing the SMTP server. If username and password is set, this is not used. |
username
|
The username to use when authenticating with the SMTP server. | |
password
|
The password to use when authenticating with the SMTP server. | |
useCertificates
|
False | Set to "True" to use client certificates when accessing the SMTP server. |
storeLocation
|
The store location to take the certificate from [CurrentUser|LocalMachine]. | |
storeName
|
The name of the store to take the certificate from [AddressBook|AuthRoot|CertificateAuthority|Disallowed|My|Root|TrustedPeople|TrustedPublisher]. | |
serialNumber
|
The serial number of the certificate. | |
</smtp>
|
||
<saveAnalysis>
|
||
forceUpdateBehaviorManualWhenEmbeddingData
|
True | Set to "True" to force embedding of data function-based data sources, such as On-demand. |
</saveAnalysis>
|
||
<preferences>
|
||
Spotfire.Automation.SendMail.SMTPHost
|
Specify the SMTP Host for Email Notification. | |
Spotfire.Automation.SendMail.FromAddress
|
Specify the From Address for Email Notification. | |
Spotfire.Automation.LibraryImport.TimeoutInSeconds
|
300 | Specify the timeout (seconds) for the library import operation for the Import Library task. |
Spotfire.Automation.LibraryExport.TimeoutInSeconds
|
300 | Specify the timeout (seconds) for the library export operation for the Export Library task. |
Spotfire.Automation.Common.ExportPath
|
A root folder file path that can be used
when exporting images, PDFs and data from different job tasks to the file
system.
This path can be inserted into different paths using in the Automation Services Job Builder.This can be particularly important if the jobs should be executed on a Linux computer, or if you need a predefined path mounted in a container image when deploying new software updates. Note: The path must be a fully qualified path, like
\\server\share, and not a relative path.
|
|
</preferences>
|
||
</spotfire.dxp.automation.tasks>
|
Parent topic: Service configuration files