edit-icon download-icon

Install EDAS Agent

Last Updated: Feb 02, 2018

Before deploying applications with EDAS, you must first install EDAS Agent on the relevant ECS instances.

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. For more information about EDAS Agent, see EDAS Agent overview.

Note:

JDK 8 is installed in EDAS Agent by default. To use JDK 7 instead, you can manually execute the installation script with the “-force -java 7“ parameter appended at the end.

For example, run the following command to install JDK 7 in the China North 2 (Beijing) region:

  1. wget -q -O /root/install.sh http://edas-bj.oss-cn-beijing-internal.aliyuncs.com/test/install.sh && sh /root/install.sh -force -java 7

You can install EDAS Agent on ECS instances in three ways:

Manual installation by executing script

  1. Log on to the EDAS console and choose Resources > ECS in the left-side navigation pane. Then click Import ECS at the upper-right corner of the ECS page.

  2. On the Import ECS page, click Switch to Manual Installation and copy the command.

    Manually install EDAS Agent

  3. Log on to the ECS instance where you want to install EDAS Agent with the root user account, paste and run the copied command.

    After the installation is finished, go to the ECS page in the EDAS console to view the new instance.

Automatic installation by using EDAS base image when you purchase ECS

The most efficient way is to have the Agent automatically installed when purchasing ECS with an EDAS base image.

  1. Click Create Instances on the ECS console, select Marketplace Image in the Choose the Operating System section. Then click Select from image market (including operating system).

  2. Enter EDAS in the search box, click Search, and select EDAS Java Environment (common ECS) from the results. The latest version is selected by default. Then click Use to select it as the EDAS base image.

  3. Complete the purchase of the ECS instance.

    The EDAS Agent is pre-installed for the ECS after the purchase. In the EDAS console, choose Resources > ECS in the left-side navigation pane, and select the region from which you just purchased the ECS instance. The ECS instance installed with EDAS Agent is displayed in the list.

Note: If the ECS instance for which the EDAS base image is purchased cannot be found, please log on to the ECS instance with the root user account, and run the edas init command. Then come back and refresh the ECS instance list.

Automatic installation by importing ECS instance

If the EDAS base image is not installed with the purchase of the ECS instance, you can click Import ECS in the EDAS console to install the EDAS Agent. Follow these steps:

  1. In the left-side navigation pane of the EDAS console, choose Resources > ECS. At the upper-right corner of the ECS page, click Import ECS.

  2. On the Import ECS page, select Namespace, Cluster and Instance, and click Next.

    • To create a common application, use the xxxx_default [ECS Cluster] selected by default.
    • To create a Docker application, select the appropriate cluster from the drop-down menu.
    • To create a new cluster, click Create Cluster.

    Select a cluster and ECS

  3. On the Set New Password page, enter a new logon password for the ECS instance and click Next.

    After you confirm the ECS import, the system erases all data on the ECS instance, and reinstalls with the EDAS official image. Please remember your new password.

    Set New Password

  4. In the Import ECS host dialog box, click Import.

    It takes a few minutes to import an ECS instance. Then, follow the prompts and click Back to go to the cluster details page under Cluster Management. In the Cluster Deployment Information area, you can view the import status and progress.

    When the ECS instance changes from Converting to Online status, the ECS instance has been imported successfully.

    After the import, you can find the imported ECS instance in the corresponding region on the ECS page.

Note: If the imported ECS instance is not found in the list for the corresponding region on the ECS page, you can re-import the instance or log on to the ECS instance with the root user account, and run the edas init command to manually convert the instance.

Thank you! We've received your feedback.