Home » Getting started » How to install Litium Studio » How to install Litium Studio
A default installation consists of the following steps:
1. Preparations
2. Set up the database
3. Set up the web site
4. Request a license for the installation
Before you start
Download the latest release of Litium Studio
Important notice!
The license that ships with Litium Studio is only a time limited evaluation license, and must be replaced by a correct license as soon as possible. Please visit Litium Studio Knowledge Center to request a new license.
1 Preparations
Verify the compatibility between the hosting environment and Litium Studio. Check the system requirements and important prerequisites.
2 Set up the database
Open the SQL Server Management Studio. You install the database by restoring a backup file into a new empty database. Do not attempt to restore into an existing empty database and do not perform a partial restore, always use a complete restore. The installation procedure differs slightly depending on whether you are using Microsoft SQL Server 2005 or 2008.
2.1 Restore the Litium Studio backup
Restore the backup “\DB\Backup\LitiumStudio_MSSQL2005.bak” into a new database by right clicking Databases/Restore database…. Type a name for your new database, select radio button From device and click …. In the new frame click Add. Find the file “\DB\Backup\LitiumStudio_MSSQL2005.bak” and check that the Selected path is correct. Click OK. Check the “Litium Studio Full Database backup” under Select the backups sets to restore and then click OK.
Right-click on the new database, select Properties/Options and ensure that the option Recursive triggers Enabled is set to true.
2.2 Create login
Right-click on Security in the left menu and select New/Login. We recommend that SQL Server Authentication is used, not Windows Authentication. You would also typically uncheck Enforce password expiration and User must change password at next login. Make the new database the Default database. To set permissions, in the left menu of the Login New window, select the User Mapping page, check your database and then check the db_owner and public permissions.
3 Set up the web site
Use the Internet Information Services (IIS) Manager to add a new website to the web server. The installation procedure differs slightly depending on which version of IIS you are using.
3.1 Using IIS 5 or 6
a) Create a new empty directory for the new web site c:\inetpub\x\wwwroot, where “x” is the name of your new web site.
b) Open the IIS Manager. Create a new Application Pool by right-clicking the Application Pools directory and select New/Application pool.
c) Configure the settings for recycling, shutting down the worker process after certain idle time and exceeding maximum failures. You do this by right-clicking the Application Pool, select Properties and set the values under the Performance, Health and Recycling tabs. Note: The settings should be fitted according to the server installation. Values in Image 3 are only examples.
d) If you wish to group several Litium Studio websites in the same pool, it is good practice to place all installations of the same version of Litium Studio in the same Application Pool (e.g. one pool for all 4.5 installations). Note that all web sites within the same pool must use the same version of ASP.NET.
e) Create a new Web Site (Note! The web site name cannot consist of numbers alone). Set the Home Directory/Path to the wwwroot directory created in step 3.1.a using the Application Pool created in step 3.1.b. Use the permissions as proposed by the wizard (ensure that Read and Run Scripts permissions are checked). Enter the domain name of the default site of the installation in the Host name input field (If using IE6 or later, you cannot use underscore in the domain name). Assert that the Web Site runs in .NET Full Trust mode.
f) Select “default.aspx” as the Default Document for the Web Site (use the Document tab). Add “default.aspx” if it is not listed and remove all other documents in the list. Ensure that the Enable default document option is checked.
g) Redirect all HTML 404 errors to the Litium Studio error page (use the Custom Errors tab). For the 404 error set Message = “URL” and Path = “[NAME]/Site/CMS/PageNotFound.aspx” where [NAME] equals the name of the Web Site. Note that the path is case sensitive.
h) Ensure that the Web Site uses ASP.NET version 2.0 (use the ASP.NET tab).
i) Ensure that every file is executed by the ASP.Net-dll by right clicking your website and select Properties/Home Directory/Configuration/Add. Set Wildcard application maps to “C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll”. Ensure that Verify that file exists is unchecked. (See image 4.)
j) Copy the whole contents of the Deploy directory in the Litium Studio release to the wwwroot directory created in step 3.1.a. Note: if you move the files instead of copying the files, file permissions will have to be set manually.
3.2 Using IIS 7
a) Create a new empty directory for the new Web Site, typically c:\Inetpub\x\wwwroot, where “x” is the name of the new web site.
b) Open the IIS Manager. Create a new Application Pool by right-clicking Application Pools/Add application pool. Select “.NET Framework v2.0” and “Integrated” Managed Pipeline Mode.
c) Configure the settings for recycling, shutting down the worker process after certain idle time and exceeding maximum failures. You do this by right-clicking the application pool, select Advanced Settings and set the values under Process Model, Rapid-Fail Protection and Recycling. Note: The settings should be fitted according to the server installation. Values in Image 5 are only examples.
d) If you wish to group several Litium Studio websites in the same pool, it is good practice to place all installations of the same version of Litium Studio in the same Application Pool (e.g. one pool for all 4.5 installations). Note that all web sites within the same pool must use the same version of ASP.NET.
e) Create a new Web Site by right clicking on Sites/Add website in the left menu, using the Application Pool selected in step 3.2.b. Type a site name (Note! The name cannot consist of numbers alone) and set the Physical path to the wwwroot directory created in step 3.2.a. Enter the domain name for the default site of the installation in the Host name input field (If using IE6 or later, you cannot use underscore in the domain name). Click ok.
f) Double click your site in the left menu of the IIS Manager. Double-click the Default Document icon in the center frame and select "default.aspx" as the default file for the Web Site. Add “default.aspx” if it is not listed. Remove all other documents in the list.
g) Double click the .NET Trust Levels icon in the center frame and ensure that the Web Site runs in .NET Full Trust mode.
h) Copy the whole contents of the Deploy directory in the Litium Studio release to the wwwroot directory created in step 3.2.a. Select Copy and Replace for the Web.Config file.
Note: if you move the files instead of copying the files, file permissions will have to be set manually.
3.3 Create a Files directory
Create an empty directory where the new web site will store its files.
3.3.1 Create a new empty directory
Create a new empty directory called c:\inetpub\x\Files, where “x” is the name of your new web site created in step 3.1.a (using IIS5 or 6) or step 3.2.a (using IIS 7). Ensure that the Files directory is not placed inside the wwwroot directory of the web site.
3.3.2 Ensure that the Application Pool Identity has read and write permissions to the Files directory as follows:
a. Right click on the Files directory and select Properties/Security/Advanced/Change Permissions/Add (if the Application Pool Identity already exists in the list click Edit and go to step c).
b. Enter the name of the Application Pool Identity (in IIS 7 this is usually the “IIS_IUSRS” or the “NETWORK SERVICE” user account on the local web server). Starting with Windows 7 and Windows Server 2008 you can add the virtual account DefaultAppPool instead of the old account type. For every Application Pool you create, the IIS Admin Process (WAS) will create a virtual account with the name of the new Application Pool and run the Application Pool's worker processes under this account. To add this new virtual identity, simply type “IIS APPPOOL\DefaultAppPool” in the edit box. Read more about Process Model Settings in IIS7 at Litium Studio Knowledge Center and at the IIS Learning Center.
c. Set the following Allow permissions (apply to “This folder, subfolders and files”) as shown in Image 7:
- “List folder / read data”
- “Read attributes”
- “Read extended attributes”
- “Create files / write data”
- “Create folders / append data”
- “Write attributes”
- “Write extended attributes”
- “Delete subfolders and files”
- “Delete”
Ensure that the user does not have
Allow permissions for:
- “Full control”
- “Traverse folder / execute file”
- “Read permissions”
- “Change permissions”
- “Take ownership”
3.3.3 Copy the contents of the Files directory
Copy the entire contents of the Files directory in the Litium Studio release to the Files directory created in step 3.3.1. Note: if you move the files instead of copying the files, file permissions will have to be set manually.
3.4 Configure Web.Config
Open the Web.Config file placed in the wwwroot directory of your installation using MS Visual Studio (2008 or later) and make the following changes:
a) Enter the connection string to the database in the connectionStrings\add node (where name="FoundationConnectionString). Change the attribute values for User ID, Password, Database and Server (according to the SQL Server database login created in step 2.2).
b) Set the SMTP server to use in the node: litium\foundation\general\smtpServer (attribute “value”).
c) Set the complete path to the File directory in the node litium\foundation\general\filesDirectory (attribute “value”).
d) Set the maximum cache size in the node litium\studio\cms (attribute “MaxCacheSizeInMB”) to the number of megabytes that the site may cache ( “-1” = no limit).
e) Ensure that the web application is not in debug mode by setting the value for the system.web\compilation node to debug= “false”.
f) Ensure that the system.web\customErrors node is set to mode=”On”
3.5 Configuring the DNS server
Create the DNS Entry in your DNS server for the domain name entered when creating the new Web Site in the IIS (or add it to your local hosts file when developing on your local machine, “C:\Windows\System32\drivers\etc\hosts”).
3.6 Start the web site and log in
Start the web site in the IIS Manager by right clicking the site and select Manage Web Site/Start, open a browser and type the domain name of your site into the address field followed by /LitiumStudio (“yourdomain/LitiumStudio”).
Log in to Litium Studio back office using username = “System” and password = “Password”.
Note: You need to change this password when you receive your new license.
3.7 Configure the default web site
Once logged in to the back office, you need to configure the default web site. Start by changing the domain name (to the name entered in the IIS) by clicking the Litium Studio logotype and select Control Panel/Web Publishing/Web sites and Texts. Select your site and then click Edit. Add the Domain name entered in the IIS in step 3.
3.8 Rebuild the search indices
Rebuild all search indices by opening Control Panel/System settings/Search indices. Click the Rebuild All button.
4 Request a license for the installation
The license that ships with Litium Studio is only a time limited evaluation license, and must be replaced by a correct license as soon as possible. Please request a new license.
When the evaluation time has expired, the installation can no longer be used.
Comments made
No comments are made
You need to be logged in to make a comment