Notes from Rational Support

Matching: how-to

NT LAN Manager version 2 (NTLM v2) Authentication failed in IBM Rational Performance Tester

Soumya Y Shanthimohan Tags: how-to rational-client-support technotes rational rational-performance-test... ‎ 2 Comments ‎ 7,866 Views

If you encounter the NT LAN Manager version 2 (NTLM v2) "Authentication failed" error in IBM Rational Performance Tester, you can follow the steps in the below technote to set up NTLM v2 in RPT:

http://www.ibm.com/support/docview.wss?uid=swg27036836

Along with the steps in the technote above, also make sure that the 'Host' field contains the System name and the 'Doman' field contains the domain name, as seen in the attached screen-shot -

Modified on by AcdntlPoet

Is it possible to import workitems by e-mail in Rational Team Concert?

Sumant Renukarya Tags: rational-client-support work-around rational how-to rfe import email rational-team-concert ‎ 2 Comments ‎ 8,699 Views

There have been few queries from clients asking if it is possible to import work items by e-mail into IBM Rational Team Concert. This is a somewhat complex topic as it isn't currently supported, but there is a potential work around. Let's take a look at the information:

A. There are the following properties in Advanced Properties page of the CCM application in RTC:

****
com.ibm.team.workitem.service.internal.importer.MailPollingTask
com.ibm.team.workitem.service.internal.importer.MailReceiverService
****

Online Help for this says: "A periodic task runs on the server that checks for mail received for work item creation. This property specifies the time in seconds between runs of this task."

B. Here is a brief on this feature from Jazz.net wiki: https://jazz.net/wiki/bin/view/Main/WorkItemEmailImport
However, as the link says, it's still in experimental stage and not supported, at least as of the RTC 4.0.3 version. This should perhaps be implemented in one of the future releases.

C. However, there has been an RFE on this already and you might want to add a comment here with your additional business justification. The details, along with a business justification should add more weight to this RFE.
--> Existing RFE on this: https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/268694

I hope this note adds to the links above on this topic.

Modified on by AcdntlPoet

Rational Team Concert 2.0 communication with Rational Quality Manager and Rational Requirements Composer 3.0

Sumant Renukarya Tags: rational unsupported rational-requirements-com... rational-quality-manager rational-client-support rational-team-concert how-to ‎ 2 Comments ‎ 7,298 Views

I started working as a Technical Support Engineer, initially on Telelogic Synergy/Change products, later on IBM Rational ClearCase for the past couple of years, and lately with IBM Rational CLM (Collaborative Lifecycle Management) solutions.

Unlike with Telelogic Synergy or IBM Rational ClearCase, issues with CLM are so diverse, with less repetition of similar questions or difficulties. Here is one of the many interesting issues with CLM that I happened to work on.

The Environment:
Rational Team Concert (RTC) 2.0.0.2 server running on JFS 1.0.0.1 on server machine 'A'.
Rational Quality Manager (RQM) / Rational Requirements Composer (RRC) 3.0.1.5 running on JTS 3.0.1.5 on server machine 'B'.

Each having their own database servers, running on their respective server machines.

Issue:
The client was looking to integrate RTC 2.0.0.2 with RQM 3.0.1.5 so that users can raise defects from RQM 3.0.1.5, which in turn is a Work Item in RTC 2.0.0.2. So they tried to establish friend relationship at RQM 3.0.1.5 server but were unable to establish communication as outlined in this help topic:
http://pic.dhe.ibm.com/infocenter/clmhelp/v3r0m1/index.jsp?topic=%2Fcom.ibm.jazz.repository.web.admin.doc%2Ftopics%2Ftservertoserverconfig.html

They were able to successfully register RQM 3.0.1.5 application on the RTC 2.0.0.2 server, however, trying to register RTC 2.0.0.2 on RQM 3.0.1.5 server failed with the following error:

**********
CRJAZ2082E : An error occurred while attempting to access the Application
About service listed in the Discovery document for this application.
Please ensure that the application has been installed and provisioned correctly.
Unsupported RDFEntity Content-Type: text/html
com.ibm.team.repository.common.TeamRepositoryException
com.ibm.team.repository.service.internal.discovery.FriendsAdminRestService.executeHttpRequest (FriendsAdminRestService.java:795)
com.ibm.team.repository.service.internal.discovery.FriendsAdminRestService.getDiscoveryDocumentModel (FriendsAdminRestService.java:779)
com.ibm.team.repository.service.internal.discovery.FriendsAdminRestService.getAboutServiceContent (FriendsAdminRestService.java:965)
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:79)
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
java.lang.reflect.Method.invoke(Method.java:619)
org.eclipse.soda.sat.core.internal.record.ExportProxyServiceRecord.invoke(ExportProxyServiceRecord.java:370)
org.eclipse.soda.sat.core.internal.record.ExportProxyServiceRecord.access$0(ExportProxyServiceRecord.java:356)
org.eclipse.soda.sat.core.internal.record.ExportProxyServiceRecord$ExportedServiceInvocationHandler.invoke(ExportProxyServiceRecord.java:56)
$Proxy192.getAboutServiceContent(Unknown Source)
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
sun.reflect.NativeMethodAccessorImpl.invoke
**********

