If you have configured your license server to deny the anonymous user an Insight license, Insight will not start up correctly and users will not be able to log into Insight. In new Insight installations, this problem may not happen until the trial license expires.

When you have this problem, you will see errors like this one in your WAS SystemOut.log file:

00000060 licensing E CRREL1033E: User 'anonymous' cannot log on to the Rational Insight report server. The user is not authorized to access the report server web application.
com.ibm.rcl.ibmratl.LicenseUnknownException
User/host not on INCLUDE list for feature.
Feature: insight_user
License path: <port>@<license_server_host_name>:
FLEXnet Licensing error:-39,147
For further information, refer to the FLEXnet Licensing documentation,
available at "www.flexerasoftware.com".
at com.ibm.rcl.ibmratl.FLEXLicenseControl.checkoutName(Unknown Source)
at com.ibm.rcl.ibmratl.FLEXLicense.Out_Name(Unknown Source)
at com.ibm.rational.insight.licensing.InsightLicenseManager.validateInsightLicenses(InsightLicenseManager.java:167)
at com.ibm.rational.insight.servlet.DispatchServlet.initLicenseManager(DispatchServlet.java:130)
at com.ibm.rational.reporting.servlet.DispatchServlet.init(DispatchServlet.java:83)
at javax.servlet.GenericServlet.init(GenericServlet.java:161)
at com.cognos.pogo.transport.PogoServlet.init(PogoServlet.java:91)
at com.cognos.pogo.isolation.ServletWrapper.initServlet(ServletWrapper.java:147)
at com.cognos.pogo.isolation.ServletWrapper.init(ServletWrapper.java:109)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.init(ServletWrapper.java:342)
at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.init(ServletWrapperImpl.java:168)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.loadOnStartupCheck(ServletWrapper.java:1366)
at com.ibm.ws.webcontainer.webapp.WebApp.doLoadOnStartupActions(WebApp.java:617)
at com.ibm.ws.webcontainer.webapp.WebApp.commonInitializationFinally(WebApp.java:587)
at com.ibm.ws.webcontainer.webapp.WebAppImpl.initialize(WebAppImpl.java:425)
at com.ibm.ws.webcontainer.webapp.WebGroupImpl.addWebApplication(WebGroupImpl.java:88)
at com.ibm.ws.webcontainer.VirtualHostImpl.addWebApplication(VirtualHostImpl.java:169)
at com.ibm.ws.webcontainer.WSWebContainer.addWebApp(WSWebContainer.java:749)
at com.ibm.ws.webcontainer.WSWebContainer.addWebApplication(WSWebContainer.java:634)
at com.ibm.ws.webcontainer.component.WebContainerImpl.install(WebContainerImpl.java:426)
at com.ibm.ws.webcontainer.component.WebContainerImpl.start(WebContainerImpl.java:718)
at com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:1177)
at com.ibm.ws.runtime.component.DeployedApplicationImpl.fireDeployedObjectStart(DeployedApplicationImpl.java:1370)
at com.ibm.ws.runtime.component.DeployedModuleImpl.start(DeployedModuleImpl.java:639)
at com.ibm.ws.runtime.component.DeployedApplicationImpl.start(DeployedApplicationImpl.java:968)
at com.ibm.ws.runtime.component.ApplicationMgrImpl.startApplication(ApplicationMgrImpl.java:776)
at com.ibm.ws.runtime.component.ApplicationMgrImpl$5.run(ApplicationMgrImpl.java:2195)
at com.ibm.ws.security.auth.ContextManagerImpl.runAs(ContextManagerImpl.java:5474)
at com.ibm.ws.security.auth.ContextManagerImpl.runAsSystem(ContextManagerImpl.java:5600)
at com.ibm.ws.security.core.SecurityContext.runAsSystem(SecurityContext.java:255)
at com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:2200)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.start(CompositionUnitMgrImpl.java:389)
at com.ibm.ws.runtime.component.CompositionUnitImpl.start(CompositionUnitImpl.java:123)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.start(CompositionUnitMgrImpl.java:332)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.access$500(CompositionUnitMgrImpl.java:119)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl$CUInitializer.run(CompositionUnitMgrImpl.java:938)
at com.ibm.wsspi.runtime.component.WsComponentImpl$_AsynchInitializer.run(WsComponentImpl.java:502)
at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1864)

