IBM Support

"Internal Error ... EclipseStarter failed! ... Java property 'user.home' ... does not match Windows %UserProfile% ..." when using JAVA-based functionality

Troubleshooting


Problem

User launches Controller. User tries to start any JAVA-based functionality (e.g. "Group - Command Center" or "Company - Command Center" or "Maintain - Jobs - Define"). An error appears. There is also an error recorded inside the 'ccr_integration.log' file (which is located inside the end user's Windows profile).

Symptom

Screen:
The error message may vary, depending on environments/circumstances. Below are some examples seen:

cid:image007.png@01CFA1A3.C1D337E0
Internal Error
Error details
com.ibm.cognos.ccr.integration.IntegrationFacadeException: org.eclipse.core.runtime.adaptor.EclipseStarter failed!
at com.ibm.cognos.ccr.integration.IntegrationServiceAdapter$MyEclipseStarter.run(IntegrationServiceAdapter.java:170)
at java.lang.Thread.run(Thread.java:781)
Caused by: org.eclipse.core.runtime.CoreException: Plug-in com.ibm.cognos.ccr.integration.application was unable to load class com.ibm.cognos.ccr.integration.application.internal.IntegrationApplication.
at org.eclipse.core.internal.registry.osgi.RegistryStrategyOSGI.throwException(RegistryStrategyOSGI.java:194)
<....>
at com.ibm.cognos.ccr.integration.IntegrationServiceAdapter$MyEclipseStarter.run(IntegrationServiceAdapter.java:168)
... 1 more
Caused by: org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter$TerminatingClassNotFoundException: An error occurred while automatically activating bundle com.ibm.cognos.ccr.integration.application (11).
at org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter.postFindLocalClass(EclipseLazyStarter.java:122)
<.....>
at org.eclipse.core.internal.registry.osgi.RegistryStrategyOSGI.createExecutableExtension(RegistryStrategyOSGI.java:174)
... 9 more
Caused by: org.osgi.framework.BundleException: Exception in com.ibm.cognos.ccr.integration.application.internal.Activator.start() of bundle com.ibm.cognos.ccr.integration.application.
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(BundleContextImpl.java:734)
<....>
at org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter.postFindLocalClass(EclipseLazyStarter.java:107)
... 21 more
Caused by: java.lang.NullPointerException
at com.ibm.cognos.ccr.integration.application.internal.Activator.start(Activator.java:71)
<....>
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(BundleContextImpl.java:702)
... 27 more

ccr_integration.log (located inside the end user's profile C:\Users\USERNAME\AppData\Roaming\Cognos\ccr):
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationClientUtils#initializeLogger] POJO logger for integration facade started: count=10, limit=500000
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationClientUtils#initializeLogger] JVM args: -Xoptionsfile=C:\Program Files (x86)\IBM\IBM Cognos <....>

2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationThreadFactory#initialize] Initialized OK
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationFacadeImpl#<init>] Instantiated OK
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.DefaultIntegrationFacade#initialize] Initializing ...
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationServiceAdapter#initialize] arguments: C:\Program Files (x86)\IBM\IBM Cognos Controller\Integration\,en_GB,ltr,helpURL=http://servername/ibmcognos/controllerhelp/documentation/en/&ccrUser=MY…\SQLIntegrationControllerDEV2
2014-07-17 15:09 | WARNING | [com.ibm.cognos.ccr.integration.IntegrationClientUtils#resolveUserHome] Java property 'user.home' (\\fileserver\sharename\profilefolder\MYUSERNAME) does not match Windows %UserProfile% (C:\Users\MYUSERNAME); attempt to store user data in C:\Users\MYUSERNAME
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationServiceAdapter$MyUserConfigurationUpdater#isPropertiesEqual] Configuration file contents match
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationServiceAdapter#initializeEclipseAndOSGi] User configuration file is up-to-date: C:\Users\MYUSERNAME\ccr-config\.eclipse\configuration\config.ini
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationServiceAdapter#initializeEclipseAndOSGi] Properties:
[osgi.install.area=C:\Program Files (x86)\IBM\IBM Cognos Controller\Integration\, osgi.syspath=C:\Program Files (x86)\IBM\IBM Cognos Controller\Integration\plugins/, osgi.framework=null, osgi.configuration.area=C:\Users\MYUSERNAME\ccr-config\.eclipse\configuration, osgi.instance.area=C:\Users\MYUSERNAME\ccr-config\.eclipse\workspace, osgi.user.area=C:\Users\MYUSERNAME\ccr-config\.eclipse\userArea, REGIONAL_SETTINGS=en_GB, eclipse.orientation=ltr, java.library.path=C:\Program Files (x86)\IBM\IBM Cognos Controller\Integration\]
<...>
... 21 more
Caused by: java.lang.NullPointerException
at com.ibm.cognos.ccr.integration.application.internal.Activator.start(Activator.java:71)
at org.eclipse.osgi.framework.internal.core.BundleContextImpl$1.run(BundleContextImpl.java:711)
at java.security.AccessController.doPrivileged(AccessController.java:330)
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(BundleContextImpl.java:702)
... 27 more
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationServiceAdapter#startEclipseAndServiceTracker] Polling servicetracker, service: null
2014-07-17 15:09 | INFO | [com.ibm.cognos.ccr.integration.IntegrationServiceAdapter#startEclipseAndServiceTracker] Service started? false (service=null)
=================================================================================

If the end user now re-runs the same JAVA function, then they may receive a different error:

java.lang.IllegalStateException: Platform already running
at com.ibm.cognos.ccr.integration.IntegrationServiceAdapter.run(IntegrationServiceAdapter.java:212)
at java.lang.Thread.run(Thread.java:781)

Cause

There are several possible causes for similar symptoms.

  • TIP: For more examples, see separate IBM Technote #1968656.

This Technote specifically relates to the scenario where the cause is a limitation of Controller (reference APAR PI22879), which is triggered when the end user's Windows variable %DESKTOP% is configured to a non-default location, specifically a remote share.

Environment

In the following example, the end user's variable %DESKTOP% (located inside the registry key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders) is set to be \\myfileserver\sharename\myfolder:


This configuration is typically performed via a GPO (active directory policy), similar to the one shown below:

Resolving The Problem

Fix:
Upgrade to Controller 10.2.2021 (also known as 10.2.0 Fix Pack 1) or later.

Workaround:

There are two workarounds:

  • Method #1

Modify the relevant settings (e.g. registry key and/or GPO) so that the value for HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\Desktop is set to a standard location (e.g. C:\Users\USERNAME\Desktop).

  • Method #2

Create a folder 'ccr-config' at one level above the value inside 'Desktop'.

NOTE: This method only works when the value of 'Desktop' has a share name and then *also* an extra subfolder.

Example:

In the above example, the value of 'Desktop' is set to: \\myfileserver\sharename\myfolder

The solution is to create a folder 'ccr-config' inside the location: \\myfileserver\sharename

- In other words, there is now a folder called: \\myfileserver\sharename\ccr-config

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

Document Information

Modified date:
15 June 2018

UID

swg21679447