Installing Applications Manager in AWS

Installing Applications Manager in AWS

Applications Manager can be installed in EC2 instances in both Windows and Linux platforms. 
Applications Manager comes with bundled PostgreSQL.

Installing Applications Manager in EC2 for Windows

  1. Go to EC2 console and launch an "Windows" instance with "At least 16GB" memory.
    • Refer hardware requirements for more information.
    • If RDS is used for backend, ensure that the DB is accessible by the EC2 instance.
  2. Connect to the launched EC2 instance. To know more about connecting to the Windows instance, refer here.
  3. Download the Applications Manager executable file here.
  4. Run the downloaded file and install the Applications Manager.
  5. If RDS is used for backend, uncheck the checkbox "Launch Applications Manager now" at the end of installation process and follow the steps mentioned in the "Use RDS PostgreSQL/MSSQL as backend for Applications Manager" section below.

Installing Applications Manager in EC2 for Linux

  • Go to EC2 console and launch an "Linux" instance with "At least 16GB" memory.
    • Refer hardware requirements for more information.
    • If RDS is used for backend, ensure that the DB is accessible by the EC2 instance.
  • Connect to the launched EC2 instance. To know more about connecting to the Linux instance, refer here.
  • Then, download bin file of applications manager in the instance by executing the following command:
  • Grant execute permission to the downloaded file by executing the following command:
    • chmod +x ManageEngine_ApplicationsManager_64bit.bin
  • Install the Applications Manager by executing the below command:
    • ./ManageEngine_ApplicationsManager_64bit.bin -i console
  • If RDS is used for backend, uncheck the checkbox "Launch Applications Manager now" at the end of installation process and follow the steps mentioned in the "Use RDS PostgreSQL/MSSQL as backend for Applications Manager" section below.

Use RDS PostgreSQL/MSSQL as backend for Applications Manager

  1. Verify the DB permissions required to run Applications Manager. Refer here.
  2. Go to the RDS console, create an instance with the below configurations:
    1. Engine type : PostgreSQL/MSSQL
    2. Recommended version : Refer here.
    3. Ensure that the VPC is same as EC2, if RDS DB is private.
    4. Make note of the master username and password.
    5. After creating the instance, navigate to Connectivity & Security tab, and make note of Endpoint and port.
  3. After succesful installation, edit the AMServer.properties file.
    1. The file can be found under <Installation Directory>/Appmanager<version>/conf/AMServer.properties.
    2. Replace am.dbport.check=true with am.dbport.check=false.
    3. Replace am.db.port=15432 with am.db.port=<RDS port>.
  4. Edit the database_params.conf file:
    1. For PGSQL, goto ../Appamanger/working/conf/PGSQL/database_params.conf.
    2. For MSSQL, goto ../Appamanger/working/conf/MSSQL/database_params.conf.
    3. Change the host and port details:
      1. url jdbc:postgresql://localhost:15435/amdb to url jdbc:postgresql://<RDS host>:<RDS port>/amdb
    4. Change the database username:
      1. username dbuser AppModules to username <DB username> AppModules
    5. Change the database password:
      1. encryptedpassword eK6L4W0cd6469 AppModules to password <DB password> AppModules.
    6. Save the file.
  5. Copy the file database_params.conf from step 4 and replace it here: <Installation Directory>/Appmanager<version>/working/conf/database_params.conf.

Before starting Applications manager,
    • Ensure that EC2 and RDS security groups have correct inbound and outbound rules.
      • For windows instances, we have to create a windows firewall rule to access a port. To create a rule, refer here.
    • To ensure that EC2 and RDS are be able to communicate with each other, add the IP and port to inbound and outbound rules in both the security groups.
    • To allow everyone,  add "All Traffic" with 0.0.0.0/0.
If you have any other issues, kindly check the list of troubleshooting links given below:
Please double check the RDS endpoints, port, username and password before troubleshooting.
  • To add custom IP addresses to security groups of EC2 and RDS, refer here.
  • For RDS connection problems from EC2. Refer here.
    • For RDS connection in VPC problems. Refer here.

          • Related Articles

          • Installing Applications Manager in Cloud (AWS, Azure)

            To install Applications Manager in the cloud, we can use any of the below methods: AWS/Azure marketplace Direct installation AWS/Azure marketplace Applications manager is readily available in AWS/Azure marketplace as a pre-installed product. AWS ...
          • Installing Applications Manager in Microsoft Azure

            Applications manager can be installed in Azure Virtual Machines in both Windows and Linux platforms.  Applications Manager comes with bundled PostgreSQL. Installing Applications Manager in VM for Windows Go to Virtual Machines and create a "Windows" ...
          • Issues while installing or starting Applications Manager with Microsoft SQL Server backend database

            Problem: Unable to install or start Applications Manager using Microsoft SQL Server database as backend. Solution: Follow the below troubleshooting steps to resolve the issue: 1. On the Microsoft SQL server host, go to Start -> All Programs -> ...
          • AWS Monitor Addition - FAQs

            During monitor addition :  Provide proper 'Display name' for the Amazon monitor. Select the 'Amazon Services'  you wish to discover in the drop box. By default, all the services will be selected. Currently as in version 15350, we support EC2, ...
          • AWS EKS Troubleshooting FAQs

            AWS EKS monitor can be configured only if you have already added an Amazon monitor in Applications Manager. Ensure that you have met the pre-requisites for the Amazon monitor before monitoring Elastic Kubernetes Service in Applications Manager. How ...