I played music professionally for many years, both solo and in bands. I liked each, but I always preferred playing in bands, because when a group of musicians are playing in sync, in harmony, listening, complementing, and playing off of each other, it's a wonderful thing.
As a software developer, I've always wished that teams I was on could be as tight as some of the bands that I've been in. Unfortunately, that hasn't always been the case. As developers, we often work on different parts of a project, have different responsibilities, may be geographically or organizationally dispersed, and yet, we need to pull it all together in the end to deliver high-quality software as if we were the tightest software development team.
Well, now there is a platform that can help us do just that, and the beauty of it is that its name is musical: Jazz. We can always tell when a musical group, whether a rock band, a jazz ensemble, a choir, or even an orchestra, is playing as one. The Jazz technology platform and IBM® Rational® Team Concert, the first product based on Jazz, enable software developers to truly deliver software as one ensemble.
This is intended as a quickstart guide to installing and configuring Rational Team Concert Express-C.
Summary of the products and process
Rational Team Concert Express is a client/server offering consisting of the Rational Team Concert client and the Jazz™ Team Server. I won't go into more detail here about what they are, because you can find a lot of information about them elsewhere (see Resources). Instead, I'll give you the "guide to the guide" for installing and setting up the server and client software. I'll point you to the pertinent, more detailed instructions as we go along. And I'll add a few tips to help you avoid problems.
The overall installation process involves four steps:
- Downloading the Rational Team Concert Express-C installation files from Jazz.net
- Installing and configuring the server
- Installing and configuring the client
- Optionally, setting up IBM Lotus® Sametime® (or open source Jabber) as your collaboration tool
- Start by registering at Jazz.net. It's open to the public, and it's free. Just click the Register now! link under "How do I join?"
- After you have registered and logged in, go to the Downloads page (see Figure 1), where you'll see three editions available:
Figure 1. Jazz Downloads page
- Click Express-C to download the file
- Extract the contents of the zip file to a local installation directory (
Setting up the Jazz Team Server
In this section you will start the Tomact server and log in to the Jazz Team Server Setup wizard. Once this is done you can configure and administer your Jazz projects by accessing the Jazz Team Server Administration pages.
- Start the Tomcat server by running the file
- Open a browser and enter the URL:
- Log in to the Jazz Team Server Setup wizard with the user/password: ADMIN/ADMIN (case-sensitive), as shown in Figure 2.
Figure 2. The Jazz Team Server Setup login page
- On the Jazz Team Server Setup page, click the Fast Path Setup button for the default configuration (Figure 3).
Note: Optionally, you and click Custom Setup to configure a different database and enable e-mail notifications, but for now let's get Jazz up and running quickly.
Figure 3. The Jazz Team Server Setup page
- On the Setup User Registry page, select your user registry, setup a user account for yourself, and assign a client access license to the user account you're creating. Click Next.
Note: In the Express-C version, the following account licenses are available: 1 for the build system user account, and and 3 for Developer clients. You can purchase additional client licenses for up to a total of 10 Contributor and Developer users. If you anticipate a larger team, then download and install either the Rational Team Concert Express or Standard.
- On the Summary page of the Jazz Team Server Setup wizard, you can create more user accounts or create a new Jazz project, or simply click Finish to complete the server setup (Figure 4).
Figure 4. The Jazz Team Server Setup Summary page
On the Jazz Team Server Administration pages you'll see summaries, statistics, and status of your projects, you can also manage users, project areas, e-mail and database settings, and other project properties. You can log in to the Jazz Administration pages by entering the URL:
https://localhost:9443/jazz/admin in your browser and change these settings at any time now that server setup is complete.
Note:For a more complete description of the installation process, as well as some troubleshooting tips, see the Product Overview at the Rational software Information Center.
Server installation tips
I extracted the ZIP file below the root directory and a single Jazz directory was created that installed both the server and client directories under it, but the installation location is up to you. The server comes with its own Java™ runtime environment (JRE) tool, as the client does, too. You can use the default Derby database that is part of the default installation, or you can configure the server to use IBM DB2® or another database as your repository, depending on your edition. I took the quickest path and opted to use the Derby database. I used Tomcat (included) as the application server.
After the installation, I created shortcuts to start and stop the application server and added them to the Windows Start menu. That makes it easy. Figure 5 shows the menu after I also installed the client.
Figure 5. Menu after installation
If you have trouble accessing the default Tomcat page or the Jazz Team Server administration page from your browser, check to see whether your firewall is preventing access. You can find other troubleshooting help in the online server setup guide.
Client installation tips
Next, you'll start the client installation and log in to the Rational Team Concert workspace.
- Navigate to the installation dierctory,
- Double-click the file
Note: You may want to create a shortcut to this file on your Desktop or Start menu.
- When the Workplace Launcher dialog appears, select a location for your workspace, and click OK.
The Rational Team Concert workspace is displayed, as shown in Figure 6.
Figure 6. The Rational Team Concert workspace
Note: If you get a warning dialog that you cannot connect to the localhost repository, as shown in Figure 7, check the following:
Figure 7. Login Failed warning dialog
- Make sure that Tomcat is started and properly configured.
If you still cannot connect, do the following:
- In the Rational Team Concert workspace, expand the Repository Connections node.
- Right-click ADMIN@localhost, and click Properties.
- In the Properties for ADMIN@localhost dialog box, click Jazz Repository Connection, and make sure that under Location, that the value for URI is:
- If not, enter the URI above.
- Under Authentication, enter the Jazz server administrator password, and click Apply and then click OK (Figure 8).
Figure 8. Properties for ADMIN@localhost dialog
You should now be able to connect to your localhost.
Note: If you are already a team member in another Rational Team Concert project, you should also see those connections in your workspace under the Repository Connections node.
The Jazz technology platform and Rational Team Concert Express enable your team to work even more in harmony. Not only do they change the way that your team members can work together, but they are fun to use.
- Learn more about the IBM Rational Jazz technology platform:
- Visit the Rational software area on developerWorks for technical resources and best practices for Rational Software Delivery Platform products.
- Explore Rational computer-based, Web-based, and instructor-led online courses. Hone your skills and learn more about Rational tools with these courses, which range from introductory to advanced. The courses on this catalog are available for purchase through computer-based training or Web-based training. Additionally, some "Getting Started" courses are available free of charge.
- Subscribe to the Rational Edge newsletter for articles on the concepts behind effective software development.
- Subscribe to the IBM developerWorks newsletter, a weekly update on the best of developerWorks tutorials, articles, downloads, community activities, webcasts and events.
- Browse the technology bookstore for books on these and other technical topics.
Get products and technologies
- Download trial versions of IBM Rational software.
- Download these IBM product evaluation versions and get your hands on application development tools and middleware products from DB2®, Lotus®, Tivoli®, and WebSphere®.
Dig deeper into Rational software on developerWorks
Get samples, articles, product docs, and community resources to help build, deploy, and manage your cloud apps.
Experiment with new directions in software development.
Software development in the cloud. Register today to create a project.
Evaluate IBM software and solutions, and transform challenges into opportunities.