Steps taken:
--> They were in a situation where they did not have the option to upgrade from RTC 2.0.0.2 to RTC 3.0.1.5, due to IT and resource constraints. But they did want to get these products to work and roll out to users. Trying to register RTC 2.0.0.2 at RQM 3.0.1.5 server always failed with the errors as above.

--> Based on the error and configuration, we informed the customer that it is an unsupported scenario. With RTC 3.0 or 2.0.0.2 the integration for RQM, RQM must be 2.0.1 or 2.0.0.1. This was not the case in their set-up and hence would not work.

https://jazz.net/library/article/304/

However, they had a concern in why there were able to link RQM 3.0.1.5 in RTC 2.0.0.2 server, whereas the reverse did not work. They were in a strange scenario, where the lower version (RTC) linked correctly to the higher (RQM), while the opposite did not happen. We understood in Support, that the combination they had is not supported and should not work.

However, the solution for their problem was to delete the existing server friend relationship between RTC 2.0.0.2 and RQM 3.0.1.5 at RQM 3.0.1.5 server and redefine them. This made the integration work and they were able to see the RQM Projects areas from RTC and the RTC project areas from RQM. They were then able to open defects from RQM to RTC.

While I haven't been able to reflect upon why the specific setup did or did not work here, I thought it's worth a time to write a note on this behavior and note the steps we saw achieve some success in this unsupported configuration.

I welcome any comments or suggestions on this article.

Author: SumantRenukarya

Modified on by AcdntlPoet

Rational Purify Plus Licensing Solutions

Saurabh.Tyagi Tags: rational-purifyplus how-to flexnet rational error licensing rational-client-support ‎ 2 Comments ‎ 12,266 Views

Lets discuss a dynamic software analysis tool which is designed to help the developers write more reliable code: IBM Rational Purify Plus. It is now known as an advanced memory error detection tool that helps you accurately find hard-to-debug memory corruption errors. You need to fine-tune your application by using Purify, and when you run the tuned application, Purify scrutinizes every memory access and reports any corruption error before it occurs.

Purify is a very useful tool throughout the software development lifecycle. Developers can use it to ensure that the new code that they have written is not going to inadvertently cause any memory corruption errors or leaks. It includes capabilities like:

Memory debugging- pinpoints hard to find memory errors such as un-initialized memory access, buffer overflow and improper freeing of memory,
Memory leak detection- identifies memory blocks that no longer have a valid pointer. Purify is supported on Windows, Linux, Solaris, and AIX,
Performance profiling- highlights application performance bottlenecks and improves application understanding with a graphical representation of function calls, and
Code coverage- identifies untested code with line-level precision.

Now, by looking at this crisp description some of us would really want to try this software, its functionality, and capabilities Below is the link for those who have a feeling that this would be of great help to his/her organisation and can help developers in many ways.
Evaluate the Product and share your thoughts- Rational PurifyPlus: http://www.ibm.com/developerworks/downloads/r/rpp/

In order to use and evaluate the product, or even in your production environment, to run any rational product you would need a license file which will be the key to success. In simple words, to run this dynamic software analysis tool we need a license, the license could be of your choice, for the type of license please see the earlier blog post: Licenses types and their functionality

By using the license file and the setup in order to serve the license we can launch the product. This seems to be easy and yes it is, if we do not consider external factors like network, correct license file, server settings, client settings etc, which is not possible, and we run into issues. These issues are simple if we do things right the first time and do it right all the time.

There would be many instances where you have thought that when everything is in place and we have valid licenses which are imported using the license server as recommended, then what could be the possible cause of the error?

Considering the fact that everything is done correctly and there is a very little room for error, I have done some research on it, and here are my findings: Errors specifically (licensing errors) related to PurifyPlus revolve around few settings. I will talk about them one by one in detail in order to get clear picture of what can be done to eliminate these kind of errors and save time,

