Installation Guide


Editions of Applications Manager

Meet your specific monitoring and business objectives by choosing the right edition of ManageEngine Applications Manager. Applications Manager is available in these editions:

  • Free Edition
  • Professional Edition (Trial/Registered)
  • Enterprise Edition (Trial/Registered)

Free Edition

The Free Edition allows you Five monitors (excluding the Monitors added by default). The Free Edition never expires and you get most of the functionality of Professional Edition. Compare the Free and the Professional Edition.

Professional / Enterprise

You can avail 30 days of evaluation with no restrictions on the number of monitors. The Professional Edition allows you to monitor up to 250 monitors. The 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").After your 30-day free trial ends, your installation will automatically convert to the free edition unless you apply a commercial license.

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 differences between Free, 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 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

Installing Applications Manager in Windows (.exe)

Download and execute theManageEngine_ApplicationsManager.exe file. The Installation Wizard is displayed and will guide you through the setup process.

  1. Click Next at the Welcome Screen to proceed.
  2. Read the license agreement and click Yes if you accept the terms.
  3. Select the language in which you wish to install Applications Manager.
  4. The next screen prompts you to select the product edition (Free Edition, Professional Edition, Enterprise Edition):
    • If you select Enterprise Edition, specify if you want to install Applications Manager as an Admin Server or a Managed Server. If you wish to install Applications Manager as a 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.
    • If you have choosen to install the Free or Professional Edition, continue to step 7.
  5. Provide the location where Applications Manager should be installed on your machine. Also, specify the name of the new Applications Manager Folder in the installation location. Click Next.
  6. Specify the Webserver port (9090 by default) and the SSL Port (8443, by default).
  7. You can enter your details to Register for Technical Support. Click Next.
  8. If you have chosen to install the Professional Edition of Applications Manager, you can opt for either the 30 day Trial Edition or the Registered version. If you select Registered User, the next screen will prompt you to select the registered license file from your system.
  9. Select the Database back-end support :
    • PostgreSQL- PostgreSQL comes bundled with your download of Applications Manager from Build 11000. We supportPostgreSQL Versions upto 9.3.5 for backend.
    • Microsoft SQL Server (version 2005, 2008, 2012) - 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.

Prerequisites for using SQL AlwaysOn Availability Groups as Database back-end support :

Applications Manager supports SQL AlwaysOn availability groups as database backend. To connect to the SQL Always On, you will need to provide the SQL availability group 's DNS name & listener port (usually 1433 ) in the place of the database details during installation.

Setup completes the installation of Applications Manager.

Demo

Note
To install Applications Manager as service in a system, you must have administrative privileges in that system. More Information on 'Manually Installing Applications Manager as Service'.

Installing 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.
  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_11_linux.bin, then type the following command in the command prompt: ./ManageEngine_ApplicationsManager_11_linux.bin -console
To execute .bin type files, users require Executepermission.
Execution of this command would take you through the installation process.
When installing Applications Manager in a Linux machine, please make sure the installation is done using a non-root user account with admin privileges.

Troubleshooting an Installation process

In case of problems during installation in a Linux system, follow the steps given below to produce the logs files:

  • 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. For example, if the file name is ManageEngine_ApplicationsManager_11_linux.bin, create a text file named ManageEngine_ApplicationsManager_11_linux.sp
  • Open the ".sp" text file in an editor, add is.debug=1 as the content.
  • Save the ".sp" text file in the same directory where the binary file resides.
  • Change to the directory where the binary file is present by executing cd command
  • Invoke the installer as ./<File Name>.bin -is:javaconsole -is:log log.txt
  • 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

  • Shut Down Applications Manager (Make sure that the ManageEngine ApplicationsManager service is stopped if installed as a Windows service)
  • Open a command prompt as an administrator [ Command Prompt -> right click --> Run as administrator], go to Applications Manager Home directory and execute the following commands:

shutdownApplicationsManager.bat

shutdownApplicationsManager.bat -force

  • Exit out of the command prompt and close all files, folders opened in the Applications Manager Home directory
  • Click Start > Programs > ManageEngine Applications Manager > Uninstall Applications Manager
  • Also from Control Panel > Add/Remove Programs.

Linux

  • 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

  • Exit out of the command prompt and close all files, folders opened in the Applications Manager Home directory
  • Execute the command ./uninstaller.bin from the AppManager/_uninst directory.
Note
You can uninstall Applications Manager via Command Line also. Type the following command in the command prompt:
./uninstaller.bin-console
Execution of this command would take you through the uninstallation process.

Here's how you can manually uninstall Applications Manager

 

Frequently Asked Questions

Question: How can I do a "Silent Installation" of Applications Manager in Linux?

Solution: For a silent installation, run the installer (.bin file) as below:

<Installation file(.bin )> -silent -options ismp_silent.txt

For example: .../AppManager10$ ./ManageEngine_ApplicationsManager_64bit.bin -silent -options ismp_silent.txt.

The options which you normally enter during installation is stored in a text (reference) file which is provided in the -Options flag. The General Template file is added in the attachment.

Question: I downloaded the .bin file to install Applications Manager in my Linux machine. When I tried to execute the file I got a dialog box displaying "Could not display the file. File is of an unknown format".

Solution: You must change the permission for the downloaded file. You can use the command "chmod +x <nameofbinary>.bin" to provide the permission for executing the downoaded file.

Note:

By default, Applications Manager will not store installation logs. To enable installation logs, do the following:

  • Create a file named APMBinFileName.sp (ManageEngineApplicationsManager.sp) in the location where the .bin folder of Application Manager is downloaded.
  • Inside the file, type (is.debug=1) and save it.
  • Then start the installation using below options:

./bin -is:log log.txt along with the options that are given in the solution.