Step 4 - After upgrade
The upgrade tool only upgrades the product and not the solution. Templates, images, page types or script files (which are stored in the “/UI”, “/App_Code” and “/Site” folder) are part of the solution and will therefore not be updated. Since there is likely breaking changes between product versions, you will also have to ugrade the customizations made to other parts of the solution.
1. Read the documentation
What is new? >>>
Breaking changes >>>
Release notes >>>
API documentation >>>
2. Make the solution compile
After the product has been upgraded, you need to make your entire solution compile. In many cases it will not, because of customizations made (templates, page types, add-ons, plug-ins etc) that might not be compatible with the latest version of Litium Studio. This is due to breaking changes between product versions.
Before you try to compile your solution you need to update the target .NET framework version on each project/website to point to ".NET Framework 4.5.2". You need do that on the property page of each project, the following is an example on how the page can look.
3. Upgrade add-ons (skip this step if no add-ons are used in the solution)
Add-ons are considered part of the solution. If an add-on has been customized in the solution it should be upgraded in the project. But there is also the possibility to download complete upgraded add-ons, for example the most common payment providers.
4. Web.config file
Solution specific registrations and extension/add-on registrations are not moved
If you have solution specific registrations or extension/add-on registrations in the web.config file, those rows are not moved to the new web.config file. You have to move them manually.
Check the moved configuration values
Check that the following configuration values (“XXXX”) are correctly moved to the new web.config file by comparing with your old web.config file from your solution back up.
Note that the System user login is removed and replaced by users in local machine or domain with admin rights.
• <add name="FoundationConnectionString" connectionString="Pooling=true;User Id=XXXX;Password=XXXX;Database=XXXX;Server=XXXX" providerName="System.Data.SqlClient"/>
• <filesDirectory value="XXXX"/>
• <smtpServer value="XXXX"/>
• <appender name="LitiumStudioFileLog" type="log4net.Appender.RollingFileAppender">
<file value="XXXX"/>
Check all other values that are differing from the standard web.config of latest Litium Studio version.
5. Rebuild the search indices
The last step in upgrading the solution is to rebuild all search indices. Log into the Litium Studio back office and open the Control Panel/System settings/Search indices. Click the Rebuild All button.
6. Make sure the solution compiles - again
Make sure your solution compiles without errors. Your upgrade is now complete.