This is a guide how to perform a manual upgrade of Litium Studio. We recommend that you to use the upgrade program instead of upgrading manually.
Step 1 - Check system requirements and release notes
Check system requirements and prerequisites, full release notes and breaking changes.
Step 2 - Request a new license
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 cannot be used. The upgraded Litium Studio will not give access to the modules or the control panel without a license matching the version number.
Step 3 - Create backup
Create a full backup of your database and www root folder.
Step 4 - Update the database
When the process has begun, the website is not accessible for users and all users that are logged in will be disconnected and logged out. All script files are found in the compressed file Upgrade.zip in folder DB\Scripts.
Run the DB-scripts listed below. After each script has executed, check the result panel for red error messages. If an error is exposed check the error message and decide whether to rollback your backup or continue.
1. UpgradeTo461.HF.sql (skip this step if the latest 4.6.1 Hotfix has been installed)
2. UpgradeTo462.sql
3. UpgradeTo462.HF.sql (if it exists, otherwise you can skip this step)
4. Functions.sql
5. Stored_Procedures.sql
6. Triggers.sql
Step 5 - Update the files in the web root folder
Some files in the web root have been changed and need to be replaced on the server. Note that the files in the web\Site folder will be replaced when upgrading. If the default templates have been modified using the same file name, your changes will be overwritten.
1. Remove the bin and Litium Studio folders found in the web root folder of your installation.
2. Copy the web.config, bin and Litium Studio folders from the Deploy folder to the web root. The Deploy folder is found in the compressed Upgrade.zip file.
3. The Web.config file has been replaced. Update the new file with the correct information (from your backup).
4. Check that your custom templates are working as expected. If based on the default templates, we recommend that you check the changes done to default templates.
5. Check that all specific installation changes and components will build with the new assemblies.
Step 6 - Update the system, module and website strings
Some system, module and web site strings have been updated or added.
6.1 Update the system strings
Repeat the following for each xml file in the Definitions folder inside the upgrade.zip package, and for each language installed:
1. Open “Control panel - System Settings - System texts”.
2. Click “Import” in the toolbar.
3. Choose the file to import: “SystemStrings[Language].xml” (replace “Language” with the
appropriate language).
4. Select language in the “Select language” dropdown.
5. Mark the checkbox “Replace existing values” only if the current values should be overwritten.
6. Click the “Import” toolbar button to import.
6.2 Update the module strings
Repeat the following for each XML file in the Definitions folder inside the upgrade.zip package, for each module and for each language installed:
1. Open “Control panel - System Settings - Modules”.
2. Select the module to update and click the “Texts” toolbar button.
3. Select the “Import” toolbar button.
4. Choose the file to import: “[ModuleName]ModuleStrings[Language].xml” (replace
“ModuleName” and “Language” with the appropriate module name and language).
5. Mark the checkbox “Replace existing values” only if the current values should be overwritten.
6. Click the “Import” toolbar button to import.
6.3 Update the web site strings
Repeat the following for each XML file in the Definitions folder inside the upgrade.zip package and for each web site (note that all strings for the website will be overwritten):
1. Open “Control panel - Web Publishing - Web sites and texts”.
2. Select the web site to update and click the “Texts” toolbar button.
3. Select the “Import” toolbar button.
4. Choose the file to import: “CMSWebSiteStrings[Language].xml” and/or NewsletterWebSiteStrings[Language].xml” (replace “Language” with the appropriate
language). Make sure to import using the same language as the web site is using.
5. Mark the checkbox “Replace existing values” only if the current values should be
overwritten.
6. Click the “Import” toolbar button to import.
Step 7 - Rebuild the search indices
Rebuild the search indices.
1. Open “Control panel - System Settings - Search indices”.
2. Click the “Rebuild All” button.
Step 8 - Install the new license
The upgraded Litium Studio will not give access to the modules or the control panel without a license matching the version number. When you have requested a new license, you will receive an e-mail with the license file. The license file should be added in the bin folder of the web root.