Quick Steps to Install eG Manager and Agents for Enterprise Deployments
This document provides you with simple steps that will guide you to quickly install and configure the eG manager and agents in an Enterprise deployment. For the detailed installation procedure, refer to Detailed Installation Guide.
The quick installation steps are:
- Step 1: Download eG Enterprise
- Step 2: Obtain a valid license for the eG Manager
- Step 3: Ensure the availability of a database
- Step 4: Install and Configure the eG Manager
- Step 5:Configure the type of deployment
- Step 6: Deploy the license for the eG Manager
- Step 7: Install and Configure the eG Agent
- Step 8: Administer eG Enterprise
To download eG Enterprise, please contact firstname.lastname@example.org.
Make sure that you have adequate hardware capabilities for the systems that will host the eG manager and agents.
To obtain a valid license, please send an email to email@example.com requesting a license to use the product. Given below are the details of the license that will be sent to you:
Number of agents
Number of websites
Solaris 7 (or higher), Red Hat Enterprise Linux 5 (or higher), AIX 4.3.3 (or higher), HP-UX 10 (or higher), Free BSD 5.4, Tru64 5.1, openSUSE 11 (or above), CentOS 5.2 (or above), Fedora Linux, Oracle Linux v6.x (or higher), Ubuntu, Debian (OR) Windows 8 (OR) Windows 10 (OR) Windows 11 (OR) Windows 2012 (OR) Windows 2016 (OR) Windows 2019 (OR) Windows 2022
Other modules enabled
Integration Console, Reporter, Detailed Diagnosis
An Oracle database (version 11G / 12c / 18c / 19c) / Microsoft SQL Server (version 2012 / 2014 / 2016 / 2017 / 2019) / Microsoft Azure SQL Database is required to host the eG database. When installing the eG manager, specify the location of the database server.
If you want to use Oracle Database:
For the evaluation period, you can download a 90-day trial version of the Oracle database server from Oracle's Technology Network homepage. As per Oracle’s licensing policy, you will need to an Oracle Web account to obtain the evaluation version.
The link from where you need to download the Oracle evaluation version:
Once you connect to the above-mentioned URL, follow the steps below:
- Scroll down the list of Oracle Software Downloads displayed therein to locate the Database section.
- Click on the Database Enterprise/Standard Editions link in this section to download it.
- Next, in the Oracle Database Software Downloads page that then appears, scroll down the Oracle Database 19c section.
- Click on any Download link in that section that corresponds to the operating system on which the Oracle database server is to be installed.
If you want to use Microsoft SQL Database:
For the evaluation period, you can download a 180-days trial version of Microsoft SQL Server 2019 from the following link: https://www.microsoft.com/en-us/sql-server/sql-server-downloads.
While installing the SQL server, ensure that the installation of the server is performed in the case-insensitive mode. Also, make sure that the Simple Recovery mode is set.
You also have the option of using an existing Microsoft Azure SQL Database (if any) as the eG backend.
Please ensure that the database server has a tablespace with at least 100MB of space for hosting the eG database.
Now, proceed to install the eG manager and configure it to use either an Oracle / Microsoft SQL database. Please refer to the Detailed Installation Guide for detailed installation and configuration instructions.
- The eG manager can be installed on a Linux host from a super-user account only.
- The eG manager can be installed on a Windows host from a ‘local/domain administrator’ account only.
- If installing on a Windows system, please reboot the server after the installation.
- Before installing the eG manager, make sure that no other Tomcat server pre-exists on the target manager host.
Next, using the special web page that the eG manager's setup program provides, you can configure what type of eG manager deployment this is - i.e., you can indicate what the eG manager being installed will be monitoring. The options are as follows:
Enterprise: This model is ideal if your eG manager will be monitoring only your organization's IT infrastructure. In this case, eG's agent-based/agentless monitors will be deployed on and will pull metrics from the components in your infrastructure only. The employees of your organization will be the primary stakeholders and consumers of the performance data so collected.
Such a model is typically, administrator-driven. In other words, an administrator will be responsible for performing all administrative activities related to the eG manager - this includes, installing agents, managing the components, configuring thresholds, tests and alerting, managing users, building segments and services, defining zones, and more. The other stakeholders - i.e., the employees - will usually be vested with only monitoring rights, or in some special cases, very limited administrative rights, as the administrator deems fit.
SaaS: This model is ideal if you are a Managed Service Provider (MSP), providing infrastructure hosting and management services to multiple customers. Monitoring is quiet often a cloud-based service that an MSP offers to each of their customers. If you are an MSP, you will want the eG manager to not just monitor your infrastructure, but also that of your customers. This means that an eG manager centrally deployed in the MSP infrastructure will be managing agents deployed in the customer infrastructure as well.
The SaaS model also helps where a single eG manager manages agents used by different departments (eg., Development, Testing, Support etc.) / support groups (Europe Support, EMEA Support, USA Support etc.) / IT domains (Network administration, Database administration, Windows administration etc.).
With the SaaS model, eG Enterprise fully supports mult-tenancy. Unlike the Enterprise model, in SaaS, the administrator will not be the sole custodian of administrative rights. Instead, these rights will be delegated to the individual tenants - say, MSP customers, department heads/workers, support personnel who are part of different support groups, or IT domain experts. The tenants are thus empowered to deploy the agents they want, manage the components they wish to monitor, and customize accesses, monitoring, and alerting based on the requirements of their infrastructure. The central administrator will continue to hold unrestricted administrative rights, which will enable him/her to manage monitoring licenses of the tenants, oversee performance and problems across tenant infrastructures, and even override a tenant's monitoring configuration if required.
For an Enterprise deployment of eG Enterprise, select the Our Organization (Enterprise) option in this web page. Using this web page, you can also custom-define how your manager performs monitoring and alerting, enforce organizational security policies, and enable the auditing of manager operations, without even logging into the eG management console.
Use the setup program of the eG manager to upload the trial license that has been provided to you to the eG manager’s bin directory. Refer to the
You can also choose to manually copy the file to the bin directory. In this case, note that for a Windows installation of the eG manager, you have to copy the license file to the <EG_INSTALL_DIR>\bin directory. For a Linux installation of the eG manager on the other hand, make sure that you save the license in the ‘/opt/egurkha/bin directory.
If you do not save the license in the correct place, under the correct name, the eG manager will not start.
In an Enterprise deployment, the eG agent installables have to be downloaded from the eG Innovations web site as described in step 1 above, and then manually installed on each target host. After successful installation of an eG agent, you need to run a setup_agent routine on the agent host to configure agent-manager communication. Refer to the Detailed Installation Guide for details.
- Agent installation does not require a reboot of the system.
- The eG agent can be installed on Unix hosts from a super-user account only.
- The eG agent can be installed on a Windows host from a ‘local/domain administrator’ account only.
Connect to the eG management console using the URL: http://<eGManagerIP>:<eGManagerPort>/, or https://<eGManagerIP>:<eGManagerPort>/ (if you have SSL-enabled the eG manager during installation).
To administer eG Enterprise, login to the eG manager as the user admin with password admin.
Please refer to the Administering eG Enterprise document to determine how to administer and use eG Enterprise.