unable to edit UI sketch (content generation error)

Hi Attila,

The problem you describe is with the viewing of graphical artifacts, not the ability to edit them. While this might seem to be a minor point, the significance is that viewing graphical artifacts is handled server side by the converter app whereas editing is performed client side using the browser add-on.

So, the key thing to check in this case is actually the state of the converter on the server and not anything related to the client. The most common cause for the error you are encountering is the inability of the server to service graphical requests from the converter app. This typically happens on Linux platforms that have been configured to be headless (console-mode only). If this is your situation, you may find the following technote useful. What you'll need to do is install Xvfb and export DISPLAY to handle the graphics requests. If this does not describe your server configuration, please provide some additional details about your server, and we'll help get the issue resolved for you.

https://www-304.ibm.com/support/docview.wss?q1=RN2.0.0.1&rs=3499&uid=swg21410023&cs=utf-8&lang=en&loc=en_US

Hi Stef,

Thanks a lot for your help, this was indeed the problem (headless linux server). Following instructions in referenced technote solved our problem, so now we can start evaluate RRC functionality :)

Best regards,
Attila

Unfortunately there are more errors.. UI Sketch viewing and editing is working now, but I tried to open a Business Process Diagram (JKE Requirements Process Overview from MTM sample), and I have this error in catalina.out:

2011-08-01 14:11:28,781 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I << HTTP/1.1 500 Internal Server Error

2011-08-01 14:11:28,782 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I << [Timing] 2629ms

2011-08-01 14:11:28,782 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>] GET https://jazz-test.qsoft:9443/rm/converterproxy?resourceURL=https%3A%2F%2Fjazz-test.qsoft%3A9443%2Frm%2Fresources%2F_aYx3kLnZEeC3zKVH7UIkfQ&contentType=https%3A%2F%2Fjazz-test.qsoft%3A9443%2Frm%2Ftypes%2F_SB66VbnZEeC3zKVH7UIkfQ%23BusinessProcessDiagram&revision=_euFq8bnZEeC3zKVH7UIkfQ&dojo.preventCache=1312200685817 HTTP/1.1

2011-08-01 14:11:28,783 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      host: jazz-test.qsoft:9443

2011-08-01 14:11:28,783 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      user-agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.19) Gecko/20110707 Firefox/3.6.19

2011-08-01 14:11:28,783 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      accept: none

2011-08-01 14:11:28,783 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      accept-language: en-us,hu-hu;q=0.8,hu;q=0.5,en;q=0.3

2011-08-01 14:11:28,784 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      accept-encoding: gzip,deflate

2011-08-01 14:11:28,784 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      accept-charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7

2011-08-01 14:11:28,784 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      keep-alive: 115

2011-08-01 14:11:28,785 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      connection: keep-alive

2011-08-01 14:11:28,785 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      x-com-ibm-rdm-request-correlation-id: RRC_WEBUI_0.3237151222805079

2011-08-01 14:11:28,785 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      doorsrp-request-type: private

2011-08-01 14:11:28,786 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      content-type: text/plain

2011-08-01 14:11:28,786 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      x-requested-with: XMLHttpRequest

2011-08-01 14:11:28,786 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      referer: https://jazz-test.qsoft:9443/rm/web

2011-08-01 14:11:28,786 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<Request>>]      cookie: https://jazz-test.qsoft:9443/jts/process/project-areas/_R6Z9ErnZEeC3zKVH7UIkfQ_0_filterStateCookie=0001; com.ibm.rdm.web.server.client.utils.ResourceUtil._artifactTemplateCookie2https://jazz-test.qsoft:9443/jts/process/project-areas/_R6Z9ErnZEeC3zKVH7UIkfQ=; JazzFormAuth=Form; https://jazz-test.qsoft:9443/jts/process/project-areas/_R6Z9ErnZEeC3zKVH7UIkfQ_4_filterStateCookie=001; X-Last-Modified-XSD=2011-08-01T11%3A50%3A01.899Z; SaveStateCookie=https%3A%2F%2Fjazz-test.qsoft%3A9443%2Frm%2Ffolders%2F_ZoRAornZEeC3zKVH7UIkfQ; jfs-oauth-realm-mapping=https%3A%2F%2Fjazz-test.qsoft%3A9443%2Fjts%3D0; JSESSIONIDSSO=F212DFEF6550F95504A7ADEA29FED47B

