ManageEngine Applications Manager SILVERSTREAM 3.75 App Help
User Manual: SILVERSTREAM 3.75
Open the PDF directly: View PDF 
.
Page Count: 746 [warning: Documents this large are best viewed by clicking the View PDF Link!]
- Introduction
- Installation and Setup
- Getting Started
- Working with Monitor Groups
- Configuring New Monitor
- Application Servers
- To create VMware vFabric tc Server Monitor
- 1. Click on New Monitor link.
- 2. Select VMware vFabric tc Server.
- 3. Provide the Display name of the monitor.
- 4. Enter the Host Name in which the vFabric tc Server is running.
- 5. Enter the Port number in which the JMX Agent is running (6969 by default). The port in which JMX agent is running; is defined in the 'catalina.properties' file.
- 6. Enter the User Name and Password of the vFabric tc Server.
- 7. Specify the JNDIPath. For example, JNDIPath for default installations of vFabric tc Server is /jmxrmi.
- 8. Specify the Polling Interval in minutes.
- 9. Choose the Monitor Group from the combo box with which you want to associate vFabric tc Server Monitor (optional).
- 10. Click Add Monitor(s). This discovers the vFabric tc Server from the network and starts monitoring it.
- The supported versions of WebLogic Servers are 6.1, 7.x, 8.x, 9.x, 10.x.
- Know the Prerequisites that are required to monitor WebLogic.
- To create a WebLogic Server Monitor
- 1. Click on New Monitor link.
- 2. Select WebLogic Server.
- 3. Enter the IP Address/ hostname of the host.
- 4. Enter the SubNetMask of the network.
- 5. Enter the port number in which WebLogic is running.
- 6. Enter the polling interval time in minutes.
- 7. Provide the monitor-specific authentication information, such as user name and password.
- 8. Choose the Monitor Group from the combo box with which you want to associate WebLogic Server Monitor (optional).
- 9. Click Add Monitor(s). This discovers WebLogic server from the network and starts monitoring them.
- The supported versions of WebSphere Servers are 5.x and 6.x.
- To create a WebSphere Server Monitor
- 1. Click on New Monitor link.
- 2. Select WebSphere Server.
- 3. Select the Deployment Mode as Base or Network Deployment.
- 4. For Base Mode, Enter the Host name/IP Address of the host in which websphere application server is running. For Network Deployment, enter the Host name/IP Address of the websphere application server in which the perf servlet is installed. This will autoZ
- 5. Enter the SubNetMask of the network.
- 6. Enter the HTTP Transport Port (9080 by default).
- 7. Enter the polling interval time in minutes.
- 8. Select the version of the WebSphere to be monitored - 5.x or 6.x.
- 9. Enter the port number of the SOAP Connector (8880 by default).
- 10. If you want to monitor WebSphere through SSL mode, select the SSL is enabled checkbox.
- 11. Enter the User Name and Password, if Global Security is enabled.
- 12. In Network Deployment Mode, Enter the Network Deployer's Host and SOAP Port (Default : 8879).
- 13. Choose the Monitor Group from the combo box with which you want to associate WebSphere Server Monitor (optional).
- 14. Click Add Monitor(s). This discovers WebSphere server from the network and starts monitoring them.
- See Also
- Monitor Information - Application Servers | Create Other New Monitors
- Cloud Monitors
- Custom Monitors
- Database Query Monitor
- Database Servers
- File / Directory Monitors
- HTTP URL Monitors
- Java Runtime Monitors
- Mail Servers
- Middleware / Portal
- Oracle E-Business Suite
- SAP Server Monitors
- Script Monitors
- Servers
- Services
- Custom Monitor Type
- Virtualization
- Web Server / Services
- To create a SSL Certificate Monitor, follow the steps given below:
- 1. Click on New Monitor link. Choose SSL Certificate Monitor.
- 2. Provide an appropriate Display Name for the SSL Certificate monitor.
- 3. Enter the Domain name for which SSL certificate is required to be monitored.
- 4. Provide the port in which the server is running [Default port is 443].
- 5. Check the box Need proxy to connect to the domain if the server is connected through proxy. In such cases you should also configure proxy server settings through the 'Configure Proxy' option available in the Admin tab.
- 6. Enter the Timeout value in seconds.
- 7. Provide the polling interval in minutes.
- 8. Choose the Monitor Group from the combo box with which you want to associate the SSL Certificate Monitor (optional).
- 9. Click Add Monitor(s). This discovers the SSL Certificate from the server and starts monitoring it.
- To create a Web Server Monitor, follow the steps given below:
- 1. Click on New Monitor link. Choose Web Server.
- 2. Enter the IP Address or hostname of the host in which the Monitor is running.
- 3. Enter the SubNetMask of the network.
- 4. Provide the port number in which the monitor is running.
- 5. Enter the polling interval time in minutes.
- 6. Choose the Monitor Group from the combo box with which you want to associate Web Server Monitor (optional).
- 7. Click Add Monitor(s). This discovers the Web server from the network and starts monitoring them.
- If you have added Monitors and not associated them with a Monitor Group, you can do this manually anytime. For information on associating a Monitor with a Monitor Group, refer to Associating Monitor with Monitor Groups topic.
- To create Web Services Monitor, follow the steps given below:
- Note: If you want to access Web Services through Proxy , Kindly go to Admin > Configure Proxy Settings > Check if Proxy is configured, else configure the same. For hosts that don't require Proxy, add them to the No Proxy list.
- 1. Click on New Monitor link. Choose Web Services.
- 2. Enter the WSDL URL.
- 3. Select the checkbox if proxy is required for connection to the WSDL URL.
- 4. Enter the polling interval time in minutes.
- 5. Enter the Timeout.
- 6. Give the User Name and Password, if it is required to invoke the webservice operation.
- 7. Choose the Monitor Group from the combo box with which you want to associate Web Services Monitor (optional).
- 8. Click Add Monitor(s).
- If you have added Monitors and not associated them with a Monitor Group, you can do this manually anytime. For information on associating a Monitor with a Monitor Group, refer to Associating Monitor with Monitor Groups topic.
- After creation of Web Services monitor, you can proceed to add the required operations and configure the thresholds and alarms for the same. Kindly refer Web Services Monitor for more details on operations.
- See Also
- Monitor Information - Web Server / Services | Create Other New Monitors
- Windows Performance Counters
- Application Servers
- Viewing Performance Metrics
- Application Servers
- Cloud Applications
- Windows Azure Monitors
- Custom Monitors
- Database Servers
- Middleware / Portal
- Servers
- Virtualization
- Product Integration
- ManageEngine OpManager Network Monitoring Connector
- ManageEngine OpStor SAN Monitoring Connector
- ManageEngine ServiceDesk Plus
- Site24x7 Data Integration
- ManageEngine OpManager Network Monitoring Connector
- ManageEngine OpStor SAN Monitoring Connector
- Applications Manager integration with Site24x7
- Integrating with ServiceDesk Plus
- Services
- Mail Servers
- Web Server / Services
- Real Browser Monitor
- HTTP URL Monitors
- Oracle E-Business Suite Monitor
- SAP Server Monitors
- SAP CCMS Monitors
- Java Runtime Monitor
- Alarms
- Reports
- Performing Admin Activities
- Discovery and Data Collection
- Alarm/Action
- Applications Manager Server Settings
- Integration with Portals
- Reporting
- Upload Files/Binaries
- Bulk Configuration of Monitors
- Data Backup
- Server Settings
- Production Environment
- Applications Manager REST APIs
- Prerequisites
- How do APIs work?
- Generate API Key
- Steps for using REST API
- API Description
- Add Monitor
- AddMonitor API
- AddMonitor API - Application Servers
- AddMonitor API - Cloud Apps
- AddMonitor API - Custom Monitors
- Database Query Monitor
- AddMonitor API - Database Servers
- AddMonitor API - ERP
- AddMonitor API - EUM Monitors
- AddMonitor API - Java/Transaction
- AddMonitor API - Mail Servers
- AddMonitor API - Middleware/Portal
- AddMonitor API - Servers
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- AddMonitor API - Services
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- Syntax:
- Request Parameters:
- Sample Request:
- AddMonitor API - Virtualization
- AddMonitor API - Web Server/Services
- Downtime Scheduler Operations
- Edit Monitor
- Monitor Group Operations
- List Data
- User Management
- Perform Operations
- Error Handling
- End User Monitoring (EUM)
- Enterprise Edition
- Anomaly Profile
- SLA Management Console For Managers
- Technical Support and Product Information
- Glossary
- Web Client Details
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
1
Table of Contents
INTRODUCTION ........................................................................................................... 10
Key Features .........................................................................................................................11
Monitoring Capabilities ...........................................................................................................14
Release Notes .......................................................................................................................17
INSTALLATION AND SETUP ...................................................................................... 33
System Requirements ............................................................................................................34
Differences between Windows and Linux versions of Applications Manager ..........................36
Installing and Uninstalling ......................................................................................................37
Licensing Applications Manager ............................................................................................43
Using Update Manager ..........................................................................................................44
Starting and Shutting Down Applications Manager ................................................................45
GETTING STARTED .................................................................................................... 47
Understanding Applications Manager ....................................................................................48
Prerequisites for Applications Manager ..................................................................................52
Working with Applications Manager .......................................................................................67
WORKING WITH MONITOR GROUPS ........................................................................ 68
Creating Monitor Groups ........................................................................................................69
Creating New Web Application Group ....................................................................................71
VMware Virtual Infrastructure Groups ....................................................................................73
Associating Monitors to Monitor Groups.................................................................................74
Deleting Monitor from Monitor Groups ...................................................................................75
Editing and Deleting a Monitor Group ....................................................................................76
CONFIGURING NEW MONITOR.................................................................................. 77
Application Servers ................................................................................................................79
Cloud Monitors.......................................................................................................................93
Amazon Monitors ................................................................................................................................. 94
Windows Azure Monitors ..................................................................................................................... 95
Custom Monitors ....................................................................................................................97
Database Query Monitor ........................................................................................................99
Database Servers ................................................................................................................ 100
File / Directory Monitors ....................................................................................................... 108
HTTP URL Monitors............................................................................................................. 110
Java Runtime Monitors ........................................................................................................ 117
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
2
Mail Servers ......................................................................................................................... 118
Middleware / Portal .............................................................................................................. 120
Oracle E-Business Suite ...................................................................................................... 124
SAP Server Monitors ........................................................................................................... 126
Script Monitors ..................................................................................................................... 127
Servers ................................................................................................................................ 130
Services ............................................................................................................................... 134
Custom Monitor Type ........................................................................................................... 141
Virtualization ........................................................................................................................ 145
Microsoft Hyper-V Servers ................................................................................................................. 146
VMware ESX/ESXi Servers ............................................................................................................... 147
Web Server / Services ......................................................................................................... 148
Windows Performance Counters ......................................................................................... 154
VIEWING PERFORMANCE METRICS ....................................................................... 155
Application Servers .............................................................................................................. 158
Microsoft .NET ................................................................................................................................... 159
GlassFish Servers .............................................................................................................................. 161
JBoss Servers .................................................................................................................................... 163
Oracle Application Servers ................................................................................................................ 165
SilverStream Servers ......................................................................................................................... 168
Tomcat Servers .................................................................................................................................. 170
WebLogic Servers .............................................................................................................................. 172
WebSphere Servers ........................................................................................................................... 176
Cloud Applications ............................................................................................................... 179
Amazon .............................................................................................................................................. 180
Amazon EC2 Instances ..................................................................................................................... 183
Amazon RDS Instances ..................................................................................................................... 187
Windows Azure Monitors ..................................................................................................... 190
Custom Monitors .................................................................................................................. 194
Adding JMX MBeans Attributes ......................................................................................................... 196
Adding SNMP OID Attributes ............................................................................................................. 198
File / Directory Monitors ..................................................................................................................... 199
Database Query Monitor .................................................................................................................... 201
Script Monitors ................................................................................................................................... 203
Windows Performance Counters ....................................................................................................... 208
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
3
Database Servers ................................................................................................................ 210
MySQL DB Servers ............................................................................................................................ 211
Oracle DB Servers ............................................................................................................................. 215
MS SQL DB Servers .......................................................................................................................... 223
IBM DB2 DB Servers ......................................................................................................................... 228
Sybase DB Servers ............................................................................................................................ 232
PostgreSQL DB Servers .................................................................................................................... 235
NoSQL Database Servers ................................................................................................................. 238
Cassandra DB ................................................................................................................................ 239
MongoDB ...................................................................................................................................... 241
Memcached Servers ...................................................................................................................... 244
Middleware / Portal .............................................................................................................. 246
Microsoft MQ (MSMQ) ....................................................................................................................... 247
Microsoft Office Sharepoint Servers .................................................................................................. 249
WebLogic Integration Servers ........................................................................................................... 253
IBM WebSphere MQ .......................................................................................................................... 255
VMware vFabric RabbitMQ ................................................................................................................ 257
Servers ................................................................................................................................ 260
Windows Servers ............................................................................................................................... 267
Linux Servers ..................................................................................................................................... 274
IBM AS400 / iSeries ........................................................................................................................... 280
Virtualization ........................................................................................................................ 298
VMware ESX/ESXi Servers ............................................................................................................... 299
Virtual Machines ........................................................................................................................... 305
VMware vCenter Servers .............................................................................................................. 309
Microsoft Hyper-V Servers ................................................................................................................. 311
Hyper-V Virtual Machines ............................................................................................................. 317
Product Integration .............................................................................................................. 319
ManageEngine OpManager Network Monitoring Connector ...................................................... 320
ManageEngine OpStor SAN Monitoring Connector...................................................................... 322
Applications Manager integration with Site24x7 ......................................................................... 324
Integrating with ServiceDesk Plus ................................................................................................. 327
Services ............................................................................................................................... 329
Mail Servers ......................................................................................................................... 336
Web Server / Services ......................................................................................................... 342
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
4
Real Browser Monitor .......................................................................................................... 347
HTTP URL Monitors............................................................................................................. 351
Oracle E-Business Suite Monitor ......................................................................................... 353
SAP Server Monitors ........................................................................................................... 355
SAP CCMS Monitors ........................................................................................................... 359
Java Runtime Monitor .......................................................................................................... 361
ALARMS ..................................................................................................................... 366
Alarm Details ....................................................................................................................... 368
Viewing and Configuring Alarms Globally ............................................................................ 370
Creating Threshold Profile ................................................................................................... 371
Creating Actions .................................................................................................................. 372
Sending E-mail ................................................................................................................................... 373
Sending SMS ..................................................................................................................................... 374
Executing Program ............................................................................................................................ 375
Sending Trap ..................................................................................................................................... 377
Execute MBean Operation ................................................................................................................. 379
Log a Ticket ....................................................................................................................................... 381
Perform Java Action ........................................................................................................................... 382
Perform Amazon EC2 Instance Action .............................................................................................. 383
Perform Virtual Machine Action ......................................................................................................... 384
Windows Services Action .................................................................................................................. 385
Replaceable Tags .............................................................................................................................. 387
Associating Threshold and Action with Attributes ................................................................. 390
Alarm Escalation .................................................................................................................. 392
Bulk Alarm Configuration ..................................................................................................... 393
Configuring Dependencies and Alarm Rules ........................................................................ 394
Configuring Consecutive Polls ............................................................................................. 397
REPORTS ................................................................................................................... 398
7 / 30 Reports ...................................................................................................................... 400
Capacity Planning Reports................................................................................................... 405
Grouping of Reports ............................................................................................................ 408
PERFORMING ADMIN ACTIVITIES ........................................................................... 420
Discovery and Data Collection ............................................................................................. 422
Discovery ........................................................................................................................................... 426
Custom Monitor Type......................................................................................................................... 428
Performance Polling ........................................................................................................................... 431
Downtime Scheduler .......................................................................................................................... 434
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
5
Server Process Templates ................................................................................................................ 435
Windows Service Templates ............................................................................................................. 437
Alarm/Action ........................................................................................................................ 438
Availability Settings ............................................................................................................................ 439
Action / Alarm Settings....................................................................................................................... 441
Windows Event Log Rules ................................................................................................................. 443
Alarm Escalation ................................................................................................................................ 446
Configure Global SNMP Trap ............................................................................................................ 447
SNMP Trap Listener .......................................................................................................................... 448
Applications Manager Server Settings ................................................................................. 450
Global Settings ................................................................................................................................... 451
Configure Mail Server ........................................................................................................................ 453
Configure SMS Server ....................................................................................................................... 454
Configure Proxy ................................................................................................................................. 455
User Administration ............................................................................................................................ 456
Logging .............................................................................................................................................. 460
Personalize Web Client...................................................................................................................... 461
Integration with Portals ........................................................................................................ 462
REST API ........................................................................................................................................... 463
JSON Feed ........................................................................................................................................ 464
Dashboards ........................................................................................................................................ 465
World Map Business View ................................................................................................................. 466
Reporting ............................................................................................................................. 467
Reports Settings ................................................................................................................................ 468
Enable Reports .................................................................................................................................. 470
Enable Reports .................................................................................................................................. 471
Business Hours .................................................................................................................................. 472
Upload Files/Binaries ........................................................................................................... 473
Bulk Configuration of Monitors ............................................................................................. 474
Data Backup ........................................................................................................................ 476
Server Settings .................................................................................................................... 477
Production Environment ....................................................................................................... 479
APPLICATIONS MANAGER REST APIS .................................................................. 481
Prerequisites ...................................................................................................................................... 481
How do APIs work? ............................................................................................................................ 481
Generate API Key .............................................................................................................................. 481
Steps for using REST API ................................................................................................................. 481
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
6
API Description .................................................................................................................................. 482
Add Monitor ......................................................................................................................... 485
AddMonitor API .................................................................................................................................. 485
AddMonitor API - Application Servers ............................................................................................... 487
Microsoft .NET .............................................................................................................................. 487
GlassFish ........................................................................................................................................ 488
JBoss Server................................................................................................................................... 489
Oracle Application Server ............................................................................................................. 490
SilverStream Server ....................................................................................................................... 490
Tomcat Server ............................................................................................................................... 491
WebLogic Server ........................................................................................................................... 492
WebSphere Server ........................................................................................................................ 493
AddMonitor API - Cloud Apps ............................................................................................................ 495
AddMonitor API - Custom Monitors ................................................................................................... 496
Database Query Monitor .................................................................................................................... 497
AddMonitor API - Database Servers .................................................................................................. 499
AddMonitor API - ERP ....................................................................................................................... 506
AddMonitor API - EUM Monitors ........................................................................................................ 508
AddMonitor API - Java/Transaction ................................................................................................... 515
AddMonitor API - Mail Servers .......................................................................................................... 517
AddMonitor API - Middleware/Portal .................................................................................................. 519
AddMonitor API - Servers .................................................................................................................. 523
AddMonitor API - Services ................................................................................................................. 533
AddMonitor API - Virtualization .......................................................................................................... 542
AddMonitor API - Web Server/Services ............................................................................................. 545
Downtime Scheduler Operations ......................................................................................... 551
MaintenanceTask API ........................................................................................................................ 551
Creating Downtime Scheduler Tasks ................................................................................................ 552
DeleteMaintenanceTask API ............................................................................................................. 556
EditMaintenanceTask API ................................................................................................................. 557
GetMaintenanceTaskDetails/ListMaintenanceTaskDetails API ........................................................ 561
Edit Monitor ......................................................................................................................... 562
Edit DNS Monitor API ........................................................................................................................ 563
Edit Service Monitor API .................................................................................................................... 565
Edit SSL Certificate Monitor API ........................................................................................................ 566
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
7
Monitor Group Operations ................................................................................................... 568
Add Monitor Group API ...................................................................................................................... 569
Add Sub-Group API ........................................................................................................................... 570
Associate Monitor to Monitor Group API ........................................................................................... 571
Delete Monitor Group API .................................................................................................................. 572
Delete Sub-Group API ....................................................................................................................... 573
Edit Monitor Group API ...................................................................................................................... 574
Move Monitor Group API ................................................................................................................... 576
Unassociate Monitor from Monitor Group API ................................................................................... 577
List Data .............................................................................................................................. 578
GetMonitorData API ........................................................................................................................... 579
ListActions API ................................................................................................................................... 582
List Alarms API .................................................................................................................................. 584
ListDashboards API ........................................................................................................................... 588
List Monitor API .................................................................................................................................. 590
ListMonitorGroups API ....................................................................................................................... 594
ListMGDetails API .............................................................................................................................. 598
ListMonitorTypes API ......................................................................................................................... 606
List Server API ................................................................................................................................... 610
Search API ......................................................................................................................................... 613
ShowPolledData API.......................................................................................................................... 617
User Management ............................................................................................................... 622
ListUserDetails API ............................................................................................................................ 623
Create User API ................................................................................................................................. 625
Update User API ................................................................................................................................ 627
Delete User API ................................................................................................................................. 629
Perform Operations ............................................................................................................. 630
Authenticator API ............................................................................................................................... 631
DeleteMonitor API .............................................................................................................................. 633
Enable/Disable Actions API ............................................................................................................... 635
ExecuteAction .................................................................................................................................... 636
Manage API ....................................................................................................................................... 638
Ping API ............................................................................................................................................. 641
PollNow API ....................................................................................................................................... 643
UnManage API ................................................................................................................................... 645
UnManage and Reset Status API ...................................................................................................... 647
Error Handling...................................................................................................................... 648
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
8
END USER MONITORING (EUM) .............................................................................. 656
How does End User Monitoring (EUM) Work? ..................................................................... 657
Installing and Uninstalling EUM Agent ................................................................................. 659
EUM Dashboard .................................................................................................................. 662
APM Insight - An Overview .................................................................................................. 663
How does APM Insight work? .............................................................................................. 664
Installing the APM Insight Java Agent .................................................................................. 665
APM Insight Ruby on Rails Agent ........................................................................................ 671
APM Insight .NET Agent ...................................................................................................... 673
APM Insight Agent Configuration Options ............................................................................ 675
APM Insight Dashboard ....................................................................................................... 680
Web Transaction ................................................................................................................................ 681
Apdex Score ...................................................................................................................................... 683
ENTERPRISE EDITION .............................................................................................. 684
Enterprise Edition - Admin Server ........................................................................................ 686
Installation .................................................................................................................................... 686
Managed Server Configuration ..................................................................................................... 686
Creating Monitor Groups in Admin Server ................................................................................... 687
Actions .......................................................................................................................................... 687
Enterprise Edition - Managed Server ................................................................................... 689
Enterprise Edition - Failover Support ................................................................................... 690
ANOMALY PROFILE .................................................................................................. 692
SLA MANAGEMENT CONSOLE FOR MANAGERS ................................................. 695
TECHNICAL SUPPORT AND PRODUCT INFORMATION ........................................ 697
GLOSSARY ................................................................................................................ 701
WEB CLIENT DETAILS .............................................................................................. 705
Icon Representation ............................................................................................................. 707
Custom Dashboards ............................................................................................................ 710
Custom Fields ...................................................................................................................... 714
Mobile Web/ iPhone App ..................................................................................................... 716
Appendix .............................................................................................................................. 719
Applications Manager Home ................................................................................................ 720
Data Collection - Host Resource .......................................................................................... 721
SNMP Agent Installation ...................................................................................................... 723
Installing SNMP Agent on Windows XP, 2000 and 2003 .................................................................. 724
SNMP Agent Configuration .................................................................................................. 729
Security/Firewall Requirements ........................................................................................... 733
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
9
User Management Security Policy ....................................................................................... 741
Forums / Blogs ..................................................................................................................... 743
Add-Ons .............................................................................................................................. 745
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
10
Introduction
ManageEngine® Applications Manager is a comprehensive application monitoring software used to
monitor heterogeneous business applications such as web applications, application servers, web servers,
databases, network services, systems, virtual systems, cloud resources, etc. It provides remote business
management to the applications or resources in the network. It is a powerful tool for system and network
administrators, helping them monitor any number of applications or services running in the network
without much manual effort.
Applications Manager offers out-of-the-box discovery, availability, health, performance and fault
management, and reporting of multi-vendor applications.
Alarms are generated to notify the faults in the application and are configured to trigger actions, such as
notifying the user through e-mail, SMS, trap, executing a command and invoking a MBean operation.
Through alarms, you can identify the root cause of any problem in the network with just a few clicks.
Additionally, the flexible architecture of the Applications Manager allows you to manage any application
(J2EE or J2SE) that exposes management information via JMX or SNMP through custom applications.
Note: By clicking on the Help link in the Web Client, you can access the context sensitive help
pages.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
11
Key Features
The following are some of the key features of Applications Manager.
Note: Apart from the below-mentioned applications, you can also monitor your own custom applications
via scripts. It will be added as a New Monitor Type.
Feature Description
Application Server
Monitoring
Monitors Microsoft .NET, SilverStream, GlassFish, WebLogic, WebSphere,
Tomcat, VMware vFabric tc Server, Oracle Application Server, JBoss
Application Server and also web-based applications such as Servlets, JSP, and
EJB of the application servers.
Middleware / Portal
Monitoring
Monitors WebLogic Integration, IBM WebSphere MQ, Microsoft Office
Sharepoint, and Microsoft Message Queue (MSMQ) servers.
SAP Monitoring
Monitors the performance of SAP Servers and SAP CCMS servers.
Oracle EBS Monitoring
Monitors the modules of Oracle E-Business Suite
APM Insight
Monitoring
Comprehensive end-to-end monitoring of Java, Ruby on Rails and .NET web
transactions. Provides an indepth view into the performance metrics of all
components starting from URLs to SQLs and transaction trace histories.
Virtualization
Monitoring
Monitor VMware ESX/ESXi servers, Microsoft Hyper-V servers and their guest
virtual machine instances. Support for monitoring virtual infrastructure
components such as data center and cluster through vCenter.
Cloud Apps Monitoring Support for monitoring Amazon EC2 & RDS instances, attached EBS volumes
and Amazon S3 buckets. Windows Azure monitor enables users to collect
diagnostic data for the applications deployed in Windows Azure platform.
Database Monitoring Supports monitoring of MySQL, Oracle, IBM DB2, Sybase, MS SQL,
PostgreSQL and NoSQL database monitoring for Memcached, Cassandra and
MongoDB servers.
Host Resource
Monitoring
Monitors the performance of Windows, Linux, Solaris, HP Unix, Tru64, Mac OS,
Unix, IBM AIX, IBM AS400 / iSeries, Novell and FreeBSD servers. Also
monitors Event Logs for Windows.
Java Runtime Monitor Provides out-of-the-box remote monitoring and management on the Java
platform and of applications that run on it.
File System Monitor Monitors changes in the selected files and directories.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
12
Feature Description
Windows Performance
Counters
Monitors windows performance counter values through WMI.
Ping Monitor
Checks for availability of a device, server or network device.
Script Monitoring Ad-hoc Windows/Linux custom scripts, used in-house can be managed from the
same web console. Additionally, QEngine, a test automation suite has been
integrated in Applications Manager.
Services Monitoring Monitors Services such as FTP, DNS, SFTP, Telnet, RMI adaptor, TCP port,
etc.
Mail Servers
Monitoring
Monitors Mail servers (including SMTP servers and POP servers) and Microsoft
Exchange Server.
WebServices
Monitoring
Monitors Apache, IIS,PHP,SSL Certificate,Web Services (SOAP) and other
webservers.
End User Experience
Monitoring
Provides the ability to measure the experience of your end users. Includes
support for Real Browser Monitor, DNS, Ping, LDAP and Mail Server monitors.
HTTP URL Monitoring
Monitors any HTTP or HTTPS -based URL of web pages.
Custom Application
Management
Groups data sources from multiple resources and displays them in a common
place. The data sources can be JMX MBeans and SNMP agents.
Root Cause Analysis
Provides details on the different severity levels by identifying its reason/cause.
Fault Management Sends 'Alarms' based on the monitored attributes. These can be escalated
through e-mail / SMS /trap/ MBean Operation/ execute a program.
Performance Reports The performance of the monitored application is depicted in the form of graphs
and charts for easy analysis. Its powerful reporting mechanism enables you to
analyze the trends over a period. Scheduling of reports is also possible.
Graphical
Representation of
Attribute Statistics
The attribute details are represented through graphs that provides an easy
approach to understand the "attribute vs time" statistics for one hour. Also the
icons and provided in the graphs represent details about the statistics
for 7 days and 30 days respectively.
Intuitive Web Client Allows you to perform admin activities through Web browser interface. You can
also monitor and view attributes such as the health and availability of the
monitors.
Holistic view to Monitor
Group
Manages a wide range of business applications and network services. It
provides you the flexibility to group the application and its related services to be
monitored as a single unit.
Mobile Web/ iPhone
App
An optimized view of applications being monitored for all types of smart phones
available in the market.Â
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
13
Feature Description
Business Service
Management
Helps the Manager to have an integrated high-level view of the Business
Infrastructure. Location intelligence is added via World Map Business View.
Scalable Architecture It's scalable architecture provides you the ability to monitor a variety of
Monitors. It uses a blend of both agent-based monitoring and agent-less
monitoring depending on the need.
Product Integration Integration with ManageEngine OpManager, ManageEngine OpStor,
ManageEngine ServiceDesk Plus and Site24x7.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
14
Monitoring Capabilities
This section lists the different types that Applications Manager can monitor. The types are divided into
categories based on the type of system or component.
Note: Apart from the applications mentioned below, you can monitor your own custom applications via
scripts. It will be added as a new monitor type.
1. Application Servers
o GlassFish Servers
o JBoss Servers
o Microsoft .NET
o Oracle Application Servers
o SilverStream
o Tomcat Servers
o VMware vFabric tc Server
o WebLogic Servers
o WebSphere Servers
2. Database Servers
o IBM DB2 Database Servers
o MS SQL Database Servers
o MySQL Database Servers
o Oracle Database Servers
o PostgreSQL Database Servers
o Sybase Database Servers
o Memcached Database Servers
o Cassandra Database Servers
o MongoDB Servers
3. Middleware / Portal
o IBM WebSphere MQ
o Microsoft Message Queue (MSMQ)
o Microsoft Office SharePoint
o WebLogic Integration Servers
o VMware vFabric RabbitMQ
4. ERP
o Oracle E-Business Suite
o SAP CCMS Server
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
15
o SAP Server
5. Virtualization Solutions
o Hyper-V servers
o Virtual Machines
o VMware ESX/ESXi servers
6. Cloud Apps
o Amazon EC2
o Amazon RDS
o Amazon S3
o Windows Azure
7. Services
o Active Directory
o DNS Monitor
o FTP / SFTP Monitor
o JMX Applications
o LDAP Monitor
o Ping Monitor
o Service Monitoring
o SNMP
o Telnet
8. Mail Servers
o Mail Server
o Microsoft Exchange Server
9. Web Server / Services
o Apache Server
o HTTP(s) URL Monitors and HTTP(s) URL Sequence (Record & Palyback)
o IIS Server
o PHP
o Real Browser Monitor
o SSL Certificate Monitor
o Web Server
o Web Services
10. Servers
o Free BSD
o HP Unix / Tru64 Unix
o IBM AIX
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
16
o IBM AS400 / iSeries
o Linux
o Mac OS
o Novell
o Solaris
o Windows
11. Custom Monitors
o Database Query Monitor
o File System Monitor
o JMX / SNMP Dashboard
o Script Monitor
o Windows Performance Counters
12. Web Transaction Monitors
o APM Insight for Java, .NET and Ruby on Rails
o Java Runtime
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
17
Release Notes
What's New in Release 11.0
• Support for Cassandra Database Monitoring with capabilities to monitor pending tasks,node
status in cluster, operation latency and more.
• Support for MongoDB Monitoring with capabilities to monitor connections, lock statistics,
journaling statistics and more.
• The default database bundled with the product is PostgreSQL from Build 11000. However, our
existing customers can continue using MySQL or migrate to Microsoft SQL Server.
• JBoss Monitoring is extended to support JBoss 6.0.
• Support for Windows 8 and Windows 2012 monitoring.
• Apache Tomcat bundled with the product is upgraded to version 7.0.21
• JRE bundled with the product is upgraded to version 1.6
What's New in Release 10.9
• AS400 monitoring enhanced to support History Log monitoring.
• Web Transaction Recorder tool enhanced with capabilities to record AJAX request and option to
re-record the sequence.
• Hardware monitoring enhanced to support monitoring via WMI.
What's New in Release 10.8
• The new Cloud Starter Edition that supports all private/public cloud and open source apps.
• Windows Azure monitoring and APM Insight .NET transaction monitoring are moved from Beta to
GA.
• Site24x7 Integration to monitor website performance both from within your corporate LAN and
from multiple locations outside your data center.
• Enhanced Server Monitoring to include hardware status details.
• Support for Weblogic 12c monitoring.
• Support for Tomcat 7.x monitoring.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
18
What's New in Release 10.7
• Capacity planning reports for detailed capacity analysis of CPU, memory, network, disk utilization
and more.
• Enhanced VMware ESX servers monitoring to include hardware and latency performance details.
• APM Insight .NET transaction monitoring for visibility into key performance metrics, user
satisfaction assessment, summarized database operations and transaction traces in minutes.
• Cloud monitoring capability is now extended to incorporate Windows Azure monitoring .
• Redesigned UI for the alarms tab with smoother filtering capability.
• Custom field-based filtering has been introduced for reports.
• Enhanced server monitoring to support network-mapped drives and volume mount points.
What's New in Release 10.6
• APM Insight is equipped with Ruby on Rails application monitoring capabilities; providing end-to-
end visibility into all tiers of your ruby transactions and insight into key performance metrics.
• New REST APIs introduced, for adding and deleting monitor group/ sub group and to associate
monitor to a monitor group.
• Option to configure "Tomcat Manager" URI for monitoring Tomcat server.
What's New in Release 10.5
• Applications Manager iPhone App - Our native application for iOS-based devices provides
comprehensive application monitoring on the go. | Download App
• Option to perform bulk import of server monitors using SSH Key-based authentication.
• Option to view the SOAP response in the alarm email for SOAP threshold violation.
Issues Fixed in 10.5
• The issue with the Shared Directory monitor showing Availability Status as down has been fixed.
• The issue with raw data clean up not happening for SQL back end has been fixed. | More...
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
19
What's New in Release 10.4
• The J2EE Web Transaction Monitoring feature has been enhanced. Its now called APM Insight
(Java) and comes with better troubleshooting capabilities.
• Mobile Web Client - Access Applications Manager from your Mobile Web Browsers.
• AS400 monitoring is enhanced to support specific job, subsystem monitoring.
• SNMP V3 support for monitoring servers, sending and receiving Traps.
• File Monitoring is enhanced to support content matching for remote windows files/ rolling logs.
• REST API-based integration with ManageEngine ServiceDesk to automate Alarm Management.
• Support for Internet Explorer 9 in Real Browser Monitoring (EUM Add On).
• Rest API Enhancements to list polled data for monitor, search monitor, list monitor groups.
What's New in Release 10.3
• Out-of-the-box support for monitoring the performance and availability of VMware vFabric
RabbitMQ messaging systems.
• Web client user authentication using LDAP/AD.
• Web client GUI enhancements.
• Customizing the logo in reports.
• Support for embedding different world map views.
• Support for monitoring SSLv3 enabled websites in URL monitoring.
What's New in Release 10.2
• Support for monitoring Oracle JRockit JVM in Java Runtime Monitor.
• Support for monitoring IBM JVM in Java Runtime Monitor.
• Ability to play sound for critical alarms.
• Performance Metric Widget enhanced to show graphs for additional metrics with scaling option.
What's New in Release 10.1
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
20
• Out-of-the-box support for monitoring the availability and performance of VMware vFabric tc
servers and the Spring Applications deployed on the server.
• We now support monitoring of validity and expiry dates of SSL Certificates.
• Support for Gmail in Mail Server Configuration.
• Ability to add new Event Logs other than the available default ones.
• Support for monitoring SOAP Operations with headers.
What's New in Release 10.0
• End User Experience Monitoring (EUM) add on introduced. The 'Real Browser Monitor' add-on
has been rechristened as 'End User Monitoring' add-on with enhancements that help it go beyond
real browser monitoring. This now includes LDAP, DNS, Ping and Mail Server RTT. Also, the
pricing structure of RBM has been modified from an agent-based model to a flat-fee model.
• Custom fields and labels for monitors and groups. You can view this by clicking on the 'Custom
Fields' button inside a monitor or monitor group.
• We now show split up of CPU utilization by CPU cores. There is also support for viewing server
configuration parameters.
• Improved web client and ability to customize tabs.
• Support for monitoring Virtual Infrastructure through vCenter server.
• Support for Amazon S3 monitoring.
• Ability to specify roles for Exchange server 2007/2010. This helps view more performance
metrics.
• A 64-bit binary for Applications Manager.
• IPV6 support for most monitor types.
• Anomaly Detection is no more an add-on feature. It will be part of the basic product.
• SSL support for SMTP and POP in mail server monitor.
What's New in Release 9.5
• Ability to automatically provision virtual resources based on threshold breaches. You can create
actions to automatically start, stop and restart VMs of both VMware ESX and Hyper-V servers
from Applications Manager.
• Ability to automatically provision cloud resources based on threshold breaches. You can create
actions to automatically start, stop and restart Amazon EC2 instances from Applications
Manager.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
21
• Out-of-the-box support for monitoring the availability and performance of Microsoft Message
Queue (MSMQ)
• Option to associate multiple dependent devices across managed servers.
• Enhancements to fault management module including the option to execute email/SMS actions
during selected business hours and the option to execute actions for a specific number of times
or repeatedly until it gets acknowledged.
What's New in Release 9.4
• Out-of-the-box support for monitoring the availability and performance of Microsoft Hyper-V
servers and their guest virtual machines. Applications Manager now supports multiple
virtualization vendors such as VMware and Microsoft.
• Introduced server process templates/Windows service templates which are a pre-defined,
reusable collection of processes. They provide an easy way to add multiple server
processes/templates for monitoring across a group of servers.
• Improved method of managing operations in web services. Includes the ability to specify SOAP
Action and Request values corresponding to the operation and also the ability to add custom
operations.
• New REST APIs to add different monitor types, delete and list monitors.
• Options to stop, start and reboot Amazon EC2 instances from within Applications Manager.
• Additional performance metrics for MySQL DB servers including information about system
variables of the MySQL server.
What's New in Release 9.3
• Out-of-the-box support for monitoring the availability and performance of Amazon EC2 and RDS
instances. Applications Manager helps you ensure your business-critical cloud-based applications
and services are performing well at all times.
• Introduced new report type for monitor groups known as Availability and Downtime Trend
Report. This report compares the availability of the monitor group against target availability and
also shows the downtime count and total downtime for the monitor group.
• Enhancements to SNMP Trap listener feature including the ability to select trap severity based on
threshold profiles.
• Support for monitoring Exchange server 2010.
• Option to monitor WebSphere Application Server through secure SSL mode.
• Support for associating dependent devices across managed servers in the Enterprise edition.
This will help you better organize your monitors and reduce redundant checks.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
22
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
23
What's New in Release 9.2
• Out-of-the-box support for monitoring the availability and performance of VMware ESX/ESXi host
servers and their guest virtual machine instances. Applications Manager provides a single
console for monitoring both physical and virtual components of a heterogeneous IT environment.
• Comprehensive monitoring of Memcached servers to help you detect and diagnose problems
with your caching systems faster.
• Support for monitoring PostgreSQL database servers.
• Introduced Web application group which is a new type of Monitor Group. This will be useful for
grouping your web infrastructure into logical components such as servers, databases, web
servers, etc and better manage the relationship between components.
• An improved Real Browser Monitor (RBM) dashboard that provides an overview of the status
of your web transactions from multiple locations.
• New REST APIs to create, edit and delete downtime schedulers, get monitor data, and add
monitors.
• Option to send events as SNMP Traps to external SNMP Trap listeners.
• Enhancements to Java Runtime Monitor including the ability to know how garbage collection
behaves in the JVM. You can also see the impact of the GC on thread dump with history and
view historical JVM configuration parameters.
• Support for monitoring Windows 7 server.
• Support for monitoring WebSphere Application Server version 7.
• Issues fixed include ServiceDesk Plus integration issue when customers enable AD
authentication in ServiceDesk Plus. | More
What's New in Release 9.1
• New monitor type called "Real Browser Monitor" (RBM) introduced. RBM opens up a Microsoft
Internet Explorer browser and monitors a web application just like how a real user sees it. It
supports playback from different geographical locations.
• Get notified of anomalies in a production application by defining anomaly profiles on performance
metrics. Support for anomalies based on fixed baseline, moving baseline and custom
expressions. There is also an Anomaly Dashboard introduced to facilitate viewing all the
performance metrics.
• REST APIs introduced to make integration of Applications Manager with internal portals and other
monitoring tools easier.
• At a glance Report that provide a summary of 10 monitors based on various performance metrics
and uptime. You can view reports by Monitors, Monitor Types and Monitor Groups.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
24
• Alarm Management : Define dependent device for a Monitor Group or individual monitor to
suppress false downtime alarms caused by the dependent device being down.Enhanced alarm
configuration rules for health and availability of Monitor Group.
• Monitor Group Template Dashboards have been introduced. This will help configure a custom
dashboard and reuse it for multiple Monitor Groups (business applications or customers) - based
on how you use the product.
• New widgets called "Bookmarks" and "Custom Text and HTML" for Integrating knowledge base
articles and other web links added to Custom Dashboards.
• To enhance Web Client security, configurable Account policies has been added to the User
Administration Module.
What's New in Release 9
• Microsoft SQL Server database back-end support.
• Support for monitoring Oracle E-Business Suite.
• Ability to create custom dashboards.
• Enhancements in server monitoring.
• Enhancements in WebClient look and feel.
• The MySQL DB Server bundled in the product has been upgraded from version 4.0.13 to version
5.0.52.
What's New in Release 8.6
• Monitor the performance of AS400 / iSeries.
• Support for monitoring SAP CCMS metrics.
• LDAP, DNS and FTP/SFTP Service Monitors are now supported by Applications Manager.
• Additional metrics such as Hour of day, Day of week, Statistical and Heat chart report tabs in 7,30
History data are added.
• Support for Monitor Group/Sub-Group in downtime scheduler.
• Ability to assign Sub-Group for operator role.
Issues Fixed in 8.6
• Issue in Database Query monitor is fixed. It now retains only new data collected across all rows
and columns.
• Memory leak issue in JBoss monitoring is fixed.
• Issue fixed in infinite loop in URL monitors.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
25
• Issue in associating monitors to a monitor group with same name is fixed. | More...
What's New in Release 8.5
• Database Query Monitor is now supported by Applications Manager.
• Applications Manager now supports Active Directory Monitoring.
• A new flash-based graphical view, called Business View, is added to view IT infrastructure.
• Support for database details in MySql monitors that are collected once per day based on
configuration is added.
Issues Fixed in 8.5
• Issue in Configure Alarms for Script and Query monitor when scalar attributes are not available is
fixed.
• Issue in collecting Performance metrics for Weblogic 9 and 10 datacollection, when WLS server
is restarted without restarting Applications Manager, is fixed.
• Issue fixed in Server Monitors when memory load increases leading to Out Of Memory.
• Issue fixed to have multiple network interface on the same host. | More...
What's New in Release 8.4
• ManageEngine Applications Manager integrates now with a comprehensive Network Monitoring
Tool, ManageEngine OpManager.
• In WebServices monitoring, added support for generating alarms based on the output of the
service.
• Free Edition of Applications Manager will not support DB2, Sybase in addition to Add-ons.
• J2EE Web Transactions, IBM WebSphere MQ Series and MS Office Sharepoint have been
modified as Add-ons.
Issues Fixed in 8.4
• Issue in synching of data between the Managed Servers and Admin Servers is fixed.
• Issue in showing the status in Icons View and Table view is fixed
• Fixed issue in enabling and disabling SSL in AMServer.properties is fixed Cleanup entries are
added for the Script Table data
• Fixed issue in Archiving for Tomcat Session and Oracle Users. | More...
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
26
What's New in Release 8.3
• IBM WebSphere MQ, SilverStream, Microsoft Office Sharepoint Server, GlassFish Server Monitor
Support added
• Windows Vista monitoring support added
• Oracle 10.1.3 monitoring support added
• Support for Custom attribute reports added
• Poll Now - option added for monitors
• Restricted access of Monitor Groups for Managers.
Issues Fixed in 8.3
• Fixed issue in Google Map display when the monitor group display name contains single quotes.
• While creating the Monitor Group (MG), the owners select box is shown empty when the latest
MySQL Driver is used.
• In MySQL monitoring, when the 'last error' attribute is having sepcial characters the polling will
stop for that monitor.
• The performance issue in deleting the NA rows in script monitor is fixed.| More...
What's New in Release 8.2
• Availability and Health Reports - Critical Snapshot, History reports added
• Availability Trend Report, Outage Comparison Report added
• Ability to configure Business hours for reports added
• Support for bulk import of monitor configurations
• Support for sending SMS alarms via Modem
• Network Interface monitoring in WMI mode added
What's New in Release 8.1
• Sybase Support added
• Outage Comparison Reports, Availability Trend Reports, Availability and Health Snapshot
Reports added
• Support for adding custom monitor types
• MySQL monitoring enhancements added
• Network Interface monitoring added
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
27
What's New in Release 8
• SAP Server Monitoring support added
• Enhancements in Availability and Performance Dashboards
• DB2 Monitoring Enhanced
• Improvement in scalability of reports
• WebClient Enhancements
What's New in Release 7.4
• Ping Monitor support added
• Support for Secondary Mail Server configuration
• Support for creating a Monitor Group within a Monitor Group (Monitor Sub-Group)
• Support for Monitor Group creation in Admin Server (Enterprise-Edition Setup)
• Ability to treat Monitor Group as a Services Group or as an Application Cluster has been added.
What's New in Release 7.3
• Localized webclient to support German, Spanish and French languages
• Support for monitoring Windows Performance Counters in Windows 2000
• Availability and Health realtime snapshot report for Monitor Groups added
• Support for JSON Feeds for integrating Applications Manager data in corporate intranet
• $DATE tag enhancements in actions.
• Alarm Escalation added
What's New in Release 7.2
• WebLogic Integration Server Monitoring
• Support for Java Runtime Monitor
• File System Monitoring
• Failover support for Enterprise Edition
• IIS Enhancements
• WebSphere Enhancements
• Script Monitoring Enhancements - Table support added
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
28
• WebClient Enhancements
What's New in Release 7.1
• Web Services (SOAP) Monitoring
• Windows Performance Counters Monitoring
• Support for monitoring Mac OS
• JBoss 4.0.4 Support
• WebLogic 9.2 Support
• Ability to specify the attribute type for JMX and SNMP Monitors
• Windows Authentication Support for MS SQL Server monitoring
• New Plasma View of monitors added
• Ability to compare reports is added
• Customizable UI for home tab and Plasma View
• Bulk update of Poll intervals added
• More $Tags support in executing actions ($OID, $DATE, $URL)
• SSH Key based authentication for Remote Script Monitoring and Execute Program Action
• Ability to set auto refresh time interval added.
• New Simple web client layout added. Option to choose between Classic and Simple layouts.
• New Maroon color theme added for personalizing the webclient
• While creating new monitors, troubleshooting is made easy via Diagnose Link
What's New in Release 7
What's New in Update for 7
• Remote sessions opened in Server monitoring, issue fixed
• Script Monitoring issues fixed
• Issue in invoking MBean Operation in JMX 1.2 fixed
What's New in Release 7
• Enterprise Edition - Support for large scale monitoring with a distributed setup
• Support for Windows Services monitoring
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
29
• Support for Remote Script monitoring
• Server Monitoring Enhancements (HP-UX, IBM AIX, Linux, Solaris)
• Webclient and Server Performance Enhancements
• Webclient HTTPS support
• Improved Fault Management capabilities
• Support for Authenticated JMX Agents
• Improved multi-lingual support
• Other bug fixes and minor enhancements
What's New in Release 6.6
• Support for Oracle Application Server Monitoring
• Support for Tru64 Unix Monitoring
• Support for Windows Event Log monitoring
• Support for LAMP Edition and Database Edition of ManageEngine Applications Manager
• Option to schedule daily, weekly, monthly performance and availability reports
• Option to copy and paste the configuration of one monitor to create new monitors
• Bulk update of usernames and passwords of monitors
• Ability to Manage / Unmanage a monitor
• Option to configure the number of polls for performance data collection
• Bulk alarm configuration for attributes
• More configuration support for Google Maps Business Views
What's New in Release 6.0.5
• Integration of Google Maps Business View
• Support for Weblogic 9.1
• Support for JBoss 4.0.3
• Multilingual support for Simplified Chinese and Japanese languages
• PDF report generation for attributes is provided
• Enhanced Web Client
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
30
What's New in Release 6.0.4
• Support for monitoring Microsoft .NET
• Support for monitoring WebLogic 9.
• Support for monitoring Web Transactions.
• Support for monitoring Oracle RAC.
• Integration of ManageEngine ServiceDesk Plus to track the alarms generated as trouble tickets.
• NTLM support is provided in URL monitoring.
• Reporting enhancements like Downtime History report of individual monitors and Summary
Report are provided.
• Various usability enhancements like configuring prerequisites for monitoring are provided at the
initial stage itself.
• Option to configure database retention parameters.
What's New in Release 6.0.3
• Support for Monitoring Microsoft Exchange Server.
• Support for Monitoring of FreeBSD Operating Systems.
• Support for Monitoring JBoss 4.0.2.
• Support for Telnet Monitoring is provided.
• Integration of AdventNet's QEngine - a platform independent Test Automation tool used for Web
Functionality, Web Performance, Java Application Functionality, Java API, SOAP, Regression,
and Java Application Performance testing.
• Standalone Enhanced URL Recorder is provided.
• SSL support for Apache, IIS and PHP.
• Consoles for Manager provided to maintain SLAs.
• Option to associate multiple users to single Monitor Group is provided.
• Alarm Enhancements like Pick/Unpick alarms, Annotation of alarms have been provided.
• Polls to retry can be configured individually for any attribute of a Monitor.
• Multiple varbind support in alarm messages is provided.
• Option to export reports to CSV and PDF formats.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
31
What's New in Release 6.0.2
• Support for Monitoring IBM AIX servers.
• Support for Monitoring HP Unix Servers.
• Support for Script Monitoring is provided.
• Support for PHP Monitoring is provided.
• WebSphere 6.0 Monitoring support is provided.
• WebSphere Monitoring in Network Deployment mode is supported.
• Maintenance Task Scheduler Provided.
• SNMP Trap Listener provided.
• JMX Notification Listener Provided.
• Introduction of new role - "User", in addition to the existing Operator & Administrator roles.
• Replaceable Tags enhancement provided in actions.
• Support for String data type for defining threshold values.
• Option to be execute an action (like email) repeatedly, till a monitor returns to normalcy.
• Alarm Template feature for bulk alarm configuration.
• Support for JBoss SSL .
• Custom Time Period reports provided.
• Option to delete known downtime reports provided.
What's New in Release 6.0.1
• Support for Monitoring Apache WebServers.
• Support for Monitoring IIS WebServers.
• Support for IBM DB2 Database Server Monitoring.
• JMX MBean Operation Support.
• Support for Monitoring JBoss 4.x.
• Support for Tomcat SSL.
What's New in Release 6
• Support for Monitoring WebSphere Application Server 5.x
• Support for Monitoring JBoss Application Server 3.2.x
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
32
• Support for Monitoring Tomcat Application Server
• Support for Monitoring WebLogic 8.1 Application Server
• Support for Monitoring MS SQL Database
• Support for Monitoring Oracle 10g Database
• Support for Monitoring MySQL Database
• Support for Monitoring Mail servers (SMTP, POP)
• Support for Monitoring Web servers
• Support for Monitoring Network Services like ftp, telnet, tcp port, etc
• Support for Monitoring Websites (URL, URL sequence, URL content monitors)
• SNMP based custom application monitoring
• JMX based custom application monitoring for MX4J / JDK 1.5, WebLogic JMX, JBossMX,
WebSphere JMX
• Intuitive Web client support
• Unified view of monitors using Monitor Group
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
33
Installation and Setup
You can install Applications Manager with ease, by going through the following sections:
• System Requirements
• Windows vs Linux Downloads
• Installing and Uninstalling
• Licensing
• Using Update Manager
• Starting and Shutting Down
• Troubleshooting
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
34
System Requirements
This section lists the system requirements for installing and working with Applications Manager.
Hardware Requirements:
The performance of Applications Manager depends considerably on the CPU and memory of the system.
The following table describes the recommended configuration of the system running the product.
Up to 250 monitors (with medium load on the monitored servers)
Operating Platform Processor Speed Memory Hard Disk Space
Required
Windows/Linux
1.4 GHz
2 GB RAM
20 GB
250 - 1000 monitors - Enterprise Edition Setup (One Admin & 2-3 Managed Servers)
Per Managed Server/Admin Server
Operating Platform Processor Speed Memory Hard Disk Space
Required
Windows / Linux
1.8 GHz
2 GB RAM
40 GB
1000 monitors and above - Enterprise Edition Setup (One Admin & 4 Managed Servers and above)
Per Managed Server/Admin Server
Operating Platform Processor Speed Memory* Hard Disk Space
Required
Windows / Linux Dual processor 1.8 * 2
GHz
2 GB RAM - Managed
Server
100 GB or higher based
on monitors
*The above mentioned memory does not include memory used by OS which should account for another
2GB
*If number of Managed Servers are high, 4 GB RAM for the Admin Server is recommended.
Note: It is recommended to read the Best Practices Guide before going into production.
Real Browser Monitor System requirement (for the machine where RBM Agent is to be deployed):
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
35
RBM Agents have to be installed on a dedicated Windows Machine - 256 MB RAM, 1 GB HD with
Internet Explorer 6 or above. However, Applications Manager can be installed on Windows or Linux. This
works with the Professional Edition and Enterprise Edition (with Managed Server). Know more about Real
Browser Monitor.
Software Requirements:
Supported Operating Systems
• Windows XP Professional, Windows Vista / Windows 7, Windows Server 2003, 2008, 2012
• RedHat Linux 8.0 and above
• Enterprise Linux 2.1 and above / Debian / Suse / Ubuntu / Mandriva / CentOS / Fedora Core
Supported Monitor Resolution
Applications Manager is optimized for 1024 x 768 resolution and above.
Note:
Do take a look at the Windows Vs Linux Downloads page. Compare the capabilities of Windows and
linux variations before proceeding to download the product.
Supported Database Backends
Applications Manager supports PostgreSQL and MS SQL database backends for storing all the
configuration information and data collected. PostgreSQL comes bundled with your download of
Applications Manager from Build 11000.
The supported MS SQL database versions that you may use are:
• MS SQL Servers 2005 / 2008 / 2012 ( SQL Standard / Enterprise Edition )
SQL Server Collation : Any case-insensitive collation. For Chinese Installation use chinese_PRC_CI_AS
Note: We continue support for MySQL database for our existing customers.
Supported Browsers
• Internet Explorer 6.0 and above
• Firefox 2.x and above
• Google Chrome v23.0 and above
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
36
Differences between Windows and Linux versions of
Applications Manager
Although most of the Applications Manager features are supported on both the Windows and Linux
versions, there are certain features which are only available in the Windows version.
Features supported only in the Windows Version:
The Microsoft applications/servers listed below can be monitored only using the Windows version of
Applications Manager. This is because the data collection happens through WMI (Windows Management
Instrumentation):
• Exchange Server
• Active Directory
• Microsoft .Net
• Hyper-V
• MSMQ
• SharePoint
• IIS Server
• Windows Performance Counters(any parameter related to Win32_PerfFormattedData)
Apart from these monitors, other features that are supported only in the Windows version are:
Event log rules: Any event can be monitored and notified when it occurs. This is useful when any
application generates a failure event in the Windows Event log viewer. This is helpful in a way that the
event log comes before the application actually crashes. This serves as a proactive mode of monitoring
your applications and services.
NTLM authenticated URLs and Recording HTTP(s) Sequence/Real Browser Monitor(RBM): You can
record the HTTP(s) sequence through Recorder.exe tool which works only from a Windows OS. However,
you will be able to save the sequence to Applications Manager on a Linux OS.
NOTE: In the Linux Version of Applications Manager, Windows Server Monitoring is possible only in the
SNMP mode.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
37
Installing and Uninstalling
The following are the Applications Manager product Installations.
• Free Edition
• Professional Edition (Trial/Registered)
• Enterprise Edition (Trial/Registered)
Free Edition: This allows you to monitor Five monitors (This excludes the Monitors added by default).
The Free Edition never expires and you get most of the functionality of Professional Edition. See the
difference between Free Edition and Professional Edition.
Professional / Enterprise Edition (Trial): You can avail 30 days of evaluation with no restrictions on
number of monitors. Professional Edition allows you to monitor up to 250 monitors. Enterprise Edition
allows you to monitor more number of servers and applications in a distributed setup. You can configure
independent Applications Manager installations to monitor resources and then collectively view the data
of all the independent Applications Manager installations ("Managed Server") from a single central
installation ("Admin Server").
Professional / Enterprise Edition (Registered): This is the registered version of the product.
ManageEngine provides the Registered user file after you purchase the product. To get the registered
user file, e-mail to sales@manageengine.com.
To know the comprehensive difference between Professional and Enterprise Edition features, visit our
website - Feature Comparision.
Note: You can upgrade the Professional Edition / Enterprise Edition Trial and Free Edition to
Professional / Enterprise Registered Edition. This is applicable, if you have purchased ManageEngine
Applications Manager and hold the registered license key. To upgrade your license, refer Licensing
Applications Manager.
To install Applications Manager in Windows (.exe)
To install Applications Manager in Linux (.bin)
Troubleshooting Installation
Uninstalling Applications Manager
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
38
To Install Applications Manager in Windows (.exe)
1. Download and Execute the file. The Installation Wizard is displayed. Click Next to continue.
2. Read the license agreement and click Yes.
3. Select the language in which you wish to install Applications Manager. The options are English,
Simplified Chinese, Japanese, Vietnamese, French, German, European Spanish, Korean,
Hungarian and Traditional Chinese.
4. The next screen prompts for the product edition (Free Edition, Professional Edition, Enterprise
Edition). Select the preferred edition to install. If Professional - is selected, follow the below
given steps.
5. Provide the location where the Applications Manager should be installed in your machine. Click
Browse to provide a different location of installation. Click Next.
6. Specify the name of the Folder to be placed in Program Folder. The default is ManageEngine
Applications Manager 9. Click Next.
7. Specify the port at which web server has to be started. By default, it is 9090. This is the port at
which you will connect the web client
8. Select the Database back-end support - PostgreSQL (Bundled with the product. No Setup
required) or Microsoft SQL Server (version 2005 and 2008).
9. If you select Microsoft SQL Server, you need to select if it is based on SQL Authentication or
Windows Authentication. If it is based on SQL Authentication, enter the Host Name, Port
Number, Database Name, User Name, Password of the SQL Server. If it is based on Windows
Authentication, enter the Host Name, Port Number, Database Name of the SQL Server and the
User Name , Password of the machine in which SQL Server is running. Also provide minimum
privileges required : The user account should be the DB_Owner of the created Database.
10. If you want to install Applications Manager as a service, select the 'Install Applications Manager
as Service' option and click Next.
Note: For installing as service, you need to have administrative privileges in that system. Incase,
you did not select this option while installing the Applications Manager, you can then install
Applications Manager as service by invoking the installService.bat found under <home>/bin. For
invoking installService.bat, you must have started Applications Manager atleast once. [More
Information on 'Manually Installing Applications Manager as Service'.].
11. Current Settings is displayed in the next screen. If you need to make changes, click Back, else
click Next to continue installation.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
39
12. If you had earlier selected Professional Edition, now you have to choose whether it is trial or
registered. If registered, the next screen will prompt you to select the registered license file from
your system.
13. If you had selected Free License, follow the steps from 5to 9 .
14. If you had selected Enterprise Edition, choose if you want install applications manager as
Admin Server or Managed Server.
15. If you had selected Enterprise Edition - Admin Server, next you have to enter the Admin server
host name, Port number and SSL Port number. Then, follow the steps from 5 to 9.
16. If you had selected Enterprise Edition - Managed Server, enter the associated admin server
Host name and SSL port number. If a proxy server is needed to contact the admin server from
the Managed Server machine, Enter the Host name, Port number, username and password of the
proxy server.
Then follow steps from 5 to 9.
17. You have an option to fill up a registration form for Technical Support.
18. Finally, you would be given two options - 1. To view the ReadMe file 2. To launch Applications
Manager immediately.
19. Click Finish to complete the installation process.
To Install Applications Manager in Linux (.bin)
1. Download the product for Linux.
2. Execute the downloaded file. The Installation Wizard is displayed. Click Next to continue. Read
the license agreement and click Next.
3. The next screen prompts for the product edition (Free Edition, Professional Edition, Enterprise
Edition). Select the preferred edition to install. If Professional - is selected, follow the below
given steps.
4. Select the language in which you wish to install Applications Manager. The options are English,
Simplified Chinese, Japanese, Vietnamese, French, German, European Spanish, Korean,
Hungarian and Traditional Chinese.
5. Choose whether it is trial or registered. If registered, the next screen will prompt you to select
the registered license file from your system.
6. Specify the port at which web server has to be started. By default, it is 9090. This is the port at
which you will connect the web client.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
40
7. Select the Database back-end support - PostgreSQL (Bundled with the product. No Setup
required) or Microsoft SQL Server (version 2005 and 2008).
8. If you select Microsoft SQL Server, you need to select if it is based on SQL Authentication or
Windows Authentication. If it is based on SQL Authentication, enter the Host Name, Port
Number, Database Name, User Name, Password of the SQL Server. If it is based on Windows
Authentication, enter the Host Name, Port Number, Database Name of the SQL Server and the
User Name , Password of the machine in which SQL Server is running. Also provide minimum
privileges required : The user account should be the DB_Owner of the created Database.
9. Provide the location where the Applications Manager should be installed in your machine. Click
Next.
10. Current Settings is displayed in the next screen. If you need to make changes, click Back, else
click Next to continue installation.
11. Click Finish to complete the installation process.
12. If you had selected Free License, follow the steps from 4 to 9 .
13. If you had selected Enterprise Edition, choose if you want install applications manager as
Admin server or Managed server.
14. If you had selected Enterprise Edition - Admin Server, next you have to enter the Admin server
host name, Port number and SSL Port number. Then follow the steps from 4 to 9.
15. If you had selected Enterprise Edition - Managed Server, enter the associated Admin server
Host name and SSL port number. If a proxy server is needed to contact the admin server from
the Managed Server machine, click on the proxy server check box. In the next screen, enter the
Host name, Port number, User Name and Password of the proxy server. Then follow steps from 4
to 9.
16. You have an option to fill up a registration form for Technical Support.
17. Finally, select if you want to view the ReadMe file or click Finish to launch Applications Manager
immediately.
Note: You can install Applications Manager via Command Line also. If the file name is
ManageEngine_ApplicationsManager_9_linux.bin, then type the following command in the command
prompt:
./ManageEngine_ApplicationsManager_9_linux.bin -console
Execution of this command would take you through the installation process.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
41
Trouble Shooting Installation
In case of any errors during installation, follow the steps given below to produce the logs files
(applicable only for Linux).
1. Create a text with the same name as that of the installer and with extension as ".sp". i.e, For
<File Name>.bin, create a text file named <File Name>.sp
Example: If the file name is ManageEngine_ApplicationsManager_9_linux.bin, create a text
file named ManageEngine_ApplicationsManager_9_linux.sp
2. Open the ".sp" text file in an editor, add is.debug=1 as the content.
3. Save the ".sp" text file in the same directory where the binary file resides.
4. Change to the directory where the binary file is present by executing cd command
5. Invoke the installer as ./<File Name>.bin -is:javaconsole -is:log log.txt
6. The above command will create the log file named log.txt. Mail the log file to appmanager-
support@manageengine.com.
Note: If the execution of the installation command throws an error such as "there may not be enough
temporary space available in the temp folder", then execute the file with the argument as
[for Windows] - <File Name>.exe -is:tempdir $DIRNAME
[for Linux] - ./<File Name>.bin -is:tempdir $DIRNAME
where $DIRNAME is the absolute path of any existing directory.
Troubleshoot: For more Installation Troubleshooting, refer Troubleshooting page on our
website.
Uninstalling Applications Manager
Windows:
1. Shut Down Applications Manager (Make sure that the ManageEngine ApplicationsManager service is
stopped if installed as a Windows service)
2. Open a command prompt, go to Applications Manager Home directory
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
42
( by default it is C:\Program Files\ManageEngine\AppManager ) and execute the below commands,
shutdownApplicationsManager.bat
shutdownApplicationsManager.bat -force
3. Exit out of the command prompt and close all files, folders opened in the Applications Manager Home
directory
4. Click Start > Programs > ManageEngine Applications Manager > Uninstall Applications Manager
5. Also from Control Panel > Add/Remove Programs.
Linux:
1. From the command line, go to Applications Manager Home directory ( by default it is
/opt/ManageEngine/AppManager ) and execute the below commands
sh shutdownApplicationsManager.sh
sh shutdownApplicationsManager.sh -force
2. Exit out of the command prompt and close all files, folders opened in the Applications Manager Home
directory
3. Execute the command ./uninstaller.bin from the AppManager/_uninst directory.
Manually uninstalling Applications Manager
Refer the steps in the below link,
http://apm.manageengine.com/manually-uninstall-Applications-Manager.html
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
43
Licensing Applications Manager
When you have purchased the registered license file, you need to apply the license file over the existing
version. This section explains the procedure to apply the new license file.
Applying the New License File from the Web Client
A quick way to apply the new license file is from the web client.
1. In the web client, click on the [admin] drop-down list link provided at the top right-hand corner.
2. Click Product License link in the menu
3. A Register Applications Manager pop-up is displayed.
4. Click Browse button and locate the file (License.xml) in your local machine.
5. Click Register.
Your existing version is now changed to Professional Edition - Registered.
Note: For Enterprise Edition, it is sufficient that you apply the license in Admin Server alone, the
managed servers will be taken care automatically.
Note: The Product License link on top will disappear once you have applied the registered license. If the
registered customers, want to upgrade their license further, they can use the Product License link under
Applications Manager Server Settings in the Admin tab.
Applying the New License File using License Manager
The license manager comes handy when your license has already expired and you are not able to access
the web client.
1. Invoke the updateLicense.bat/.sh file located in the <Applications Manager Home>/bin directory.
The License Manager UI is displayed.
2. Click Browse button and locate the file (License.xml) in your local machine.
3. Click Next.
4. Click Finish.
5. Re-start the Applications Manager server.
Note: To invoke License Manager via Command Line, use the following command
<updateLicense.bat/.sh -c>
Please contact us at appmanager-support@manageengine.com for any technical query.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
44
Using Update Manager
The Update Manager is a tool which is used for installing the service packs (.ppm file) over Applications
Manager. The service pack may contain certain bug fixes and new feature additions. This document
explains about how to use the Update manager to install service packs over Applications Manager.
Note: The Update Manager also has some useful validation incorporated. This validation includes
compatibility checks. You cannot use update manager to install an incompatible service pack. For
example, you cannot install a service pack of another product in Applications Manager or a service pack
of one version of Applications Manager in another version.
Installing Service Pack using Update Manager
1. Run updateManager.bat/sh file located in the <Applications Manager Home>/bin directory or
invoke Start > Programs > ManageEngine Applications Manager 10 > Update Manager in
Windows. The Update Manager tool is displayed. Click Update.
2. Provide the service pack (.ppm file) by clicking the Browse button. Only compatible service pack
file will be opened. Once the file is specified, other buttons such as Readme and Install are
enabled.
3. Click the Readme button and the Readme file related to the service pack is displayed in a
separate window.
4. Click Install. This opens a new panel where the installation process is displayed. On completion,
a message "Service Pack installed successfully" is displayed and the service pack is listed in the
Installed Patches section
To uninstall the service pack, click the Uninstall button and to know the service pack details, click the
Details button in Update Manager.
Installing Service Pack using Update Manager (Command Line Option)
1. Under <Applications Manager Home>/bin, execute the following command.
updateManager.bat -c in Windows
sh updateManager.sh -c in Linux
2. To force quit Applications Manager execute the following
command:shutdownApplicationsManager -force in
WindowsshutdownApplicationsManager.sh -f in Linux
Using this command line option, you can install or uninstall a service pack or view its details. Press 'i' to
install and specify the absolute path of the service pack file in your machine.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
45
Starting and Shutting Down Applications Manager
Starting Applications Manager
Once installation is successful, you can start the Applications Manager by following the instructions
provided for different operating systems.
To start Applications Manager
In Windows
o Click Start > Programs > ManageEngine Applications Manager 10> Applications
Manager Start (or)
o Invoke the batch file startApplicationsManager.bat file located in the <Applications
Manager Home> directory.
Once the server is initialized, a tray icon is placed in the Windows system tray . After the server
is started completely the icon changes to and a message "Server Ready for Monitoring!" is
displayed over the icon. Right-click on the Applications Manager tray icon to connect to the web
client or stop Applications Manager.
Starting Applications Manager as a Windows Service
In Windows, you can start Applications Manager as a service. With this feature you can start the
Applications Manager server automatically when the Windows system starts.
By default, during product installation, you can choose to install it as a service (More on Installation). If
you have not enabled it then, use the following option to setup Applications Manager as a service.
1. Go to <Applications Manager Home>/bin directory, execute the file installservice.bat. On
executing this file, 'ManageEngine Applications Manager' service is added in Windows
Services and the startup type is set as 'Automatic', by default. (To ensure if it is installed as
service, check for the 'Services' under 'Windows Administrative Tools'). Note: For installing
Applications Manager as service, you need to have administrative privileges in that system.
2. Now, when you start Windows system, Applications Manager is automatically started. You can
swap between Automatic and Manual modes.
To uninstall this service, go to <Applications Manager Home>/bin directory, execute the file
uninstallservice.bat.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
46
In Linux
Execute the startApplicationsManager.sh file in the <Applications Manager Home> directory.
See this blog to get tips on starting Applications Manager when Linux boots.
Troubleshoot: Having trouble starting Applications Manager? Refer to the online
Troubleshooting section.
Shutting Down Applications Manager
To shutdown Applications Manager
In Windows
o Click Start > Programs > ManageEngine Applications Manager 10> Applications
Manager Shutdown (or)
o In Applications Manager's Admin tab, under Tools, click on Shut Down Applications
Manager icon (or)
o Invoke shutdownApplicationsManager.bat file located in the <Applications Manager
Home> directory (or)
o Right-click on the Applications Manager tray icon and click Stop Applications Manager
(or)
o Click Start > Run> services.msc> opens up Services console > stop ManageEngine
Applications Manager
[If Applications Manager is running as service]
In Linux
Use shutdownApplicationsManager.sh script located in the <Applications Manager Home>
directory to shutdown Applications Manager.
You can also use the Shut Down Applications Manager tool under Admin tab in Applications
Manager.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
47
Getting Started
When Applications Manager is started in Windows, the default browser as configured in your system is
invoked and the login screen is displayed. Login by specifying the authentication details. The default user
name and password are "admin" and "admin" respectively. To know more about the different types of
user access to the product, refer to the User Administration section of Performing Admin Activities.
In Windows, if you do not want the client to open by default, follow the steps given below to disable it.
1. Edit AMServer.properties file located in the <Applications Manager Home>/conf directory.
2. Set the value of am.browser.startup as false (by default, it is true).
After this configuration, when you restart the server the next time, the web client will not be invoked
automatically. In Linux, by itself, the client will not open by default..
To login to Web Client when it is not opened by default
1. Connect to the Applications Manager through any browser with the host name and port number,
say http://localhost:9090, where 9090 is the default port number.
In Windows,
a. Click Program Files > ManageEngine Applications Manager > Applications Manager Web
Console.
b. Right-click the Applications Manager tray icon and click Start Web Client.
1. Then log in to the Applications Manager by filling in the User Authentication details.
Note: You can also use the startWebConsole.bat or sh file available at the <Applications Manager
Home> directory that opens a default browser of the localhost and connect to the Applications
Manager at http://localhost:9090. Ensure that the Applications Manager is started before executing
this file.
Browse through the following topics which would help you understand Applications Manager better and
work with it easily.
• Understanding Applications Manager
• Prerequisites for Applications Manager
• Working with Applications Manager
You can also refer our Best Practices Guide for more help on getting started with Applications Manager.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
48
Understanding Applications Manager
Applications Manager is a web-based monitoring tool that manages the performance of applications,
servers, databases, systems, services, websites, and JMX/SNMP-based custom applications in a
complex IT infrastructure.
You can find seven module tabs at the top which are explained as follows:
Intro Introduction Page of Applications Manager. It gives an overview of the working of
Applications Manager.
Home Has four views: Summary, Business View, Availability and Performance
Summary: Has a dashboard that shows the health and availability of all the Monitor
Groups in a snapshot . Lists all the Monitor Groups created and their details and
graphical representation of the Monitor Group with most critical alarms. Recent 5 alarms
can be also be viewed.
Business View: The business view provides you a graphical snapshot of the entire
business infrastructure which is being monitored. This view displays the various
Monitors associated to Monitor Groups along with its health and availability.
Availability: Gives the Availability history of the Monitors/ Monitor Groups in a snapshot.
You can get the data for either the last 24 hours or the last 30 days.
Performance: Gives the Health history and events of Monitor/Monitor Groups in a
dashboard. You can get the data for either the last 24 hours or the last 30 days
(excluding today).
Custom Dashboards: Apart from the already available dashboards, you can create
your own custom dashboards by using different widgets.
Monitors Lists all the Monitor Types supported and provides the number of Monitor being
discovered in the network. You can also click on the Monitor Types to view information
of their Monitors. On clicking the Monitor Types, you can view the Availability
Dashboard, Performance Dashboard and the List View that shows the performance
attributes of the Monitor in detail.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
49
Alarms Lists the alarms generated by the Monitor and their attributes, based on predefined
thresholds. The view is customizable such that you can view alarms for all or for
particular application or Monitor Type, list 10/25/50/75/100/125 entries in a single view,
etc.
Reports Lists the Monitor Groups and the different Monitor Types for which the reports are
generated. Reports can be viewed based on attributes listed for the corresponding
Monitor Type.
Support Provides information on getting assistance from the Applications Manager Technical
center. It also provides monitoring information on Applications Manager which monitors
itself.
Admin Lists the admin operations such as creating new application, new Monitor, etc. to be
performed for monitoring.
The left frame consists of links for easy navigation and the top frame consists of links such as Talk back,
Help, Personalize etc. common in all the screens. To know more details on these links and icon
representation, refer to the Web Client section. The various tables in the web client can be dragged and
arranged as per your requirement
Note: Have a look at Getting Started - How to Demos from Website.
Under Monitor tab, you can see all the monitors listed down. There are six different views
Category
View
Lists the monitors according to the various categories like Applications Servers,
Database Servers etc.,
Bulk
Config
View
Lists all the details of the monitors that are monitored. From this view you can carry out
bulk admin operations like updating user name and passwords across monitors. Refer
Bulk Configuration for further details.
Business
View
In this view, the Monitors will be arranged in an default order.You can re-arrange the
Monitors and click on the floppy disk icon to save the view. You can also zoom in and
out of the view, and save the zoom level which is optimal for your viewing.
Business View has the following properties.You can edit the view by clicking on
Settings icon and selecting the Edit View from the menu.
1. Update Monitor - This setting allows you to refresh the status of the Monitors
and Monitor Groups automatically by fixing some limited time (in minutes).
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
50
2. Reload Interval - This setting is similar to Update Monitor except that it will
reload the entire view after the given time. The recommended interval would be
15 minutes.
3. Associated Monitor Groups - This setting allows you to add various Monitor
Groups to your view. This is only available for the "Customizable Business
View".
4. Under View Properties, by selecting Show only Monitor Groups and Sub
Groups allows you to include the Monitor Groups and Sub Groups in the
selected view.
5. By selecting Show only Critical Monitors you can show only critical Sub
Groups and Monitors inside the selected view.
6. By selecting Show only Monitor Groups Status you can show the status of
top level Monitor Groups (that are selected via Associated Monitor Groups) in
the selected view.
You can create multiple views for a Monitor Group. Click on the Settings icon in the
business view and select Create New View. By providing various details like Update
Monitor time interval, Reload interval, opting to select Monitor and Monitor Groups and
Sub Groups you can create a custom view.
In addition, you can also edit its apperance of the view . Go to the Display Properties
tab and provide the following details:
1. Background color
2. Line Color
3. Label Color
4. Line Thickness
5. Line Transperancy
Publishing the View: Applications Manager allows you to embed these Business View
in intranet/internet portals by selecting the menu option 'Publish The View' from
Settings and copy the iframe details and pasting it in the webpages.
World
Map View
Applications Manager, integrated with online map services, provides network traffic
information at a geographical dimension. By using online map API features, Applications
manager provides different levels of abstraction in the network data visualization.Refer
to World Map View for further details.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
51
Icon View Lists all the monitors using icons, shows the host and the monitors assosciated with it
symbolically
Table
View
Lists the monitors within the host in a tabular format.
Plasma
View
The plasma view enables you to have a snapshot of what is happening with the
monitors, at one glance. The view can be put up on a plasma screen, and you can have
a look even when you are not in front of the monitor.
The 'Customize View' option available in the top right hand corner, gives you the option
to customize the layout. By checking the option “Play sound alarm for critical events”,
you can get notified/ warned of the critical events by sound alarms.
Monitor
Group
View
Lists all Monitor Groups and the Sub-Groups available. You can associate Monitors,
Copy Paste Monitor, configure alarms through this Monitor Group View itself. (as like
Bulk Config view). In addition, you can enable or disable actions via this view itself, i.e,
even if you have already configured actions like sending EMail, through 'disable action'
you can prevent EMail action.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
52
Prerequisites for Applications Manager
Discussed below are the prerequisites for managing the various monitors:
o Application Servers
GlassFish
JBoss
Oracle Application Server
Tomcat
WebLogic
WebSphere
o Database Servers
MS SQL DB Servers
MySQL DB Servers
PostgreSQL
o Cloud Apps
Windows Azure
o ERP
Oracle EBS
SAP Server, SAP CCMS
o Java / Transactions
APM Insight
Java Runtime Monitor
o Middleware / Portal
IBM WebSphere MQ
WebLogic Integration Server
o Web Server / Services
NTLM Authenticated URLs
PHP
Apache
Application Servers
Glassfish
While monitoring Glassfish application servers, make the following changes in the
domain.xml file and then restart it:
• Change the "accept-all" property to "true" for the "jmx-connector" node :
<jmx-connector accept-all="true"
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
53
The configuration line should look like this :
<jmx-connector accept-all="true" address="0.0.0.0" auth-realm-
name="admin-realm" enabled="true" name="system" port="8686"
protocol="rmi_jrmp" security-enabled="false"/>
JBoss
To monitor JBoss, the http-invoker.sar should be deployed in the JBoss Server. The
application (http-invoker.sar) is by default deployed in the JBoss server.
If the http port of the JBoss server is changed then the port number in the attribute
InvokerURLSuffix should also be modified in jboss-3.2.0/server/default/deploy/http-
invoker.sar/META-INF/jboss-service.xml file.
To monitor JBoss 5.0.0 version and above jbossagent.sar should be deployed in JBoss
server.
To deploy, follow the steps below
Copy jbossagent.sar from location <Applications Manager home>/working/resources
and paste under <JBOSS_HOME>/server/default/deploy. If you are running JBoss in
different domain like all, then deployment target folder would be
<JBOSS_HOME>/server/all/deploy.
Oracle Application Server
Applications Manager uses the Dynamic Monitoring Service (DMS) provided by Oracle
Application Server to monitor the same. For this reason, the DMS Servlet has to be made
accessible to the system where the Applications Manager is running.
To enable the access, please follow the instructions provided below
[The instructions are referred from the Oracle website :
http://docs.oracle.com/cd/B14099_16/core.1012/b14001/monitor.htm#sthref86]
By default, the dms0/AggreSpy URL is redirected and the redirect location is protected,
allowing only the localhost (127.0.0.1) to access the AggreSpy Servlet.
To view metrics from a system other than the localhost you need to change the DMS
configuration for the system that is running the Oracle Application Server that you want to
monitor by modifying the file $ORACLE_HOME/Apache/Apache/conf/dms.conf on UNIX,
or %ORACLE_HOME%\Apache\Apache\conf\dms.conf on Windows systems.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
54
The following example shows a sample default configuration from dms.conf. This
configuration limits AggreSpy to access metrics on the localhost (127.0.0.1). The port
shown, 7200, may differ on your installation.
Example: Sample dms.conf File for localhost Access for DMS Metrics
# proxy to DMS AggreSpy
Redirect /dms0/AggreSpy http://localhost:7200/dmsoc4j/AggreSpy
#DMS VirtualHost for access and logging control
Listen 127.0.0.1:7200
OpmnHostPort http://localhost:7200
<VirtualHost 127.0.0.1:7200>
ServerName 127.0.0.1
By changing the dms.conf configuration to specify the host that provides, or serves DMS
metrics, you can allow users on systems other than the localhost to access the DMS
metrics from the location http://host:port/dms0/AggreSpy.
Caution: Modifying dms.conf has security implications. Only modify this file if you
understand the security implications for your site. By exposing metrics to systems other
than the localhost, you allow other sites to potentially view critical Oracle Application
Server internal status and runtime information.
To view metrics from a system other than the localhost (127.0.0.1), do the following:
• Modify dms.conf by changing the entries with the value for localhost "127.0.0.1"
shown in Example to the name of the server providing the metrics (obtain the
server name from the ServerName directive in the httpd.conf file, for example
tv.us.oracle.com).
• Find below a sample updated dms.conf that allows access from a system other
than the localhost (127.0.0.1).
Example: Sample dms.conf File for Remote Host Access for DMS Metrics
# proxy to DMS AggreSpy
Redirect /dms0/AggreSpy http://tv.us.oracle.com:7200/dmsoc4j/AggreSpy
#DMS VirtualHost for access and logging control
Listen tv.us.oracle.com:7200
OpmnHostPort http://tv.us.oracle.com:7200
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
55
<VirtualHost tv.us.oracle.com:7200>
ServerName tv.us.oracle.com
• Restart, or stop and start the Oracle HTTP Server using Application Server
Control Console or using the Oracle Process Manager and Notification Server
opmnctl command.
For example,
%opmnctl restartproc process-type=HTTP_Server
or
%opmnctl stopproc process-type=HTTP_Server
%opmnctl startproc process-type=HTTP_Server
After performing the above steps, please ensure that you are able to
access the url http://<host>:7200/dmsoc4j/AggreSpy from the
Applications Manager system.
Tomcat
AdventNet agent has to be deployed in Tomcat Servers 3.x and 4.x. More
In case of Tomcat 5.x and 6.x, an application named Manager must be running in it for
Applications Manager to monitor the Tomcat server. By default, this application will be
running in the server. Moreover, the user role to access the server must also be
manager. To add a role as "manager" for any of the users such as tomcat, role1, or both,
you need to make changes in tomcat-users.xml file located in the /conf directory.
Click the link to view an example tomcat-users.xml, which has user tomcat with role as
manager
WebLogic
To monitor WebLogic 6.1 ,
Follow the steps given below:
1) Provide only Admin user name.
2) Copy Weblogic.jar from folder <Weblogic
Home>/weblogic61/server/lib in Remote WebLogic server version 6.
Copy to <AppManager Home >\working\classes\weblogic\version6 folder
in the machine where Applications Manager is running
To monitor WebLogic 7.x:
You should set the weblogic.disableMBeanAuthorization and
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
56
weblogic.management.anonymousAdminLookupEnabled variables to true for enabling
data collection.
Follow the steps given below:
1) Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin
directory and add the following arguments
-Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true Click
here for Sample startWLS.cmd/sh
2) Restart the WebLogic Server for the changes to take effect
3) Copy Weblogic.jar from folder <Weblogic
Home>/weblogic70/server/lib in Remote WebLogic server version 7.
Copy to <AppManager Home>\working\classes\weblogic\version7 folder
in the machine where Applications Manager is running
To monitor WebLogic 8.x
You should set the weblogic.disableMBeanAuthorization and
weblogic.management.anonymousAdminLookupEnabled variables to true for enabling
data collection.
Follow the steps given below:
1) Edit startWLS.cmdsh present in the <WLS_HOME>/server/bin
directory and add the following arguments
-Dweblogic.disableMBeanAuthorization=true
-Dweblogic.management.anonymousAdminLookupEnabled=true Click
here for Sample startWLS.cmd/sh
2) Restart the WebLogic Server for the changes to take effect
3) Copy Weblogic.jar from folder <Weblogic
Home>/weblogic81/server/lib in Remote WebLogic server version 8
Copy to <AppManager Home>\working\classes\weblogic\version8 folder
in the machine where Applications Manager is running.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
57
To monitor WebLogic 9.x,
Copy Weblogic.jar from folder <Weblogic Home>/weblogic92/server/lib in Remote
WebLogic server version 9 . Copy to <AppManager
Home>\working\classes\weblogic\version9 folder in the machine where Applications
Manager is running.
To monitor WebLogic 10.x ,
Copy Weblogic.jar, wlclient.jar, wljmsclient.jar from folder <Weblogic
Home>/wlserver_10.0/server/lib in Remote WebLogic server version 10 .Copy to
<AppManager Home>\working\classes\weblogic\version10 folder in machine where
Applications Manager is running.
WebSphere Application Server
For base deployment:
You have to modify the Performance Monitor Interface (PMI) Specification Level from
"None" to "Standard". Then deploy the perfServletApp.ear file, which uses the PMI
infrastructure to retrieve the performance information from WebSphere Application
Server, in the WebSphere. Restart WebSphere Application Server.
For Network deployment:
You have to modify the PMI Sepcifictaion Level from "None"to "Standard" in all the
WebSphere Servers in Network Deployment. Then deploy the perfServletApp.ear file,
which uses the PMI infrastructure to retrieve the performance information from
WebSphere Application Server, in any one of the WebSphere Servers in the Network
Deployment. Restart WebSphere Application Server.
Note: Steps to check whether WebSphere monitor has been correctly set.
To modify PMI specification level:
• Connect to the Admin console - http://<Host>:<Port>/admin/
• On the left-side tree, expand the Servers node.
• Click on Application Servers link. This will display the list of servers running in the
node.
• Click on the server for which data collection has to be enabled.
• In the Additional Properties table, click on Performance Monitoring Service.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
58
• Change the Initial specification level to "Standard" and then apply the changes.
Also enable (select) Startup.
To deploy perfServletApp.ear:
• In the Admin console, on the left-side tree, click Applications node.
• Click on Enterprise Applications.
• The right-side table lists all the installed applications. Check if perfServletApp is
already available. If not, click 'Install' to install the perfServletApp.ear file (which
is available by default under WebSphere installation directory).
• Restart WebSphere Server.
Steps to Check whether Websphere monitor has been correctly set
For Base Deployment
To ensure whether the PMI & perfServletApp are configured properly in WebSphere,
invoke the below URL & check whether the data is returned in XML format.
http://WebSphereHost:Port/wasPerfTool/servlet/perfservlet?connector=SOAP&port=SOA
P-PORT
where
WebSphere Host -> Host in which WebSphere Application Server is running
WebSphere Port -> HTTP Transport port of the WebSphere Application server [How to
locate HTTP Port]
SOAP Port -> SOAP Port of WebSphere [How to locate SOAP Port]
For Network Deployment
To ensure whether the PMI & perfServletApp are configured properly in WebSphere,
invoke the below URL & check whether the data is returned in XML format.
http://WebSphereHost:Port/wasPerfTool/servlet/perfservlet?connector=SOAP&port=Netw
orkDeployerSOAP-PORT&HOST=NetworkDeployerHost
WebSphere Host -> The host of the websphere application server in which the perf
servlet application is installed
Websphere Port -> HTTP Transport port of the Websphere server in which the perf
servlet application is installed [How to locate HTTP Port]
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
59
NetworkDeployer SOAP PORT -> The SOAP port of the domain manager (DMGR) [How
to locate SOAP Port]
Network Deployer Host -> The host in which the domain manager is running.
Note: Also check whether WebSphere admin user is added to the monitor group of the
perfservletApp.
How to locate SOAP Port?
1. Login to Admin console
2. Expand the server link on left side tree. Click on Application Servers
3. In Base mode, various WebSpheres will be listed down. Click on the WebSphere's
name- > Under Additional Properties, click on End Points link -> click on SOAP connector
address. You can get the SOAP port from there.
4. In Network Deployment mode, Click DMGR - > Under Additional Properties, click on
End Points link -> click on SOAP connector address - You can get the SOAP port from
there.
How to find the HTTP Transport port?
1. Login to Admin console
2. Expand the Server link on left side tree, Click on Application Servers
3. Various WebSpheres will be listed down. Click on the WebSphere's name- > Under
Additional Properties, click on Web Container link -> click on HTTP Transports link. You
can get the HTTP port from there.
Database Servers
MS SQL Database Server
For monitoring a MS SQL database server the user should be permitted to access the
MASTER and MSDB databases. He must log in using either the Public and
Db_datareader roles for both MASTER and MSDB databases.
For SQL 2005, 2008 and 2012 servers the 'View Server State' permission should be
also present. If you would like to monitor SQL Server using SQL named instance, you
need to ensure that the 'SQL Browser Service' is running in the system.
To grant View Server State, you can use any of the following methods :
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
60
1) Execute the following query
GRANT VIEW SERVER STATE TO username;
2) In SQL management studio for user choose Properties -> Securables -> Click Add (
under securables ) -> choose "All objects of the Types..." -> choose Servers -> choose
Grant for "View server state" permission.
Note:
The collation option for Applications Manager's backend MS SQL Database is case-
insensitive.
MySQL Database Server
While monitoring a MySQL database server ensure that you assign a user name that has
permission to access the MySQL database from the host where Applications Manager is
running. An alternate way is to add a relevant user who has the privileges to do the
same.
The user should have privileges to execute SELECT, SHOW DATABASES,
REPLICATION commands in the MySQL server.
For enabling these privileges, execute the following commands in the remote MySQL
Server:
INSERT INTO user (Host,User) VALUES('<host>','<user>');
GRANT SELECT,SHOW DATABASES,REPLICATION CLIENT ON *.* TO
'<user>'@'<host>';
FLUSH PRIVILEGES; (Use the host name - Applications Manager machine).
PostgreSQL
Applications Manager uses PostgreSQL's subsystem statistics collector to monitor
PostgreSQL server activity. By default, the statistics collector is accessible.
If you have problems in adding a new PostgreSQL server, follow the steps given below:
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
61
1. Open postgresql.conf under <postgres home>/data
2. Check value of configuration parameter listen address it has to be "*", if not
change it to "*". Click here for more details on configuring postgresql.conf
3. Open pg_hba.conf under /data
4. Add a new line host all all 0.0.0.0/0 md5 to allow all machines with proper
password authentication to access PostgreSQL DB server. Click here for more
details on configuring pg_hba.conf
CLOUD APPS
Windows Azure
• To add Windows Azure in Applications Manager, you must first export file of your Windows Azure
Managed Certificates (eg., testcertificate.pfx) and password of the pfx file.
• To monitor Windows Azure in Applications Manager, invoke the batch script
exportCertificateToAppManager.bat in the <Applications Manager Home>\bin directory.
ERP
Oracle EBS
Applications Manager uses the Dynamic Monitoring Service (DMS) to monitor
performance and availability of Oracle E-Business Suite.For this reason, the DMS Servlet
has to be made accessible to the system where the Applications Manager is running.
By default, the dms0/AggreSpy URL is protected, allowing only the localhost (127.0.0.1)
to access the AggreSpy Servlet. To view metrics from a system other than the localhost,
you need to change the DMS configuration for the system running the Oracle EBS.
This can be done as follows:
Step 1: Open the trusted.conf file under $ORACLE_HOME/Apache/Apache/conf on
UNIX, or %ORACLE_HOME%\Apache\Apache\conf\ on Windows systems and add the
Applications Manager Hostname and IPaddress in the "Allow from" list.
<Location ~ "/(dms0|DMS|Spy|AggreSpy)">
Order deny,allow
Deny from all
Allow from localhost
Allow from <list of TRUSTED IPs>
</Location>
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
62
Step 2: Now open the httpd.conf and httpd_pls.conf file and check if the trusted.conf file
is included. The best way is to check if the word trusted.conf is available in these files. If
not add the following lines and save the files:
# Include the trusted.conf file
include $ORACLE_HOME/Apache/Apache/conf/trusted.conf
Step 3: Restart Oracle E-Business Suite and ensure that you are able to access the url
http://<host>:<port>/dms0/AggreSpy from the Applications Manager system.
Note:
Modifying trusted.conf has security implications. Modify this file only if you understand the
security implications for your site. By exposing metrics to systems other than the
localhost, you allow other sites to potentially view critical Oracle EBS Server internal
status and runtime information.
SAP Server, SAP CCMS
SAP Server Monitoring and SAP CCMS Monitoring requires SAP JavaConnector ( JCo)
to be present in Applications Manager's classpath.
For Windows:
1. Download SAP JavaConnector [sapjco-ntintel-2.1.10] from
https://websmp104.sap-
ag.de/~sapidb/011000358700007415502002E/JCoDownload.htm#4. Depending
on whether Applications Manager is running on a 32 or 64 bit machine, make
sure you download the respective zip file.
2. Unzip the file.
3. In the machine, where Applications Manager is running, Copy librfc32.dll to
C:\WINDOWS\system32 directory. Copy sapjcorfc.dll and sapjco.jar to
AppManager_home/working/lib directory.
4. Verify msvcr71.dll and msvcp71.dll exist in the Windows system directory. The
DLL files must be added to the Windows system directory if they do not already
exist.
5. Restart Applications Manager.
Note:
In case you are using the 32 bit version of Applications Manager in a 64 bit machine, then
Copy the 32 bit version of librfc32.dll file to directory C:\Windows\SysWOW64.
Right click on my computer and open the system properties
Then click on the advanced tab and edit the environmental variables
Next edit the path and add the entry %SystemRoot%\SysWOW64\ in that path
Save the settings.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
63
For Linux:
1. Download latest SAP JavaConnector [sapjco-linuxintel-2.1.10] from
https://websmp104.sap-
ag.de/~sapidb/011000358700007415502002E/JCoDownload.htm#4. Depending
on whether Applications Manager is running on a 32 or 64 bit machine, make
sure you download the respective zip file.
2. Unzip the file.
3. In the machine, where Applications Manager is running, copy libsapjcorfc.so,
sapjco.jar and librfccm.so under AppManager_home/working/lib directory.
4. Verify if libstdc++-libc6.2-2.so.3 is available under /usr/lib/ directory.
5. Restart Applications Manager.
Note:
The user name provided while adding SAP monitor should have sufficient privileges to
access CCMS metrics. To check this, the user can execute RZ20 transaction in the SAP
GUI and see if the CCMS monitor sets can be displayed.
Java / Transactions
APM Insight
APM Insight includes a remote monitoring agent which has to be deployed in your
application instances. Know more about APM Insight Agent.
Java Runtime Monitor
To monitor a JDK1.5 JVM and above, add the following JVM arguments to your
application :
• -Dcom.sun.management.jmxremote -
Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.authenticate=false
To monitor IBM JDK1.5 JVM and above, add the following JVM arguments to your
application:
• -Djavax.management.builder.initial= -Dcom.sun.management.jmxremote -
Dcom.sun.management.jmxremote.port=1099 -
Dcom.sun.management.jmxremote.ssl=false -
Dcom.sun.management.jmxremote.authenticate=false
Note: Port number '1099' can be replaced with the actual port number of the JMX agent..
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
64
Middleware / Portal
IBM WebSphere MQ Monitor
For monitoring IBM Websphere MQ version 5 and version 6, three jar files are required-
com.ibm.mq.jar, com.ibm.mq.pcf-6.x.jar and connector.jar. For monitoring Version 7,
three more jar files should be added.
Follow the below steps to get these jar files and copy them to the product.
1) Download the supportpac MS0B : WebSphere MQ Java classes for PCF from the
following link
http://www-1.ibm.com/support/docview.wss?uid=swg24000668 . From this support pac,
you can get the com.ibm.mq.pcf-6.x.jar file .
2) com.ibm.mq.jar and connector.jar can be located at <Websphere MQ Home
Directory>\Java\lib directory.
3) Copy the three jar files to <ProductHome>\working\jre\lib\ext directory and restart
Applications Manager and try adding the monitor again.
4) For monitoring Version 7, additionally you need to copy the following jar files from
<websphere mq series installation>\java\lib directory to <AppManager
Installation>\working\jre\lib\ext directory
i)com.ibm.mq.headers.jar
ii)com.ibm.mq.commonservices.jar
iii)com.ibm.mq.jmqi.jar
WebLogic Integration Server
Note: WebLogic Integration Server needs some additional configuration and conditions to
be followed for monitoring.
• For monitoring WebLogic Integration Server 8.x, you should set the
weblogic.disableMBeanAuthorization and
weblogic.management.anonymousAdminLookup system variable to true for
enabling data collection.
• Follow the steps given below:
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
65
1. Edit startWLS.cmd\sh present in the <WLS_HOME>/server/bin
directory and add the following argument -
Dweblogic.disableMBeanAuthorization=true and -
Dweblogic.management.anonymousAdminLookupEnabled=true
(click on the link to view the sample startWLS.cmd\sh file)
2. Restart the WebLogic Integration Server for the changes to take effect.
3. Copy weblogic.jar from folder /weblogic81/server/lib in Remote
WebLogic server version 8 and place it under <AppManager Home
>\working\classes\weblogic\version8 folder in the machine where
Applications Manager is running.
Web Server / Services
NTLM Authenticated URLs
To monitor NTLM authenticated URLs,
• Download cryptix-jce-20050328-snap.zip file from http://www.cryptix.org/cryptix-
jce-20050328-snap.zip
• Extract the contents of the cryptix-jce-20050328-snap.zip file to any location and
copy the cryptix-jce-provider.jar file under ..\bin\ folder to Applications Manager
Home\lib\ext.
• Restart Applications Manager.
PHP
Place the phpstats.php file in the webserver's document root. The phpstats.php can be
found in <Applications Manager Home>/working/resources directory.
Apache
Enabling the Server status and the Extended-status will give additional information for the
Apache server.
To enable the Server Status, follow the steps given below:
• In Apache's httpd.conf file, locate "Location /server-status" tag.
• Remove the comment in the Location/Server-status tag, to Enable SetHandler
server-status.
• Change the attribute "deny from all" to "Allow from all".
• Remove the comment in "LoadModule status_module modules/mod_status.so".
• Save the conf file and restart the Apache Server.
To enable the Extended-status, follow the steps given below:
• Locate "ExtendedStatus" Attribute in httpd.conf file.
• Remove the comment to enable the status.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
66
• Save the conf file and restart the Apache Server.
For any further support please contact appmanager-support@manageengine.com. You can visit
Troubleshooting details.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
67
Working with Applications Manager
The following are the steps involved in monitoring:
1. Create a new Monitor Group: Create a new Monitor Group by grouping one or more Monitors.
2. Create new Monitor: Discover Monitors in the network and start collecting data (performance
metrics, availability etc) for the same.
3. Create new Monitor Type: Create new monitor type for monitoring custom applications.
4. Associate Monitor with Monitor Group: Add the discovered monitors to the Monitor Group.
5. Create threshold profile: Create thresholds to identify the status of a specific attribute.
6. Create actions: Specify what action needs to be taken in the event of an alarm.
7. Associate threshold and action with the attributes: Associate the thresholds and action to
generate alarms and perform action based on the threshold definition.
8. Configuring dependencies: Dependencies specify the rule based on which the severity of health
and availability is determined. For example, Health of a Tomcat Server may depend on the
overall response time of the server or on the response time of each of the web applications
deployed on the server etc. By configuring dependencies, you can determine the attribute, based
on which the severity of health changes.
Note: Have a look at Working with Applications Manager - How to Demos from the website.
Please go through Working with Monitor Group and Configuring Alarms for detailed information on the
above.
See Also
Best Practices Guide
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
68
Working with Monitor Groups
Monitor Groups are a logical group of one or more Monitors that provides a holistic view of your business
environment.
For example, the health of an online Web application depends on various factors, such as the health of
the application server hosting the Web application, the availability of the Web server for accessing the
Web applications, the database server for storing or getting the required information, etc. These web
applications and services can be grouped together and monitored as a single Monitor Group.
Troubleshoot: For any monitoring-related troubleshooting, refer to the online Troubleshooting
section.
The following sections are the steps involved to work with a Monitor Group:
• Creating Monitor Groups
• Creating Web Application Groups
• Creating New Monitor
• Associating Monitors to Monitor Groups
• Deleting Monitor from Monitor Groups
• Editing and Deleting a Monitor Group
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
69
Creating Monitor Groups
This section explains how you can create a new Monitor Group. A monitor Group is particularly useful for
grouping the resources of a location say the resources available in sales office or for grouping the
resources used by a business application.
Applications Manager provides two types of monitor groups - Monitor Group and Web Application Group.
The steps to create a Monitor group are explained below. To create a web application group, refer this
link.
To create a new Monitor Group, follow the steps given below:
1. Click New Monitor Group.
2. Provide a Name for the Monitor Group. This is mandatory and only alphanumeric characters,
dashes (-), underscores (_), periods (.), and spaces ( ) are allowed.
3. Provide any Description, if required.
4. Under Advanced Options, Select the Owner from the list of users created. Refer User
Administration topic for more information on the different roles of users.
Note:
Operator if associated as an owner will have Read Only Access to that particular Monitor Group
alone.
Admin user is a super user and will be able to see all Monitor Groups.
Manager if associated will be able to view this Monitor Group in Manager Console. Using this
option, Restricted Monitor Groups alone can be shown in Manager Console. [By default, if the
Manager is not explicitly associated to a Monitor Group, the Manager will be able to access all the
Monitor Groups in the Manager Console]
5. Select the location for associating the monitor group to World Map Business View. Else by
clicking on 'Add Location', world map opens up. Here you can add and select custom locations.
6. Click Finish to create the Monitor Group and to add Monitors later.
How To Demos: Have a look at our demo on creating Monitor Group in our website.
Creating a Sub-Group within a Monitor Group
By using this option, you can create a Monitor Sub-Group within a Monitor Group (a Monitor Group within
a Monitor Group). Sub-Groups help better organization of your resources. With Sub-Groups, you can
capture advanced dependencies in your infrastructure. You can group clustered databases or servers
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
70
and create complex groups. For eg., A huge banking application Monitor Group may contain 100 monitors
(application servers, systems, databases, URLs, etc.,). All the database monitors can be grouped under a
Sub-Group for effective monitoring.
To create a sub group,
• Inside the Monitor Group Details page, click on New Sub-Group link on the left.
• Give the Sub-Group name and the description.
• Click on 'Create Sub-Group'.
• Then you can associate the desired monitors to the Sub-Group.
Note: You can create up to six levels of sub-groups in a Monitor Group, by default.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
71
Creating New Web Application Group
A web application group provides a template for grouping web infrastructure into logical components. So,
instead of manually grouping your web infrastructure, you can use the web application group to
categorize your infrastructure into servers, databases, web servers, etc.
Once you create a web application group, you can view the health of the sub groups and know how each
individual sub group is performing. If there is a problem in the web application group, you can drill down
and identify which component is having a problem.The details page shows the health of all the tiers as
components giving you a better perspective of the Application's Performance and Availability. You can
also configure dependencies and powerful alarm rules for intelligent alert correlation.
To create a new web application group, follow the steps given below:
1. Click New Monitor Group and select Web Application Group from the drop-down menu.
2. Provide a Name for the Monitor Group. This is mandatory and only alphanumeric characters,
dashes (-), underscores (_), periods (.), and spaces ( ) are allowed.
3. Provide a Description, if required.
4. Select the Owner from the list of users displayed. Refer User Administration topic for more
information on the different roles of users.
Note:
Operator if associated as an owner will have Read Only Access to that particular Monitor Group
alone.
Admin user is a super user and will be able to see all Monitor Groups.
Manager if associated will be able to view this Monitor Group in Manager Console. Using this
option, Restricted Monitor Groups alone can be shown in Manager Console. [By default, if the
Manager is not explicitly associated to a Monitor Group, the Manager will be able to access all the
Monitor Groups in the Manager Console]
5. Select Web Application Group as the group type.
6. Select the Application Components from the options displayed. The components available are
End User Transaction (URL) group, Network devices group, Edge Devices group, Web Server
Group, Application Server Group, Database Group and Server Group. The components that you
select will be automatically added as sub groups within the web application group.
7. Select the Location for associating the monitor group to World Map Business View under
Advanced section. Otherwise, click the 'Add Location' link and select custom locations from the
google map that opens up.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
72
8. Click Create Monitor Group button to create the Web Application Group. You can add monitors
any time using the Associate Monitors option.
Note: You can convert a web application group to a monitor group or vice versa by changing the Group
Type. Click Monitor Group Options link from the web application group page and select the Edit option.
This will take you to the Modify Monitor Group section. You can modify the Group Type values from this
screen.
Creating a Sub-Group within a Web Application Group
If you have selected 'Application Components' while creating the web application group, the sub groups
will be automatically created based on the options you have selected. You can also add sub groups later
on by following the steps given below.
• Click the Monitor Group Actions->New Sub-Group option inside the Web Application Group
Details page.
• Provide the Sub-Group Name, Description and select the Owner from the list of users.
• Select the Group Type from the dropdown box.
• Select the Location for associating the sub group to from the drop-down box. You can also use
the 'Add Location' option to specify custom locations from google map.
• Click the Create Sub-Group button to create the sub group.
• You can then associate the desired monitors to the Sub-Group.
Note: You can create up to six levels of sub groups for a web application group, by default.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
73
VMware Virtual Infrastructure Groups
Applications Manager can discover your entire VMware virtual infrastructure through the vCenter server
and provide dependency mapping of its components. The ‘VMware Virtual Infrastructure Group’ allows
you to quickly discover all your virtual resources and model them the same way they are configured in the
vCenter server. The VMware infrastructure will be automatically categorized into components such as
Datacenter, Cluster, ESX/ESXi hosts, VMs, etc. Once you discover the virtual infrastructure, you can
easily track the availability, health and performance metrics of its various components.
The VMware virtual infrastructure group is different from monitor groups due to the fact that you have to
manually map all the resources to a monitor group. In the VMware virtual infrastructure group, the virtual
resources in your network are automatically discovered through the vCenter server and the components
mapped accordingly. When combined with the out-of-the-box support for 50+ applications, servers,
databases, and transactions spanning physical, virtual and cloud infrastructures along with auto-
provisioning of virtual systems, the VMware virtual infrastructure group becomes even more powerful.
Creating a New VMware Virtual Infrastructure Group
Follow the steps given below to create a VMware Virtual Infrastructure group:
1. Click New Monitor Group and select VMware Virtual Infrastructure from the drop-down menu.
The ‘Discover Virtual Infrastructure through vCenter’ screen will be displayed.
2. Provide a Display Name for the monitor group.
3. Specify vCenter Hostname/IP Address.
4. Specify the Port at which vCenter is running.
5. Enter the authentication credentials of the vCenter server such as User Name and Password.
6. Specify the Polling Interval in minutes.
7. Click Fetch ESX Hosts button to start the virtual infrastructure discovery.
For more information on the performance metrics provided by the VMware virtual infrastructure group,
refer this topic.
ManageEngine Applications Manager : Help Documentation
Zoho Corporation Pvt. Ltd.
74
Associating Monitors to Monitor Groups
To associate a monitor to a monitor group, follow the given steps below:
1. Click on the Monitor Group (from Home tab).
2. Under Monitor Group Information, click Associate Monitors link. Alternatively, select the
Monitor Type by moving the mouse over the Associate Monitor of Monitor Group Links in the left
frame.
3. A list of discovered Monitors that are available for associating and those that have already been
associated with that