Step 1 - Pre-upgrade steps
Steps to follow before starting the upgrade.
1. Verify the compatibility between the hosting environment and Litium Studio
Check the system requirements for Litium Studio latest version.
2. Download and unblock the zip-files
Due to a Microsoft security fix you need to unblock the zip-file after downloading. Right click the .zip file (in Windows Explorer), select "Properties", and then "Unblock".
3. 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.
4. 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.
5. 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.
All solution files can be found in the Site CMS/panels folder. Be sure to remove both the page type and the file.
6. 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.
7. 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.