SUPPORT NOTIFICATION for non-browser TRIRIGA clients such as CAD Integrator, BIM, and Microsoft Outlook add-in
JeffLong 270005B0Q4 Visits (10742)
IBM TRIRIGA does not support SAML (Security Assertion Markup Language) or credential-less login mechanisms such as SmartCard or CAC (Common Access Card) as a method of authentication for its non-browser clients such as CAD Integrator, BIM, and the Microsoft Outlook add-in.
SSO solutions need to provide a mechanism for basic authentication as per the documentation in the "Requirements for single sign-on requests in the TRIRIGA Application Platform" for non-browser clients. SAML and SmartCard or CAC do not support basic authentication for non-browser based clients.
The best practice if using SAML or SmartCard/CAC, is to authenticate directly to Tririga on a separate process server or integration server as opposed to the SSO enabled application server. (NOTE: These users will need to know thier Tririga user name and password to sign in using this solution.)
An alternative best practice would be to set up a separate non-SAML SSO solution for non-browser client users which can support basic or NTLM authentication. (NOTE: SmartCard/CAC users would need to know their SmartCard/CAC user name and password to sign in using this solution.)
There you are, planning an application and platform upgrade for your IBM TRIRIGA installation and you think everything is working just fine. You roll out to production and for the first few days afterwards, all is quiet. Suddenly, out of the blue, you notice that the floor plan graphics no long render. Where the graphics should appear, you do not see the No Graphic Available message where the graphic used to appear. What you do notice is that, in the lower right hand corner "Error 2" is displayed and the rest of the space where the graphic would normally appear is blank. This blog post will address one of the potential causes of this problem and also a means of finding the problem before you upgrade your production environment.
In order to determine the root cause, we need to know what the errors are that are referenced in that "Error 2" text in the graphics section. Clicking on the text will open a pop-up box that contains the actual error messages (2, hence the "Error 2") related to the issue. That alone will not help the support team diagnose the problem. The errors should indicate an MID number. That MID number should also be found in the server log with a time stamp associated with when the graphic should have been rendered. In a issue I was working for a client, we determined from that information that there was a problem with the graphic layer configuration records. In particular, they were missing their corresponding IBS_SPEC entries. This required removing the records from the database using SQL run against the database back end. The application is unable to delete the records because the application relies heavily on the IBS_SPEC table entries to perform the actions necessary to delete the records. Once the records were removed and the layer configuration records rebuilt, the graphics once again started to display.
Great, that fixed the immediate problem, but how do you prevent this from happening in the future? When planning your upgrade, you need to insure that all graphical functionality is tested before making the decision to roll the upgrade out to your production environment. Upgrade plans should always include CAD Integrator testing. In older releases of the IBM CAD Integrator tool and the IBM TRIRIGA Platform, there was a great deal of backward compatibility. As a result of this backward compatibility, most clients did not include steps to insure that graphical elements were unaffected and, instead, focused on the business process logic to insure that the non-graphical data was correct. With the later releases of IBM TRIRIGA (3.3 or later, to be more precise) the CAD Integrator tool became much more tightly coupled with the platform release. Best practice for upgrade planning should now include upgrading the CAD Integrator tool to the release that was created specifically for the platform release to which you are upgrading. As a result of adding the CAD Integrator to your upgrade plans, you should naturally expect to add more time to the validation of all CAD related graphics that appear in your IBM TRIRIGA instance.
If you found this blog post useful, be sure to 'like' the post. If you have any comments about this blog, please provide that feedback in the comments section.
Chris K 270004Y3TR Visits (9407)
After installing CAD Integrator on a CAD users machine and assigning the appropriate security groups and licenses, does the user get an error indicating that they do not have a valid CAD Integrator license? Do not panic! This blog is meant especially for you.
The likely cause of the problem is that a problem occurred during the license assignment process. First, double check that the users profile contains the license. If it is missing there, be sure to add it. Second, go to License Manager and click on the radio button next to IBM TRIRIGA CAD Inte
Chris K 270004Y3TR Visits (10036)
Have you upgraded your IBM TRIRIGA platform only to find that you cannot see any of the graphics that were visible in your previous platform release. If so, you may want to reprocess your drawings.Please note that reprocessing your drawings can take some time, so you might want to plan this process to run during off peak hours.
To reprocess your drawings, follow these steps.
1 - As an application administrator, login to the IBM TRIRIGA Admin Console.
2 - Click on the radio button next to Database Manager
3 - Click on the link titled "Reprocess published drawings".
Under certain conditions, the reprocessing of your CAD drawings may have encountered issues during the upgrade process. It is important to always review the server log file from the 1st server startup after an upgrade. In the case of your drawings, look for "Reprocessing" in the log file. Most of the entries after that line will contain information about the reprocessing of each individual drawing. If a drawing is processed without issue, you should see a series of 7 informational messages starting with "DXF: Processing Header "to "DXF: EOF" if there is a problem during the reprocessing process, you will likely see either an error or warning message between those two informational messages. If that is the case, you will want to follow the steps outlined above once the upgrade processing has completed on that 1st server.