Change setting by xml

Navigation:  System >

Change setting by xml

Version 1.0.0

Show hidden text

Next to the settings in the ACMP console you can set some values directly in the XML-file. In this section you will see all options which can be configured just in the XML-file.

 

warning

Warning:

Changes to the XML-file affect the functions and schema of the ACMP console directly.

It is important to create a copy before you modify a value!

 

Hinweis

Note:

To make changes to the XML-file you have to stop the ACMP server tasks before!

 

File location

The config.xml is filed in %ProgramData%\Aagon\ACMP\Server\Config\%ServerId%\Config.xml

The %ServerID% is different in every ACMP installation.

 

Areas

The config.xml is divided in different areas to find and modify a specific option quickly. Here are the areas:

 

hmtoggle_arrow1ClientConfig

Name

Value area

Default value

Description

ConnectionReadTimeout

Seconds

3600

Defines the connection read timeout

SearchOnlineForInstallableWindowsUpdates

true

false

true

Search for installable windows updates with the WUM scanner

PortRangeStart

Integer

12666


PortRangeEnd

Integer

12699


UserLoginTimeThresholdInSeconds

Integer

30

Gibt die Sekunden an, die ein Benutzerlogin in der Vergangenheit liegen darf, und trotzdem noch als neue Benutzeranmeldung für den Agent gewertet wird (Betrifft nicht ausgeführte Jobs bei Benutzeranmeldung weil der Windows Benutzer vor dem ACMP Agent Start durchgeführt wird)

ShutdownDialogWaitPeriodInSeconds

Integer

10

Defines the shutdown dialog wait period on a client before the shutdown jobs start automatically.

CanAbortShutdownJobs

true

false

true

Defines whether an user can abort jobs in the shutdown dialog. When the value is false the jobs start directly.

 

hmtoggle_arrow1ServerConfig

Name

Value area

Default value

Description

FileRepoPath

Windows Path


Path to the file repository of the ACMP server

FileRepoUserName

Text


Used username when FileRepoUseAuthentication = true

FileRepoPassword

Encrypted text


Used password when FileRepoUseAuthentication = true

FileRepoUseAuthentication

true
false

false

Define the file repository user authentification

MaxAgentConnections

Integer

500

Defines the maximum agent connections to the ACMP server

MaxAgentInRolloutConnections

Integer

100

Defines the maximum agent connections to the ACMP server for a rollout

SQLCommandTimeout

Seconds

30

Defines the timeout for sql commands

PushQueueSendThreadCount

Integer

5

Push queue send thread count

ServerTmpPath

Windows Path

%AcmpServer%\Temp

Pfad zu einem Verzeichnis das als ACMP Tempverzeichnis genutzt werden kann. Ermöglicht es, das zB. Verzeichnis in eine RAM Disk von mehreren Gigabyte auszulagern.

ClientAddressMode

amIpAddress
amComputerName
amComputerFQDN

amIpAddress

Defines the client address mode. You can select the primary IP (amIpAddress), the computer name (amComputerName) or the FQDN (amComputerFQDN).

UseNagle

true
false

false

Allows to activate the Nagle-Algorithm for outgoing TCP connection from the ACMP server. This does not apply for incoming connections.

CanAcceptClientsWithEmptyServerId

true

false

true

When this options is set to true the ACMP server is allowed to connect to a client with an empty ServerID.

 

hmtoggle_arrow1AgentInstallationConfig

Name

Value area

Default value

Description

ScanActiveDirectoryForClients

true
false

true

Indicates whether the active directory can be scanned for importing clients

LastActivityOfActiveDirectoryClientsInDays

Tage

60

The number of days of the last activity of active directory clients to be considered for an imprt.

IsLauncherPushQueued

true
false

true

When the login user is not administrator the launcher will send a "push" request.
If the value is set to true the request will be written in the normally client installation queue.
If the value is false the client installation queue will be omitted

InstallServiceRetryTimeout

Seconds

10

Time between two install service tries

MaxSimultaneousInstallThreads

Integer

5

Defines the maximum simultaneous install threads.

 

hmtoggle_arrow1ClientCommandConfig

Name

Value area

Default value

