Schedule demo

Server Settings


AMServer Properties file

By editing the AMServer.Properties file (available under <Applications Manager Home>/conf), users can change the default server settings used in ManageEngine Applications Manager. Under the Settings tab, click on Server Settings under Product Settings. Here is a list of keys that can be configured from the UI:

KeyDescription
am.webserver.portThis is the web server port used by Applications Manager to connect to the browser.
am.ssl.portKeys to enable SSL (https) and this will be enabled by default.
am.dbserver.typeBackend database type. Possible values : pgsql, mysql, mssql. If key not present, it will use mysql backend.
am.db.port / am.mysql.portPort used by the database. am.mysql.port was used before 11.
am.enablehttp.portEnables HTTP access to the server when set to true (default) and allows both HTTP and HTTPS connections.
am.server.agent.ssl.portThe server agent communication port (Default value: 10099).
am.disable.server.agent.portUsed to disable/enable the server agent communication port (True: the port is disabled; False: the port is open for communication).
am.tomcat.shutdown.portTomcat ports for Applications Manager. If any of these ports is occupied when Applications Manager starts, it will be changed automatically. In builds before 11, am.tomcat.shutdown.port will not change automatically even if it is occupied and it has to be changed manually
am.webcontainer.port
am.rmiregistry.port
am.shutdown.port
am.traplistener.portPort in which Applications Manager will listen and receive traps from other device
am.createSupportZipFileKey for zipping of support file. Not used by Applications Manager. Only used by IT360
am.sslprotocols.enabletlsv1Enables support for the TLSv1 protocol when set to true.
am.dbport.checkWhile starting up, Applications Manager will check if the DB port mentioned in am.db.port / am.mysql.port is already occupied. If the ports are occupied, it will automatically change am.db.port / am.mysql.port to next unoccupied port and start DB server in that port. This will be done for mysql and pgsql backend. By default these key(s) are true. If customer is using his own pgsql / mysql, these key(s) needs to be set to false. am.mysqlport.check was used before 11
am.webserverport.checkWhile starting up, Applications Manager will check if the web server port mentioned in am.webserver.port is already occupied. If the ports are occupied, it will alert user and shutdown Applications Manager.
am.sockettest.timeoutSocket test timeout value (in seconds) used by various monitors like MySQL, MsSQL, DB2, JBoss, Oracle, Service monitor etc. This value can be also changed using the Availability Check: Timeout value option under Settings tab > Availability Settings. By default, actual timeout value is 60 seconds.
Note:
  • Actual timeout value to be configured for the monitor should be four times the value specified for the key. For example, if the timeout value specified for the key is 30, then the actual timeout value configured for the monitor would be 120 seconds (30 x 4 = 120).
  • In the Enterprise Edition setup, users can use this key to specify the timeout value for the Central server to connect to the Probe servers. Learn how
am.server.languageThese keys determine the language and country of Applications Manager. Default values of language / country keys are am.server.language=en and am.server.country=US. Possible values of language / country keys are : English ( en / US ), Chinese ( zh / CN ), German ( de / DE ), Spanish ( es / ES ), French ( fr / FR ), Hungarian ( hu / HU ), Japanese ( ja / jp ), Korean ( ko / KR ), Taiwanese ( zh / TW ), Vietnamese ( vi / VN )
am.server.country
am.server.typeKey to see if its Professional edition / Enterprise Edition. Possible values are : NORM, AAM, MAS
am.edition.type 
am.adminserver.hostFor Enterprise Edition Probe server this will have the host name of Central server
am.adminserver.portFor Enterprise Edition Probe server this will have the SSL port of Central server
am.server.startresidrangeThe resourceid range for this Applications Manager. For Enterprise Edition this will be in range according to serverid.
am.failover.preferredstandby 
am.ntlm.hostnameFully qualified Hostname of Applications Manager is required for monitoring URLs with windows NTLM authentication. If this field does not have FQHN, we need to update it manually for proper URL NTLM monitoring
am.ntlm.hostdomainnameThis has the domain name of Applications Manager server which is required for monitoring URLs with windows NTLM authentication.
am.adminpollstry.countFor Enterprise Edition, Central server will report that probe server is down according to polls to try set in this key. By default value is 1.
am.appmanager.hostnameHostname of Applications Manager which is used in alert mail, alarm escalation mail, report mails sent by Applications Manager.
am.external.hostnameIf Applications Manager is in DMZ or behind firewall and has an Internal and External Hostname/IP, we can set External hostname / Ip here so that when users access JRE Thread dumps, MySQL and Ingres Process list.
am.log.dirKey for changing location of logs directory. Not used by Applications Manager. Only used by IT360
am.scheduleReports.enableSSL 
am.user.resource.enabled 
am.sso.enabled 
am.wmi.encodingEncoding to be used for parsing vbscripts output in WMI mode

