Våra sajter
www.litium.se

Ta ditt hjärta och din själ till webben! Läs mer om webblösningar.
Litium Studio Knowledgecenter

Knowledge Center för Litium Studio
Litium Scensum Knowledge Center

Knowledge Center för Litium Scensum
Litium Partner

Återfinns information som partner till Litium.
Support

Install Litium Scensum 2.1

Introduction

The Scensum solution comes with 3 startup projects(public site, backoffice and media) that are designed to cut the startup time for a standard e-commerce project. To get the startup projets to run there are a number of steps that needs to be performed.

Download the latest release

Download and unzip the Scensum release to a folder of your choosing. In the uncompressed folder you’ll find a number of sub folders:

  • DB – Contains a compressed start up database for the current release
  • DB change report from 2.0 – Contains database diff documentation generated from the previous version
  • Files – Contains all files needed for the current release, e.g. CSS, icons, images and scripts.
  • Lib – All reference files needed by the Scensum startup solution
  • Src – Contains the source code for the Scensum startup solution
  • Startup change report from 2.0 – Contains startup diff documentation generated from the previous version
  • Tools – Contains tools used to maintain a Scensum installation, e.g. rebuild Lucene index, create/edit model etc

Database

To install a new version of the Scensum 2.1 database, unzip and restore the database backup file.

By default the database is restored as read only, use the SQL manager to change it to read/write. Right click the database in the Object Explorer and select Properties/Options. Scroll down to State and change the Database Read-Only setting from true to false. Click Ok and Yes to execute the change.

Create a login and assign a password for the Scensum database. In this scenario use both mixed mode- and integrated security for the server and create the user with SQL Server authentication. Assign the public and dbowner role for that user on the Scensum database. If you are using an instance of SQL Express on your local development box the connection settings for the database.xml file might look like this Data Source=.\SQLEXPRESS;Initial Catalog=Scensum 2.1;User Id=mysite;Password=scensum

Enable MSDTC

For transactions to work correctly MSDTC must be enabled. For more information, go here:
http://technet.microsoft.com/en-us/library/cc753510.aspx 

Scensum startup solution

Copy the Files, Lib, Src and Tools folders and the Litium.Scensum.sln file from the Scensum release to your development folder.

Note! In the following chapters we will assume that you have placed the startup solution files in C:\Scensum\MySite\

Note! The projects in the folders have relative references to each other so if possible try to keep the individual structure.

Make sure that the files are all write enabled by selecting all, right clicking and uncheck the Read-only checkbox. Apply to all files and subfolders.

Best practice! To allow for multiple Scensum instances on the same web server you’ll have to change the virtual path name of the virtual directory.

Open the Litium.Scensum.sln solution file with Visual Studio but decline the prompt to create virtual directories for the web applications. You’ll get this prompt 3 times for the back office, the public site and the media project.

The solution loads Scensum with the above projects unloaded. Right click the BackOffice project in the Solution Explorer and choose to Edit the project file. Scroll down and change the IISUrl tag to your choosing. To get a good sorting in the IIS a recommended naming convention is “Litium_Scensum_<your project/customer>_BackOffice”. Save the file, right click the project in the Solution Explorer and choose Reload. Click Yes to let Visual Studio create the virtual directory.

Repeat for Web and Media.Web projects.

Media archive

The images for the Scensum solution are provided by the Media.Web application and should be added to both public site and back office.

Right click the web application for back office in the IIS, choose Add Application and name it “mediaarchive”. Use the default application pool. The application should have its physical path pointing to the disk location where Litium.Scensum.Media.Web resides.

Repeat for the public site.

Media virtual folder

The public site is dependent on icons, CSS and script files. The files needed for the startup solution are located in the Files\Media folder

Create a virtual directory inside of the Litium_Scensum_Web application and name it “media”. Set the physical path to the Files\Media folder. Set physical path credentials if required.

Note! The entire Files folder should be placed on a centralized location where it could be accessed by multiple developers and/or multiple web servers.

Configure the xml setting files

C:\Scensum\MySite\Src\Setting\Database.xml:

<Root>
  <Group Name="Default">
    <Setting Name="ConnectionString">Data Source=localhost; Initial Catalog=Scensum2_1; User ID=...; Password=...;</Setting>
    <Setting Name="Timeout">180</Setting>
  </Group>
</Root>

C:\Scensum\MySite\Src\Setting\Media.xml:

<Root> 
  <Group Name="Media"> 
    <Setting Name="StoragePath">C:\Scensum\MySite\Files\MediaArchive\</Setting> 
    <Setting Name="TempImagePath">C:\Scensum\MySite\Files\MediaArchive\Temp\</Setting> Changed!
    <Setting Name="CachePath">C:\Scensum\MySite\Files\ImageCache\</Setting> 
    <Setting Name="DummyImagePath">C:\Scensum\MySite\Files\MediaArchive\no-image.png</Setting> 
    <Setting Name="MediaTypeSpecificImageStoragePath">C:\Scensum\MySite\Files\MediaFormatIcon\</Setting> New!
    <Setting Name="UnknownImagePath">C:\Scensum\MySite\Files\MediaFormatIcon\unknown.png</Setting> New!
  </Group> 
