Extending Rational Team Concert - RTC Extending

with Tags: extending

Preparing the Environment for Extending RTC (1/3) - Installing the RTC 3.0 (windows)

EduardoBello Tags: team extending rational rtc installation concert server install client 3 Comments 14,747 Views

To begin the development of customizations to the RTC is necessary to prepare and configure the environment. Here I will split this preparation into three parts, the first one will cover the jazz server and client installation, the second one will explain the initial settings of the server and licenses, and the third part in which we talk about the changes needed to make environment ready for development, such as debug configuration and using the SDK.

We will be using version 3.0 of Rational Team Concert, if you want to develop for previous versions like 2.0.0.2, you won't find major problems, because although the product itself has improved considerably, the development methods have not changed that much.

Preparing the Environment for Extending RTC (1/3) - Installing the RTC 3.0 (windows)

    Important: This tutorial was produced using the windows version of the RTC, some screenshots may not match for other operating systems. A few aspects will be different, for example, the extension of some files "*. bat", "*. sh", "*. exe".

    Ok, lets get started. First you need to download the necessary files from the Jazz website (you must be registered and registration is free). After you log in, access the following download page https://jazz.net/downloads/rational-team-concert/releases/3.0?P=allDownloads

    There you will find several files for download, including web installers. Here we'll use the offline installers, and for that we need to download the following files:

1- https://jazz.net/downloads/rational-team-concert/releases/3.0/RTC-Developer-10-C-License-3.0.zip
2- https://jazz.net/downloads/ibm-installation-manager/releases/1.4.1
3- https://jazz.net/downloads/rational-team-concert/releases/3.0/JTS-CCM-With-Trial-Licenses-repo-3.0.zip
4- https://jazz.net/downloads/rational-team-concert/releases/3.0/RTC-Eclipse-Client-repo-3.0.zip

The first one is the license file (10 free developers licenses), then we have the installer, and the repositories of the server and client respectively.

After downloading the files, unzip them to their respective folders, as shown below:

Now install the Installation Manager (agent.installer\install.exe). Setup is very simple and requires no further explanation.

Once installed, we will now configure the repositories in Installation Manager. Access the "File" -> "Preferences", select the tab "Repositories" and click the "Add Repository"

Look for the file "repository.config" in folder "RTC-Eclipse-Client-repo-3.0\im\repo\rtc-client-offering\offering-repo", then repeat the process to file with same name, but in the folder "JTS-CCM-With-Trial-Licenses-repo-3.0\im\repo\jts-ccm-trial\offering-repo".

Now that the Installation Manager know where are the installation files, we can install the server and client. To do this click "Install".

The order of installation between server and client doesn't matter right now. Of course, you can only use the client if the server is up, but as in this first part we will not run the client, we can install it first because its installation is simpler.

Select the package Rational Team Concert - Client for Eclipse IDE and proceed with the installation, accepting the License Terms and choosing the desired directory.

Then it's time to install the server

    Okay, we have the server and the client installed. In the next post, we will configure the server initial settings to make it work properly.

    Leave your comments, critics, suggestions. Your feedback is very important to make me improve the material. Despite the fact that I'm relatively "old" in development world, I am entirely new in this area of articles, blogs and video lessons.

    Some spelling errors may occur. If you find any misspelled words, let me know.

Operation Advisor - Prevent unwanted links between workitems

EduardoBello Tags: link rational jazz code prevent advisor sample rtc extending 1 Comment 11,167 Views

    Hello, It has been a while since I posted here, I've been really busy, but I got a few minutes of free time to write this example of Operation Advisor which aims to prevent a certain type of workitem to be linked to another workitem of a different type.

    For this example, let's make Tasks workitems unable to link Defect workitems as children. You can easily change the types of workitems and links in this example to suit your needs. The purpose of this and future posts is to get familiar with the API Jazz.

    Before proceeding it is essential that you already know the first steps to creating a RTC plug-in, if you do not know stop here and read this previous post that explains the basic steps with a simple example.

    First create your Plug-in Project and select Dependencies tab and add most frequently used plugins as required (com.ibm.team.process.service, com.ibm.team.workitem.common, com.ibm.team. workitem.service, com.ibm.team.process.common, com.ibm.team.repository.common, com.ibm.team.repository.service) and import the package org.eclipse.core.runtime. After that, it is important that you save the project to refresh the workspace.

Let's select Extensions tab and add our Extension Point for this plugin. And since this is a pre-condition and will not change the state of the workitem, let's use an Operation Advisor.

    Click Add.