One among the most common error is FLEXnet Licensing error:-18,147, License checkout failure while using Purify, Quantify or PureCoverage components of DevelopmentStudio UNIX,
Full Error will be like : Purify engine: Error: License checkout failure: License server does not support this feature, FLEXlm error: -18,147.

There could be couple or reasons for this specific error to occur:

1). First among them is due to the environment settings not being configured correctly. Confirm the following environment settings are set as shown:

RSU_LICENSE_MAP=//config/License_Map
LM_LICENSE_FILE=@

If your configuration differs from the above, you can manually set the above settings by doing:
setenv RSU_LICENSE_MAP //config/License_Map
setenv LM_LICENSE_FILE @

You can now test the license by using the option -testlicense : %purify -testlicense

If you are still getting license errors, copy the License_Map file to the .Rational directory under the user's home directory
%cp /config/License_Map /$HOME/.Rational/ And test the license once again.

If this does not resolve the error we should move on to the second possibility which could cause tis error:

2 ). It is possible to set up a mixed environment where the same license server manages licenses for both a suite product and individual point products.

In this situation, license usage order can be customized by modifying the settings in the License_Map file on a per-component-product basis. For example, when a user starts an application, such as IBM Rational Rose, you can define whether that user claims a Rational Rose license or a Rational Suite license.

Fore more details on How to configure a Rational license for a UNIX system using the license map file, Please see the following link: http://www.ibm.com/support/docview.wss?uid=swg21120664

3). Now that we have done all other checks and made sure that the License Usage is correctly set and environment variables are fine, you may still find that whenever an attempt is made to launch IBM Rational PurifyPlus it results in the error “FLEXnet Licensing error:-18,147”, or specifically for a Windows server "Unable to connect to your license server" (please note this is only applicable when the License server is Windows Server and client is a UNIX machine).

The issue could be with the incorrect license file in use, which means that Rational PurifyPlus for Windows Authorized User license key has been imported.
This issue may happen when Rational PurifyPlus for Microsoft Windows has been generated, Let me explain...
See the license keys below:
License key name
IBM Rational PurifyPlus for Linux Floating License Key
IBM Rational PurifyPlus for Linux and UNIX Floating License Key
IBM Rational PurifyPlus for Windows Floating License Key

If you have a Windows license server and a LINUX or UNIX client then the license key needs to be generated should be : "IBM Rational PurifyPlus for Linux and UNIX Floating License Key"
If you have a Windows license server and a Windows client then the license you would need should be: "IBM Rational PurifyPlus for Windows Floating License Key"

The error “ FLEXnet Licensing error:-18,147” should no longer persist, if we have these things in place. Also, these should be followed as the best practice while using the software in order to minimize these kind of errors and increase performance and durability of the product we ( IBM ) is developing for you.

Related Links:
Launch of Rational PurifyPlus on Windows Server 2008 result in license error:
http://www.ibm.com/support/docview.wss?uid=swg21591482

Installing Rational PurifyPlus result in Flexlm -15 error :
http://www.ibm.com/support/docview.wss?uid=swg21587202

Launch of Rational PurifyPlus on Windows 7 results in license error :
http://www.ibm.com/support/docview.wss?uid=swg21595509

License Usage Mapper does not retain settings :
http://www.ibm.com/support/docview.wss?uid=swg21263952

image credit: (cc) Some rights reserved by Phil and Pam

Author: Saurabh Tyagi

Moving the work items to a different repository with history in RTC

Sumant Renukarya Tags: work-items how-to rational-team-concert rational-client-support rational ‎ 1 Comment ‎ 12,374 Views

One of the users using IBM Rational Team Concert (RTC) 4.0.1 were planning to move some work items to a different repository.

To do this, they were considering the following options along with some requirements:

a. Move the work items, preserving workitem ID and if possible history also.

b. Export workitems to CSV file and then import it into other repository.

Here is the information that should help users with similar queries:

One can move the work items to a different project area, only in the same repository. This, using the move functionality for the Work Items. Even with this, it is not possible to retain the work item ID and the history.
Users can export the work item and import the work items into other repository, but any references to the exported work item will continue to reference to work item in the original repository and not its copy in the other repository.

So those references would break if the work item is moved.

Even the export/import does not include the history of the work item.
How to include the history of the work item during the export is something which is not resolved yet, at least in RTC 4.0.1 version. This can be tracked in the following jazz.net work item: https://jazz.net/jazz/web/projects/Rational%20Team%20Concert#action=com.ibm.team.workitem.viewWorkItem&id=163729

Modified on by AcdntlPoet

Feed for Blog Entries

Blogs