You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

(This page is a mock up of a proposed developer outreach program to university students and other potential Tuscany contributors)



Welcome!

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 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

Complete and submit the form at https://issues.apache.org/jira/secure/Signup!default.jspa .

This account gives you access to browse lists of Jiras, comment on them, and contribute patches. Check here when you are done:

B. Sign up for the Apache Tuscany developer list

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. Or send a subscription email to dev-subscribe@tuscany.apache.org and receive information in your email.

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. Talk live with developers from around the world.

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

Check here when you are done:

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

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:

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/

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/

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/

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

Check here when you are done:

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

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@......)
  • No labels