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 and unblock the Litium Studio zip-file
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".
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 make sure the following search filters are installed.
Search filters on the web servers
In order for the search engine to function when searching documents, the following must be installed on each web server Download and install MS Office Filter Pack
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.
2.1 Restore the Litium Studio backup
Restore the backup “\DB\Backup\LitiumStudio.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.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
Under General, 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.
3.1 Using IIS7 or later
3.1.1 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.
3.1.2 Open the IIS Manager. Create a new Application Pool by right-clicking Application Pools/Add application pool. Select “.NET Framework v4.0” and “Integrated” Managed Pipeline Mode.
3.1.3 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.
NOTE! If you encounter an "Access Denied" error message when trying to login to back office, change the Load User Profile flag to "True".
3.1.4 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.6 installations). Note that all web sites within the same pool must use the same version of ASP.NET.
3.1.5 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 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. Click OK.
3.1.6 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.2 Create a Files directory
Create an empty directory where the new web site will store its files.
3.2.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 step3.2.a. Ensure that the Files directory is not placed inside the wwwroot directory of the web site.
3.2.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 (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”):
- “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.2.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.3 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:
- 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).
- Set the SMTP server to use in the node: litium\foundation\general\smtpServer (attribute “value”).
- Set the complete path to the File directory in the node litium\foundation\general\filesDirectory (attribute “value”).
- Ensure that the web application is not in debug mode by setting the value for the system.web\compilation node to debug= “false”.
- Ensure that the system.web\customErrors node is set to mode=”On”
3.4 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.5 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 your windows account including the domainname/computername. If the windows account is an email-address, start the line with a backslash (\).
3.6 Configure the default web site
Once logged into 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.7 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.