Upgrade

When all corrections are made and your solution is compiling, run the “Litium Studio Upgrade Tool.exe” on one of your web servers and follow the instructions on the screen.

2. Make sure there are no errors in the log

At the end of the upgrading process, check the log file for any contingent warnings. If the upgrade tool does not complete, an error will be written to the log file. If this is the case: restore your backup, try to correct the error and run the upgrade tool again.

If your upgrading is failing with the following error message you need to reset the read only folder attribute. Resetting of attributes can’t be handle inside windows and you need to open your command prompt, see example below.

============================================================
An unhandled error has occured.
============================================================
Access to the path 'C:\Inetpub\wwwroot\Templates\Icons' is denied.
at System.IO.Directory.DeleteHelper(String fullPath, String userPath, Boolean recursive)
at System.IO.Directory.Delete(String fullPath, String userPath, Boolean recursive)
at Litium.Foundation.Upgrade.FileManager.DeleteDirectory(String directoryPath)
at Litium.Foundation.Upgrade.FileManager.CopyDirectoriesAndFiles(String sourceDirectory, String destinationDirectory, String directoryName, String fileFilter, String directoryFilter, Boolean overwrite, Boolean deleteSource, StringBuilder report)
at Litium.Studio.Upgrade.Tasks.Version_450.MoveFilesStep.Execute(DatabaseManager databaseManager, FileManager fileManager, StringBuilder generalReport)
at Litium.Foundation.Upgrade.ProgressBarWindow.backgroundWorker_DoWork(Object sender, DoWorkEventArgs e)
at Litium.Foundation.Upgrade.GUI.Install.Installation(Object param)

This need to be done before running the upgrade program. Restore your backup and before starting upgrade program you should do the following.

Example if you have your wwwroot folder located in c:\Inetpub
1. Click on the start menu, click run and enter cmd and press ok
2. Enter following command and press enter > cd /D C:\Inetpub\wwwroot
3. Enter following command and press enter > attrib /D /S -R *.*
4. Enter following command and press enter > exit

3. Download and install payment providers (if upgrading the E-Commerce module)

With Litium Studio 4.6 all payment providers became add-ons. Therefore, during upgrade all payment provider dll:s have been deleted and you need to download and install the add-ons. Instructions on how to install is in the add-on package.

4. Reconfigure the Web.Config file

During upgrade the Web.Config file is overwritten. Any custom changes made must be restored manually from the backup. Open the Web.Config file found in the wwwroot directory of your installation and compare with your back up copy. More information on how to configure the Web.Config file

5. If links are broken after upgrade

If you encounter broken links from one page to another within your website, check if the links start with "/web/" (not using http and domain name). If not, the broken links could be public url:s that have been used inside the editor and they will not work after upgrade. When linking between pages of one website internal links should always be used. They are stored in a way that is not affected by upgrades, change of page name or moving the page to another location within the site. Starting in Litium Studio 4.6 all internal links are stored as Page Id:s that will not be affected by upgrades etc.

Congratulations! Your product has been upgraded. Now it is time to upgrade the solution part of the project.

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 your solution.