The errors correspond to the time when Rational Insight starts up.

In addition, you will see errors like this in the license server log:

(ibmratl) DENIED: "insight_user" anonymous@<insight_server_host_name>[#u#anonymous#u##s#<insight_server_host_name>#s#] (User/host not on INCLUDE list for feature. (-39,349))

You may also see errors like these:

00000060 licensing E CRREL1005E: The trial period for the report server has expired. Users cannot log on to the report server until this issue is resolved.
00000060 licensing E
com.ibm.rational.reporting.licensing.TrialExpiredError:
at com.ibm.rational.reporting.licensing.TrialLicenseManager.startTrial(TrialLicenseManager.java:211)
at com.ibm.rational.insight.licensing.InsightLicenseManager.validateInsightLicenses(InsightLicenseManager.java:207)
at com.ibm.rational.insight.servlet.DispatchServlet.initLicenseManager(DispatchServlet.java:130)
at com.ibm.rational.reporting.servlet.DispatchServlet.init(DispatchServlet.java:83)
at javax.servlet.GenericServlet.init(GenericServlet.java:161)
at com.cognos.pogo.transport.PogoServlet.init(PogoServlet.java:91)
at com.cognos.pogo.isolation.ServletWrapper.initServlet(ServletWrapper.java:147)
at com.cognos.pogo.isolation.ServletWrapper.init(ServletWrapper.java:109)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.init(ServletWrapper.java:342)
at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.init(ServletWrapperImpl.java:168)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.loadOnStartupCheck(ServletWrapper.java:1366)
at com.ibm.ws.webcontainer.webapp.WebApp.doLoadOnStartupActions(WebApp.java:617)
at com.ibm.ws.webcontainer.webapp.WebApp.commonInitializationFinally(WebApp.java:587)
at com.ibm.ws.webcontainer.webapp.WebAppImpl.initialize(WebAppImpl.java:425)
at com.ibm.ws.webcontainer.webapp.WebGroupImpl.addWebApplication(WebGroupImpl.java:88)
at com.ibm.ws.webcontainer.VirtualHostImpl.addWebApplication(VirtualHostImpl.java:169)
at com.ibm.ws.webcontainer.WSWebContainer.addWebApp(WSWebContainer.java:749)
at com.ibm.ws.webcontainer.WSWebContainer.addWebApplication(WSWebContainer.java:634)
at com.ibm.ws.webcontainer.component.WebContainerImpl.install(WebContainerImpl.java:426)
at com.ibm.ws.webcontainer.component.WebContainerImpl.start(WebContainerImpl.java:718)
at com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:1177)
at com.ibm.ws.runtime.component.DeployedApplicationImpl.fireDeployedObjectStart(DeployedApplicationImpl.java:1370)
at com.ibm.ws.runtime.component.DeployedModuleImpl.start(DeployedModuleImpl.java:639)
at com.ibm.ws.runtime.component.DeployedApplicationImpl.start(DeployedApplicationImpl.java:968)
at com.ibm.ws.runtime.component.ApplicationMgrImpl.startApplication(ApplicationMgrImpl.java:776)
at com.ibm.ws.runtime.component.ApplicationMgrImpl$5.run(ApplicationMgrImpl.java:2195)
at com.ibm.ws.security.auth.ContextManagerImpl.runAs(ContextManagerImpl.java:5474)
at com.ibm.ws.security.auth.ContextManagerImpl.runAsSystem(ContextManagerImpl.java:5600)
at com.ibm.ws.security.core.SecurityContext.runAsSystem(SecurityContext.java:255)
at com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:2200)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.start(CompositionUnitMgrImpl.java:389)
at com.ibm.ws.runtime.component.CompositionUnitImpl.start(CompositionUnitImpl.java:123)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.start(CompositionUnitMgrImpl.java:332)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.access$500(CompositionUnitMgrImpl.java:119)
at com.ibm.ws.runtime.component.CompositionUnitMgrImpl$CUInitializer.run(CompositionUnitMgrImpl.java:938)
at com.ibm.wsspi.runtime.component.WsComponentImpl$_AsynchInitializer.run(WsComponentImpl.java:502)
at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1864)

