2.3 Installing the SpringSource Tool Suite
Prev | 2. Installation | Next

## 2.3 Installing the SpringSource Tool Suite

The SpringSource Tool Suite (STS) is a development environment based on Eclipse that needs to be configured with the plugins needed to work with Web Server and OSGi. Although the steps are similar, the details of installing STS depend on the operating system.

Go to the STS download site (http://www.springsource.com/products/springsource-tool-suite-download) and download the variant appropriate to the operating system being used. This guide is consistent with STS version 2.3.2.RELEASE. Previous versions may not work properly with the latest revision of GreenPages, currently 2.1.0.M01.

### Installing STS on Windows™ operating systems

Unzip the download of STS to the root directory of a drive (this will avoid possible problems with long pathnames).

    prompt> cd C:\
    prompt> "%JAVA_HOME%"\bin\jar xf \full…path…to\springsource-tool-suite-2.3.2.RELEASE-e3.4-win32.zip

To verify the installation, run the `eclipse.exe` executable in the unzipped directory and check that STS displays a welcome panel. The first time there may be a short delay due to the initial set-up of indexes.

#### Installing STS on UNIX™ operating systems

Unpack the download of STS to a suitable location on the file system, such as `/opt` or, if root access is not available, the home directory. (If the download was automatically unpacked by the operating system, simply move the unpacked directory to the chosen location.)

To verify the installation, run the STS executable (`Eclipse.app` on Mac OS X) in the unpacked directory and check that STS displays a welcome panel. The first time there may be a short delay due to the initial set-up of indexes.

### Adding the Virgo tools plugins

After installing and starting STS, click Help > Install New Software... and add the SpringSource Tools tools update site (http://www.springsource.com/milestone/e3.5). Install the SpringSource dm Server Tools which include the tools for Virgo. When prompted, restart Eclipse.

### Note about Java versions in STS

SpringSource Tool Suite runs on Eclipse using Java Version 1.5, and Web Server requires Java Version 1.6. The GreenPages application built here also requires Java Version 1.6. Alter the default Java compiler settings in STS before proceeding:

1. In SpringSource Tool Suite, click Window > Preferences from the menu.

2. In the Preferences window, click Java > Compiler in the left panel.

3. In the right panel, set the Compiler compliance level to `1.6`.

4. Click Apply. You will get a message asking if you want a full rebuild; click Yes. The rebuild should take very little time to complete.

   You might also see a message similar to the following on the settings panel: “When selecting 1.6 compliance, make sure to have a compatible JRE installed and activated (currently 1.5).” A link to Configure this will appear. Select this link to open the Java--Installed JREs panel. If not already selected, choose a JRE suitable for Java Version 1.6.x (for example `JVM 1.6.0`).

5. Click OK.

Prev | Up | Next
2.2 Installing Web Server | Home | 2.4 Installing Apache Maven