2011-08-01 14:11:28,787 RRC [http-9443-Processor17] ERROR dm.fronting.server.headers.services.ConverterProxy  - CRRRS4120I <<      <no>

2011-08-01 14:11:28,788 RRC [http-9443-Processor17] ERROR m.fronting.server.response.services.ConverterProxy  - CRRRS4120I << ---No entity-

Maybe it's related, but I see this also at the beginning of the log:

Xlib:  extension "RANDR" missing on display "localhost:1.0"

However, when I click Edit, I can see and edit the whole process.

This installation uses openSUSE 11.4, with RTC/RRC/RQM 3.0.1, Derby for DB and Tomcat for app server (test setup).

Thanks,
Attila

Unfortunately there are more errors.. UI Sketch viewing and editing is working now, but I tried to open a Business Process Diagram (JKE Requirements Process Overview from MTM sample), and I have this error in catalina.out:
{snip}

Maybe it's related, but I see this also at the beginning of the log:

Xlib:  extension "RANDR" missing on display "localhost:1.0"

However, when I click Edit, I can see and edit the whole process.

This installation uses openSUSE 11.4, with RTC/RRC/RQM 3.0.1, Derby for DB and Tomcat for app server (test setup).

Thanks,
Attila

It sounds like there may be some other modules missing from your linux configuration, so the trick is figuring out which ones.
As a really simple first check, I would look to see if you have these installed. Note that you didn't mention whether this is a 32 or 64-bit server, so the location may vary between /usr/lib or usr/lib64 as it is on my RHEL server or someplace yet again different since I'm not familiar with the organization of openSUSE. Some of the version info may defer as well.

