Open topic with navigation
You can use the following information to troubleshoot your custom integration points and resolve common errors that may occur. It also includes instructions about how to upgrade your integration points for use in Relativity 9.4 and above.
This page includes the following information:
Use the following guidelines to upgrade your custom integration points for use in Relativity 9.4 and above.
Obtain the new versions of the Relativity Integration Points SDK and the Relativity SDK. Update the references in your projects to the new .dll files in these SDKs. For more information, see Download the SDKs and Set up your Visual Studio solution.
If you have implemented your source provider using dependency injection or have a provider factory inheriting from the DefaultProviderFactory class, update your source provider code as described in this section.
In previous versions of the Integration Points API, you needed to implement the CreateInstance() method on the DefaultProviderFactory class, create another class that implemented the IStartUp interface, and then use the PluginBuilder class to set the provider factory.
In Relativity 9.4 and above, you must now create a class that implements the new abstract ProviderFactoryBase class from the kCura.IntegrationPoints.Domain namespace. Use these guidelines when creating this class:
Recompile the source code for your integration point, and upload the .dlls to Relativity. For more information, see Deploy your integration point.
Upload the remaining assemblies to Relativity as resource files. You can obtain them from the Relativity Integration Points SDK. Ensure that you upload the .dll files in the correct order. For more information, see Deploy your integration point.
Use the following troubleshooting guidelines to resolve common errors that may occur in integration points.
An integration point doesn't run if the required agent wasn't added or the .dll files were uploaded in the wrong order. Complete the following tasks to troubleshoot an application that doesn't run:
To improve the performance of your application, limit the number of providers executing any given time.
To debug an integration point provider, you must point to the local Symbol files (.pdb) in your Visual Studio application. Unlike other Relativity extensibility points, the Integration Point framework doesn't support uploading the .pdb files to the application domain for use in debugging.
These instructions describe how to debug the following methods that an integration points provider supports. These methods execute at different times and places in your code:
Use the following steps to debug an integration point provider:
(Click to expand)
Note: Attach to the debugger to the w3p process as late as possible. The server rapidly spawns these processes, which may prevent them from being caught by the debugger.
(Click to expand)
When you attach to multiple w3p processes, debugging in Visual Studio may slow down. As an alternative, you attach to a w3p process by using the following command in the command prompt on the machine where the IIS is installed:
C:\Windows\System32\inetsrv\appcmd.exe list wp
It takes the process ID with the following GUID: