All Products
Search

This Product

    Enterprise Distributed Application Service:Set up a local EDAS development environment

    Document Center

    Enterprise Distributed Application Service:Set up a local EDAS development environment

    Last Updated:Mar 11, 2026

    Enterprise Distributed Application Service (EDAS) applications run on two runtime containers: Ali-Tomcat and Pandora. These containers integrate core features such as service publishing, service subscription, and tracing. To build and debug EDAS applications locally, install both containers and configure your IDE.

    Before you begin

    Make sure that you have:

    • Java Development Kit (JDK) 1.7 or later installed. Run java -version to verify.

    • One of the following IDEs installed:

      IDESupported editions
      EclipseAll editions
      IntelliJ IDEACommercial release only. Community Edition is not supported.

    Install Ali-Tomcat and Pandora

    Ali-Tomcat and Pandora are containers on which services in EDAS depend during runtime. Applications must be published to these containers for running. Install both before configuring your IDE.

    1. Download one of the following Ali-Tomcat packages:

    2. Extract the package to a local directory, for example d:\work\tomcat\.

    3. Download the Pandora package.

    4. Extract Pandora into the deploy subdirectory of your Ali-Tomcat installation. Using the example path above, extract it to d:\work\tomcat\deploy\.

    5. Verify the directory structure. On Linux, run the following command from your Ali-Tomcat directory: Expected output: On Windows, navigate to the deploy directory in File Explorer and confirm that the taobao-hsf.sar folder and its contents match the structure above.

         tree -L 2 deploy/
         deploy/
   └── taobao-hsf.sar
       ├── META-INF
       ├── lib
       ├── log.properties
       ├── plugins
       ├── sharedlib
       └── version.properties

      Pandora directory structure on Windows

    Note

    For troubleshooting, see Ali-Tomcat FAQ and Pandora issues.

    Configure Eclipse

    Eclipse integration requires the Tomcat4E plug-in. After installation, you can run and debug EDAS applications directly from the IDE.

    Install the Tomcat4E plug-in

    1. Download the Tomcat4E plug-in package and extract it to a local directory, for example d:\work\tomcat4e\.

    2. Open Eclipse. In the menu bar, choose Help > Install New Software.

    3. In the Install dialog box, click Add next to the Work with field. In the Add Repository dialog box, click Local, select the directory where you extracted the Tomcat4E package (for example, d:\work\tomcat4e\), and click OK.

    4. In the Install dialog box, click Select All, then click Next.

    5. Follow the remaining prompts to complete the installation, then restart Eclipse.

    Create a run configuration

    1. After Eclipse restarts, choose Run As > Run Configurations from the menu.

    2. In the left pane, find AliTomcat Webapp and click New launch configuration.

    3. Click the AliTomcat tab. In the taobao-hsf.sar Location section, click Browse and select the local Pandora path, for example d:\work\tomcat\deploy\taobao-hsf.sar.

    4. Click Apply or Run. The configuration is saved. The next time you run this project, it uses the same settings automatically.

    Verify the setup

    Check the console output after running your project. If Pandora container initialization messages appear, the Eclipse development environment is ready.

    Pandora startup success in Eclipse

    Configure IntelliJ IDEA

    Important

    Only the commercial release of IntelliJ IDEA is supported. Community Edition is not supported.

    Add Ali-Tomcat as an application server

    1. Open IntelliJ IDEA. In the menu bar, choose Run > Edit Configurations....

    2. In the Run/Debug Configurations dialog, navigate to Defaults > Tomcat Server > Local in the left pane.

    3. Click the Server tab. In the Application Server section, click Configure.

    4. On the Application Server page, click + in the upper-right corner. In the Tomcat Server dialog box, set Tomcat Home to the directory where you extracted Ali-Tomcat (for example, d:\work\tomcat\). The Tomcat base directory field auto-populates with the same path.

    5. Click OK.

    Configure the run settings

    1. In the Run/Debug Configurations dialog, select the Ali-Tomcat server you configured from the Application Server drop-down list.

    2. In the VM Options field, add the following JVM parameters: Replace <path-to-pandora> with the absolute path to your Pandora installation. For example:

      Note

      These JVM parameters are for local development only. Do not include them when you deploy to EDAS.

      ParameterDescription
      -Dpandora.locationAbsolute path to the taobao-hsf.sar directory in your Ali-Tomcat installation
      -Dvipserver.server.portPort for the local lightweight configuration and registry center. Speeds up local application startup.
         -Dpandora.location=<path-to-pandora> -Dvipserver.server.port=8080
         -Dpandora.location=d:\work\tomcat\deploy\taobao-hsf.sar -Dvipserver.server.port=8080

    3. Click Apply or OK.