Insight requires an anonymous license during startup. To resolve this problem, you need to reconfigure your license server's options file so that the anonymous user can check out an Insight license. The license is checked out and immediately returned, so it will not impact users' ability to connect to Insight. You will need to restart your license server after updating the options file, and the change will take 12 hours to take effect.

Update 5/3/2016

The above applies to token licenses. If you are using named-user floating licenses (also known as authorized user licenses) and you follow the above steps, it will work but the license server won't let you list more users in the options file than the number of licenses you have -- so if you have X licenses and include anonymous in the options file, you can only list X-1 users, which does impact your users (unlike what happens with token licenses). This is due to a FlexLM limitation specific to authorized user licenses. With Insight, the anonymous user needs to be able to check out a license in order to start the report server, the anonymous user must be included in the options file. Thus, Sales needs to provide enough licenses to cover all the users purchased plus an additional license for the anonymous user. If you are running into this issue, please reach out to your sales rep.

If the Insight database is hosted on Oracle and the Insight Oracle user does not have the correct quota on the tablespaces in the Insight databases, the DCC web UI will show multiple symptoms as operations fail because the Insight database user cannot allocate an extent in the impacted tablespaces.

Common symptoms of this problem are:

The Data Collections Jobs status page no longer displays new entries.

The "Delete History" operation in the Data Collection Jobs status page fails with this error:

Error 500: CRRCD1500E An exception com.ibm.team.jfs.app.http.HttpPreconditionFailedException was caught in the class sun.reflect.NativeConstructorAccessorImpl from calling the function newInstance0.
Precondition Failed Error 412: CRJZS0220E The precondition given in one or more of the request-header fields evaluated to false when it was tested on the server.

Updates to settings in the Data Collection Jobs page fail with the error above.

You see errors like this in your application server logs:

ORA-01950: no privileges on tablespace 'ETLUSER'

Troubleshooting this issue

This problem generally happens when the Insight database user's quota on the tablespace referenced in the ORA-01950 error is 0 instead of -1 (unlimited). To determine whether you are having this problem, show each ORA-01950 error to your DBA and have your DBA verify that the IBM Rational Insight database user has the correct quota on the tablespace(s) referenced in the ORA-01950 error(s).

To fix the problem

To resolve this issue, the DBA needs to fix the tablespace allocation on each tablespace referenced in an ORA-01950 error -- the Insight database user's quota cannot be 0 (it is commonly -1, which means unlimited quota).

It may be that even though you successfully ran the Insight Setup tool to configure Insight, and the Setup tool had no problems connecting to the remote DB2 databases, neither Insight nor Cognos can connect to these databases.

If you have this problem, running an Insight report from Cognos Connection results in the error:

QE-DEF-0285
The logon failed

You may also see this error in cogserver.log:

Failure QE-DEF-0285 The logon failed.QE-DEF-0325 The logon failed for the following reason:RQP-DEF-0068 Unable to connect to at least one database during a multi-database attach to 1 database(s) in: RIDW UDA-SQL-0031 Unable to access the "RIDW" database. Check that the connection parameters to the database are configured correctly. For example, ensure that the data source connection contains the signon information, such as a password, to connect to the database.UDA-SQL-0107 A general exception has occurred during the operation "attach".

There are configuration problems that can prevent Insight from connecting to a remote DB2 database that won't impact Insight Setup because Setup tests the connection to the remote DB2 database via the JDBC thin driver, which is not impacted by configuration problems with operating system environment variables.

Things to check

If Insight is installed on a different server than DB2, find out whether the DB2 databases you cannot connect to from the Insight system were cataloged locally with the DB2 client (on the Insight system).

In addition, if you are using a 64-bit DB2 client on UNIX, please check your LD_LIBRARY_PATH environment variable to see if the 32-bit DB2 libraries are present.

To fix the problem

If using UNIX, and your system does not have the 32-bit IBM DB2 libraries in LD_LIBRARY_PATH, you should resolve this configuration issue as described in the DB2 considerations documentation.

Always providing the greatest content on IBM Rational products and concepts, the following not-to-miss items went live on developerWorks Rational this week:

New articles:

Quick start guide: Rational Team Concert and OSLCBy: Paulo Cavoto, IT specialist, IBMMost integration requirements can be met with OSLC services, thus avoiding complex customizations and reducing deployment time. In this article you will learn to authenticate, connect, retrieve, and store information in Rational Team Concert using Java.Product: IBM Rational Team Concert

