Per Nergård
Oct 19, 2012
  4225
(1 votes)

Convert a native VPP to a versioning VPP including link conversion

This post was originally planned to be about converting a Sharepoint (SP) connect VPP to a versioning counterpart. But since a SP VPP store the links in the EPiserver database in the same way as a native provider, it works for both types.

The main reason our customer wanted to switch from the SP VPP was that it like a native provider doesn’t support permanent links.

You can read my post about the Share point connect here.

The conversion process is quite easy once you know how to do it.

And it works for both CMS5 and CMS6.

1. Get the files

First off you need to get all the files. This should be no problem since we’re talking about a native provider. If it’s a SP VPP you may need to get someone from the SharePoint side help you extracting the files. Setting showinfilemanger to false is also recommended before you start so no new documents are added during the conversion process.

2. Setup the new VPP

First we need to setup the new versioning VPP. The thing here is that the new VPP must have the same virtual name as the one we’re converting from.

So before creating the new VPP we need to change the virtualpath on the original and add a location element for that path.

Doing this will break all the current links so I did a small HttpModule to handle those requests until the conversion process is done. Download the code here.

3. Add the files to the new VPP

To add the files to the new versioning VPP I just used the drag and drop functionality which seemed to work great. Unfortunately it doesn’t work with empty folders.

If I were to do it again I would use Anders Hattestads excellent file copier which works like a charm from native to versioning. For some reason it didn’t work between a SharePoint VPP and a versioning.  You can read Anders blog post here.

Now when the files are in the versioning provider we could disable the httpmodule and all existing links will work. But if you try to change a filename you’ll see that the links still aren’t permanent so we’ll have to wait.

4. Converting the links

When it came to this part I really didn’t now how to go about it. I had a mail conversation with EPiServer support that sent me two aspx pages from the migration tool (CMS 4 to CMS5) that I could check for some input on how to build my own solution.

After reading some code I realized that the link conversion was probably done after the migration tool had updated the CMS4 database to a CMS 5 and that I therefore probably could use it for my needs.

Lucky for me it worked. Just drop the ConvertLinks.aspx in the root folder for your site and browse to it. It’s fast so just wait a minute or two and then refresh the page. If the status says completed it’s finished. If not just wait a minute longer and press refresh again until it does.

The migration tool can be downloaded from here. And after installing it you can find the .aspx file in the C:\Program Files (x86)\EPiServer\MigrationTool\SiteDeployedPages folder.

Now we can disable the httpmodule.

5. Cleaning up

Don’t forget to permanently remove the old VPP configuration and location element. And don’t forget to setup the indexingservice.config.

6. Done

Now we have successfully converted a native or SP VPP to a versioning one and the editors have never been happier.

If there are interest about it, I could do another blog post with a bit more detail about the actual steps in the deployment process. Leave a comment if that’s the case.

Oct 19, 2012

Comments

Please login to comment.
Latest blogs
Dynamic packages in Commerce Connect

In Optimizely Commerce Connect, you can group different items using packages and bundles. Package: A package has one or more versions of a product...

K Khan | Nov 1, 2024

Efficient Catalog Metadata Management and Product Updates Using DTOs in Optimizely Commerce

This post explores ways to manage and update catalog metadata in Optimizely Commerce by utilizing Data Transfer Objects (DTOs). DTOs provide a...

Sujit Senapati | Oct 31, 2024

Effortlessly Resize Images with Cloudflare's On-the-Fly Solution

Resizing images in C# has traditionally been a complex and time-consuming task, often requiring intricate code and handling various image processin...

Manoj Kumawat | Oct 31, 2024 | Syndicated blog

XSS Vulnerabilities Patched with TinyMCE 6.8.4

Two different XSS vulnerabilities were fixed in the latest update of the NuGet package EPiServer.CMS.TinyMce. Update today!

Tomas Hensrud Gulla | Oct 30, 2024 | Syndicated blog

Opticon 2024 London - Key Highlights and Insights

Welcome to Onederland. Discover the key highlights from the Opticon Conference 2024 in London, including the NetSpring acquisition, advancements in...

Raghavendra Murthy | Oct 30, 2024 | Syndicated blog

Mastering clearing Cache in Optimizely CMS with ISynchronizedObjectInstanceCache & MemoryCache

In the fast-paced world of web development, efficient memory management is essential for optimizing application performance and enhancing user...

Sujit Senapati | Oct 28, 2024