libXtst.so.6
libstdc++.so.5 (it's important to have .5, .6 will not work)

A slightly more involved check (assuming the above two are present) is to extract libswt-pi-gtk-3557.so from the appropriate jar below (again, depending on whether you are 32 or 64-bit):

org.eclipse.swt.gtk.linux.x86_3.5.2.v3557f.jar
org.eclipse.swt.gtk.linux.x86_64_3.5.2.v3557f.jar

You would find these jars in a location like the following (again, your location may vary):

/opt/IBM/JazzTeamServer/server/tomcat/webapps/converter/WEB-INF/eclipse/plugins

Once you have the .so file extracted, execute:

ldd libswt-pi-gtk-3557.so

and see if it reports any missing dependencies.

It sounds like there may be some other modules missing from your linux configuration, so the trick is figuring out which ones.
As a really simple first check, I would look to see if you have these installed. Note that you didn't mention whether this is a 32 or 64-bit server, so the location may vary between /usr/lib or usr/lib64 as it is on my RHEL server or someplace yet again different since I'm not familiar with the organization of openSUSE. Some of the version info may defer as well.

libXtst.so.6
libstdc++.so.5 (it's important to have .5, .6 will not work)

We have an x64 installation, and usr/lib64/libstdc++.so.5 was missing, only libstdc++.so.6 was present. I installed missing libstdc++ and now everything seems to work fine (unfortunately today I don't have too much time to test it, but all types of content I could find was generated properly).

Nevertheless I ran ldd libswt-pi-gtk-3557.so and found one missing dependecy, linux-vdso.so.1:

        linux-vdso.so.1 =>  (0x00007fff581d7000)

        libgtk-x11-2.0.so.0 => /usr/lib64/libgtk-x11-2.0.so.0 (0x00007feff6f8a000)

        libgthread-2.0.so.0 => /lib64/libgthread-2.0.so.0 (0x00007feff6d85000)

        libXtst.so.6 => /usr/lib64/libXtst.so.6 (0x00007feff6b7d000)

        libc.so.6 => /lib64/libc.so.6 (0x00007feff6810000)

        libgdk-x11-2.0.so.0 => /usr/lib64/libgdk-x11-2.0.so.0 (0x00007feff655b000)

        libpangocairo-1.0.so.0 => /usr/lib64/libpangocairo-1.0.so.0 (0x00007feff634d000)

        libX11.so.6 => /usr/lib64/libX11.so.6 (0x00007feff600a000)

        libXfixes.so.3 => /usr/lib64/libXfixes.so.3 (0x00007feff5e04000)

        libatk-1.0.so.0 => /usr/lib64/libatk-1.0.so.0 (0x00007feff5be1000)

        libcairo.so.2 => /usr/lib64/libcairo.so.2 (0x00007feff5929000)

        libgdk_pixbuf-2.0.so.0 => /usr/lib64/libgdk_pixbuf-2.0.so.0 (0x00007feff570a000)

        libm.so.6 => /lib64/libm.so.6 (0x00007feff54b2000)

        libgio-2.0.so.0 => /lib64/libgio-2.0.so.0 (0x00007feff5184000)

        libpangoft2-1.0.so.0 => /usr/lib64/libpangoft2-1.0.so.0 (0x00007feff4f57000)

        libpango-1.0.so.0 => /usr/lib64/libpango-1.0.so.0 (0x00007feff4d0a000)

        libfontconfig.so.1 => /usr/lib64/libfontconfig.so.1 (0x00007feff4ad3000)

        libgobject-2.0.so.0 => /lib64/libgobject-2.0.so.0 (0x00007feff4882000)

        libgmodule-2.0.so.0 => /lib64/libgmodule-2.0.so.0 (0x00007feff467d000)

        libglib-2.0.so.0 => /lib64/libglib-2.0.so.0 (0x00007feff438b000)

        libpthread.so.0 => /lib64/libpthread.so.0 (0x00007feff416e000)

        librt.so.1 => /lib64/librt.so.1 (0x00007feff3f64000)

        libXext.so.6 => /usr/lib64/libXext.so.6 (0x00007feff3d51000)

        /lib64/ld-linux-x86-64.so.2 (0x00007feff7750000)

        libXrender.so.1 => /usr/lib64/libXrender.so.1 (0x00007feff3b46000)

        libXinerama.so.1 => /usr/lib64/libXinerama.so.1 (0x00007feff3942000)

        libXi.so.6 => /usr/lib64/libXi.so.6 (0x00007feff3732000)

        libXrandr.so.2 => /usr/lib64/libXrandr.so.2 (0x00007feff3529000)

        libXcursor.so.1 => /usr/lib64/libXcursor.so.1 (0x00007feff331d000)

        libXcomposite.so.1 => /usr/lib64/libXcomposite.so.1 (0x00007feff311a000)

        libXdamage.so.1 => /usr/lib64/libXdamage.so.1 (0x00007feff2f17000)

        libfreetype.so.6 => /usr/lib64/libfreetype.so.6 (0x00007feff2c8c000)

        libxcb.so.1 => /usr/lib64/libxcb.so.1 (0x00007feff2a6f000)

        libdl.so.2 => /lib64/libdl.so.2 (0x00007feff286b000)

        libpixman-1.so.0 => /usr/lib64/libpixman-1.so.0 (0x00007feff25fb000)

        libpng14.so.14 => /usr/lib64/libpng14.so.14 (0x00007feff23d1000)

        libz.so.1 => /lib64/libz.so.1 (0x00007feff21b9000)

        libresolv.so.2 => /lib64/libresolv.so.2 (0x00007feff1fa1000)

        libselinux.so.1 => /lib64/libselinux.so.1 (0x00007feff1d82000)

        libexpat.so.1 => /lib64/libexpat.so.1 (0x00007feff1b58000)

        libpcre.so.0 => /lib64/libpcre.so.0 (0x00007feff1921000)

        libXau.so.6 => /usr/lib64/libXau.so.6 (0x00007feff171d000)

I noticed more .so files in org.eclipse.swt.gtk.linux.x86_64_3.5.2.v3557f.jar, should I check those files with ldd as well?

Also, can you point me to a documentation about these prerequisites for RRC? Just in case something is still missing, I'd like to find it out before starting evaluation and have users complaining. Btw I still see 'Xlib: extension "RANDR" missing on display "localhost:1.0"' in catalina.out, can it cause problems in the future?

Thanks for your help once again.

Best regards,
Attila

Hi Attila,

Congrats! I think you're all good.

No need to worry about linux-vdso.so.1. What you were really looking for are any entries that would have said "not found".

I believe the compatibility library for libstdc++ was the ticket. Apparently the .6 version doesn't play nice with the JRE and causes problems within AWT. We only recently stumbled across this issue, and in our investigation, found this IBM Support document (and a couple of others like it):
https://www-304.ibm.com/support/docview.wss?uid=swg21297575

Unfortunately it seems some linux installations will have .5 installed while others just have .6, so it's on our "hit list" of things to check for when people encounter a problem with the converter.

The only thing we've really documented as a "pre-req" is from the original technote I provided about installing Xvfb. After that, it get's into odd cases such as the one you just encountered, or I've seen cases where some systems didn't have libXtst (which in your case was there). I did put together a slide for our support team of some commons things to check when having issues with the converter, and I could look into publishing that on jazz.net, but I find it's typically best that we interact with users directly to identify these problems. For example, I also have scripts/class files that test the basic ability of SWT and AWT to be run on the server. The latter would likely have detected your problem. But these require some manual tweaking based on your installation.

At this point, what I can say is you need this:
- Gtk+ 2.2.1 and it's dependencies
- compat-libstdc++
- libXtst.so.6
- Xvfb (if not running a desktop like Gnome) and export DISPLAY (per the prior technote)

But it seems we always find something else as no two linux servers ever seem to be alike. ;)

Hi Stef,

Oh yes, the wonders of different flavours and installations of Linux systems :) Since our production server is an exact copy of this test server, I think we won't have any problem with installing and using RRC if we decide to use it (we already use RTC for almost two years).

Thanks for your help and the detailed explanation!

Best regards,
Attila

Hi - I'm getting the following msg when attempting to access a User interface sketch artifact in RRC 3.0.1:

The requested content could not be generated.
ID CRRRW8010E A server error prevented the generation of the content. Refresh your browser to generate the content again. If the problem persists, there might be an issue with the server. Ask your administrator to check the server status.

I'm using FF 3.6.21 version - tried to get the RRCBrowserAddOn but couldn't find any.

Can you please advise on what to do to get the Artifact content displayed properly?

Thanks!

Hi Maria,

Unfortunately a number of underlying issues can result in that particular error message. The bottom line is that the converter application running on the server is not able to provide a graphical rendering of your artifact. This is totally unrelated to the RRCBrowserAddOn which is used strictly for the purposes of editing such artifacts.

In order to assist you with this problem, please provide some details about the server you are using. The most common cause of this issue is that the server is a linux-based, headless (console mode) configuration that does not have the necessary graphical components to serve up the rendering and can typically be resolved following the steps from this technote:
https://www-304.ibm.com/support/docview.wss?q1=RN2.0.0.1&rs=3499&uid=swg21410023&cs=utf-8&lang=en&loc=en_US

The technote was originally written for the 2.x release but the principle still applies in 3.0.1. But as I said, there are several issues that can lead to this error and the technote may just be the first step in resolving it.

Hi,

I uninstalled FF version 3.6.21 and installed FF version 3.6.18 - still facing the same error.