@Mutable @ThreadSafety(level=NOT_THREADSAFE) public final class CollectSupportDataTaskProperties extends java.lang.Object implements java.io.Serializable
CollectSupportDataTask
.
NOTE: This class, and other classes within the
com.unboundid.ldap.sdk.unboundidds
package structure, are only
supported for use against Ping Identity, UnboundID, and
Nokia/Alcatel-Lucent 8661 server products. These classes provide support
for proprietary functionality or for external specifications that are not
considered stable or mature enough to be guaranteed to work in an
interoperable way with other types of LDAP servers.
Constructor and Description |
---|
CollectSupportDataTaskProperties()
Creates a new set of collect support data task properties without any of
the properties set (so that the server will use default values for all of
them).
|
CollectSupportDataTaskProperties(CollectSupportDataTask task)
Creates a new set of collect support data task properties set from the
provided task instance.
|
CollectSupportDataTaskProperties(CollectSupportDataTaskProperties properties)
Creates a new set of collect support data task properties as a copy of the
provided properties.
|
Modifier and Type | Method and Description |
---|---|
java.lang.Boolean |
getAlertOnError()
Retrieves the flag that indicates whether the server should send an
administrative alert notification if the task does not complete
successfully.
|
java.lang.Boolean |
getAlertOnStart()
Retrieves the flag that indicates whether the server should send an
administrative alert notification when the task starts running.
|
java.lang.Boolean |
getAlertOnSuccess()
Retrieves the flag that indicates whether the server should send an
administrative alert notification if the task completes successfully.
|
java.lang.String |
getComment()
Retrieves an additional comment that should be included in the support data
archive.
|
java.util.List<java.lang.String> |
getDependencyIDs()
Retrieves the task IDs for any tasks that must complete before the new
collect support data task will be eligible to start running.
|
java.lang.String |
getEncryptionPassphraseFile()
Retrieves the path on the server filesystem to a file that contains the
passphrase to use to encrypt the support data archive.
|
FailedDependencyAction |
getFailedDependencyAction()
Retrieves the action that the server should take if any of the tasks on
which the new task depends did not complete successfully.
|
java.lang.Boolean |
getIncludeBinaryFiles()
Retrieves the value of a flag that indicates whether the support data
archive may include binary files.
|
java.lang.Boolean |
getIncludeExpensiveData()
Retrieves the value of a flag that indicates whether the support data
archive may include data that is potentially expensive to collect and
could affect the performance or responsiveness of the server.
|
java.lang.Boolean |
getIncludeExtensionSource()
Retrieves the value of a flag that indicates whether the support data
archive should include source code (if available) for any third-party
extensions installed in the server.
|
java.lang.Boolean |
getIncludeReplicationStateDump()
Retrieves the value of a flag that indicates whether the support data
archive may include a replication state dump, which may be several
megabytes in size.
|
java.lang.Integer |
getJStackCount()
Retrieves the number of times that the jstack utility should be invoked to
obtain stack traces from all threads in the server.
|
java.lang.String |
getLogDuration()
Retrieves a string representation of the duration (up until the time that
the collect support data task is invoked) of log content that should be
included in the support data archive.
|
java.lang.Long |
getLogDurationMillis()
Retrieves a parsed value of the log duration in milliseconds.
|
java.util.Date |
getLogEndTime()
Retrieves the end time for the range of log messages to include in the
support data archive.
|
java.lang.Integer |
getLogFileHeadCollectionSizeKB()
Retrieves the amount of data in kilobytes to capture from the beginning of
each log file that should be included in the support data archive.
|
java.lang.Integer |
getLogFileTailCollectionSizeKB()
Retrieves the amount of data in kilobytes to capture from the end of each
log file that should be included in the support data archive.
|
java.util.Date |
getLogStartTime()
Retrieves the start time for the range of log messages to include in the
support data archive.
|
java.util.List<java.lang.String> |
getNotifyOnCompletion()
Retrieves the addresses to email whenever the task completes, regardless of
its success or failure.
|
java.util.List<java.lang.String> |
getNotifyOnError()
Retrieves the addresses to email if the task does not complete
successfully.
|
java.util.List<java.lang.String> |
getNotifyOnStart()
Retrieves the addresses to email whenever the task starts running.
|
java.util.List<java.lang.String> |
getNotifyOnSuccess()
Retrieves the addresses to email if the task completes successfully.
|
java.lang.String |
getOutputPath()
Retrieves the path on the server filesystem to which the support data
archive should be written.
|
java.lang.Integer |
getReportCount()
Retrieves the number of intervals that should be captured from tools that
use interval-based sampling (e.g., vmstat, iostat, mpstat, etc.).
|
java.lang.Integer |
getReportIntervalSeconds()
Retrieves the interval duration in seconds that should be used for tools
that use interval-based sampling (e.g., vmstat, iostat, mpstat, etc.).
|
java.lang.String |
getRetainPreviousSupportDataArchiveAge()
Retrieves the minimum age of existing support data archives that should be
retained.
|
java.lang.Long |
getRetainPreviousSupportDataArchiveAgeMillis()
Retrieves a parsed value of the retain previous support data archive age in
milliseconds.
|
java.lang.Integer |
getRetainPreviousSupportDataArchiveCount()
Retrieves the minimum number of existing support data archives that should
be retained.
|
java.util.Date |
getScheduledStartTime()
Retrieves the earliest time that the task should be eligible to start
running.
|
CollectSupportDataSecurityLevel |
getSecurityLevel()
Retrieves the security level that should be used to indicate which data
should be obscured, redacted, or omitted from the support data archive.
|
java.lang.String |
getTaskID()
Retrieves the task ID that should be used for the task.
|
java.lang.Boolean |
getUseSequentialMode()
Retrieves the value of a flag that indicates whether the server should
collect items for the support data archive in sequential mode rather than
in parallel.
|
void |
setAlertOnError(java.lang.Boolean alertOnError)
Specifies the flag that indicates whether the server should send an
administrative alert notification if the task does not complete
successfully.
|
void |
setAlertOnStart(java.lang.Boolean alertOnStart)
Specifies the flag that indicates whether the server should send an
administrative alert notification when the task starts running.
|
void |
setAlertOnSuccess(java.lang.Boolean alertOnSuccess)
Specifies the flag that indicates whether the server should send an
administrative alert notification if the task completes successfully.
|
void |
setComment(java.lang.String comment)
Specifies an additional comment that should be included in the support data
archive.
|
void |
setDependencyIDs(java.util.List<java.lang.String> dependencyIDs)
Specifies the task IDs for any tasks that must complete before the new
collect support data task will be eligible to start running.
|
void |
setEncryptionPassphraseFile(java.lang.String encryptionPassphraseFile)
Specifies the path on the server filesystem to a file that contains the
passphrase to use to encrypt the support data archive.
|
void |
setFailedDependencyAction(FailedDependencyAction failedDependencyAction)
Specifies the action that the server should take if any of the tasks on
which the new task depends did not complete successfully.
|
void |
setIncludeBinaryFiles(java.lang.Boolean includeBinaryFiles)
Specifies the value of a flag that that indicates whether the support data
archive may include binary files.
|
void |
setIncludeExpensiveData(java.lang.Boolean includeExpensiveData)
Specifies the value of a flag that indicates whether the support data
archive may include data that is potentially expensive to collect and could
affect the performance or responsiveness of the server.
|
void |
setIncludeExtensionSource(java.lang.Boolean includeExtensionSource)
Specifies the value of a flag that indicates whether the support data
archive should include source code (if available) for any third-party
extensions installed in the server.
|
void |
setIncludeReplicationStateDump(java.lang.Boolean includeReplicationStateDump)
Specifies the value of a flag that indicates whether the support data
archive may include a replication state dump, which may be several
megabytes in size.
|
void |
setJStackCount(java.lang.Integer jstackCount)
Specifies the number of times that the jstack utility should be invoked to
obtain stack traces from all threads in the server.
|
void |
setLogDuration(java.lang.String logDuration)
Specifies the string representation of the duration (up until the time that
the collect support data task is invoked) of log content that should be
included in the support data archive.
|
void |
setLogDurationMillis(java.lang.Long logDurationMillis)
Specifies the duration in milliseconds (up until the time that the collect
support data task is invoked) of log content that should be included in the
support data archive.
|
void |
setLogFileHeadCollectionSizeKB(java.lang.Integer logFileHeadCollectionSizeKB)
Specifies the amount of data in kilobytes to capture from the beginning of
each log file that should be included in the support data archive.
|
void |
setLogFileTailCollectionSizeKB(java.lang.Integer logFileTailCollectionSizeKB)
Specifies the amount of data in kilobytes to capture from the end of each
log file that should be included in the support data archive.
|
void |
setLogTimeRange(java.util.Date logStartTime,
java.util.Date logEndTime)
Specifies the time range for log messages to include in the support data
archive.
|
void |
setNotifyOnCompletion(java.util.List<java.lang.String> notifyOnCompletion)
Specifies the addresses to email whenever the task completes, regardless of
its success or failure.
|
void |
setNotifyOnError(java.util.List<java.lang.String> notifyOnError)
Specifies the addresses to email if the task does not complete
successfully.
|
void |
setNotifyOnStart(java.util.List<java.lang.String> notifyOnStart)
Specifies the addresses to email whenever the task starts running.
|
void |
setNotifyOnSuccess(java.util.List<java.lang.String> notifyOnSuccess)
Specifies the addresses to email if the task completes successfully.
|
void |
setOutputPath(java.lang.String outputPath)
Specifies the path on the server filesystem to which the support data '
archive should be written.
|
void |
setReportCount(java.lang.Integer reportCount)
Specifies the number of intervals that should be captured form tools that
use interval-based sampling (e.g., vmstat, iostat, mpstat, etc.).
|
void |
setReportIntervalSeconds(java.lang.Integer reportIntervalSeconds)
Specifies the interval duration in seconds that should be used for tools
that use interval-based sampling (e.g., vmstat, iostat, mpstat, etc.).
|
void |
setRetainPreviousSupportDataArchiveAge(java.lang.String retainPreviousSupportDataArchiveAge)
Specifies the minimum age of existing support data archives that should be
retained.
|
void |
setRetainPreviousSupportDataArchiveAgeMillis(java.lang.Long retainPreviousSupportDataArchiveAgeMillis)
Specifies the minimum age in milliseconds of existing support data
archives that should be retained.
|
void |
setRetainPreviousSupportDataArchiveCount(java.lang.Integer retainPreviousSupportDataArchiveCount)
Specifies the minimum number of existing support data archives that should
be retained.
|
void |
setScheduledStartTime(java.util.Date scheduledStartTime)
Specifies the earliest time that the task should be eligible to start
running.
|
void |
setSecurityLevel(CollectSupportDataSecurityLevel securityLevel)
Specifies the security level that should be used to indicate which data
should be obscured, redacted, or omitted from the support data archive.
|
void |
setTaskID(java.lang.String taskID)
Specifies the task ID that should be used for the task.
|
void |
setUseSequentialMode(java.lang.Boolean useSequentialMode)
Specifies the value of a flag that indicates whether the server should
collect items for the support data archive in sequential mode rather than
in parallel.
|
java.lang.String |
toString()
Retrieves a string representation of this collect support data task
properties object.
|
void |
toString(java.lang.StringBuilder buffer)
Appends a string representation of this collect support data task
properties object to the provided buffer.
|
public CollectSupportDataTaskProperties()
public CollectSupportDataTaskProperties(@NotNull CollectSupportDataTaskProperties properties)
properties
- The collect support data task properties to duplicate.public CollectSupportDataTaskProperties(@NotNull CollectSupportDataTask task)
task
- The collect support data task instance from which the
properties should be set.@Nullable public java.lang.String getOutputPath()
null
if no value has been
specified for the property.public void setOutputPath(@Nullable java.lang.String outputPath)
outputPath
- The path on the server filesystem to which the support
data archive should be written. It may be null
if the server should choose the path and name for the
output file.@Nullable public java.lang.String getEncryptionPassphraseFile()
null
if no value has been specified for the property, and
the support data archive should not be encrypted.public void setEncryptionPassphraseFile(@Nullable java.lang.String encryptionPassphraseFile)
encryptionPassphraseFile
- The path on the server filesystem to a
file that contains the passphrase to use
to encrypt the support data archive. It
may be null
if the support data
archive should not be encrypted.@Nullable public java.lang.Boolean getIncludeExpensiveData()
null
if the property should not be specified when the
task is created (in which case the server will use a default
behavior of excluding expensive data).public void setIncludeExpensiveData(@Nullable java.lang.Boolean includeExpensiveData)
includeExpensiveData
- The value of a flag that indicates whether
the support data archive may include data
that is potentially expensive to collect. It
may be null
if the flag should not be
specified when the task is created (in which
case the server will use a default behavior
of excluding expensive data).@Nullable public java.lang.Boolean getIncludeReplicationStateDump()
null
if
the property should not be specified when the task is created (in
which case the server will use a default behavior of excluding the
state dump).public void setIncludeReplicationStateDump(@Nullable java.lang.Boolean includeReplicationStateDump)
includeReplicationStateDump
- The value of a flag that indicates
whether the support data archive may
include a replication state dump. It
may be null
if the flag should
not be specified when the task is
created (in which case the server will
use a default behavior of excluding
the state dump).@Nullable public java.lang.Boolean getIncludeBinaryFiles()
null
if the property
should not be specified when the task is created (in which case
the server will use a default behavior of excluding binary files).public void setIncludeBinaryFiles(@Nullable java.lang.Boolean includeBinaryFiles)
includeBinaryFiles
- The value of a flag that indicates whether the
support data archive may include binary files.
It may be null
if the property should
not be specified when the task is created (in
which case the server will use a default
behavior of excluding binary files).@Nullable public java.lang.Boolean getIncludeExtensionSource()
null
if
the property should not be specified when the task is created (in
which case the server will use a default behavior of excluding
extension source code).public void setIncludeExtensionSource(@Nullable java.lang.Boolean includeExtensionSource)
includeExtensionSource
- The value of a flag that indicates whether
the support data archive should include
source code (if available) for any
third-party extensions in the server. It
may be null
if the property should
not be specified when the task is
created (in which case the server will use
a default behavior of excluding extension
source code).@Nullable public java.lang.Boolean getUseSequentialMode()
null
if the property should
not be specified when the task is created (in which case the
server will default to capturing data in parallel).public void setUseSequentialMode(@Nullable java.lang.Boolean useSequentialMode)
useSequentialMode
- The value of a flag that indicates whether the
server should collect items for the support data
archive in sequential mode rather than in
parallel. It may be null
if the
property should not be specified when the task
is created (in which case the server will
default to capturing data in parallel).@Nullable public CollectSupportDataSecurityLevel getSecurityLevel()
null
if the property should not be
specified when the task is created (in which case the server will
use a default security level).public void setSecurityLevel(@Nullable CollectSupportDataSecurityLevel securityLevel)
securityLevel
- The security level that should be used when creating
the support data archive. It may be null
if
the property should not be specified when the task
is created (in which case the server will use a
default security level).@Nullable public java.lang.Integer getReportCount()
null
if the property
should not be specified when the task is created (in which case
the server will use a default report count).public void setReportCount(@Nullable java.lang.Integer reportCount)
reportCount
- The number of intervals that should be captured from
tools that use interval-based sampling. The value
must not be negative, but it may be zero to indicate
that no intervals should be captured. It may be
null
if the property should not be specified
when the task is created (in which case the server
will use a default report count).@Nullable public java.lang.Integer getReportIntervalSeconds()
null
if the property
should not be specified when the task is created (in which case
the server will use a default report interval).public void setReportIntervalSeconds(@Nullable java.lang.Integer reportIntervalSeconds)
reportIntervalSeconds
- The interval duration in seconds that should
be used for tools that use interval-based
sampling. The value must be greater than or
equal to one. It may be null
if the
property should not be specified when the
task is created (in which case the server
will use a default report count).@Nullable public java.lang.Integer getJStackCount()
null
if the property should not be specified when the task
is created (in which case the server will use a default count).public void setJStackCount(@Nullable java.lang.Integer jstackCount)
jstackCount
- The number of times that the jstack utility should be
invoked to obtain stack traces from all threads in the
server. The value must not be negative, but it may be
zero to indicate that the jstack utility should not be
invoked. It may be null
if the property
should not be specified when the task is created (in
which case the server will use a default count).@Nullable public java.util.Date getLogStartTime()
null
if no log start time has
been specified.@Nullable public java.util.Date getLogEndTime()
null
if no log end time has
been specified.public void setLogTimeRange(@Nullable java.util.Date logStartTime, @Nullable java.util.Date logEndTime)
logStartTime
- The start time for the range of log messages to
include in the support data archive. It may be
null
if no log time range should be used.logEndTime
- The end time for the range of log messages to include
in the support data archive. It may be null
if no log time range should be used, or if the time
range should only be specified using a start time
without an end time.@Nullable public java.lang.String getLogDuration()
null
if the
property should not be specified when the task is created (in
which case the server will use a default behavior for selecting
the amount of log content to include).@Nullable public java.lang.Long getLogDurationMillis() throws TaskException
null
if no log duration is set.TaskException
- If the log duration value cannot be parsed as a
valid duration.public void setLogDuration(@Nullable java.lang.String logDuration) throws TaskException
logDuration
- The string representation of the duration of log
content that should be included in the support data
archive. It may be null
if the property
should not be specified when the task is created (in
which case the server will determine an appropriate
amount of log content to include).TaskException
- If the provided string representation cannot be
parsed as a valid duration.public void setLogDurationMillis(@Nullable java.lang.Long logDurationMillis)
logDurationMillis
- The duration in milliseconds of log content that
should be included in the support data archive.
The value must be greater than zero. It may be
null
if the property should not be
specified when the task is created (in which
case the server will determine an appropriate
amount of log content to include).@Nullable public java.lang.Integer getLogFileHeadCollectionSizeKB()
null
if the property should not be specified when the
task is created (in which case the server will determine an
appropriate amount of log content to include).public void setLogFileHeadCollectionSizeKB(@Nullable java.lang.Integer logFileHeadCollectionSizeKB)
logFileHeadCollectionSizeKB
- The amount of data in kilobytes to
capture from the beginning of each log
file that should be included in the
support data archive. This may be
null
if the property should
not be specified when the task is
created (in which case the server will
determine an appropriate amount of log
content to include).@Nullable public java.lang.Integer getLogFileTailCollectionSizeKB()
null
if the property should not be specified when the task
is created (in which case the server will determine an
appropriate amount of log content to include).public void setLogFileTailCollectionSizeKB(@Nullable java.lang.Integer logFileTailCollectionSizeKB)
logFileTailCollectionSizeKB
- The amount of data in kilobytes to
capture from the end of each log file
that should be included in the
support data archive. This may be
null
if the property should
not be specified when the task is
created (in which case the server will
determine an appropriate amount of log
content to include).@Nullable public java.lang.String getComment()
null
if no comment should be included.public void setComment(@Nullable java.lang.String comment)
comment
- An additional comment that should be included in the
support data archive. It may be null
if no
additional comment should be included.@Nullable public java.lang.Integer getRetainPreviousSupportDataArchiveCount()
null
if there is no minimum retain count.public void setRetainPreviousSupportDataArchiveCount(@Nullable java.lang.Integer retainPreviousSupportDataArchiveCount)
retainPreviousSupportDataArchiveCount
- The minimum number of existing support data archives that
should be retained. A value of zero indicates that only the
new support data archive should be retained, and any other
preexisting archives may be removed. It may be null
if only the age of existing archives should be considered (if
a retain age is specified), or if no existing support data
archives should be removed (if no retain age is specified).@Nullable public java.lang.String getRetainPreviousSupportDataArchiveAge()
null
if there is no minimum retain age.@Nullable public java.lang.Long getRetainPreviousSupportDataArchiveAgeMillis() throws TaskException
null
if no retain age is set.TaskException
- If the retain age value cannot be parsed as a valid
duration.public void setRetainPreviousSupportDataArchiveAge(@Nullable java.lang.String retainPreviousSupportDataArchiveAge) throws TaskException
retainPreviousSupportDataArchiveAge
- The minimum age of existing support data archives that
should be retained. Any existing support data archives that
are older than this may be removed. It may be null
if only the number of existing archives should be considered
(if a retain count is specified), or if no existing support
data archives should be removed (if no retain count is
specified).TaskException
- If the provided string representation cannot be
parsed as a valid duration.public void setRetainPreviousSupportDataArchiveAgeMillis(@Nullable java.lang.Long retainPreviousSupportDataArchiveAgeMillis)
retainPreviousSupportDataArchiveAgeMillis
- The minimum age in milliseconds of existing support data
archives that should be retained. Any existing support data
archives that are older than this may be removed. It may be
null
if only the number of existing archives should be
considered (if a retain count is specified), or if no existing
support data archives should be removed (if no retain count is
specified).@Nullable public java.lang.String getTaskID()
null
if a
random UUID should be generated for use as the task ID.public void setTaskID(@Nullable java.lang.String taskID)
taskID
- The task ID that should be used for the task. It may be
null
if a random UUID should be generated for use
as the task ID.@Nullable public java.util.Date getScheduledStartTime()
null
if the task should be eligible to start
immediately (or as soon as all of its dependencies have been
satisfied).public void setScheduledStartTime(@Nullable java.util.Date scheduledStartTime)
scheduledStartTime
- The earliest time that the task should be
eligible to start running. It may be
null
if the task should be eligible to
start immediately (or as soon as all of its
dependencies have been satisfied).@NotNull public java.util.List<java.lang.String> getDependencyIDs()
public void setDependencyIDs(@Nullable java.util.List<java.lang.String> dependencyIDs)
dependencyIDs
- The task IDs for any tasks that must complete before
the new collect support data task will be eligible
to start running. It may be null
or empty
if the new task should not depend on any other
tasks.@Nullable public FailedDependencyAction getFailedDependencyAction()
null
if the property should not be specified when creating
the task (and the server should choose an appropriate failed
dependency action).public void setFailedDependencyAction(@Nullable FailedDependencyAction failedDependencyAction)
failedDependencyAction
- The action that the server should take if
any of the tasks on which the new task
depends did not complete successfully. It
may be null
if the property should
not be specified when creating the task
(and the server should choose an
appropriate failed dependency action).@NotNull public java.util.List<java.lang.String> getNotifyOnStart()
public void setNotifyOnStart(@Nullable java.util.List<java.lang.String> notifyOnStart)
notifyOnStart
- The addresses to email whenever the task starts
running. It amy be null
or empty if no
email notification should be sent when starting the
task.@NotNull public java.util.List<java.lang.String> getNotifyOnCompletion()
public void setNotifyOnCompletion(@Nullable java.util.List<java.lang.String> notifyOnCompletion)
notifyOnCompletion
- The addresses to email whenever the task
completes. It amy be null
or empty if
no email notification should be sent when the
task completes.@NotNull public java.util.List<java.lang.String> getNotifyOnSuccess()
public void setNotifyOnSuccess(@Nullable java.util.List<java.lang.String> notifyOnSuccess)
notifyOnSuccess
- The addresses to email if the task completes
successfully. It amy be null
or empty if
no email notification should be sent on
successful completion.@NotNull public java.util.List<java.lang.String> getNotifyOnError()
public void setNotifyOnError(@Nullable java.util.List<java.lang.String> notifyOnError)
notifyOnError
- The addresses to email if the task does not complete
successfully. It amy be null
or empty if
no email notification should be sent on an
unsuccessful completion.@Nullable public java.lang.Boolean getAlertOnStart()
null
if the property should not be specified when the
task is created (and the server will default to not sending any
alert).public void setAlertOnStart(@Nullable java.lang.Boolean alertOnStart)
alertOnStart
- The flag that indicates whether the server should
send an administrative alert notification when the
task starts running, It may be null
if the
property should not be specified when the task is
created (and the server will default to not sending
any alert).@Nullable public java.lang.Boolean getAlertOnSuccess()
null
if the property should not be
specified when the task is created (and the server will default to
not sending any alert).public void setAlertOnSuccess(@Nullable java.lang.Boolean alertOnSuccess)
alertOnSuccess
- The flag that indicates whether the server should
send an administrative alert notification if the
task completes successfully, It may be
null
if the property should not be
specified when the task is created (and the server
will default to not sending any alert).@Nullable public java.lang.Boolean getAlertOnError()
null
if the property should not be
specified when the task is created (and the server will default to
not sending any alert).public void setAlertOnError(@Nullable java.lang.Boolean alertOnError)
alertOnError
- The flag that indicates whether the server should
send an administrative alert notification if the task
does not complete successfully, It may be
null
if the property should not be specified
when the task is created (and the server will default
to not sending any alert).@NotNull public java.lang.String toString()
toString
in class java.lang.Object