This section outlines the steps required to manually upgrade a web application using Nevron WebParts from previous version.
1. Obtain the version number of the previous version.
The easiest way to do that is to check the assemblies version in the following folder:
SharePoint 2007 - C:\Program Files\Nevron Software\Nevron SharePoint Vision [Version] for MOSS and WSS 2007\Bin
SharePoint 2010 - C:\Program Files\Nevron Software\Nevron SharePoint Vision [Version] for MOSS and WSS 2010\Bin
Right click on a .dll file there, select properties and check the version from the version tab.
2. Uninstall the old version.
Uninstall the old version from the web applications using it and unregister the solution from the web server(s). This step can be performed using the WebParts registration wizard shipped with the old version.
If you have previously installed Nevron SharePoint Vision on multiple WFEs in your farm environment, you need to perform step 2, 3, 4, 4.1, 4.2 and 4.3 on each WFE.
When you uninstall Nevron SharePoint Vision using Control Panel's Add/Remove Programs (or Programs and Features) the installation will automatically launch the WebParts registration wizard with unregister option.
3. Check if the Nevron SharePoint solution has been properly removed.
Run cmd.exe and navigate to:
SharePoint 2007 - C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\BIN
SharePoint 2010 - C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\BIN
Check if there is “nevronsharepointvision.wsp”, by using the following command:
stsadm -o enumsolutions
If “nevronsharepointvision.wsp” is still present, run the following command:
stsadm -o deletesolution -name nevronsharepointvision.wsp -override
4. Make sure that the web.config does not contain entries from the previous version.
Typically the installer will modify the SafeControls, httpHandlers and assemblyBinding web.config entries.
4.1 SafeControls section.
Remove all entries similar to:
<SafeControl Assembly="Nevron.SPVision, Version=x.x.x.x, Culture=neutral, PublicKeyToken=c37de877cbfea086" Namespace="Nevron.SPVision" TypeName="*" Safe="True" />
<SafeControl Assembly="Nevron.Chart.SharePoint, Version=x.x.x.x, Culture=neutral, PublicKeyToken=061415a4cdb7466a" Namespace="Nevron.Chart.SharePoint" TypeName="*" Safe="True" />
4.2 httpHandlers section (handlers section in SharePoint 2010).
Remove all entries that point to a Nevron assembly for example:
SharePoint 2007
<add verb="*" path="ChartCommander.axd" type="Nevron.Chart.SharePoint.Design.NChartCommanderHttpHandler, Nevron.Chart.SharePoint.Design, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a569cfe19372196c" validate="false" />
SharePoint 2010
<add name="NHatchStylePreview" preCondition="integratedMode" verb="*" path="NHatchStylePreview.axd" type="Nevron.SPVision.Design.NHatchStylePreviewHttpHandler, Nevron.SPVision, Version=x.x.x.x, Culture=neutral, PublicKeyToken=c37de877cbfea086" />
4.3 assemblyBinding section.
Remove all dependentAssembly entries that redirect Nevron assemblies - for example:
<dependentAssembly>
<assemblyIdentity name="Nevron.Chart.SharePoint" publicKeyToken="061415a4cdb7466a" culture="neutral" />
<bindingRedirect oldVersion="x.x.x.x" newVersion="x.x.x.x" />
</dependentAssembly>
5. Install the new version and run the web part registration wizard only on the Application Server (the server hosting Central Administration)
5.1 Run the Web Part Registration Wizard
Run the web part registration wizard during the installation or run the registration wizard after the installation from the Start >> All Programs >> Nevron SharePoint Vision >> Web Parts Registration Wizard.
5.2 Automatic Assembly Binding
In the registration wizard task page check "Register Assembly Binding From Previous Version" and enter the version number you obtained in step 1:
Run the web part registration wizard as described in the Installation and Administration topic.
5.3 Automatic Assembly Binding
In the registration wizard task page check "Register Assembly Binding From Previous Version" and enter the version number you obtained in step 1:
5.4 Manual Assembly Binding
Alternatively you can manually update the web.config file if you registered the web parts without specifying a binding from a previous version. The web.config file of the SharePoint application contains a section instructing SharePoint to redirect requests to assemblies with specific version to assemblies with other version. This is called assembly redirection and is commonly used to upgrade assemblies without breaking the application. Lets say that the version of the Nevron Web Parts you currently use is 9.12.2.12 and you want to upgrade to version 11.5.15.12 (Vol1 2011). In this case you need to add the following XML tag under the assemblyBinding section of the web.config file:
XML |
Copy Code
|
---|---|
<dependentAssembly> <assemblyIdentity name="Nevron.Chart.SharePoint" publicKeyToken="061415a4cdb7466a" culture="neutral" /> <bindingRedirect oldVersion="9.12.2.12" newVersion="10.2.25.12" /> </dependentAssembly> |
Note that if you uninstalled the previous version of the webparts you'll have to touch the SafeControls section of the web.config file, by adding a "SafeControl" entry for the old version dll:
XML |
Copy Code
|
---|---|
<SafeControl Assembly="Nevron.Chart.SharePoint, Version=9.12.2.12, Culture=neutral, PublicKeyToken=061415a4cdb7466a" Namespace="Nevron.Chart.SharePoint" TypeName="*" Safe="True" /> |