IBM Support

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



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).


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

Internal Error
Error details org.eclipse.core.runtime.adaptor.EclipseStarter failed!
Caused by: org.eclipse.core.runtime.CoreException: Plug-in was unable to load class
at org.eclipse.core.internal.registry.osgi.RegistryStrategyOSGI.throwException(
... 1 more
Caused by: org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter$TerminatingClassNotFoundException: An error occurred while automatically activating bundle (11).
at org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter.postFindLocalClass(
at org.eclipse.core.internal.registry.osgi.RegistryStrategyOSGI.createExecutableExtension(
... 9 more
Caused by: org.osgi.framework.BundleException: Exception in of bundle
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(
at org.eclipse.core.runtime.internal.adaptor.EclipseLazyStarter.postFindLocalClass(
... 21 more
Caused by: java.lang.NullPointerException
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(
... 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 | [] POJO logger for integration facade started: count=10, limit=500000
2014-07-17 15:09 | INFO | [] JVM args: -Xoptionsfile=C:\Program Files (x86)\IBM\IBM Cognos <....>

2014-07-17 15:09 | INFO | [] Initialized OK
2014-07-17 15:09 | INFO | [<init>] Instantiated OK
2014-07-17 15:09 | INFO | [] Initializing ...
2014-07-17 15:09 | INFO | [] 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 | [] 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 | [$MyUserConfigurationUpdater#isPropertiesEqual] Configuration file contents match
2014-07-17 15:09 | INFO | [] User configuration file is up-to-date: C:\Users\MYUSERNAME\ccr-config\.eclipse\configuration\config.ini
2014-07-17 15:09 | INFO | [] 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 org.eclipse.osgi.framework.internal.core.BundleContextImpl$
at org.eclipse.osgi.framework.internal.core.BundleContextImpl.startActivator(
... 27 more
2014-07-17 15:09 | INFO | [] Polling servicetracker, service: null
2014-07-17 15:09 | INFO | [] 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


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.


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

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


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.


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":"Cognos Controller"},"Business Unit":{"code":"BU002","label":"Business Analytics"},"Component":"Controller","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.2.0","Edition":""}]

Document Information

Modified date:
15 June 2018