edit-icon download-icon

Install EDAS Agent

Last Updated: Nov 15, 2018

EDAS Agent overview

EDAS Agent is the Daemon program installed on ECS instances to implement communication between the EDAS cluster and the applications deployed on the corresponding ECS instances.EDAS Agent functions as follows:

  • Application management: deploys, starts, and stops applications.
  • Status reporting: reports application viability status, health check results, and Ali-Tomcat container status.
  • Information retrieval: retrieves the monitoring information on ECS instances and containers.

In addition to the preceding application-based management, EDAS Agent is used for communication between the EDAS console and your applications. Here is a simple example. EDAS Agent obtains and submits the information whether a given ECS instance correctly and promptly publishes a service that an application publishes.

NOTE: The preceding functions are transparent to you. You only need to install EDAS Agent.

EDAS Agent in EDAS

Install EDAS Agent

EDAS deploys applications (including first-time installation and later on expansion) on ECS instances that are installed with EDAS Agent only.The nodes in the EDAS billing system refer to the ECS instances which are installed with EDAS Agent and deployed with applications.To use EDAS, you must install EDAS Agent while or after you purchase an ECS instance.

You can install EDAS Agent in three ways:

Notes:

  • JDK 8 is installed on EDAS Agent by default in the three ways. To use JDK 7 or other versions, you can manually execute the script for installation.
  • To manually execute the script for installation, you must log on to the ECS instance as a root Log on to the ECS instance.
  • Currently, EDAS Agent can be installed and run on 64-bit CentOS 6.5/6.8/7.0/7.2/7.3/7.4 or 64-bit Ali-Linux 5.7 only.
  • This script can be run repeatedly. Running the script overwrites the existing version of EDAS Agent installed on the instance. Therefore, you upgrade EDAS Agent by running the same script.
  • The script for installation is region specific. You must switch to the appropriate region before clicking Install EDAS Agent.
  • Different installation methods or different images or clusters selected during installation result in different Agent states, which determines the type of applications that can be created on the ECS instance. Pay attention to instructions for different installation methods.

Use an EDAS base image to automatically install EDAS Agent when purchasing an ECS instance

The simplest method of installing EDAS Agent is to use an EDAS base image when purchasing an ECS instance.

NOTE: The disk is formatted if you use this method. To prevent the disk from being formatted, we recommend that you [use the command script to install EDAS Agent manually] (#CLI).

  1. Log on to the EDAS console. On the left-side navigation bar, choose Resource Management > ECS.

  2. In the upper-right corner of the ECS Instance List page, click Create Instance to go to the ECS purchase page.

  3. On the purchase page, select Image Market in the Image column, and then click Select from image market (including operating system).

  4. Enter EDAS in the search box and click Search.

  5. Select images from search results based on requirements of applications created. The latest version is selected by default (no earlier versions are recommended). Click Use.

    • To create a Regular Application, select EDAS Java Environment (Regular ECS).

    • To create a Docker application, select EDAS.

  6. Purchase an ECS instance based on prompts on the page.

Import an ECS instance to automatically install EDAS Agent

If you did not select any EDAS base image when purchasing an ECS instance, you can use click Import ECS in the EDAS Console to install EDAS Agent. The process is as follows:

NOTE: The disk is formatted if you use this method. To prevent the disk from being formatted, we recommend that you [use the command script to install EDAS Agent manually] (#CLI).

  1. Log on to the EDAS console. On the left-side navigation bar, choose Resource Management > ECS.

  2. Click Import ECS in the upper right corner of the Instances page.

  3. On the Select Cluster and ECS page, select Namespace and Cluster. From the instance list displayed, select ECS instances purchased but not provided with EDAS Agent, and click Next. To install EDAS Agent manually, you can select Switch to Manual Installation in the upper right corner to go to the Install EDAS Agent on Single Instance Manually page and [use the command script to install EDAS Agent manually] (#CLI).

    • To create a regular application, select ECS Cluster.

    • To create a Docker application, select Swarm Cluster.

    • To create a Kubernetes application, select Kubernetes Cluster.

    • If no clusters are desired, click Create Cluster.

    Selecting Instances

  4. On the Set New Password page, set a new password for logon to the ECS instance and click Next. In this way, all data in the ECS instance is erased. To reinstall the operating system, you need to reset the password. After image-based installation, you can enter the new password to log on to the ECS instance.

    Enter a password

  5. Click Import on the Import ECS Instances page.

  6. Wait five minutes before the import process is finished. Based on prompts on the page, click Back to go to the Cluster Information page, and view the import status in the Cluster Deployment Information area. If the health check result is changed from Converting to Online, it indicates that the ECS instance is imported successfully with EDAS Agent installed.

Use the command script to install EDAS Agent manually

NOTE: This installation method is applicable only to regular applications.

  1. Log on to the EDAS console. On the left-side navigation bar, choose Resource Management > ECS.

  2. Select a region and namespace for the ECS instance in the upper left corner of the Instances page.

  3. Click Import ECS in the upper right corner of the Instances page.

  4. Click Switch to Manual Installation in the upper right corner of the Import ECS page. On the Install EDAS Agent on Single Instance Manually page, click Click to Copy.

    Installation script

    NOTE: For image installation, click Switch to Image Installation in the upper right corner of the page and [import an ECS instance] (#ImportECS).

  5. Log on to the ECS instance where you want to install EDAS Agent as a root user.

  6. On the ECS instance, paste the copied command and execute it.

Result verification

After EDAS Agent is installed, choose Resource Management > ECS on the left-side navigation bar of the EDAS console. On the Instances page, select a region to view the EDAS Agent Status.

  • If EDAS Agent is installed successfully, the status is Online or Docker Online (Docker application or Kubernetes application).

  • If EDAS Agent installation failed, the status is Unknown.

Upgrade EDAS Agent

The procedure for upgrading EDAS Agent is similar to the procedure for installing EDAS Agent using the command script. For details, see [Use the command script to install EDAS Agent manually] (#CLI).

Thank you! We've received your feedback.