Step 1 - Pre-upgrade steps
Steps to follow before starting the upgrade.
1. Verify the compatibility between the hosting environment and Litium Studio
These are the System requirements for Litium Studio latest version.
2. Ensure that the following prerequisites are in place
.NET Framework 4.5.2
.NET Framework 4.5.2 has to be installed on the machine. Ensure that the Internet Information Services (IIS) is able to handle ASP.NET. If missing, run “aspnet_regiis.exe –i” to reinstall ASP.NET on the IIS. "aspnet_regiis.exe" is usually found in C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319.
System user login
System user login password is removed in Litium Studio 4.8. To login as System user you need to use a local machine user account with administrator priviledges, or a user in the domain with admin previledges.
Makesure you have a account to login as system user, or you may create the account after upgrading to login to backoffice as the System user.
3. Setup a test environment
An upgrade should never be performed on a live production environment. Create a localtest environment to use for upgrading before going live.
4. Remove all unused files in the solution
Many compilation errors are due to old files that are not used in the project. In order to avoid future upgrade problems, we suggest that you keep the solution as tidy as possible, deleting page types and files that are not in use. They can always be added later if needed.
From version 4.5 all solution files are moved to the Site CMS/panels folder. Be sure to remove both the page type and the file.
5. Additional steps when upgrading the Product Catalog module
Remove unused languages from the Product Catalog module
If there are unused languages that are connected to the Product Catalog module, remove them via settings of the module. Go to the Control Panel/System settings/Language/Delete.
Set translations for all the languages that are connected to the Product Catalog module
Set translations in all languages that are connected to the Product Catalog module for each product catalog and for each article that is published under the product catalog. Otherwise product groups and products will not have the status published in the Product Catalog module after the upgrade.
Check items in the Product Catalog module
- Each article can be only in one variant group in the new version of the Litium Studio. Ensure that articles belong to only one variant group.
- Variant group having variant “Article x” and “Article x” cannot be product in the same product group. Upgrade tool will remove the product created via “Article x” from that product group. Product created via variant group having “Article x” will be left in the product group.
- Products created via same article cannot be in the same product group. Upgrade tool will remove the products created via “Article x” from the product group and only one product created via “Article x” will be left in the product group.
- Products created via variant groups having the same article cannot be in the same product group. Upgrade tool will remove the products created via variant groups having “Article x” and only one product created via variant group having “Article x” will be left in the product group.
6. Check file data
- Check that all properties that should be stored in database and should have file-data also have that data. Use the sql-script FileStorageCheckBeforeUpgrade.sql found at the bottom of this page.
- Check that all files that should be on disc are in correct location.
- Check that all files that are in disc have not attribute read only.
7. Make sure the solution compiles
We recommend that you make sure your solution compiles before upgrading. If you encounter compilation errors, correct them before running the upgrade tool.
Your web site will build correctly before starting upgrade:
- Start Visual Studio.
- Open your website.
- Build your website.
- Correct build errors.
- Redo the steps until no build errors occur.
- Close Visual Studio to avoid file locks during the upgrade.
8. Request a new license - the upgrade program deletes the previous
The upgrade program deletes the old license when running and doesn't install any temporary license. You should therefore request a new license before running the upgrade program and be ready to install it immediately afterwards or the installation can not be used. The upgraded Litium Studio will not give access to the modules or the control panel without a license matching the version number.