Look for: com.ibm.team.proccess.service.operationAdvisors. This option only appears if you have correctly added the required plugins as mentioned earlier.

     Fill the following fields:
                      id: Identifier of the advisor
                     class: Java class that will be called by the advisor
                     name: Name by which the advisor will be identified in the process settings.
                     operationId: Id of the operation where the advisor will be injected.

    Add an extension service, Right click, New -> extensionService and fill an id and use the same class used in the extension point.

    Now let's the code:

    All done! Now just create the feature and the site and upload the plugin to server.

    I will try to shorten the time between posts, but by May it can be a bit difficult. See you next time!

Preparing the Environment for Extending RTC (2/3) - Initial Settings

EduardoBello Tags: for settings environment extending configure 3.0 install preparing initial rtc setup 1 Comment 11,190 Views

This is the second part of the article "Preparing the Environment for Extending RTC", you can access the first part here. In this post we will deal with the initial configuration of the RTC local server to make it running and ready to be prepared for development.

Preparing the Environment for Extending RTC (2/3) - Initial Settings

Important: This tutorial was produced using the windows version of the RTC, some screenshots may not match for other operating systems. A few aspects will be different, for example, the extension of some files "*. bat", "*. sh", "*. exe".

Once installed, we need to make the initial settings on the server local RTC to make it run properly. First, let's start the server. Go to the folder where the Jazz server was installed and run "server.startup.bat" (or "server.startup.sh", see note above)

The first time may take up to several minutes to start the server. When the message "INFO: Server startup in seconds *****" appears, it means the server is up.

Now let's access server for the first time to configure it. Access: https://localhost:9443/jts/setup and login with username ADMIN and password ADMIN.

The first screen will be shown as follow. Click "Next"

Here we set the public URI for our server. This part requires some additional steps, as shown below, the Jazz do not kindly accept us to leave "localhost" as our Public URI.

There are MANY ways to solve this, I chose a really simple one: Create an entry in the hosts file resolving any given name (I chose "rtclocaljazz.com") to our local ip. In windows the file to be edited is "windows\system32\drivers\etc\hosts", in Linux is "/etc/hosts". Below is the windows screenshot

Then the jazz server will let us set up our public URI without restrictions. So fill the field with the value: https://rtclocaljazz.com:9443/jts

For the next steps, we can leave the default settings.

Database configuration, if you have some SQL Server, Oracle or DB2 that prefer to use, you can configure it here.

E-mail notifications. For now we'll leave it disabled.

Setup user registry. Here we can also leave the default option for the Jazz use tomcat's database.

For security reasons, Jazz recommends to you disable the ADMIN user, since it is a standard user. So you must create your user and check "Disable default ADMIN access" option.

For now do not choose any license. Later we'll add the free developers licenses.

Now let's set and register the Jazz application named "Change and Configuration Management." Click "Register Applications"

If all goes well, you see the following message.

The application public URI will be the same as the jazz server, only changing "jts" (Jazz team server) to "ccm" (change and configuration management). In this case: https://rtclocaljazz.com:9443/ccm

In database configuration, we can leave the default options

Finalize application setup.

After that, choose "Administer the Server"

Ok, it's almost done. Now we need to install the licenses on the server, remember that in our case we'll use the 10 free licenses that IBM provides to RTC Express Edition. Access server administration: https://rtclocaljazz.com:9443/jts/admin .

Choose the "Manage server" option via "Jazz Team Server - Server Administration", then navigate to option License Key Management

In the Client Access License Types box click "Add". In file dialog that appears click on "Choose File" (or "Browser" depending on your OS and browser)

Find and select the file "RTC_Developer-10-C.jar" (which was unzipped from licenses archive as mentioned in the first part of this article)

The jazz will recognize the file, then just click "Next."

Do not forget to edit the user you created and assign to him one of these 10 licenses free.

    Finally! Our server is fully functional. I advise you to create users, project areas, workitems, browse through the server options ... In other words, become familiar with Jazz Team Concert.

    After I finished this tutorial, I found an official Jazz Team video (http://jazz.net/library/video/552) about the same subject. Check it also:

    Next post will be about the necessary changes to configure the development environment. Probably the third part will be a video lesson, if I can solve minor problems with sound on my workstation. This third party should only be published in early January, so Happy New Year everyone!

    Leave your comments, critics, suggestions. Your feedback is very important to make me improve the material. Despite the fact that I'm relatively "old" in development world, I am entirely new in this area of articles, blogs and video lessons.

     Some spelling errors may occur. If you find any misspelled words, let me know.

Modified by EduardoBello

Feed for Blog Entries ▼

Blogs