Troubleshooting
Problem
After upgrading an installation of IBM i2 Analyst's Notebook from V8 to V9 with the IBM i2 Information Exchange for Analysis Search for Analyst's Notebook plug-in installed, i2 iXa throws a NullReferenceException error at startup. Though you can continue on to the main i2 Analyst's Notebook interface, you may find that elements of the user interface that use i2 iXa do not appear, or do not function correctly.
Symptom
Error seen when viewing 'Copy diagnostics to clipboard' output
Error Details: Exception of type 'System.NullReferenceException'
Object reference not set to an instance of an object.
Stack Trace: at i2.Adams.SemanticSupport.SemanticProvider.GetBehaviourDirectoryForApplication(String applicationIdentifier)
at b..ctor()
Cause
The issue may occur in instances where an i2 Product has previously been installed and had placed the SemanticMatchingBehaviour.dll into the Windows Global Assembly Cache (GAC). In this case, the presence of the dll in the GAC may prevent the installer of your product from writing the necessary registry key values when they are missing.
Diagnosing The Problem
To check whether this fix will resolve the issue on your machine, carry out the following steps.
Note: For the following steps, the folder paths contained in the registry are given as typical examples, and may be different to your actual installation.
- Open the Windows Registry using the Registry Editor. To do this, either press the Windows Key + R to bring up the 'Run' dialog, and then enter 'regedit.exe' into the 'Open:' text field, and click 'OK'
Alternatively you can usually click the Start button, and then the 'Run...' button at the right hand side, which will also bring up the Run dialog for you to enter 'regedit.exe' into and click 'OK'
- Using the now opened registry editor, navigate to the following key -
- On a 32-bit machine: HKEY_LOCAL_MACHINE\SOFTWARE\i2\SMBEngine\SMB1.3
- On a 64-bit machine: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\i2\SMBEngine\SMB1.3
- A machine exhibiting the erroneous behavior will not have the following String Values, or may not have the key present at all.
- On a 32-bit machine:
Base Folder = C:\Program Files (x86)\Common Files\i2 Shared\SMB1.3\
ProdRevision = 1.3.0.5521 - On a 64-bit machine:
Base Folder = C:\Program Files\Common Files\i2 Shared\SMB1.3\
ProdRevision = 1.3.0.5521
A working machine registry will look something like the following
Resolving The Problem
- Navigate to the Windows registry using the registry editor, and add the missing string values.
- To add a new value, right click in the right hand pane after selecting the appropriate folder from the left hand side, and then selecting the appropriate type, in this case, String Value.
- Create the following keys
- On a 32-bit machine:
Navigate to: HKEY_LOCAL_MACHINE\SOFTWARE\i2\SMBEngine\SMB1.3
Add the missing String Values:
Base Folder = C:\Program Files\Common Files\i2 Shared\SMB1.3\
ProdRevision = 1.3.0.5521 - On a 64-bit machine:
Navigate to: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\i2\SMBEngine\SMB1.3
Add the missing String Values:
Base Folder = C:\Program Files (x86)\Common Files\i2 Shared\ SMB1.3\
ProdRevision = 1.3.0.5521
Note: The Base Folder string may need to be different, based on the installation location of your IBM i2 Products
Historical Number
17990;668;668
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21974921