|
4 | 4 |
|
5 | 5 | ## Background
|
6 | 6 |
|
7 |
| -There are many great resources for learning CMS12 and Commerce14: |
8 |
| - |
9 |
| -- The official developer documentation has been updated: |
10 |
| - https://world.optimizely.com |
11 |
| -- The official user guild has been updated: |
12 |
| - https://webhelp.optimizely.com |
13 |
| -- Mark Price and Scott Reed host a masterclass on .NET5: |
14 |
| - https://www.optimizely.com/support/education/product/migrating-to-optimizely-cms-12-and-commerce-14 |
15 |
| - |
16 |
| -...and so on. |
17 |
| -But there aren’t many resources for upgrading from CMS 11 / Commerce 13 |
| 7 | +There are many great resources for learning how to build a new solution using CMS 12 and Commerce 14. The official [developer documentation](https://world.optimizely.com) has been updated, the official [user guide](https://webhelp.optimizely.com) has been updated, and an excellent [masterclass](https://www.optimizely.com/support/education/product/migrating-to-optimizely-cms-12-and-commerce-14) is hosted by Mark Price and Scott Reed (to name a few). But there aren’t many resources sharing information on how to take an existing CMS 11 / Commerce 13 solution and upgrade it to .NET 5+. |
18 | 8 |
|
19 | 9 | ## Prerequisites
|
20 | 10 |
|
21 |
| -Phase 0: Stuff to do before you begin |
22 |
| - |
23 |
| -### Read the official documentation |
24 |
| - |
25 |
| -1. Upgrading to Content Cloud (CMS 12) |
26 |
| - https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/upgrading-to-content-cloud-cms-12 |
27 |
| - |
28 |
| -2. Breaking changes in Content Cloud (CMS 12) |
29 |
| - https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/breaking-changes-in-content-cloud-cms-12 |
30 |
| - |
31 |
| -3. System requirements for Optimizely |
32 |
| - https://docs.developers.optimizely.com/content-cloud/v12.0.0-content-cloud/docs/system-requirements-for-optimizely |
33 |
| - |
34 |
| -### Be on .NET Framework 4.7.2 or higher |
35 |
| - |
36 |
| -CMS11 only requires .NET Framework 4.6.1, but Microsoft recommends being on 4.7.2 or higher when using Upgrade-Assistant |
37 |
| - |
38 |
| -- https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/system-requirements-for-optimizely |
39 |
| -- https://docs.microsoft.com/en-us/dotnet/core/porting/premigration-needed-changes |
| 11 | +### 1. Read the official documentation |
40 | 12 |
|
41 |
| -### Update to the latest version of CMS11 (Commerce13) before upgrading |
| 13 | +1. [Upgrading to Content Cloud (CMS 12)](https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/upgrading-to-content-cloud-cms-12) |
| 14 | +2. [Breaking changes in Content Cloud (CMS 12)](https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/breaking-changes-in-content-cloud-cms-12) |
| 15 | +3. [System requirements for Optimizely (CMS 12)](https://docs.developers.optimizely.com/content-cloud/v12.0.0-content-cloud/docs/system-requirements-for-optimizely) |
42 | 16 |
|
43 |
| -The official documentation doesn’t explicitly say to do this, but I can’t think of any reason not to. |
| 17 | +### 2. Be on .NET Framework 4.7.2 or higher |
44 | 18 |
|
45 |
| -### Check the status of add-on packages |
| 19 | +CMS 11 only [requires](https://docs.developers.optimizely.com/content-cloud/v11.0.0-content-cloud/docs/system-requirements-for-optimizely) .NET Framework 4.6.1, but Microsoft [recommends](https://docs.microsoft.com/en-us/dotnet/core/porting/premigration-needed-changes) being on 4.7.2 or higher when using Upgrade-Assistant |
46 | 20 |
|
47 |
| -- Official CMS/Commerce add-on platform compatibility: |
48 |
| - https://docs.developers.optimizely.com/integrations/v1.1.0-apps-and-integrations/docs/add-ons-platform-compatibility |
| 21 | +### 3. Update to the latest version of CMS11 (Commerce13) before upgrading |
49 | 22 |
|
50 |
| -- Official big list of package migration status: |
51 |
| - https://world.optimizely.com/resources/net5/add-ons |
| 23 | +The official documentation doesn't explicitly say to do this, but is there any reason _not_ to? |
52 | 24 |
|
53 |
| -### Check the status of add-on packages |
| 25 | +### 4. Check the status of add-on packages |
54 | 26 |
|
55 |
| -Give yourself time to check the status of your favorite third party add-ons. |
| 27 | +Optimizely maintains a list of the .NET 5 migration status of the official platform and addon NuGet packages: |
56 | 28 |
|
57 |
| -Having no workaround for unsupported add-ons could derail your whole upgrade project. Know what you’re getting into. |
| 29 | +- [Add-ons platform compatibility (Optimizely Developer Docs)](https://docs.developers.optimizely.com/integrations/v1.1.0-apps-and-integrations/docs/add-ons-platform-compatibility) |
| 30 | +- [Add-Ons Status (Optimizely.com)](https://world.optimizely.com/resources/net5/add-ons) |
58 | 31 |
|
59 |
| -Note: Some old, .NET Framework add-ons will still work, just with a warning. |
| 32 | +No such list exists for unofficial add-ons (as of this writing). So, when planning the upgrade, give yourself time to check the status of your favorite third party add-ons. Having no workaround for unsupported add-ons could derail your whole upgrade project. Know what you’re getting into. |
60 | 33 |
|
61 |
| -Example: Authorize.Net. |
62 |
| -There is no .NET Core+ package, but it still compiles and runs. |
| 34 | +Note that some old, .NET Framework add-ons will still work, just with a warning. For example: Authorize.Net. There is no .NET Core+ package, but it still compiles and runs. |
63 | 35 |
|
64 | 36 | ## Upgrade-Assistant
|
65 | 37 |
|
|
0 commit comments