Server Configuration
You can configure the Avantra server runtime environment by setting the values for multiple parameters. Some of the parameters can be adjusted while the server is running and others require a restart. If there is a refresh icon beside the parameter you need to restart the Avantra server service before changes will take effect.
To adjust Server parameters:
- Select Administration > Settings from the top-level menu.
- Choose Avantra Master.
- Click on the Edit icon and change the value or on the Refresh icon to restore the default.
- Click Save.
Server Parameters
| Parameter | Description | Default Value | Unit |
|---|---|---|---|
| Automation.AutomationThreads | Sets the maximum number of worker threads that can be used from the Avantra automation engine. | 10 | Integer |
| DB Clean Up Service.CcmsAlertKeepdays | Defines how long to keep CCMS Alerts in the Avantra Database. | 60 | Days |
| DB Clean Up Service.DAILY_CHECK_KEEPTIME | Defines how long to keep Daily Checks in the Avantra Database. 0 means forever. Please be aware that the unit is months. | 0 | Months |
| DB Clean Up Service.KeepAbortedMessagesForNDays | Defines how long aborted Notification messages are kept in the Avantra Database. | 3 | Days |
| DB Clean Up Service.KeepOkBlockedMessagesForNDays | Defines how long blocked OK Notification messages are kept in the database. | 3 | Days |
| DB Clean Up Service.KeepOkSentMessagesForNDays | Defines how long sent OK Notification messages are kept in the database. | 3 | Days |
| DB Clean Up Service.KeepUnprocessedMessagesForNHours | Defines how long unprocessed Notification messages are kept in the Avantra Database. | 6 | Hours |
| DB Clean Up Service.LOGBOOK_KEEPTIME | Defines how long logbook entries are kept in the Avantra Database. | 24 | Months |
| DB Clean Up Service.RTM_HISTORY_KEEPTIME | Defines how long RealTime Monitoring history records are kept in the Avantra Database. | 60 | Days |
| DB Clean Up Service.UPDATE_LOG_KEEP_DAYS | Defines the maximum age of Agent Self Updates log records to keep. | 60 | Days |
| ForceAuditComment | Makes a comment for Start/Stop/Restart actions a mandatory action. The comment field is always visible on Start/Stop actions and is blank by default. Entering text (not less than 5 characters) is mandatory to start the action. Possible values are: OFF: comment field is available, but entering a comment is optional ON: entering a comment is mandatory to perform the action | OFF | |
| global.AGENTLISTENERPORT | Defines the default TCP port of the Avantra Agent to which the Avantra Server tries to connect unless an AgentListenerPort is defined. | 9051 | Number |
| global.log-level | Defines the level of messages to be logged in Avantra Server master.log* files in C:\Program Files\syslink\master\log (on Microsoft Windows operating systems) or /syslink/master/log (on Unix-like operating systems) | INFO | Enum |
| global.Workflow-stop-execution-waiting-for-days | Defines the timeout for workflow execution steps in the waiting state (e.g., manual step or ask to retry). | 10 | Day |
| Gateway.tunnels | Defines tunnels to avantra-gateways in order to establish reverse connections. | empty | String of format: { id 1 ';' url 1 } { id 2 ';' url 2 }…. The URL has the format like the one described in AgentConnectRoute. |
| Mail.charset | Configures the default character set for the encoding used in the Mail Service. | empty | String |
| Mail.connect-timeout | Configures the connection timeout used in the Mail Service. | 20000 | Milliseconds |
| Mail.from | Configures the default sender address used in the Mail Service. | empty | String |
| Mail.host | Configures the default SMTP server hostname or IP address used in the Mail Service. | empty | String |
| Mail.port | Configures the default SMTP server port used in the Mail Service. | 25 | Number |
| Mail.send-separately | Configures the Mail Service: If set to true, emails to multiple recipients are sent as separate emails instead of one email being sent to multiple recipients. | false | Boolean |
| Mail.ssl | Configures the Mail Service to use SMTP over SSL. | false | Boolean |
| Mail.ssl-port | Configures the port to which the Mail service connects if Mail.ssl is set. | 465 | Number |
| Mail.suppress-names | Configures the Mail Service to suppress names in the FROM and To field. In other words, if set to true, only the email address is included. | false | Boolean |
| Mail.timeout | Configures the socket timeout used in the Mail Service. | 20000 | Milliseconds |
| Mail.tls | Configures Avantra Server's Mail Service to use STARTTSL with SMTP. | false | Boolean |
| Mail.use-cc | Configures the Mail Service to add only the first recipient to the TO field and all others to the CC field. | false | Boolean |
| Mail.user | Configures the user name used by the Mail Service for authentication. | empty | String |
| Mail.password | Configures the password for Mail.user. | empty | String |
| MaintenanceWindowManager.NumberOfDaysToKeepMtnwHistory | Defines the number of days that old Maintenance Window history records are kept. History records are used internally only. This setting does not affect the Maintenance Windows themselves! | 60 | Days |
| MasterWorker.enable-masterworker-2 | Enable a third worker for the Avantra Server Do not change this setting unless instructed by the Avantra support! | false | Boolean |
| MasterWorker.enable-masterworker-3 | Enable a fourth worker for the Avantra Server Do not change this setting unless instructed by the Avantra support! | false | Boolean |
| MasterWorker.max-queue-size | Defines the length of the communication queue between the Avantra Server and its workers. Do not change this setting unless instructed by the Avantra support! | 200 | Number |
| Max.steps-triggered-per-minute | Defines how many steps can be started simultaneously per minute. Depending on the resources available to the Avantra servers, the default number of maximum steps executed per minute may be too high or too low. If you experience issues starting many workflows, lower the parameter value. | 60 | Number |
| Network.bind-address | Defines the IP Address for the Avantra Server to listen to. The default is 0.0.0.0 in case of which the Avantra Server will listen on all available IP addresses of the host. | 0.0.0.0 | String |
| Network.client-alias | Determines the aliases of the keystore used for outgoing connections. | client,client52 | List |
| Network.masterhost | Defines FQDN of the Avantra Server. This value is determined automatically based on the physical hostname and the value of Network.bind-address, and there is usually no need to change it. This value is taken as the default for the MasterHost Monitoring Parameter. :::tip If the value determined is not suitable for the Avantra Agents to communicate with the Avantra Server, you probably want to define a Parameter Set for Servers containing a properly defined MasterHost.::: | Integer | |
| Network.masterport | Defines the Listening TCP port of the Avantra Server. This value is taken as the default for the MasterPort Monitoring Parameter. | 9050 | Integer |
| Network.server-alias | Determines the aliases of the keystore used for incoming connections. | server,server52 | List |
| Network.tls-cipher-suites | Defines patterns for allowed SSL/TLS cipher suites. Note that this only applies to outbound communication between the Avantra Server and the Avantra Agent. | SSL,TLS | String |
| Network.tls-enabled-client-protocols | Defines enabled SSL/TLS protocols for connections to an SSL/TLS server. | TLSv1.2,TLSv1.3 | String |
| Network.tls-minimal-server-protocol | Defines the minimal/preferred SSL/TLS protocol version to be used in server mode. | TLSv1.2 | Enum |
| Notifier.enable | Defines if the Notifier service of the Avantra Server is started. | true | Boolean |
| Notifier.LogLevel | Defines the level of messages to be logged in Avantra Server notifier.log* files in C:\Program Files\syslink\master\log (on Microsoft Windows operating systems) or /syslink/master/log (on Unix-like operating systems) | INFO | Enum |
| Notifier.Mail.fromSenderName | Defines the default sender address used by the Notifier service of the Avantra Server. It is used as the default sender for Email output channels. It can either be just an email address example@domain.com or the combination of name and email address Firstname Lastname <example@domain.com>. | empty | String |
| Notifier.EnableRawEmailAddresses | By default, notification output channels can only send emails to known users in Avantra. Set this option if you want to send emails to users who are not Avantra users. | Not set | Boolean |
| Notifier.PollEveryNSeconds | Defines how frequently (in seconds) the Notifier service of the Avantra Server processes Notification Actions. | 120 | Enum |
| Performance.PERFDATA_AGGREGATION_HOUR | This property defines the hours when Performance data is aggregated. | 02:00 | Integer |
| Performance.PERFDATA_KEEPTIME | Defines how long (in months) to keep hourly and daily Performance data in the Avantra Database. | 6 | Enum |
| Performance.PERFDATA_KEEPTIME_MONTHLY | Defines how long (in months) to keep monthly Performance data in the Avantra Database. | 36 | Enum |
| Performance.PERFDATA_MEASUREMENTS_KEEPTIME | Defines how long (in days) to keep raw/real-time performance measurements in the database. Default is -1 days. -1 disables the collection of performance measurements. Maximum collection time is 182 days, which is approximately 6 months. Performance.PERFDATA_KEEPTIME is for aggregated hourly values, and Performance.PERFDATA_KEEPTIME_MONTHLY is for aggregated monthly values. | -1 | Enum |
| Security.EnableOSCodeExec | Enables all Avantra features that may allow remote code execution, including RUN_PROG and RUN_JS Custom Checks, SSH automation action, Run an external command output channel, JavaScript Resolver notification. :::note If you want to disable remote code execution, e.g. for security reasons, you can do so by going to Administration > Settings in the top-level menu and then navigating to Avantra Master. | True | Boolean |
| Security.RUNJSAllowDBWrite | Allows you to execute database WRITE statements (INSERT, DELETE, UPDATE) in addition to READ statements. When set to moniparam, it enables the monitoring parameter (for a database or SAP System) RunJSAllowDBWrite to be used. | ||
| System Configuration.CONFIG_REFRESH_TIME | Defines the maximum time span the Avantra Server will resend any configuration data to the Avantra Agents no matter if it has changed or not. | 86400 | Seconds |
| System Configuration.enable | Enable or disable the service that synchronizes configuration settings to the Avantra Agents. | True | Boolean |
| System Configuration.SEND_ATTEMPTS | Defines how often the Configuration Service tries to send a configuration update or command to the Avantra Agent before the data to be sent is discarded. | 5 | Enum |
| Web.authentication | If set to on, the User having the Administrator Role assigned. | on | String |
| Web.enable-https | If set to on, the Web.http-server is only accessible using HTTPS. | off | String |
| Web.http-port | Defines the web port number of the Web.http-server. | 9058 | String |
| Web.http-server | Defines if the statistics web server of the Avantra Server is turned on or off. | on | Boolean |
| Web.jvm | Enables or disables JVM diagnostics servlet. | off | Boolean |
| Web.servlets-display | Enables or disables the display of servlets on the Web Server. | on | Boolean |
| Worker.AGENTALIVE_REFRESH_MIN_WAIT | Defines the minimum time the Avantra Server waits to update the Last message from Avantra Agent is at least hh:mm:ss message of the AGENTALIVE Check in case the check status remains Critical. | 300 | Enum |
| Worker.DCD_MAX_MESSAGE_SIZE | Defines the maximum size (in bytes) of Daily Check Detail messages. | 65536 | Enum |
| Worker.InstanceDetectionForceMatchCustomer | If set to 1, SAP Instances are automatically assigned only if the Customer of the hosting Server matches the Customer of the target SAP System. | 1 | Boolean |
| Worker.LOGKEEPFILES | Defines the number of Avantra Server Worker log files in C:\ | 10 | Integer |
| Worker.LOGTIMEHIRES | Defines the time stamp precision of Avantra Server Worker log files in %ProgramFiles%\master\services\mw\log (on Microsoft Windows operating systems)or /avantra/master/services/mw/log (on Unix-like operating systems). (0=seconds, 1=milliseconds, 2=microseconds) | 1 | Enum |
| Worker.LOGTIMEHIRES | Defines the time stamp precision of Avantra Server Worker log files in %ProgramFiles%\master\services\mw\log (on Microsoft Windows operating systems)or /avantra/master/services/mw/log (on Unix-like operating systems). (0=seconds, 1=milliseconds, 2=microseconds) | 1 | Enum |
| Worker.TRACELEVEL | Defines the log level of Avantra Server Worker log files in %ProgramFiles%\master\services\mw\log (on Microsoft Windows operating systems) or /avantra/master/services/mw/log (on Unix-like operating systems). | 2 | Enum |