Update the system configuration
Use this command to set any of the properties on the System Settings page of the server. The JSON template for this command lists all of the properties that you can change, but you can omit properties that you are not changing.
Request
PUT https://{hostname}:{port}
/cli/systemConfiguration
This command takes a JSON request string or file. Use the following template for the request:
{
"agentAutoLicense": "Specify true to automatically
assign licenses to agents",
"artifactAgent": "Specify a default agent for component
version imports.",
"auditLogCleanupEnabled": "Whether the audit logs will
be deleted after a given number of days.",
"auditLogCleanupHour": "The hour when audit logs are
cleaned; the value must be an integer from 0 (midnight) to
23 (11pm).",
"auditLogCleanupMinute": "The minute when audit logs are
cleaned; the value must be an integer from 0 to 59.",
"auditLogReadEntriesEnabled": "Controls whether READ
events are captured in the audit log.",
"auditLogRetentionLength": "The number of days to retain
audit log entries.",
"cleanupArchivePath": "The path for archived component
versions",
"cleanupCountToKeep": "The number of component versions
to keep",
"cleanupDaysToKeep": "The number of days component
versions are kept",
"cleanupHourOfDay": "The time when versions are cleaned;
the value must be an integer from 0 (midnight) to 23 (11
pm)",
"defaultLocale": "The default locale to use for the
system (determines language and date formats.)",
"deleteEnvResources": "Enable deleting resources from
environment resource tree",
"deployMailHost": "The host name of the mail server that
is used for notifications",
"deployMailPassword": "The user password for sending
email notifications",
"deployMailPort": "The SMTP port that is used by the
notifications mail server",
"deployMailSecure": "Specifies whether the SMTP
connection is secure",
"deployMailSender": "The sender address for email
notifications",
"deployMailUsername": "The user name for sending email
notifications",
"enableAllowFailure": "Controls whether the 'allow
failure' option can be used on the steps in a workflow.",
"enableInactiveLinks": "Specify true to show links to
inactive objects",
"enablePromptOnUse": "Controls whether user-entered
values can be specified at process run time",
"enableUIDebugging": "Changes how the UI resources are
loaded so it is easier to debug problems in the UI if set.
Enabling reduces UI performance.",
"envCompPropsOverrideEnvProps": "Determines whether or
not environment component properties will override
environment properties.",
"environmentCountToKeep": "The number of versions to
retain for this environment. Lists the versions in order
of the time of deployment to this environment, and exempts
the first N from artifact cleanup. If an archive path is
set, the versions that are cleaned up will be archived. If
no archive path is set, the versions will be deleted. To
retain all versions of a component, enter -1.",
"environmentDaysToKeep": "The number of days since
deployment to retain component versions which have been
deployed to this environment. If an archive path is set,
the versions that are cleaned up will be archived. If no
archive path is set, the versions will be deleted. To
retain component versions indefinitely, enter -1.",
"externalApprovalAgent": "Specify a default agent to use
for running External Approval Processes. Superseded by
approvalAgentPool.",
"externalApprovalAgentPool": "Specify a default agent
pool to use for running External Approval Processes.
Supersedes approvalAgent.",
"externalURL": "The URL that agents use to connect to
the server",
"externalUserURL": "The URL that users enter to connect
to the server",
"failProcessesWithUnresolvedProperties": "Determines
whether or not a process will fail when it encounters a
property that cannot be resolved.",
"historyCleanupDaysToKeep": "The number of days
application process history is to be kept. -1 will disable
application process history cleanup.",
"historyCleanupDuration": "The maxiumum number of hours
per day the history cleanup process can take; the value
must be an integer from 1 to 23.",
"historyCleanupEnabled": "The system will not delete any
process history unless this is enabled.",
"historyCleanupHour": "The time when application process
history is cleaned; the value must be an integer from 0
(midnight) to 23 (11pm).",
"historyCleanupMinute": "The minute when process history
is cleaned; the value must be an integer from 0 to 59.",
"integrationTag": "Specify an agent tag to use any agent
with the given tag for version imports.",
"licenseServerUrl": "The host name and port of the
license server",
"maintenanceModeEnabled": "When this option is enabled,
the server will be in maintenance mode.",
"minimumPasswordLength": "Determines the minimum length
for passwords",
"repoAutoIntegrationPeriod": "The number of seconds
between the times that the server polls components for new
versions",
"requireCommentForProcessChanges": "When enabled, the
user must provide a comment when saving changes to any
process design.",
"requireDigits": "Require new passwords to contain at
least one number character.",
"requireDuplicate": "Require new passwords to not match
the username, actual name, or configured email.",
"requireLowercase": "Require new passwords to contain at
least one lowercase character.",
"requireSpecials": "Require new passwords to contain at
least one special character.",
"requireUppercase": "Require new passwords to contain at
least one uppercase character.",
"skipCollectPropertiesForExistingAgents": "Controls
whether or not agent properties will be updated when an
existing agent reconnects to the server.",
"snapshotDaysToKeep": "The number of days to retain
snapshots. Snapshots are always kept if they are the most
recently deployed snapshot in an environment. Each
environment can override this setting and retain
snapshots longer. In this case a snapshot will only be
deleted if it is not retained by an environment. If no
environment is retaining the snapshot and the snapshot is
older than the number of days in this setting, the server
deletes the snapshot. To retain all snapshots
indefinitely, enter -1.",
"use.default.atr.if.not.specified": "Use the Default
Auth Token Restriction for plugin steps that do not have
an auth token restriction set. If false this will not
restrict auth token usage at all. Any new version will
have an auth token restriction.",
"validateAgentIp": "Controls validation of agent IPs and
hostnames. The first time the agent connects, its IP and
hostname will be saved. In subsequent connections, if
either has changed, the agent will be prevented from
coming online.",
"winRSAgent": "The agent to use for running agent
installation processes on Windows machines. The agent must
be installed on a Windows machine."
}
Example JSON request
{
"minimumPasswordLength": "9",
"requireComplexPasswords": "true"
}
Related CLI command: setSystemConfiguration.