Getting Started / Upgrading From Previous Versions
In This Topic
    Upgrading From Previous Versions
    In This Topic

    This topic describes the approaches you can use to upgrade pages containing Nevron WebParts from older versions.

     Updating the Web Application to Use an Upgraded Version

    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" />
    Finally you need to Activate the "Nevron Legacy Web Parts" site collection feature.