This page is an attempt to pass along some tips and best practices around deployments of Jazz technology. Got a good Jazz tip? Then let me know and I will post it up here.
Using Jazz and Maven (April 2012)
In his article, How to Do Maven Releases with Jazz SCM, Mike MacDonagh writes a great article on how to use Maven and jazz together, and a good strategy and tooling for making them do what you want. Mike is becoming one of my favorite authors out there.
Searching for Jazz information (November 2011)
I have some customers that claim that finding things on Jazz.net is difficult, and they don’t like our search engine. I can understand, because I am not always thrilled with the results that I get from our search engine. Did you know that you can tailor a Google search to get your search results? I got this from Jim Ruehlin, and he just types what he is looking for into a Google search, and then adds “ site:jazz.net” to the end of the search string. I tried it with a self serving search, “Toczala site:jazz.net“, and then one on “reverse proxy site:jazz.net“, and it really works.
Tuning the JVM running your Jazz application (November 2011)
I have some customers that are really looking to tune the performance of their Jazz application servers. They have looked at the Jazz wiki entry on tuning the RQM server, and the garbage collection configuration. What does the gencon switch do for you garbage collection? It handles short term objects differently from longer term objects, and reduces the pause when doing garbage collection. You can read more about JVM options in this great article on garbage collection policies.
Installing CLM 2011 as a non-root (non-admin) User (June 2011)
I saw that some customers have run into issues with being able to install as a root (or admin) user. Check out Philippe Krief’s blog on How to install CLM 2011 as a non-root user. Philippe is a member of our Jumpstart team, and is one of the best Jazz guys in the field.
Simple Release Notes Script on Linux (January 2011)
Ran into an issue with a customer looking at RTC, and decided to do something about it. Go out and read about my Simple RTC Release Notes Script in my blog article. You can find a link to download the script at the top of the article.
Getting Ugly on Linux (December 2010)
I have run into an issue with xulrunner 1.9 on my Linux box. I am running Lucid (10.04), and I have the same issue everytime I bring up the Eclipse client and try to modify a work item. It keeps causing my Eclipse shell to throw errors with some strange advice about defining MOZILLA_FIVE_HOME. So I went in and changed my startup shell with this:
export MOZILLA_FIVE_HOME=/usr/lib/xulrunner-126.96.36.199 export LD_LIBRARY_PATH=$MOZILLA_FIVE_HOME
It didn’t help. So today I took an upgrade to the xulrunner package, and took on xulrunner 188.8.131.52 (184.108.40.206+build3+nobinonly-0ubuntu0.10.04.1). My problem has magically disappeared! if you are seeing the same types of issues, I suggest that you get to xulrunner 220.127.116.11, and see if it fixes your issues.
Using Ajax to extend Jazz functionality? (November 2010)
I found this link today, to Jesse Skinner’s blog, which provides his readers with a free download of his book “Unobtrusive Ajax“. Now I have not read the book yet, but it is published by O’Reilly, so I figure it must be useful. If you do download and read it, please let me know if you find it useful.
Eclipse Tips and Tricks (September 2010)
Today I ran into an issue that I had earlier, and found the answer a second time. I had upgraded Ubuntu (to 9.10), and my Eclipse shell had the annoying habit of not recognizing my mouse clicks. I could navigate using the tab key, and select using the space bar, but no mouse clicks were recognized. I found a posting on an Eclipse forum that gave me my answer. You just need to update your environment to include “export GDK_NATIVE_WINDOWS=1”. In the forum, they suggested doing this from the Eclipse launcher, but I found it better if you put it in your default environment (since I have multiple Eclipse versions that I launch). I just changed my /etc/environment file so it now looks like this:
PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games" export GDK_NATIVE_WINDOWS=1
I imagine that a similar fix would work with other Linux distributions.
Developer Tips and Tricks (June 2010)
Today there is no originality, just a link to a great blog posting put up by a developer that uses Jazz/RTC. His blog posting, Advanced Eclipse and Rational Team Concert (RTC) Tips, is a really quick read. He provides some handy tips for developers working in an RTC environment. Some of the tips are specific to RTC, while others are just more general Eclipse tips. I have to admit, a couple of these were new to me.
Using Your Own Diff Engines (April 2010)
There is a new piece of functionality available in RTC 18.104.22.168. It allows you to substitute your own diff engine within the Jazz client. If you want to use your own diff tool, just follow these steps:
- Select Window -> Preferences.
- In the preferences dialog, navigate to Team -> Jazz Source Control -> External Compare Tools.
- Use an external compare tool as the default open action”, and choose from one of the tools shown (Beyond Compare, DiffMerge, P4Merge, or WinMerge) or add your own tool. Use the provided merge tool settings as a template for passing file parameters to the tool if you select a custom tool.
Visualizing your Workflows (April 2010)
Just saw this great blog entry with a Workflow Visualizer. This is a GREAT little tool. It took me 5 minutes to set up on my Linux box, and it will save me hours of time in the future. Don’t know who created it, but I really like it. I brought the jar down to my machine, created a quick launcher script, and it works. All I do now is cut and paste all of the process XML from the Process Configuration Source window for a project, paste it into a temp file, and I get a nice PDF of the process workflow.
Unable to Get Jazz to “Stick” in Visual Studio (March 2010)
I ran into this issue in March with a customer. We imported code from a ClearCase snapshot view into Jazz using Eclipse (because we wanted to preserve the file structure, in support of their existing build process). Everything was added to Jazz source control with no problem, but every time we brought up Visual Studio, the solutions would revert back to using ClearCase for source control. The issue was that the csproj files had bindings to ClearCase, and they were under source control. We were able to fix the issue by removing the bindings from the csproj files using a tool some guidance that we found on removing SCC bindings from Visual Studio projects.
Strange Errors in Jazz/ RTC Plans (February 2010)
I have often run into issues when modifying process templates, where I get errors when attempting to display iteration plans. I had my own workarounds that sometime worked (and sometimes did NOT work), but now I have a technote that explains the problem of iteration plan errors, and how to fix it.
Upgrading to RTC 2.0 (January 2010)
Just heard from a customer that they did an upgrade of a Jazz DB that had been in production for almost a year. They had 7 GB of database data, and it took about 38 hours to import the data, with no errors. What kinds of times are others seeing out there? Not sure what the specs of the web server and DB server were, so this could be an anomaly. That is why I would LOVE to hear about the experiences of others out there.
I have heard that turning off database event logging during import can GREATLY speed up this process.
Fixing Those $%#%# Certificates (January 2010)
I hate when we keep getting those “Invalid Certificate” messages from our Jazz servers. It’s a pain. So here is what you can do. Check out the sections on setting up the SSL (there are two of them) in this tech note on Setting up CALM with WAS. If you are not using WebSphere (WAS), then you probably want to read the section on setting up SSL from this post on Configuring a Clustered Jazz Implementation. These directions should work for your certificate issues. Note that this wiki entry talks about the clustering ability that is being developed for RTC 3.0, which is currently under development. I cannot wait until we have support for clustering!
RTC Enterprise 2.0 Workspace Loading – Sandboxes (December 2009)
I have some customers that need to load “variants” of their code, but cannot load them into the same Eclipse workspace. So they need to be able to load them somewhere else. You can now do this with RTC 2.0, by utilizing workspaces. To find out all of your file loading options, check out this article on Loading Content froma Jazz Source Control Repository in RTC 2.0.
RTC Enterprise 2.0 Install Tip (December 2009)
Just went through an install of the new RTC Enterprise with a customer. They ran into some issues with their WebSphere Web Server giving them problems. The issue was that they didn’t have the correct version of WebSphere (they had to install 22.214.171.124), and then they had to patch it (see this link for the patch).
Using Dependent Choice Lists in RTC 2.0 (December 2009 – Updated August 2010)
(Note: the mechanism for doing this will be simplified in the v3.0 release of RTC)
Using 64 bit Linux (August 2009)
When installing RTC on a 64 bit Linux system, make sure that you have the proper X11 libraries installed. Even though it is a 64 bit Linux, you will need to install specific 32 bit X11 libraries for the reporting and charting functions to work correctly (See this page of the install guide).
Connecting with ClearCase (August 2009)
When utilizing the ClearCase Connector technology to connect ClearCase to a Jazz implementation, it is usually best to import the code FIRST. After the code has been imported from a ClearCase synchronization stream/branch, then you can set up the ClearCase Synchronizer with that stream. Everything seems to go faster and more smoothly this way.
Save Your Setup (March 2009)
When deploying Jazz, it makes sense to save off zip archives with your developing process. This allows recreation of the process in other environments. Also save any build automations and specific plugins that you may have developed.
Wondering About Jazz Testing Solutions? (June 2009)
Check out Matt Archer’s blog, he is a consultant for Ivan Jacobson International. Ivar was one of the Rational Three Amigos, so he’s not completely unbiased, but he does have his own opinions. Very good source for testing information, just read How do I integrate IBM Rational Quality Manager with Jazz?
Personal Installation Preferences (February 2009)
I prefer the zip install for my Jazz setup, because I can do it without impacting anything else on my machine. It is simple to do, and I can have multiple client versions on my laptop (which I do to support multiple customers). If you are deploying to a large audience, you may want to encourage the Installation Manager install method, because it will allow users to pull client bits from a trusted source (jazz.net).
Did You do Something Stupid? (September 2009)
I admit it, I have done some dumb things with Jazz and RTC, and really screwed up a running instance of Jazz. How do you fix this? You can always roll back to your ORIGINAL setup of Jazz, by following these steps:
- Log out of Jazz server from your browser.
- Log back in, using this url: https://localhost:9443/jazz/admin?internal=true (replace localhost with your own Jazz server hostname)
- Click on Server Reset at bottom of the left hand menu, and then click the Request Server Reset button on the page.
- Stop the Jazz server, make sure all server processes have shut down.
- Start the jazz server
- Now notice that all of your settings and preferences are reset to their original values.
The repository remains intact, and you don’t lose any work. All that happens is that the server settings, licensing, and properties are rest to their original settings. This is a great way to get back to your starting point, rather than tearing the whole thing down, reinstalling, and then hoping the repository remains intact.