Umbraco 7 to 13 via uSyncMigrations, heavy DTGE use, any hints and tips?
j
Ahoy lovely Umbraco Discord community, I just discovered a site that I thought was on v8 is actually on v7 😱 so I need to migrate it sharpish. As it's on v7 uSyncMigrations looks mighty tempting but I've yet to use it. I wondered if anyone with experience in this could share any hints and tips? I'm specifically interested in how well the DTGE to Block Grid migration works, as this site almost exclusively uses DTGE for its content. Callum mentioned that I should tag you @Lotte , as you've had some experience in this?
l
uSync Migrations helped us go v7 to v12 with a site that uses DTGE yup! A tad fiddly in parts but content wise was a dream / god send / other positive phrases First question ... what version of v7?
PS commiserations re the v7 discovery 🤗
c
We did one last year using usync migrations that had DTGE and converted it to block grid. Had to do a few PRs to get it working fully but yep it all worked out great
j
Super, this is good news so far! Version is 7.15 - I just updated it. Fortunately it's a relatively simple site.
l
Good news it's on v7.15 - you should be able to install the 'packer' then on that site - https://github.com/Jumoo/uSyncMigrations/blob/main/GETTING-STARTED.md - and generate a zip I would then just give it a go: spin up a new v13 site, copy over the views. doesn't matter that they will all break if tried, usync just needs files to exist to create templates then install the usync migrations package and try an import of the zip at least then you'll see what issues it has
We ended up cloning the usync migrations repo and referencing locally (instead of installing via nuget) so we could hack in some things we needed. I'll remind myself why we needed to do that and if it was DTGE related!
n
Hey @Jason, I have just migrated a fairly complex v8 website content to v13 using the uSync packages, following the uSync.Migrations document that Lotte has shared and it has worked like a charm. The package has done all of the NestedContent to Block List transformations, too. Thank you @Kevin Jump for your great packages. (I'll talk to my company to sponsor you.) #h5yr
b
@Jason I did it few times, happy to give you some advices 😛
n
Today, I have realised that Media settings were migrated but not the actual media items. I have done a bit of research, sounds like this is expected. How did you migrate your media items @Lotte @bielu ?
b
Copy media folder from old solution, because you mean just files?
n
yes
The old solution uses an Azure blob storage container to store the media items. I have created a new Azure blob storage container and done the setup on thew new v13 website to use the new container to store the media items. After copying old media into new media container, I still can not see the media items in Umbraco backoffice.
When I add new media items, I can see them both in Umbraco backoffice and on the new Azure blob storage container.
b
wait not sure i follow, you have fully missing media items in backoffice? if that's the case are you sure you had enabled media migration?
n
Yes, that is correct. All content items have been migrated but none of the media items are in the backoffice. I was expecting to see them there with broken links. How do you enable media migration? I can't see a setting for it. https://github.com/Jumoo/uSyncMigrations/blob/main/GETTING-STARTED.md
uSync.Migration.Packer (for v8) has only one option and that is the "Make a pack" option. After clicking this button it generates a migration zip file. After creating the zip file, I then chose the "Upload a zip" option on the v13 website to start a migration. I chose a migration plan, converted the files and Imported everything. I now have all my content pages and umbraco settings but none of the media items (media section is empty).
l
Am pretty sure you have to manually copy the media files over to the new environment yourself. If you unzip the packer file, I believe that the 'media' folder only has the usync files with the info for adding to the media section, not the media files itself. I always copied the media files over to the new environment before running the migration logic so that the files were found when the import ran You say that adding new meda items to your v13 backoffice works. I would check the uSync media files for those items, and compare to the media files in the packer zip. Perhaps the path is different in the new environment 🤷‍♀️
n
Thanks Lotte and bielu for your answers. Media items are in Azure blob storage containers, I'll check the uSync media files, I'll also try an uSync full export on the old website before migrations.
b
@Nurhak Kaya make sure if your v7/v8 has enabled media exporting as well (as I usuallly turn it off as dont want media in usync files) 😂
n
How do you enable or disable that please? I can't see a setting anywhere.
Is that a setting in uSync Migration Packer section?
And here is the final result:
Content data is looking good.
a
@Jason I did one last year using migrations. I had to make a PR into uSync too to get the ids to sort themselves out, but otherwise it worked pretty well.
n
Yes, I remember the time when you used it.
I have just spinned up a new Umbraco version 13.4.1 website, used uSync.Migrations 4.0.0-phase.5.1, it didn't migrate the media items even though I can see that the zip file has a Media folder with media items in it. No problem with the content.
b
Okay so you have media folder in V8, can you share what migration plan are you using?
Also can you share example media file with me?
h
The usync files just create the reference in umbraco, it does not contain the actual media.
n
I am using "Convert to Nested Content to BlockLists and Grid to BlockGrid" migration plan. Yes, media items are in a blob storage, I am not expecting uSync.Migrations to contain the actual files, but the references, as actual files are in a blob storage. I believe my exported files include the Media references, but it doesn't migrate the media references into the v13 database.
m
do you see any errors in the import log (from the migration) click view results and then mediahandler... (IIRC)
b
@Nurhak Kaya can you share you usync configuration from app settings? as I have feeling like the issue might be here 🤔
441 Views