edit-icon download-icon

Install EDAS Agent

Last Updated: Feb 01, 2019

EDAS Agent is the daemon program installed on ECS instances that communicates between the EDAS cluster and the applications deployed on the corresponding ECS instances.EDAS Agent provides the following functions:

  • 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 this application-based management, EDAS Agent is also used to communicate between the EDAS console and your applications.For example, EDAS Agent must be used to determine whether an ECS instance has correctly and promptly published a service that an application publishes.

Note: You can transparently access these functions by installing 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 application instances 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 after you purchase an ECS instance.

There are three ways to install EDAS Agent:

Note:

  • JDK 8 is installed on EDAS Agent by default in these three scenarios. To use JDK 7 or another version, run the corresponding installation script.
  • This script requires you to log on to your ECS instance as the root user.
  • 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 executed repeatedly, which overwrites the existing version of EDAS Agent installed on the ECS instance. Therefore, you can 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 EDAS Agent statuses. This determines the type of applications that you can create on the ECS instance.When using an installation method, follow the related instructions.

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

The easiest method of installation of EDAS Agent is to use the EDAS base image when purchasing an ECS instance.

Note: This method requires disk formatting. To avoid formatting disks, we recommend that you use the command script to manually install EDAS Agent.

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

  2. In the upper-right corner of the ECS page, click Create Instance.

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

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

  5. Select an image from the search results based on the requirements of your applications. By default, the latest version of image is selected (we recommend that you do not select an earlier version). Then, click Use.

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

    • To create a Docker application, select EDAS.

  6. Follow the instructions on the page to purchase an ECS instance.

Import an ECS instance to automatically install EDAS Agent

If you did not select any EDAS base images when purchasing an ECS instance, you can use the Import ECS function in the EDAS console to install EDAS Agent. An ECS instance can be imported either directly or after image conversion.

Under any of the following conditions, direct import of an ECS instance is not possible:

  • The ECS instance was created before December 1, 2017.
  • A classic network ECS instance is imported into a classic network cluster.
  • The ECS instance is not running (it is stopped, starting, or stopping).
  • The ECS instance is a Windows instance or does not support simple shell commands.
  • The ECS instance is not imported from an ECS cluster.

Note: If image conversion is required, disk formatting will be performed. To avoid formatting disks, we recommend that you manually execute the script to install EDAS Agent.

  1. In the left-side navigation pane of the EDAS console, choose Resource Management > ECS.

  2. On the ECS page, select Region and Namespace. Then, click Import ECS in the upper right corner of the page.

  3. On the Select Cluster and ECS page, enter Namespace and Select Cluster to Import.In the ECS instance list, select the ECS instance that needs to be imported, and click Next.

    Note:

    • If the desired cluster is not in the list, click Create Cluster to the right of Select Cluster to Import to create a cluster.
    • To manually install EDAS Agent, click 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 manually install EDAS Agent.
  4. On the Ready to Import Page, view the information of the selected instance.

    • If the ECS instance can be imported directly, click Confirm and Import.If the ECS instance needs to be converted before import, select I agree to convert the above instances, and fully understand that the data in the original systems will be lost after conversion and enter the new password for root user logon after conversion.Click Confirm and Import.
  5. On the Import tab page, view the import progress of the instance.

    • If the ECS instance supports direct import, you can view its import progress on the Import tab page. If the message Instance transfer succeeded is displayed, the ECS instance has been imported successfully.Click Click to return to the Cluster Details page. If the status of the ECS instance is Running, the ECS instance has been imported to the cluster and EDAS Agent has been successfully installed.
    • For an ECS instance that needs to be converted before being imported, the import progress of the ECS instance displayed on the Import page is Converting now. This may take 5 minutes.If you click Click to return to the Cluster Details page before the import is completed, the health check status Converting and the conversion progress in percentage are displayed. When the import is completed, the health check status Running is displayed,indicating that the ECS instance has been imported to the cluster and EDAS Agent has been installed successfully.

Use the command script to manually install EDAS Agent

Note: This approach applies to ECS instances in the ECS cluster only.

1.In the left-side navigation pane, choose Resource Management > ECS.

  1. On the ECS page, select Region and Namespace. Then, click Import ECS in the upper right corner of the page.

  2. 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.

    Note: To install EDAS Agent with an image, click Switch to Image Installation in the upper-right corner of the page and then import an ECS instance.

  3. Log on to the ECS instance where the EDAS Agent is to be installed as the root.

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

Result verification

After installing EDAS Agent, choose Resource Management > ECS from the left-side navigation pane of the EDAS console. On the ECS page, choose the appropriate region to view the Agent Status.

  • If the EDAS Agent installation is successful, the Agent status is Online (for ECS clusters) or Docker Online (for Swarm or Kubernetes clusters).

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

Upgrade EDAS Agent

The procedure for upgrading EDAS Agent is similar to that for installing EDAS Agent with a command script. For details, see Use the command script to manually install EDAS Agent.

Thank you! We've received your feedback.