How to install Sense/Net from source package (IIS 7.5 and IIS 7.0)

From Sense/Net Wiki
Jump to: navigation, search
  •  
  •  
  •  
  •  
  • 100%
  • 6.0
  • Enterprise
  • Community
  • Planned

Overview

In this document we would like to guide you through the installation process of Sense/Net ECM from a source package. We hope that you will encounter no complications during installation, or later on while working with Sense/Net ECM. If you come across a bug by any chance, or have questions concerning our product, feel free to contact us at our forum.

This document describes the steps of installing Sense/Net ECM on machines with IIS 7.0 or higher version.

In case you use IIS 6.0, please read the following howto: How to install Sense/Net from source package (IIS 6.0)

Steps

In case you are an Enterprise customer and want to use the Task Management feature in Sense/Net ECM (e.g. you want to have preview images for your documents), please install the Task Management component first.

1. Download Sense/Net ECM

Download the Sense/Net ECM source package. The latest version of this package is available on our CodePlex page.

The public CodePlex page above offers Sense/Net ECM Community Edition. Customers who have access to the Enterprise Edition should use that source package. For differences between the two editions, please visit the following article:

Install MSBuild Extension Pack

If you did not install this package previously, please download and install it, as it is a prerequisite for building the Sense/Net ECM solution.

2. Extract the package

Extract the package to a folder of your choice, we will refer to this location as sourceroot later on.

3. Set up IIS

3.1 Start the IIS Manager

Start IIS Manager (Control Panel\Administrative Tools\Internet Information Services (IIS) Manager).

3.2 Check bindings

Leave bindings of the created site as set by default - you will be able to access it using http://localhost. Ensure that no other (running) site is bound to localhost.

To use another hostname you will need to configure that address in the web.config with the urlList element. However we recommend you finish the installation first using the localhost binding.

3.3 Add a new site

Create a new website: Right click on Sites and select Add Web Site.

Add new site

Choose a name for your site (Site name).

Set your Physical path to: %sourceroot%\Source\SenseNet\WebSite

Configure website

4. Check application pool settings

Ensure that the application pool of your site is configured properly. You can find the recommended settings for each version in the following table:

table 1 - Application pool settings
Sense/Net version .NET Framework version of the application pool
6.0.1 or before v2.0
6.0.2 or later v4.0

To edit application pool settings, you should follow the steps below:

4.1 Find the application pool of your site

By clicking on Application pool in the upper left corner you will get the list of available application pools. If the settings of your site's application pool doesn't match the recommended settints (See table 1) you have to change it.

Browse application pools
4.2 Select the appropriate version

Double-click on the application pool of your site, then select the appropriate version of .NET Framework from the .NET Framework version dropdown.

Check application pool settings

5. Set up database connection

The easiest way to set up database connection is creating an Alias in your SQL Server Configuration Manager.

5.1. Open SQL Server Configuration Manager

5.2. Right Click on Aliases, then select New Alias

Creating new alias

5.3. Set up the new Alias

Setting the porperties

Use the values from the following table (you have to replace DB_SERVER_NAME to the name of your sql server instance)

Caption text
Property name Property value
Alias MySenseNetContentRepositoryDatasource
Protocol Named Pipes
Server DB_SERVER_NAME

The Alias Name must be set exactly as above, please be aware of uppercase and lowercase characters and remove any leading or trailing space characters that may got there because of a copy/paste operation.

Please create an alias for every configuration. In the image above you see two Alias nodes in the tree: please create the alias for both!

5.4 Enable client protocols

Please go through the Client Protocols sections for all configurations above, and enable all protocol types (Named pipes, TCP/IP).

6. Open the solution

Open %sourceroot%\Source\SenseNet\SenseNet.sln in Visual Studio

7. Rebuild the entire solution

Rebuild the entire solution

8. Run install script

To run this script you need to have administrative rights for the SQL Server instance.

Run the install script: %sourceroot%\Deployment\InstallSenseNet.bat

If the installation fails because of dll load errors (e.g. you see "Could not load library" on the console) than make sure that all dll files in the Tools, bin, and References folders are unblocked. You can unblock files in a single folder using the Unblock-File command in Windows PowerShell:

dir "C:\SenseNet\References" | Unblock-File

dir "C:\SenseNet\Source\SenseNet\Website\bin" | Unblock-File

dir "C:\SenseNet\Source\SenseNet\Website\Tools" | Unblock-File

9. Set up permissions

The identity of the application pool running the site must be (at least) the dbowner of SenseNetContentRepository database. (Hint: if your app pool is running in the name of ApplicationPoolIdentity you may create a new login for IIS APPPOOL\<application pool name> in Microsoft SQL Server Management Studio (don't search for this user, just type it in) and grant db_owner permissions).

10. Installation finished

You can browse your application on http://localhost This link works only if you have a live demo install on your localhost! (Don't forget! Some feature needs authentication and/or admin rights!).

Video

Related links

How to install Sense/Net from web deployment package (IIS 6.0)

How to install Sense/Net from web deployment package (IIS 7.5 and IIS 7.0)

How to install Sense/Net from source package (IIS 6.0)