Deploy IBM Rational Insight 1.1.1.2 for the enterpriseBy: Ali Manji, Software Developer, IBM If you are considering deploying an IBM Rational Insight in your large enterprise, read this article. Ali Manji takes you step-by-step through how to install Rational Insight components across three separate workstations.Product: IBM Rational Insight

Featured download:

IBM Rational InsightIBM Rational Insight delivers measurement best practices to help organizations reduce time to market, improve quality, and take greater control of software and systems development and delivery. It provides objective dashboards and measures for transparency and control into risks, status, and trends.

Our developers were busy over the Thanksgiving holiday week, working tirelessly to get you the fixes and updates you need! Here's the latest and greatest downloads which have gone live from Rational Support since November 13th.... and don't forget to check out the downloads tag to see the fixes you may have missed over the summer and early fall months:

Back to school has come and gone, and we're inching towards those important life choices we all must make soon: What to be for Halloween! I jest, of course, as a way to help divert your attention from the stresses of your kids' school work and woes, and hopefully help you focus back in on your own work and success... To that end, here are the articles, downloads, and truly great content that went live on developerWorks Rational last week:

Tackle the multichannel testing challengeBy Monica Luke, Lifecycle Scenario Architect, IBM, USAMobile and web-enabled applications bring new challenges to multichannel testing, or interleaving a single test scenario across several interfaces. It's becoming a requirement to move seamlessly from mobile to web and back again. Reviewing approaches that have worked in the past leads to a discussion about tackling the future.Product: Rational Functional Tester

Introduction to C++0x scoped enums and good usage patternsBy Wael Yehia, Software Developer, IBM, CanadaThe author describes all aspects of the new scoped enums from C++0x, the C++ standard, and provides examples and guidance for good usage patterns. Scoped enums can help you write more portable and more expressive code that can be forward declared, without any implicit conversions to aid type safety.Product: C/C++ Compilers

Invisible Thread blog: Keys to successful demand and delivery managementDemand and delivery management connects executives, managers, and development teams, so that everyone focuses on the same goals even amid continual change. This article offers five imperatives for an effective ALM approach that includes delivery management and lists essential ingredients for successful demand and delivery management.

We are pleased to feature Contributing Author Mark Lines

Mark Lines is Managing Partner at Scott W. Ambler + Associates. In 2012, Mark was awarded the IBM Champion designation for his work in the IBM community. He is an IT Process Consultant and Agile Coach. With Scott, he is co-author of Disciplined Agile Delivery: A Practitioner's Guide to Agile Software Delivery in the Enterprise (IBM Press, 2012). Mark writes for many publications and is a frequent speaker at industry conferences, including IBM Innovate. He delivers workshops on Disciplined Agile Delivery (DAD), as well as other agile topics. In his spare time, Mark likes to camp, golf, and ski in the Canadian Rockies. He can be reached at mark [at] scottwambler.com

Rational Programming Patterns for System z V8.5, which modernizes pattern-driven programming and enterprise-wide repository services for Pacbase developers within the Rational Software Delivery Platform, is now available for trial download on developerWorks: http://www.ibm.com/developerworks/downloads/r/rppz/

Not familiar with Rational Reporting for Development Intelligence (RRDI)? Have no fear, Michael Fox has a great article here outlining RRDI and covering what's new in version 2.0.... Now that you know what RRDI is and what it can do for you, time to move on to some demos walking you through RRDI from start to finish!

IBM Rational Reporting for Development Intelligence V2.0, Part 1: Overview and installation- This demo is the first of three showing a complete Rational Reporting for Development Intelligence (RRDI) 2.0 installation. This release contains many important new capabilities. One of these is a totally redesigned install/configure process intended to greatly simplify getting Rational Reporting for Development Intelligence up and running. This demo describes the new content in the 2.0 release, then proceeds to install the product. The second and third demos complete the process and demonstrate Rational Reporting for Development Intelligence in action.

Here's two new videos from IBM Rational Education and IBM Jazz covering different aspects of the CLM Money that Matters sample. Both of these should help you understand, configure, and run through the product lifecycle using the same CLM sample. You really won't want to miss these two!