General Settings

OptionDescription
Maximum Subgroup levelThe number of subgroup levels that can be created within a monitor group. The maximum number allowed is 25.
Raw data cleanuptime (hours) *The time period (in hours) of raw data stored in the database for all non-conf monitor's attributes can be changed by using this key. The maximum time period allowed to retain the raw data is 24 hours.
Non-server monitor data cleanup interval (days)To change the clean interval of data stored for monitors like Memcached, Amazon, Cassandra, Oracle, DNS Monitor, Database Query Monitor, Exchange Server, GlassFish etc., this key value is changed.
Starting day of weekly MonitorGroup outage comparison reportFor the outage comparison week report, the week starts from Sunday.
OutOfMemoryException duration (mins)If 30 (am.oomexception.count) out of memory error occurs in less than 30 minutes (am.oomexception.duration), Applications Manager will restart.
OutOfMemoryException countNumber of times a retry is attempted before restarting Applications Manager when an OutOfMemoryException occurs.
Maximum threads for scheduler *Specifies the maximum number of threads allowed for scheduler tasks. The limit is set to 200 threads.
Generate heap dump when free JVM memory goes below (MB)If free JVM memory is less than 20 MB, a heap dump for Applications Manager is generated.
Debug-Info directory size limit (MB)The old files in the Debug-Info directory are cleared, once the limit reaches 80% of this key value. The maximum allowable size is 512 MB.
Command length in Execute program actionChanging this key value increases the command size limit for the execute program action, which is set to 400 characters by default. The maximum allowable size is now 1000 characters.
Audit Tables Cleanup Interval (in months)Specifies the time period (in months) after which older entries in the audit table are automatically deleted to optimize database performance and manage storage.
Audit Table Size (in rows)The maximum number of rows allowed in the audit table to manage database performance and storage.
Maximum row count for Query tool and Custom query reportThe maximum number of rows to be fetched as a result in Query tool and Custom query report.
Maximum allowed polling interval (in days)The maximum polling interval allowed in days.
Enable Subgroups viewWhen enabled, displays subgroups in Alarms, Reports and New Monitor page's Monitor Group.
Enable Subgroups in SLA viewLists sub groups in SLA page, if enabled along with 'Enable subgroups view'.
Send mail on datacollection failureCentral receives email,if data collection for monitor(s) doesn't occur for more than an hour or if there are out Of memory errors or if data collection stops for 50% of monitors.
Disable data cleanup in business hoursEnabling this key ,ensures that data cleanup doesn't happen between 8:00 am to 6:00 pm.
Open browser on Startup *When enabled, the browser automatically opens when Applications Manager starts.
Perform data collection in fixed polling interval *Schedule Data Collection for the CONF monitors, Custom Monitor Types on the given polling interval.
View Sub Groups in Monitor Group WidgetWhen enabled, the widget displays the subgroups present within a monitor group, providing better visibility into the group's hierarchy and structure.
View Monitor Groups as Status Lights in Business View (Deprecated View)When enabled, monitor groups will be shown as status light indicators in the legacy Business View layout, providing a quick overview of their health status.
Enable weekly stray entries cleanupWhen enabled, it cleans up stray entries on Saturdays whenever Applications Manager is restarted. After the first cleanup is done, subsequent cleanups will take place on first Saturday of every month.
Enable weekly stray entries cleanupWhen enabled, stray entries from archive tables gets cleaned up on Saturday of every month at 11 PM.
Maximum threads for schedulerThe maximum number of threads allowed for a Scheduler Task (Only available in the Enterprise Edition).
Maximum polling load factor to add monitorSpecifies the maximum allowable polling load factor on the Probe server when adding a new monitor (Only available in the Enterprise Edition).
Probe server maximum monitor countThe maximum number of monitors allowed per Probe server (Only available in the Enterprise Edition).

Note: Log clean-up in Applications Manager is an automatic process and logs are cleared without any changes in settings. To make changes in clean-up intervals refer to the table above and specify necessary values to the appropriate fields.

