Page History

...

Welcome to Tuscany Tune Up, an easy way for university students, software developers, and web enthusiasts to try out open source development on one of the hottest technologies around - Apache Tuscany. Tuscany is a Service Oriented Architecture, an enabling technology for all sorts of business services to talk to each other and share business information. What's interesting is that Tuscany allows all sorts of underlying technology to talk over many protocols (HTTP, Atom, web services, JMS) in a seemless way, whether implemented in Java, BPEL, SCA, Java or scripting languages such as Groovey Groovy or JScript. Tuscany is used by many top corporations on many state-of-the art web sites. Swap out pieces in building block fashion. Make changes in a hurry. Respond to new requirements quickly.

How does Tuscany Tune-Up work? In exchange for less than 8 hours of your time, you will be able to experience open source development and contribute to an actual product. You will be helping the Tuscany project improve by solving actual issues known as Jiras. See whether you like web development. Learn a new technology. Gain valuable experience for your resume. Get in touch with the world-wide development team. Meet and discuss issues with student mentors. Just follow the steps below, marking off the steps as you complete them. If you get stuck, each section lists a live person that you can talk to via chat, email, or web cam. It's an easy way to pick up a valuable new skill. In the end we will reward you with a commemorative pin.

Step 1. - Get Connected

Come join the Tuscany development team. By completing this step you become a true Tuscany contributor. You gain access to the open source world of software development. This gives you access to mailing lists and our issues lists which are known as Jiras. You can think of Jiras as bugs, feature requests, or areas for improvement.

Estimated time for this step: 1 hour

A. Sign up for an Apache developer account

...

These lists will give you access to the latest discussions. Follow the latest issues that are being solved by the developers. Point your feed reader to http://mail-archives.apache.org/mod_mbox/tuscany-dev/?format=atom^{Image Removed}. Or send a subscription email to dev-subscribe@tuscany.apache.org and receive information in your email.

 Check Check here when you are done:

C. Join the Tuscany Chat Channel

Point your chat tool (such as Chatzilla) to irc://irc.freenode.net/tuscany^{Image Removed}. Talk live with developers from around the world.

 Check Check here when you are done:

...

Trouble with this Step?

Contact these Mentors:

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)

Step 2. - Try Out Tuscany

Still don't have a good idea what Tuscany is? Let's give it a test run. First we will set up your development environment. Then we will give Tuscany a test run. Then we will bring up Tuscany in a debugger.

Estimated time for this step: 2 hours

A. Download Tuscany

Download the latest release of Tuscany to your computer. You can run Tuscany on any system that supports the programming language Java and the Java developer toolkit - Linux, MacOS, or Windows. Make a fresh directory such as Tuscany. Down load and unzip this Tuscany binary to that directory.

http://tuscany.apache.org/tuscany-downloads-documentations.html^{Image Added}

Check here when you are done:

Image Added

B. Download a Java Development Kit

If your system does not have Java installed, you will need to install it. You can use any version of Java, but here we are using the version from Sun.

 http://java.sun.com/javase/downloads/index.jsp^{Image Added}

Open a command window and test if your Java has installed correctly. When you type "java -version" you should see a Java version number.

Check here when you are done:

Image Added

C. Download Development Tools

Tuscany requires Java to run. However Tuscany Tune Up is geared towards developers. So we are going to install some state of the art development tools. You will need the Maven tool to build Tuscany, the Subversion tool to check out code, and the Eclipse tool to debug Java. This step we will install these tools.

Download and install Apache Maven for your operating system

http://maven.apache.org/^{Image Added}

Test that Maven works by running the command "mvn -?" at the command line.

Download and install  Tigris Subversion for your operating system

http://subversion.tigris.org/^{Image Added}

Test that subversion works by running the command "svn help" at the command line.

Download and install Eclipse for your operating system.

http://www.eclipse.org/^{Image Added}

Start Eclipse from you desktop and check that you get a welcome screen.

Check here when you are done:

Image Added

D. Run a Tuscany Sample

Now that we have all the tools in place, let's check that Tuscany actually runs. Switch to a command window and run the Tuscany calculator sample.

Let's first run the sample before we go about building it. It is easy!

• Go to the directory ..\samples\calculatorant run

Alternatively if you want to run the sample directly from the command line try the following.

• if you are using Windows issue the command:java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator.jar calculator.CalculatorClient
• if you are using *nix issue the command:java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator.jar calculator.CalculatorClient

You should see the following result:

3 + 2=5.0
3 - 2=1.0
3 * 2=6.0
3 / 2=1.5

For more help, see the Tuscany Getting Started guide at http://tuscany.apache.org/getting-started-with-tuscany-using-the-command-line.html^{Image Added}

Check here when you are done:

Image Added

Trouble with this Step?

Contact these Mentors:

• Haleh Mahbod (haleh@......)
• Luciano Resende (luciano@......)
• Raymond Feng (raymond@.....)
• Dan Becker (dan.becker@......)