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

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

sensenet 7: this article has a more recent version on the new community site.

Overview

In this document we would like to guide you through the installation process of Sense/Net ECM. We hope that you will encounter no complications during installation, or later on in 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 SenseNet 6.0 on machines with IIS 7.0 or IIS 7.5.

In case you use IIS 6.0, please read the following howto: How to install Sense/Net from web deployment 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

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

2. Web Deployment Tool

Ensure that Web Deployment Tool is installed on your system. You can download it from: http://www.iis.net/download/webdeploy.

If you can't find it on your computer, here's a guide on installing it: http://www.howtogeek.com/112455/how-to-install-iis-8-on-windows-8/


This tool allows you to import applications using IIS Manager.

3. Start the IIS Manager

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

4. 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), and select the installation path (Physical path).

Physical path should point to an empty directory. The site will be deployed under this directory.

Configure site

5. 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.

6. 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:

Step 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
Step 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

7. Import package

Right click on the newly created site and select Deploy->Import Application. Select the zip package you have downloaded with browsing and import it.

Import application

8. Setup

In the following screens you can configure the installation process.

Screen #1

You have to choose Next on this screen.

Any changes made on this page will break the proper installation process.

Import application
Screen #2

In this screen you can set if you want to create a new database or you can use an existing one. Creating a new database requires sa privileges on the selected server instance. Choosing "Use existing database" is ideal for Web Hosting scenarios.

"No database" option is not supported by Sense/Net

Select database
Screen #3

Depending on what you have chosen on the previous screen you have to provide sql related information.

SQL Server Authentication must be enabled on your SQL Server instance. To enable SQL Server Authentication read the following howto.

SQL authentication
Use existing database

If you chose Use existing database you will have to provide the following informations:

Use existing database
Field Value
Application Path You have to leave this field empty!
Database Server The name of a Microsoft SQL Server instance where the application's database will be deployed.
Database Name The name of an existing database where the application's database will be installed.
Database User Name The name of an existing user which will be used by the application to connect to the database.
Database Password Password for the user above.
Create new database

If you chose Create new database you will have to provide the following informations:

Create new database
Field Value
Application Path You have to leave this field empty!
Database Server The name of a Microsoft SQL Server instance where the application's database will be deployed.
Database Name The name of the database where the application's database will be installed.
Database Administrator The name of a power user who has enough permission to create a database and a user.
Database Administrator Password Password for the user above.
Database User Name The name of a user which will be used by the application to connect to the database. This user will be created by the install script.
Database Password Password for the user above.

When selecting Create new database the provided database name should not point to an existing database. Providing an existing database name will result in errors during installation process!

When selecting Create new database the provided 'Database User Name' should not point to an existing database user name. Providing an existing database user name will result in errors during installation process!

Warning

A pop up window will warn you: the application will be installed under the root directory. You should continue the installation by clicking OK (Installing Sense/Net into a folder beneath the root is not supported).

Warning

9. Launch portal

After the import has finished, right click on the site and select Manage Web Site->Browse. The default site will load, your installation is finished.

For Enterprise customers: you will need to set the appropriate Task Management settings in Sense/Net for the Task Management component to work - e.g. generate preview images.

Video

Related links

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

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

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

Installation troubleshooting