Availability Settings

Following are the list of options that are shown under Availability Settings. To enable/disable, click on the Edit icon, select/deselect the option and click on Save.

OptionDescription
Alert on Ping response changes when the server is downWhen enabled, it appends the ping response to the RCA when the server is down for every successive ping response changes. When disabled, appends the ping response to the RCA only once when the server is down and not for every successive ping response changes.
Enable NativePingEnables Native Ping to determine server monitor availability.
Enable PortTestEnables port test for server monitoring.
Ports to testPorts mentioned here will be used for port test.
Ping / Port test timeoutTimeout value for ping and ports test (in seconds).
Ping retriesThe number of retries to execute the ping command in case of failure to check the availability of server.
Application Server timeoutTomcat, Apache, PHP, WebSphere monitor's connection time out value (in mins).
 
Note: In the Availability Settings, the setting 'Alert on ping response changes when the server is down' is only applicable to servers. The other settings apply to the following monitor types:
  • Servers
  • Ping
  • MSSQL (Port test settings do not apply)
  • Active Directory
  • Microsoft BizTalk
  • Microsoft Dynamics AX
  • Microsoft Dynamics CRM
  • Microsoft Exchange
  • Microsoft Skype for Business
  • Microsoft MQ
  • Microsoft Office SharePoint
  • Network Policy Server (Radius Server)

Threads Configuration

OptionDescription
Main Thread *This thread is used for the JMX/SNMP Dashboard and Schedule Reports.
URLMonitor Thread *Monitors like HTTP(s) URLs,HTTP(s)-URL Sequence,SAP-CCMS use this thread for data collection.
KeyValueMonitor Thread*Monitors like Active Directory Amazon,Cassandra,Ceph Storage,DNS Monitor,Database Query Monitor,Exchange Server,Script Monitor etc. uses this thread for data collection.
MQSeriesMonitor Thread *IBM Websphere MQ monitor uses this thread for data collection
DataCollection Thread *This thread is used for data collection of monitors like AIX,AS400/iSeries,Apache Server,DB2,FreeBSD / OpenBSD,HP-UX / Tru64 UNIX,IIS Server etc.
CustomMonitor Thread *This thread used for data collection of Custom Attributes for monitors like RMI,WEBLOGIC-server,JBOSS-server,WebSphere-server,JMX1.2-MX4J-RMI.
Web Services Monitor Thread *This thread is used for WebServices.
DB Query Monitor Thread *This thread is used by the DB Query Monitor for data collection.
Prometheus Monitor Data Collection Thread *The monitors discovered via Prometheus Discovery will use this thread for data collection.

Database Configuration

OptionDescription
No. of Database Connections *This key is used to configure the no.of non transaction connections to be established with the database.

JVM Params Configuration

OptionDescription
Maximum Metaspace Size (MB) *Maximum Metaspace size allocated for Applications Manager.
Maximum Java Heap Size (MB) *Maximum memory allocated for Applications Manager.

Note: The * symbol indicates that any changes made will only take effect after restart of Applications Manager.

Monitor Group Settings

Users can choose which types of secondary-level monitors should be available for association with monitor groups. To do this, select the checkbox for each desired type and click Save.

  • Process
  • Service
  • Databases
  • Websphere MQ Queue

High Availability Settings

By selecting the Associate Virtual IP Address for Failover option, users can configure a Virtual IP address for failover. The following details must be specified when this option is enabled:

  • Virtual IP Address: An IP address that does not belong to a physical network interface. It should be static and in IPv4 format. The IP address and Virtual IP of both the primary and secondary servers must belong to the same subnet.
  • Virtual Host Name (optional): The hostname for the Virtual IP address. This hostname should resolve to the corresponding Virtual IP address and vice versa.
  • Retry Count: Specifies the number of attempts to associate the Virtual IP address in case of failure.
  • Retry Interval (in seconds): The time interval between each retry attempt to associate the Virtual IP address.

Note: Refer to this help page for a step-by-step guide on how to configure Virtual IP address for Failover.

Keys moved to DB

Apart from the keys specified in the AMServer.properties and <Applications Manager Home>/conf files, some of the keys have been moved to the database (AM_ServerConfig) and can be configured only by enabling/disabling the respective keys in that database. To find out whether the required key is shown/hidden from the UI, navigate to Settings → Support → Database Summary → Query Tool and execute the command: SELECT * FROM AM_ServerConfig;. Then search for the required key and check the value displayed under SHOWKEYINUI column. If the value shown is f, then the key is hidden from the UI.

