Migrating from .NET 3.5 to .NET 4.0

If you are migrating your AgilePoint environment from .NET 3.5 to .NET 4.0, complete the following procedure.

AgilePoint recommends engaging our Professional Services team for several critical steps in this process to ensure you do not encounter long-term issues.

Preparing to Install AgilePoint BPMS for .NET 4.0

Before you install AgilePoint BPMS for .NET 4.0, do the following:

Upgrade all of your AgilePoint components to the release level that is compatible with your version of AgilePoint BPMS for .NET 4.0.
For example, if you want to install AgilePoint BPMS v5.0 SP4 for .NET 4.0, first upgrade to AgilePoint BPMS v5.0 SP4 for .NET 3.5.

For more information, see Upgrade Guide.
Ensure you are running AgilePiont Server in Windows Service mode. IIS mode is not supported for .NET 4.0.
If you are using SharePoint or AgileForms for your AgilePoint user interface, no code change is required for this migration.

If you are using custom web services or web applications, such as ASP.NET, with AgilePoint BPMS in IIS mode, some code changes are required. Please contact AgilePoint Support to engage AgilePoint Professional Services to help with this change.
If you are using SharePoint Integration, upgrade to SharePoint 2013 or later. Earlier versions of SharePoint do not support .NET 4.0.
If you have custom AgileParts, AgileWorks, or AgileConnectors in your AgilePoint environment, recompile them with .NET 4.0.
AgilePoint Professional Services can help with this step if needed.

Installing AgilePoint BPMS for .NET 4.0

You have 2 main options to for installing AgilePoint BPMS for .NET 4.0:

Install on new hardware.
This is the simplest option, and there is no possibility for conflicts with old .NET 3.5 DLLs.
1. Set up your environment and install the software according to the instructions in this Installation Guide.
Install on existing hardware.
If you do not have replacement hardware, you can migrate to AgilePoint BPMS for .NET 4.0.

This option is recommended for client software, such as AgilePoint Envision and Developer, but for AgilePoint Server it is better to use new hardware if possible, so there are no conflicts between .NET 3.5 and .NET 4.0 DLLs.
1. Uninstall the AgilePoint BPMS for .NET 3.5 component.
2. Install the Microsoft .NET 4.0 Framework on your machine.
3. Install the AgilePoint BPMS for .NET 4.0 component.

Completing the Installation of AgilePoint BPMS for .NET 4.0

After you install AgilePoint BPMS for .NET 4.0, do the following:

Register the custom AgileParts, AgileWorks, and AgileConnectors you recompiled for .NET 4.0 on AgilePoint Server.
Manually check the .NET 4.0 GAC to ensure the DLLs are actually deployed to the GAC for .NET 4.0, and not .NET 3.5.
Once all AgilePoint components are migrated to .NET 4.0, point the .NET 4.0 AgilePoint Server to the existing AgilePoint database.
At this point, processes will continue working from where they left off.
Recheck each client and server machine in your AgilePoint BPMS environment to ensure that every component has been fully migrated to .NET 4.0. Any .NET 3.5 components in your environment can cause problems in the future. AgilePoint highly recommends engaging our Professional Services team for this evaluation.