This topic describes how to install Ali-Tomcat and Pandora and how to configure the development environment for Eclipse and IntelliJ IDEA.

Install Ali-Tomcat and Pandora

Ali-Tomcat and Pandora are containers in which EDAS depends to run services. They integrate core features such as service publishing, service subscription, and trace query. Applications must be published to Ali-Tomcat and Pandora for running.

Notice Use JDK 1.7 or later.
  1. Download the Ali-Tomcat package and decompress the downloaded package to a directory, such as d:\work\tomcat\.
  2. Download the Pandora package and decompress the downloaded package to the deploy directory (d:\work\tomcat\deploy) where Ali-Tomcat is saved.
  3. View the Pandora directory structure.
    • In a Linux system, run the tree -L 2 deploy/ command in the relevant path to view the directory structure.
      d:\work\tomcat >  tree -L 2 deploy/
                  deploy/
                      └── taobao-hsf.sar
                          ├── META-INF
                          ├── lib
                          ├── log.properties
                          ├── plugins
                          ├── sharedlib
                          └── version.properties
    • In a Windows system, directly navigate to the target path to view the directory structure.

    If you encounter any problems while installing and using Ali-Tomcat and Pandora, see Ali-Tomcat FAQPandora FAQ.

Configure the Eclipse development environment

To configure Eclipse, you must download the Tomcat4E plug-in and save it to the directory where Ali-TomcatPandora is stored. After the configuration is complete, you can directly publish and debug local code in Eclipse.
  1. Download the Tomcat4E plug-in
    The following figure shows the package content.Tomcat4E plug-in
  2. Open Eclipse. In the menu bar, choose Help > Install New Software.
  3. In the Install dialog box, click Add on the right of the Work with section. In the Add Repository dialog box, click Local. In the dialog box that appears, select the directory (d:\work\tomcat4e\) where the downloaded Tomcat4E package is decompressed, and click OK.
  4. Return to the Install dialog box. Click Select All and then click Next.
    Complete subsequent steps as instructed. After installing the Tomcat4E plug-in, restart Eclipse to make Tomcat4E take effect.
  5. After Eclipse is restarted, choose Run As > Run Configurations from the Eclipse menu.
  6. In the left-side navigation pane, find AliTomcat Webapp and click New launch configuration in the upper part.
  7. On the page that appears, click the AliTomcat tab. In the taobao-hsf.sar Location section, click Browse. Select the local Pandora path, for example, d:\work\tomcat\deploy\taobao-hsf.sar.
  8. Click Apply or Run.
    Next time, you can directly start this project without the need to configure it again.
  9. View the output information about project operation. If the following Pandora container information appears, the Eclipse development environment is configured.

Configure the IntelliJ IDEA development environment

Notice Currently, only the commercial release of IntelliJ IDEA is supported. IntelliJ IDEA Community Edition is not supported.
  1. Start IntelliJ IDEA.
  2. In the menu bar, choose Run > Edit Configuration.
  3. In the left-side navigation pane of the Run/Debug page, choose Defaults > Tomcat Server > Local.
  4. Configure Ali-Tomcat.
    1. On the right of the page, click the Server tab. In the Application Server section, click Configure.
    2. On the Application Server page, click + in the upper-right corner. In the Tomcat Server dialog box, set Tomcat Home and Tomcat base directory, and click OK.
      Set Tomcat Home to the save path for the decompressed Ali-Tomcat package. This path is automatically used for Tomcat base directory, and no setting is required.
  5. In the Application Server section, select the configured Ali-Tomcat from the drop-down list.
  6. In the VM Options section, set the Java virtual machine (JVM) startup parameters to point to the Pandora path.
    Example: -Dpandora.location=d:\work\tomcat\deploy\taobao-hsf.sar

    Replace d:\work\tomcat\deploy\taobao-hsf.sar with the path where Pandora is installed.

  7. Click Apply or OK.