</Root>

C:\Scensum\MySite\Src\Setting\Template.xml:

<Root> 
  <Group Name="Template"> 
    <Setting Name="ImagePath">C:\Scensum\MySite\Files\TemplateThumbnail\</Setting> Changed!
    <Setting Name="DummyImagePath">C:\Scensum\MySite\Files\TemplateThumbnail\noTemplate.gif</Setting> Changed!
  </Group> 
</Root>

View State

To ensure that the view state is correctly stored on disk, open the C:\Scensum\MySite\Src\Litium.Scensum.BackOffice\Web.config file and set the PersistedViewStateFolderPath to “C:\Scensum\MySite\Files\BackOfficeViewState\”.

Search engine

By default Scensum uses Lucene as a search engine and performs two different searches, public site product search and search phrase statistics search. In the search configuration setting file, the path to the Lucene index should specified.

Open the "C:\Scensum\MySite\Src\Setting\SearchConfiguration.xml" and set the path attribute for index SwedishProducts and SwedishSearchStatistics to “C:\Scensum\MySite\Files\LuceneIndex\products” and “C:\Scensum\MySite\Files\LuceneIndex\searchstatistics”.

The Lucene index files are created by running the LuceneIndexBuilder tool located in the C:\Scensum\MySite\Tools folder. You can run the index builder directly by running the Litium.Scensum.IndexBuilder.exe file.

TinyMCE

A WYSIWYG control is used from the back office application to create rich text content. The cache path in the back office web.config file needs to be specified.

Open the C:\Scensum\MySite\Src\Litium.Scensum.BackOffice\Web.config and change the cachePath tag to “C:\Scensum\MySite\Files\temp”

Dashboard

The built in dashboard in the back office interface uses chart controls to render order and visitor statistics. You’ll need to set the ChartImageHandler tag to the Files\Temp folder

Open the C:\Scensum\MySite\Src\Litium.Scensum.BackOffice\Web.config and change the ChartImageHandler tag to "storage=file;timeout=20;dir= C:\Scensum\MySite\Files\temp\;”

Ajax

For Ajax to work properly, current asp.net user should have permissions on "Temporary ASP.NET Files"" folder (e.g. "C:\Windows\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files").

Back Office

Build the back office project from Visual Studio and then open the IIS, right click the back office web application and select Manage Application\Browse. Your default web browser should launch and the back office administration interface should display the login screen.

Sign in using the credentials supplied to you together with the release.

Media

Build the media project from Visual Studio. Media handles the scaling and caching of product images. Original source images are stored in folder mediaarchive and the media web then generates what ever is requested from the public site. There is no html page visible when surfing this url.

Public site

Before you can run the public site you’ll need to make sure the channels are set up correctly.

Open the core.tChannel table in the database and change the application name to the URL of your public site, e.g. if the URL to you site is http://localhost/Litium_Scensum_MySite_Web the application name should be “localhost/Litium_Scensum_MySite_Web”.

Build the public site project (Litium.Scensum.Web) from Visual Studio and then open the IIS, right click the public site web application and select Manage Application\Browse. Your default web browser should launch and the public site interface should display the start page of the startup site.

Email and SMTP server for development on local machine

Before you can place orders and get email runing you need to configure the SMTP settings and optionally install a development SMTP server. On your development box we recommend the use of a small fake SMTP-server. http://papercut.codeplex.com/ Download it and install and this way you do not have to use yur normal public  server.

Open the file \MySite\Src\Setting\Messaging.Database.xml and simply copy the settings from Database.xml

Finally install the Litium.Scensum.Messaging service and start it up.
Execute the following command to install the service:

C:\Windows\Microsoft.NET\Framework\v2.0.50727>installutil C:\Scensum\MySite\Tools\Litium.Scensum.Messaging\Litium.Scensum.Messaging.exe

Then go to services and start the Litium.Scensum.Messaging service.

For mor information on Messaging see topic undr documentation

 

Trouble shooting

Public site search returns “Index cannot be found. Parameter name: indexPath”

Make sure you have created the Lucene index by running the LuceneIndexBuilder tool in the Files\Tools directory.

The index builder tool should create two index folders in the Files\LuceneIndex directory. If the index builder tool completes without error but the LuceneIndex directory doesn’t contain any index folders, please make sure the SearchConfiguration.xml is configured correctly.

Public site search does not display Ajax search suggestions

Make sure you have created the Lucene index by running the LuceneIndexBuilder tool in the Files\Tools directory. As the Ajax search suggestions are based on search statistics you’ll first have to make a couple of searchies to generate statistics. The LuceneIndexBuilder tool will then generate an index file based on the created statistics.

Channel with application name 'localhost/...’ does not exist

The public site URL is missing or incorrectly configured in the database. Open core.tChannel and validate that the application name column matches the URL. The protocol e.g. “http://” should not be in the database.

 

Share this

| More

Comments made

No comments are made

You need to be logged in to make a comment

Username*  


Password*  





Create your own user account!