Following are the list of keys that are moved to the AM_ServerConfig database:

KeyOption to configure in GUI
am.host.deleteDisk

 

 

 

 

 

 

 

Settings → Performance Polling → Servers

am.cli.telnet.passwordprompt
am.cli.telnet.loginprompt
am.cli.bulkcmd.exec.responsetimeout
am.server.cli.match.category.index
am.server.command.responsetimeout
am.cli.command.bulk.execute
am.cli.loginprefix
am.cliSession.caching
am.disks.ignore
am.spacecheck.warning
am.telnet.loginTimeOut
am.wmi.encoding
am.server.windows.resend.vbscripts
am.rawdata.enabled
am.rawdata.value
am.processinstance.equals
am.nosql.rediscover.intervalSettings → Performance Polling → Database Servers
am.mssql.deleteJobs
am.htmldata.mysql.daystoretain
am.pingtest.commandSettings → Performance Polling → Ping Monitor
am.repoll.intervalSettings → Performance Polling → HTTP(s) URLs
am.cam.mbeanslistsizeSettings → Performance Polling → Optimize Data Collection → JMX Application
am.dirsize.unitSettings → Performance Polling → Optimize Data Collection → File/Directory Monitor
am.filesize.unit
am.file.contentcheckcount
am.ftp.filesizeSettings → Performance Polling → Optimize Data Collection → FTP/SFTP Monitor
am.htmldata.jre.daystoretainSettings → Performance Polling → Optimize Data Collection → JavaRuntime Monitor
am.mqseries.ccsidSettings → Performance Polling → Optimize Data Collection → WebSphere Server
am.mqdelrow.enabled
am.script.deleterowSettings → Performance Polling → Optimize Data Collection → Script Monitor
am.querymonitor.rowcountSettings → Performance Polling → Optimize Data Collection → Database Query Monitor
am.query.timeout
am.vsphere.connection.timeoutSettings → Performance Polling → Optimize Data Collection → VMware ESX/ESXi Monitor
am.vsphere.read.timeout
am.xen.resourcepool.discovery.enableSettings → Performance Polling → Optimize Data Collection → XenServer
am.ssl.enabled

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Settings → Server Setting → General Settings

am.subgroups.enabled
am.slasubgroups.enabled
am.senddcstoppedmail.enabled
am.detailview.show (Professional Edition and Enterprise Edition Probe Servers) #
am.server.deleteMonitor.comparing.csvToCmdb #
am.server.defaultDiscovery.enabled #
am.upload.enabled
am.userresource.onLogin.update #
am.admin.mgstatusview.enabled
am.querytracker.enable #
am.simple.theme.enabled #
am.startmonthread.enabled #
am.standalonesdp.enabled
am.cleanup.nonbusinesshours
am.adminserver.deletesql
am.sendmonerrormail.enabled
am.browser.startup
am.dbconnection.refresh #
am.useresource.operations.concurrent.update #
cmdb.xml.path
am.api.response.timeout
am.triggerheapdump.freememorymbst
am.mas.polling.max.loadfactor
am.mas.database.max.loadfactor
am.executeaction.size
am.errorpoll.count
am.report.weekStartDay
am.userResUpdateThread.schedule.interval #
am.subgrouplevels.count
am.html.dirsize
am.server.maximum.thread.schedulerTask (Requires restart of Applications Manager)
am.oomexception.duration
am.oomexception.count
am.confdata.cleanupinterval
am.rawdata.cleanuptime
am.enablenativeping

 

 

Settings → Server Settings → Availability Settings

am.porttestenabled
am.portstotest
am.tomcattimeout
am.porttest.timeout.seconds
am.ping.retries

# Keys are hidden from the UI and can be displayed only by enabling in DB.

Loved by customers all over the world

"Standout Tool With Extensive Monitoring Capabilities"

It allows us to track crucial metrics such as response times, resource utilization, error rates, and transaction performance. The real-time monitoring alerts promptly notify us of any issues or anomalies, enabling us to take immediate action.

Reviewer Role: Research and Development

carlos-rivero
"I like Applications Manager because it helps us to detect issues present in our servers and SQL databases."
Carlos Rivero

Tech Support Manager, Lexmark

Trusted by over 6000+ businesses globally