IBM Support

"Could not create the view: !Could not create controller of type..." / "Failed to launch! ... java.lang.NullPointerException" launching Java-related functionality, caused by invalid 'CCR_JAVA_Home' variable

Troubleshooting


Problem

User tries to launch any JAVA-related menu item (for example "Command Center"). User receives error. All users affected.

Symptom

The error will vary depending on what menu item is launched:
Example #1 - Command Center (Controller 10.1.1)
Could not create the view: !Could not create controller of type com.ibm.cognos.ccr.integration.internal.c4.ui.ControlBoardDialogController for composite class com.ibm.cognos.ccr.integration.internal.c4.ui.ControlBoardDialogUI!

[Details]
java.lang.reflect.InvocationTargetException
at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
at..................

Example #2 - Maintain - system Audit Log - Browse (Controller 10.1.1)
Multiple problems have occurred
Something unexpected happened. You may have to restart the application to continue.
Unexpected Error
Unhandled event loop exception

Stacktrace:
org.eclipse.swt.SWTException: Failed to execute runnable (org.eclipse.swt.SWTException: Widget is disposed)
org.eclipse.swt.SWT.error(SWT.java:4282)
org.eclipse.swt.SWT.error(SWT.java:4197)
org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Synchronizer.java:138)
org.eclipse.swt.widgets.Display.runAsyncMessages(Display.java:4140)
org.eclipse.swt.widgets.Display.readAndDispatch(Display.java:3757)
org.eclipse.ui.internal.Workbench.runEventLoop(Workbench.java:2696)
org.eclipse.ui.internal.Workbench.runUI(Workbench.java:2660)
org.eclipse.ui.internal.Workbench.access$4(Workbench.java:2494)
org.eclipse.ui.internal.Workbench$7.run(Workbench.java:674)
org.eclipse.core.databinding.observable.Realm.runWithDefault(Realm.java:332)
org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Workbench.java:667)
org.eclipse.ui.PlatformUI.createAndRunWorkbench(PlatformUI.java:149)
com.ibm.cognos.ccr.integration.application.internal.IntegrationApplication.start(IntegrationApplication.java:85)
org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:196)
org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:110)
org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:79)
org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:344)
com.ibm.cognos.ccr.integration.IntegrationServiceAdapter$MyEclipseStarter.run(IntegrationServiceAdapter.java:144)
java.lang.Thread.run(Thread.java:736)
Caused by:
org.eclipse.swt.SWTException: Widget is disposed
org.eclipse.swt.SWT.error(SWT.java:4282)
Example #3 - Maintain - Jobs - Define (Controller 10.4.2)
image 2637
Internal error
image 2638
com.ibm.cognos.ccr.integration.IntegrationFacadeException: org.eclipse.core.runtime.adaptor.EclipseStarter failed!
    at com.ibm.cognos.ccr.integration.IntegrationServiceAdapter$MyEclipseStarter.run(IntegrationServiceAdapter.java:169)
    at java.lang.Thread.run(Thread.java:818)
Caused by: com.ibm.cognos.ccr.common.FatalException: Failed to launch!
    at com.ibm.cognos.ccr.integration.application.internal.IntegrationApplication.start(Unknown Source)
<…………>
    at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:388)
    at com.ibm.cognos.ccr.integration.IntegrationServiceAdapter$MyEclipseStarter.run(IntegrationServiceAdapter.java:167)
    ... 1 more
Caused by: java.lang.NullPointerException
    at java.util.Hashtable.put(Hashtable.java:506)
    at java.util.Properties.setProperty(Properties.java:179)
    at com.ibm.cognos.ccr.common.ServerConfiguration.getBeanFactoryProcessors(Unknown Source)
<…………>
    at com.ibm.cognos.ccr.integration.application.internal.IntegrationApplication.processSetup(Unknown Source)
    ... 7 more

Cause

There are several possible causes for similar error messages.
  • TIP: For more examples, see separate IBM Technote #478825 .

This Technote specifically relate to the scenario where the cause is an invalid/incorrect System Variable "CCR_JAVA_Home" on the Controller application server, for example:
image 2636

Diagnosing The Problem

On the Controller application server, there are no entries created inside the 'ccr.log' file
  • TIP: By default, this is located here: C:\Program Files\ibm\cognos\ccr_64\log

Resolving The Problem

Fix:
For almost all environments, it is not necessary to have a System Variable 'CCR_JAVA_Home'
  • Therefore simply delete it.
Steps:  
1. Logon to the Controller application server as an administrator
2. Inside Windows Explorer, right-click on 'This PC' and choose 'Properties'
3. Click Advanced System Settings
4. Inside the tab "Advanced" click "Environment Variables"
5. Inside the section "System Variables" delete the entry for "CCR_JAVA_Home":
Workaround:
In some (rare) environments, it is necessary to use 'CCR_JAVA_Home'. In this case, you must:
  • Ensure that the System variable CCR_JAVA_Home is configured correctly
  • Afterwards, restart the Windows services "IBM Cognos Controller Java Proxy".

Steps:

1. Logon to the Controller application server as an administrator
2. Launch Windows Explorer, and right-click on "Computer"
3. Choose "Properties"
4. Choose "Advanced System Settings"
5. Inside the tab "Advanced" click "Environment Variables"
6. Inside the section "System Variables" check that there is an entry for "CCR_JAVA_Home"
7. Check that the 'value' is correct (no typos).
  
Examples:
  • For Controller 10.4.2 (installed in the default location) this value should be:  C:\Program Files\ibm\cognos\ccr_64\bin64\jre\8.0
image 2645
  • For Controller 10.1.1 (installed in the default location) this value should be: C:\Program Files (x86)\IBM\java60\jre
  
8. Restart the Windows services "IBM Cognos Controller Java Proxy".

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Component":"Controller","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
24 March 2020

UID

swg21615017

Page Feedback