Quick Start to Developing the Orc Language Toolset

Install Prerequisites

  1. Java 1.6 or later.
  2. Eclipse 3.7 or later. These instructions assume version 3.7.2, but other versions should behave similarly. "Eclipse Classic" is sufficient, but any Eclipse package with the JDT can be used.
  3. Subversive. You may also use Subclipse, or check out the project manually with the client of your choice.
  4. Scala IDE for Eclipse, corresponding to Scala language version 2.10.1. Note that the Scala Eclipse plug in works better with a modified eclipse.ini.
  5. A Subversion distribution that includes the svnversion command. Most UNIX systems (including macOS), Linux distributions, BSD variants, and other OSes include this as part of their base platform. A few OSes, notably Windows, require one to install a Subversion client.

Check out Orc

Use the method of your choice to check out https://orc.googlecode.com/svn/trunk/OrcScala and import it into the Eclipse project OrcScala. Here is how to accomplish this using Subversive:

  1. Launch Eclipse
  2. Go to File -> New -> Project ...
  3. Open SVN, choose Checkout Projects from SVN, and click Next >
  4. Choose Create a new repository location and click Next >
  5. Enter for the URL: https://orc.googlecode.com/svn
  6. Select trunk -> OrcScala and click Finish.
  7. Warning: Do not change the project name (from OrcScala) or the project will not build correctly.

Running Orc Programs: Alternative 1

Install the Orc Eclipse plug-in. In the Orc Run Configuration settings, go to Alternative Orc Runtime Engine and add build/orc-*.jar and lib/*.jar in your OrcScala project to the class path. Note that adding the Scala library (as it is represented in the OrcScala class path) will not work.

Running Orc Programs: Alternative 2

  1. Within Eclipse, open the Orc program you wish to run.
  2. Go to Run -> Run Configurations...
  3. Right-click Scala Application and select New
  4. Fill out the Main form as follows:
    Name
    Orc
    Project
    OrcScala
    Main class
    orc.Main
  5. Click the Arguments tab and fill out the form as follows:
    Program arguments
    "${selected_resource_loc}"
  6. Click Apply

You only have to perform the above steps once. Then whenever you want to run an Orc program:

  1. Select the program source file in Eclipse (you can open it or simply select it in the Package Explorer or Navigator).
  2. Go to Run -> Run ..., select Orc, and click Run (after doing this once, you can use the dropdown menu of the "run" icon in the toolbar as a shortcut).

Get Started

Get Involved

Contact Us

Supporting Agencies

This research is supported in part by funding from the National Science Foundation. Any opinions, findings, and conclusions or recommendations expressed on this website are those of the author(s) and do not necessarily reflect the views of the National Science Foundation.

Last updated 2016-07-04