0. Requirements:

To run the Averest plugin, you must have the Java Runtime Environment (JRE) 5.0 and Eclipse 3.2. Note that on some machines such as Ubuntu Linux, the default JVM (Java Virtual Machine) is GIJ/GCJ. To run Eclipse with another JVM, start it with option -vm (e.g. eclipse -vm /usr/local/bin/java) or edit the configuration file to change the JVM permanently. On a Linux system, for example, add JVM=/usr/local/bin/java to the file ~/.eclipse/eclipserc.

1. Install or Update Averest Plugin:

To install the Averest plugin, please perform the following steps:

• Start Eclipse
• Select "Help" -> "Software Updates" -> "Find and Install"
• Select "Search for new features to install" and click "Next >"

If you have alread created the remote site for the Averest plugin, you can skip the next four steps

• Click "New Remote Site..."
• Enter "Averest Plugin Update Site" in the name field
• Enter "http://www.averest.org/download/eclipse-plugin/org.averest.eclipse-update/" in the URL field
• Click "OK"

• Make sure that "Averest Plugin Update Site" is selected in the list of sites to include
• Click "Finish"
• Select "Averest Plugin Update Site" in the list of features to install and click "Next >"
• Read the license agreement, select "I accept the terms in the license agreement", and click "Next >"
• Click "Finish" to confirm the list of features to be installed
• Click "Install All" in the feature verification dialog
• Click "Yes" to restart the Eclipse SDK

To update the Averest Plugin, please perform the following steps:

• Select "Help" -> "Software Updates" -> "Manage Configuration"
• In the left pane, open "Eclipse SDK" and the path where Eclipse is installed (unless not already opened)
• Select "Averest Plugin for Eclipse"
• In the right pane, select "Scan for Updates"

Note that you can only update minor versions, e.g. from version 1.2.3 to 1.2.4. If you want to upgrade from version 1.2.3 to 1.3.0, please follow the installation instructions of the Averest plugin.

2. Switch to Averest Perspective:

• Select "Windows" -> "Open Perspective" -> "Other..."
• Select "Averest" perspective and click "OK"

3. Enable Remote Access to Averest Server:

• Select "Window" -> "Preferences..."
• Open "Averest" preferences and select "Server"
• Check "Use Averest Server" box
• Enter host name "srv.averest.org", port "4281", and click "OK"

4. Create New Averest Project:

• Select "File" -> "New" -> "Averest Project"
• Alternatively, you can press the right mouse button in the navigator window
• Enter the project name and click "Finish"
• To modify the project properties, select "Project" -> "Properties" and click "Averest"

5. Add Quartz File to Project:

• Select the project in the navigator window
• Select "File" -> "New" -> "Quartz File"
• Alternatively, you can press the right mouse button in the navigator window
• Enter the file name and click "Next"
• Choose a template and click "Finish"

6. Compile, Verfify, and Synthesize a Project

• Select the desired program from the "Run" menu
• Alternatively, you can use the buttons in the tool bar
• Depending on your internet connection, the file size, and the server load it may take some time until you get an acknowledgement from the server that your request is being processed.
• Information about the current process is given in the title bar of the console window
• If you want to abort a running process, click the red box in the console window
• To open the error log in case of problems, select "Windows" -> "Show View" -> "Other...", open the "PDE Runtime" folder, and select "Error Log"