IBM Rational RRDI and Insight: Modifying Cognos Data Sources, by Mike Fox- If you have a need to manipulate the Cognos data source RRDI reports use to access data, you must watch this demonstration. Perhaps you want to switch between reporting on a data warehouse loaded with CLM's Money That Matters sample data and another warehouse populated with real data (via Data Collection Jobs). This video shows you how to use Cognos Administration to modify the data source, change the credentials used to connect to the data warehouse, and create a new Cognos data source.

"Report authors can access the Collaborative Lifecycle Management (CLM) data warehouse via a Framework Manager (FM) model or access live data from the applications using reportable REST APIs. The application-based data dictionaries in this section show how elements in the FM model and in the REST API map to artifacts in CLM.

CLM includes a data warehouse, to which each of the CLM applications contribute data. The data dictionary topics in this section detail the relationship between application-specific data (physical data related to artifacts and other elements in CLM applications) and the related queries that need to be incorporated into a report so that the desired application data appears in the report ouput. When authoring reports, you can reference these mappings to determine which queries to use."

Tricks for deploying Rational Insight 1.0 in a large enterpriseBy: Ali Manji (amanji@ca.ibm.com), Software Developer, IBMIn deploying Rational Insight performance measurement software in a large enterprise, consider performance demands of running data-intensive reports on many different sources. Ali Manji explains ways to balance resources and how to install Version 1.0.1.1 in a distributed topology.Product: Rational Insight

Agile processes for the maintenance cycleBy: Moacyr Cardoso de Mello Filho (mcmello@br.ibm.com), Certified IT Specialist, IBMEveryone wants agility, yet most are still merely discussing it, says Moacyr Mello. In this essay, he explains why agile maintenance processes can transform how IT supports your business, improve software development performance, and lead to a smarter work cycle.

We are also pleased to feature Contributing Author Todd Dunnavant: Todd Dunnavant is a Principal Solution Architect in the Solution Delivery Assurance team of IBM Rational software. He is also the primary author of the Rational SOMA best practices for service solution design. For the past 14 years, his professional passion has been enabling Rational and IBM clients to improve their ability to deliver business-relevant software and system solutions. His current areas of interest are service-oriented systems and collaborative architecture management. When Todd isn't helping IBM's customers or otherwise engaging in professional activities, he indulges in exercises in futility by cheering for professional sports teams in the Houston, Texas area.

Using Rational Change and ClearCase together for changes and configurationBy Prajna Dutt (prajnadutt@in.ibm.com), Associate Software Engineer, IBM
By configuring the Rational Change for ClearCase Interface, you can use Rational Change and Rational ClearCase together for change and configuration management. Learn how these tools integrate to track implementation of change requests. (Requires intermediate-level knowledge of both tools.)
Products: IBM Rational Change, IBM Rational ClearCase

We are pleased to feature Contributing Author Jean-Louis Maréchaux

Jean-Louis Maréchaux is a Rational software engineer at the IBM Canada Lab, focusing on software architecture, Java EE technologies, service-oriented architecture (SOA), and agile software development practices. His involvement with software development projects began in 1997. He has been developing applications first, and then has been acting as a coding architect. As an IBM Rational field practitioner, Jean-Louis helped many customers define the best development environments for their collocated and distributed teams. He is now responsible for the development of training material for some of the IBM architecture, design, and development products and technologies. Jean-Louis is the author of several articles on technologies and practices. He also contributed to A Practical Guide to Distributed Scrum (IBM Press, 2010), and he started his Pragmatic Architecture blog in 2011 to share his thoughts on software engineering.

Following are the latest in downloads released by Rational over the past few weeks between December 2nd, 2011 and today (and check out the 'tags' above to find other downloads you may have also missed):

Millard Ellingsworth lives in the hills west of Portland, Oregon, where he works on the IBM Case Manager Client product, whacking widgets, doing Dojo, and trying to delight our customers with a UI worth using. During the small pockets of free time that leaves him, he divides his attention between home improvement projects, playing guitar, woodworking, and tinkering with Android development

Another great round of articles were recently published over on the jazz.net library. If you've not yet made your way over there, here's four great excuses to click the link and see what you've been missing!

CLM 2011 reporting workshopA major component of the CLM 2011 release is reporting. This workshop provides insight into key details of the reporting component, and helps you understand how to get started through a series of hands-on exercises.