Description

IsContainerInheritanceEnabled

true
false

false

Gibt an, dass Clients sich auch Scripte vom ACMP Server ziehen, die sie durch eine ContainerStruktur vererbt bekommen haben

IsContainerRecalcBeforeScriptExecutionEnabled

true
false

true

Indicates whether a container recalc should be perform before the execution of a client command.

 

hmtoggle_arrow1HelpdeskConfig

Name

Value area

Default value

Description

DefaultSendCommentPerMail

true
false

false

Indicates whether the ckeckbox "Send comment per mail" is active. This option has no impact to the bulk change.

 

Name

Value area

Default value

Description

TicketIdOpenTag

Text

{

Opening tag for the ticket ID in Emails.

TicketIdCloseTag

Text

}

Closing tag for the ticket ID in Emails.

 

 

hmtoggle_arrow1MailConfig

Name

Value area

Default value

Description

AlwaysUseFileReceiver

true
false

false

DEBUG KEY: XML Import for Emails; to test the handling of Emails without an Email server.

Name

Value area

Default value

Description

UseEhlo

true
false

true

Indicates whether EHLO or HELO will be used by SMTP

ReplyToEMail

E-Mail Address


Reply Email

ReplyToName

Text


Reply name

 

hmtoggle_arrow1WebInterfaceConfig

Name

Value area

Default value

Description

CreationDate

ISO 8601 time stamp


Creation date

LastModified

ISO 8601 time stamp


Last modified date

HasStartDate

true
false

false

Indicates whether a start date is set

HasEndDate

true
false

false

Indicates whether a end date is set

 

hmtoggle_arrow1DistribFileRepoConfig

Name

Value area

Default value

Description

NumberOfConnectionErrorsBeforePause

Integer

3

Defines the maximum number of connection errors during the time in TimeMinutesToWaitAfterConnectionFailure.

NumberOfSyncProcessors

Integer

2

Defines the number of sync processors

TimeMinutesToWaitAfterConnectionFailure

Minutes

5

Defines the minutes to wait after a connection failure when the number of connection errors in NumberOfConnectionErrorsBeforePause is reached.

ConnectionTimeOut

Seconds

30

Connection timeout

AllowedFileSizeDelta

Kilobyte

0

Schwellwert der beim Dateigrößenvergleich erlaubt ist, bis die Datei als unterschiedlich gilt.
Wenn Quell- und Zieldatei auf unterschiedlichen Dateisystemen liegen, kann es vorkommen das die API,
aufgrund von unterschiedlicher Blockgröße, unterschiedliche Dateigrößen angibt.

 

hmtoggle_arrow1ContainerConfig

Name

Value area

Default value

Description

FullContainerRecalcCommandTimeout

Seconds

90

CommandTimeout for the call of ap_ContainerAPI_RecalcClientsInContainer Recalc for all containers and all clients in the background service

PartialContainerRecalcCommandTimeout

Seconds

60

CommandTimeout for the call of ap_ContainerAPI_RecalcContainerClients_CLT_SCANNER_ARRIVAL Recalc for all containers an one client

ContainerCountLimitForDirectRecalc

Integer

100

Defines the container count limit for direct recalc. This option is depending on:

SELECT COUNT(0) cnt 

FROM CLT_CONTAINER_STRUCTURE with (READUNCOMMITTED) 

WHERE HasClientCondition = 1

 

hmtoggle_arrow1QueryManagementConfig

Name

Value area

Default value

Description

RecordCountOfPage

Integer

25000

record count per page

 

hmtoggle_arrow1ActiveUpdateConfig

Name

Value area

Default value

Description

LastTimeCheckedForUpdatesOnWebServer

Floating point number

0

TDateTime Last time checked for updates on the update server

 

hmtoggle_arrow1FinancialConfig

Name

Value area

Default value

Description

CurrencyCode

Text

EUR

Currency code to display for the cost units in the ticket management

 

hmtoggle_arrow1DatabaseConfig

Name

Value area

Default value

Description

IsFullTextSearchSupported

true
false

true

Indicates whether a fulltext search is supported on the sql server.
This will be determined and assigned automatically.

Last change on 12.04.2017