Configure ARIS agent mail server connection

If only the ARIS agent is installed but no ARIS server you can activate automatic mailing in order to receive technical information from the ARIS agent. This will inform administrators, for example, about performance problems concerning the ARIS agent.

  1. Start ARIS Cloud Controller (ACC) on the machine where the ARIS agent is installed.

  2. Enter the following lines one after the other.

    Example:

    set mail.notification.enabled=true

    set mail.smtp.host=mailserver.us

    set mail.smtp.port=25

    set mail.smtp.username=<user name>

    set mail.smtp.password=<password>

    set mail.recipients=aris.administrator1@company.com

    set mail.recipients.cc=aris.administrator2@company.com

    set mail.sender.address=<COMPUTERNAME>@us.co

The ARIS agent mail server connection is set.

Mail notification can be configured by the following parameters:

Parameter

Description

mail.notification.enabled

(default: false)

true enables automatic mailing.

mail.smtp.host

Qualified hostname or IP of the mail server.

mail.smtp.port

(common: 25)

Port of the mail server.

mail.smtp.username

User name on the mail server. If this parameter is set, the applications will implicitly enable SMTP authentication. There is NO dedicated parameter to explicitly enable SMTP authentication.

mail.smtp.password

Mail server password for the specified user.

mail.sender.address

Sender's e-mail address.

mail.sender.name

Sender's name.

mail.recipients

Recipient's e-mail address.

This parameter is multivalued, specify several recipients separated with commas, for example:

set mail.recipients = "a@abc.com","b@abc.com"

mail.recipients.cc

Recipient's e-mail address (Carbon Copy(CC)).

This parameter is multivalued (see mail.recipients)

mail.on.system.events

Defining events triggering e-mail notification.

This parameter is multivalued, specify several event types separated by comma, for example:

set mail.on.system.events = MACHINE_STATE_CPU_LOAD_HIGH, MACHINE_STATE_

Possible values:

  • MACHINE_STATE_LOW_DISK_SPACE_PERCENT

  • MACHINE_STATE_OK_DISK_SPACE_PERCENT

  • MACHINE_STATE_LOW_DISK_SPACE

  • MACHINE_STATE_OK_DISK_SPACE

  • MACHINE_STATE_CPU_LOAD_HIGH

  • MACHINE_STATE_CPU_LOAD_OK

  • MACHINE_STATE_MEMORY_USAGE_HIGH

  • MACHINE_STATE_MEMORY_USAGE_OK

mail.on.state.change

(default: FAILED)

Defining events triggering e-mail notification if a runnable is in the state FAILED.

mail.on.runnable.monitoring.events

Defining events triggering e-mail notification.

This parameter is multivalued (see mail.on.system.events).

Possible values:

  • RUNNABLE_MONITORING_HIGH_THRESHOLD_EXCEEDED

  • RUNNABLE_MONITORING_LOW_THRESHOLD_EXCEEDED