Kentico 8

1. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.1 Quick installation on a local machine (no requirements needed) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 Server and hosting requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.2.1 Configuring IIS for the installation of Kentico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.3 Installing Kentico - custom installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.4 Installing Kentico (Questions and Answers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.5 Deploying Kentico to a live server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

1.5.1 Creating virtual directories and application pools in IIS 7.5 and 7.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171.6 Additional database installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211.7 Adding and removing components from an installed Kentico web project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231.8 Installing Kentico from the command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1.8.1 Command line installation - XML configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241.9 Troubleshooting installation issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

1.9.1 Application stops after being idle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301.9.2 Disk permission problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

1.10 Uninstalling Kentico . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

InstallationTo install Kentico, run the file, which opens the :Kentico_8_0.exe Kentico Installer

Installing Kentico

Where to get more information?To learn how to develop websites, see .Kentico 8 Tutorial

You can also visit our portal for developers with blogs, forums, knowledge base and other documentation material at .DevNet

If you need advice on how to use Kentico, feel free to write to   The support team operates non-stop and will be happysupport@kentico.com.to help you.

 

Evaluation

You can begin by using the button.installing Kentico for evaluation purposes Quick installation

Local installation

Check if your development server meets the recommended configuration.

Install Kentico on your local computer with your own preferred settings using the button. If you come across anyCustom installationdifficulties with selecting the right options, see  for recommendations.Installing Kentico (Q&A)

Remote installation

Check if your development server meets the recommended configuration.

Develop your website on a remote server or set up a production environment. You will find detailed procedures for this type ofinstallation in the section.Deploying Kentico to a live server

1. 2.

3.

 

Quick installation on a local machine (no requirements needed)This type of installation is the quickest way of installing Kentico on your machine. The only prerequisites you will need are:

The operating system: Windows Vista Home Premium/Business/Enterprise/Ultimate, Windows 7 (both 32bit and 64bit) or Windows 8(both 32bit and 64bit), or their corresponding server versions – Windows Server 2008, 2008 R2, 2012.Connection to the Internet.

Quick installation

All you need to do is:

On the home page of the Installer, agree to the license terms.Click .Quick installation

Choose a sample site you wish to install. We recommend the and the . These sites utilize andCorporate site E-commerce sitepresent most of the functionality Kentico provides, and are therefore best suited for evaluation purposes.

3.

4. Click .Install

The Kentico Installer now installs Kentico including everything else needed for it to run. 

Default configuration of the quick installation

If you choose the Quick installation option, the installer installs and configures the following items:

.NET Framework 4.0Program files (in c:\Program Files (x86)\Kentico\8.0\)IIS Express (if you do not have IIS installed already) with Integrated mode of application pool and with a virtual directory (http://localh

)ost/Kentico8SQL server native clientSQL Server 2012 Express LocalDBDatabaseWeb application project (in c:\inetpub\wwwroot\Kentico\)

Kentico core filesAll available modulesAll sample site templatesAll available spell checker dictionariesAll available UI Cultures

Your chosen sample sitesTrial license

 

Server and hosting requirements

Supported server-side configuration

We recommend that you install the following components on the computer where you want to run Kentico. If you do not install thesecomponents on your computer before installing Kentico, the Installer is capable of downloading and installing them or their suitablealternatives (except for the operating system and the built-in Visual Studio server) on its own. In such cases, your computer must beconnected to the Internet.

Windows 7 (both 32bit and 64bit) or Windows 8 (both 32bit and 64bit), or their corresponding server versions – Windows Server2008 R2, 2012, 2012 R2.Microsoft .NET Framework  or newer.4.0Microsoft Internet Information Services (see the table below) or Visual Studio/Visual Web Developer 2012/2013 built-in web server.Depends on which server you choose to install your web project into. See also below.Configuring IISMicrosoft SQL Server 2008, 2008 R2, 2012 (including free SQL Server Express Edition  / ).2008 2012

Internet Information Services overview

The following table lists instructions on how to install different versions of IIS on different operating systems.

Internet Information Services version Operating system Details and installation instructions

IIS 5.1 Windows XP Professional not supported

IIS 6.0 Windows Server 2003 not supported

IIS 7.0 Windows Vista not supported

Windows Server 2008

IIS 7.5 Windows 7 IIS 7 Installation and Deployment

Windows Server 2008 R2

IIS 8.0

 

Windows 8 Installing IIS on Windows Server 2012

Windows Server 2012

IIS 8.5 Windows Server 2012 R2 Installing IIS 8.5

For the Kentico Installer to work correctly with your IIS, check that the following features are installed on your computer:

On Windows 7: , , and . ASP.NET .NET Extensibility ISAPI Extensions ISAPI FiltersOn Windows 8: ,  , and ASP.NET 4.5 .NET Extensibility 4.5 ISAPI Extensions ISAPI Filters

See for instructions.Configuring IIS for the installation of Kentico

 

  

Hosting requirements

 The following list presents requirements that your web hosting provider should meet.

 All server-side requirements. Medium-trust or full-trust permissions for the ASP.NET application. If the server uses medium trust, ASP.NET AJAX 1.0 must be installed on the server. It's recommended that your hosting plan comes with 500 MB or more memory and 100+ MB database.

Cloud hosting

Kentico fully supports the platform, including SQL Azure, Azure Storage and other services. Windows AzureMicrosoft Windows AzureSDK 2.2 is required. See for details.Requirements and limitations for running Kentico on Windows Azure

Development tools

If you want to create custom web parts or integrate custom code, you need:

Visual Studio 2012/2013 or free Visual Studio Express   for Web / .2012 Visual Studio Express 2013 for Web

Note: The system may also work with other configurations. However, Kentico does not guarantee correct functionality forunsupported options.

You can pick from the list of our .hosting partners

1. 2. 3.

4.

5.

Supported client browsers for the Kentico administration interface

The of the following browsers:latest versions

ChromeInternet ExplorerFirefoxSafari on Mac OS

Supported client browsers for site visitors

Full functionality of all live site Kentico features is only guaranteed for the of the following browsers:latest versions

ChromeInternet ExplorerFirefoxOperaSafari on Mac OSMobile browsers are supported, but some features may be limited by browser capabilities

 Most standard browsing operations also work correctly on older browser versions.

 

Configuring IIS for the installation of KenticoFor the Kentico Installer to work correctly with your IIS, check that the following features are turned on in your system.

Click and then click .Start Control PanelIn the Control Panel, click and then click .Programs Turn Windows features on or offIn the Windows Features dialog box, expand the Internet Information Services -> World Wide Web Service -> Application

categories.Development FeaturesCheck the feature (Windows 7) or feature (Windows 8).ASP.NET ASP.NET 4.5

The (.NET Extensibility 4.5), and features should be checked.NET Extensibility ISAPI Extensions ISAPI Filtersautomatically.

Click .OK

On Windows 7:

On Windows 8:

Note: The visitor browser requirements also depend on the styling and custom functionality used on the website.

If these features are not turned on, then the Kentico Installer might not detect that IIS is installed on your computer, and mightinstall IIS Express additionally.

1. 2.

3.

   

Installing Kentico - custom installationThe following procedure describes the installation of Kentico in the most basic scenario for developing purposes. We expect, that you haveIIS server installed and that you have access to an SQL server.

On the home page of the Installer, agree to the license terms.Click .Custom installation

Check if the installation location for program files suits you (these are only setup files, not the web project).When should I install only program files?

3.

4. 5.

Click .NextCheck if the installation location for your web project suits you (the default path is ).C:\inetpub\wwwroot\Kentico8

5.

6.

7. 8.

9. 10.

11. 12.

Leave the default installation type configuration.Local IIS/IIS Express - installs the web project into the local server. If you do not have the IISInternet Information Servicesserver installed, the tool will install its simplified version, the IIS Express, automatically. How to choose the target location?.NET Framework 4.0 - uses the .NET Framework version 4.0 installed on your machine. If you do not have it installed, theInstaller will install it automatically.Web application project - installs the web application project type.

You can read the differences between the two web project types in Web Application Projects versus Web Site on MSDN.Projects

To install an Azure project, select the Built-in web server in Visual Studio and .NET Framework 4.5/4.5.1 options.See for more information.Installing an Azure project

Click Next.Check . I have access to the SQL server

What if I do not install the database with my web project?

Select your SQL server from the list.Choose an authentication option for your SQL server.

The most common is the SQL Server account, in which case fill in the user name and password.

Click .Establish connectionType the name of a new database for your web project.

If you choose the option:Integrated Windows authentication

Make sure that the login of the user you are authenticated as already exists in the SQL server database and has correctschema configured (recommended schema is ).dbo

12.

13. 14.

Click .NextLeave the default configuration of components (all components included) and click .Next

What are performance counters for Health MonitoringWhat are Windows services for Scheduler and Health Monitoring

14.

15. Choose the (a showcase of Kentico capabilities), (a model of the Kentico e-commerce solution)Corporate site E-commerce siteand (to begin the development of a new website from scratch).Blank site

15.

16. Click .Install

After the installation successfully finishes, click the button to open one of your newly installed sites in a browser.Launch site

 

Installing Kentico (Questions and Answers)Although installing Kentico on a local machine is straightforward, you might still need some additional information about the choices you canmake.

This topic gives advice about some of the options in the Custom installation:

 

When should I install only program files?

The Kentico program files contain the external utilities (Kentico Installation Manager, Kentico Service Manager, etc.) and are needed to installweb projects on your computer. The installation of program files is separated from the rest, so you can install only the program files in thosecases, when you do not want to install the web project, database and website at the same time. When you run the Installer again, you will nothave to install the program files and you will be able to continue with installing your web project without delay.

In some cases, you will also want to uninstall the program files (e.g., when launching the live site) or move them to a different location:

For uninstalling, use the option of the installer. Uninstall -> Remove only Kentico program filesFor moving the program files, uninstall them first and then use the Custom installation -> Program files -> Install only program

option to install them again in a different location.files

Default logon credentials

The default user name to a newly installed web project is , the default password is blank (no password).administrator

It's highly recommended that you change the password after you finish the installation.

Most of the options in the Installer have available, which can help you make the right decisions during the installationtooltipsprocess.

How to choose the target location?

It depends on the type of server you want to use for the development of websites:

The option is practical, because the live site will also run under IIS.Local IIS/IIS Express

The option is suitable for developing and debugging of your web project. It is intended forBuilt-in web server in Visual Studiodevelopers, who are used to working with Visual Studio web server.

Also, select this option if you want to install the Windows Azure project. See .Installing an Azure project

Prepare for installation on a remote server option only copies the web project files into the chosen location on your local computerto prepare them for deployment to your production server over FTP. See .Deploying Kentico to a live server

If you are not sure, select the option, because if you do not have IIS server installed, the free IIS Express version willLocal IIS/IIS Expressbe installed automatically for you.

How to install Kentico to the root of a website?

We recommend that you install Kentico to a virtual directory for development (default behavior of the Kentico Installer 8). Then, if you wish to, deploy your project to the live server.run Kentico in the root of a website

To deploy your project, (for example, C:\inetpub\wwwroot\Kentico8\CMS\) to the root of your IIScopy the content of the CMS folderwebsite.

Note: You will not be able to build the deployed project.

You can find more information about virtual directories in this article: .Understanding Sites, Applications, and Virtual Directories on IIS 7

Which application pool mode to choose?

The application pool mode affects how the server processes requests for managed code. The default option is Integrated. We recommendusing this mode, because it means that ASP.NET will be completely integrated in IIS. Using the Classic mode is not so beneficial, but it maybe required by some legacy code. You can learn more about the application pools in the  article.Managing Application Pools in IIS 7

Which web project type to choose?

Each project type has certain pros and cons. You should consider them properly before creating your project, as it is quite difficult to convertone project type to another.

Please read this article to learn about the differences between the Web application project and Web site project: Web Application Projects.versus Web Site Projects in Visual Studio

To learn more about the requirements for installing project, see the .Windows Azure Kentico Windows Azure deployment guide

What if I do not install the database with my web project?

Without the database, your web project cannot function at all. If you do not install the database during the installation process, you canalways install it later. You only have to access any page of your web project in a browser and you will be redirected to the databaseinstallation wizard (see ).Additional database installation

If you do not have any SQL server available during the installation process, consider checking only the option. InInstallation with databasethis case, the free SQL Server 2012 Express LocalDB will be installed automatically for you.

How can I access my LocalDB database through Microsoft SQL Server Management Studio?

Use the server name. The database files (Kentico8.mdf, Kentico8_log.ldf) are physically stored in your user's profile (e.g.,(localdb)\KenticoC:\Users\Andy\).

What are performance counters for Health Monitoring?

The performance counters collect information about the performance of a Kentico web project. If you let the Installer register the performancecounters in Windows, you will be able to use the data they provide to determine weak spots and bottlenecks of your web project.

However, Kentico does not provide means for displaying the performance information and you will need to use an external application for thispurpose (for example the ). See the chapter for more information about monitoring theWindows Performance Monitor Health monitoringperformance of your system.

What are Windows services for Scheduler and Health Monitoring?

You can install these two Windows services to further improve the performance of your Kentico web project:

The option will be available only during the first installation of Kentico or after you uninstall the programInstall only program filesfiles using the Installer.

1. 2. 3.

The Health Monitoring service - some performance counters require database access for collecting values, which can slower downthe health monitoring process. By using this Windows service, you can improve the performance of the Health Monitoring module.You can also use this service to additionally register the performance counters.The Scheduler service - by using this Windows service for executing scheduled tasks, you can improve the performance of theScheduler module. 

You can also install and uninstall these services separately after the installation using the .Kentico Service Manager

Can I install and uninstall modules or other components after the installation of my web project?

Yes, using the Modify option of the Installer. See for moreAdding and removing components from an installed Kentico web projectinformation.

Which sample site should I install?

If you want to evaluate the capabilities of Kentico or if you are new to the Kentico system, choose the Corporate site or the E-commerce site.

For development, you will mostly want to choose the Blank Site, which is best suited for developing websites form scratch. However, you canalso install some of the preconfigured sample sites and then adjust them accordingly.

If you want to install sample sites after the installation, use the . Keep in mind, though, that you must have the Sample siteNew site wizardtemplates installed (you can add these templates additionally using the Modify option of the Installer).

Saving the XML configuration

If you save the configuration of an installation into an XML file, you can load it the next time you need to install Kentico on a computer. Youcan also use the XML file to install Kentico through the command line. See the  topic and the Installing Kentico from the command line Comm

, where you can also learn how to adjust the XML file manually.and line installation - XML configuration

Can i still find the Installer on my computer if I accidentally delete the   file?Kentico_8_0.exe

Yes, you can find the Installer in Windows Start -> All programs -> Kentico 8.0 -> Kentico Installer 8. If you run the Installer this way though,you will not be able to uninstall the Kentico program files.

To run the Kentico Installer with all options:

Open Windows Start -> All programs -> Kentico 8.0 -> Uninstall Kentico 8.Select Kentico 8.0 in the Programs and Features list.Click Change.

The Windows system opens full Kentico Installer.

I can't open my site in the browser

If your browser shows the 404 error after trying to open a site, try to open the site from the Windows Start menu:

Click Start -> All Programs -> Kentico 8.0 -> Sites -> your site

If you have installed a site with a LocalDB or IIS Express, then it may happen that these applications are not run automatically after yourestart Windows. In this case, open the site from the Start menu, which ensures that these applications are started properly.

Where can I find the installation log?

The path to the log is or the location of the program files.C:\Program Files (x86)\Kentico\8.0\

Where can I get more information?

You can contact our support department, which will gladly help you at .support@kentico.com 

Deploying Kentico to a live serverWhen you want to deploy Kentico on a remote live server, you must first determine the level of trust the ASP.NET application has on theserver. This is important because the medium trust environment has limitations and requires additional configuration tasks.

Limitations of medium trust environment

The following features of Kentico do not work in medium trust environment:

We strongly recommend that you develop and host your websites on servers with  environment.Full trust

Medium trust environment is considered obsolete by Microsoft and will be abandoned in one of the following versions of Kentico.You can find more information on isolating applications on servers using application pools in this article: ASP.NET Partial Trust

.does not guarantee application isolation

1. 2.

1. 2. 3. 4. 5.

6.

7.

8.

StagingIntegration with LinkedInIntegration with Google+Integration with OpenIDIntegration with WIF ( )Claims-based authenticationHealth monitoringRecording application events in the Windows event logStoring virtual objects in the file systemBounced e-mails detection. A is required.special permissionSession can be stored only using the InProc state server.Import functionality is limited. If the application is restarted during the import process due to a large number of files, the process doesnot continue but starts from the beginning.

Installing and deploying a project to a live server

When you need to deploy Kentico to a shared hosting server, install Kentico on the server and then deploy your website to the installation.These procedures are similar for both medium and full trust environment.

 Install Kentico on a medium trust server. Deploy an already developed website to a live server.

Installing Kentico on a live server

To install Kentico on a remote server with medium trust or full trust:

Run the Kentico Installer on your development computer.localCheck the license agreement and select the option.Custom installationSwitch to the tab.Installation typeSelect the .Prepare for installation on a remote serverChoose a folder for the project files (for example, C:\Temp\Kentico).

The files will be only copied to this location.Select the .NET Framework version of the remote server.

Click .InstallThe Installer copies the project files to the specified folder.

[Medium trust] Edit the project's web.config file and change the mode from to (only if you plan tosessionState StateServer InProc

8.

9.

1. 2.

3. 4.

5.

6.

deploy your project to a server with medium trust):

<sessionState mode="InProc" stateConnectionString="tcpip=127.0.0.1:42424"sqlConnectionString="data source=127.0.0.1;Trusted_Connection=yes"cookieless="false" timeout="20" />

Copy the web project files from your local folder (C:\Temp\Kentico) to the root of the website using FTP. If you want to use a sub-folder, .create a new virtual directory

 Kentico is now installed on your remote server. Continue to the next section to deploy a website to the server.  

Deploying a website to a live server

After you have installed Kentico on a live server, you can deploy an already developed website to the installation.

Open the application on your local development computer and click  ( ) next to the site to be exported. Sites Export siteEnter the name of the export package and click . OK

The site will be exported to the <web project>\CMSSiteUtils folder.\ExportCopy the exported package into the <web project>\CMSSiteUtils folder on the .\Import live serverOpen a web browser and navigate to the /default.aspx page of your live server.

The starts up.Database Setup wizardGo through the wizard and create a new Kentico database on your live server.

At the end of the process, you may be asked to update your web.config file manually – please follow the instructions on thescreen.

At the end of the Database Setup Wizard, choose to import your existing Kentico website (from the previously exported package).

The system imports the existing website. If you have deployed your project to a server with medium trust, continue to the fornext sectionfurther configuration.

Running the website in a medium trust environment

Once you've installed the website, the system should work under a medium trust level properly. to apply the configurationRestart your IISchanges and run the website.

If your website uses any third-party components that do not support a medium trust level by default, you may need to configure the systemfor them. In this case, please contact their author to get the information on how to perform the configuration required to run in a medium trustenvironment.

Configuring components for the medium trust environment

The .NET Framework provides a batch of predefined code access security policies, categorized into several trust levels, which determine thepermissions available for applications running on the given machine.

The medium trust level was used by web hosting providers on shared servers to prevent applications from accessing certain resources thatcould be harmful to other websites running on the server. Kentico can be used with the default medium trust policy. The following componentrequires higher than medium trust and must be considered in this situation.

Bounced e-mail monitoring

This section is only relevant if you wish to use the feature of the Newsletters application in a medium trust environment.bounced e-mails

To be able to check bounced e-mails, Newsletters make use of a component that creates outgoing network connections using POP3, astandard email protocol for receiving maildrops from an e-mail server. This component requires the for its operation,SocketPermissionotherwise it fails when attempting to connect to the server. This permission is denied for applications under medium trust.

If you cannot raise the trust level or create a custom security policy that includes this permission, the only solution is to attempt to convincethe hosting providers to grant the SocketPermission to your application. If you are unable to do so, the bounced email monitoring feature willunfortunately not be functional in a medium trust environment. 

Creating virtual directories and application pools in IIS 7.5 and 7.0If you need to install Kentico manually on a remote server or restore it from a backup and, at the same time, you run Kentico in a sub-folder

1.

2.

3.

After you have imported the website, you may need to adjust its configuration:

Open the application. Edit the website and make sure the website domain and domain aliases are configuredSitescorrectly for the production domain(s).Open the application and make sure your site settings contain correct values, especially the valueSettings SMTP serverin the section.System -> E-mails

Open the application. Click  ( ) next to your new site and make sure the website is displayedSites Open live sitecorrectly.

(in contrast to running Kentico in the root of the website), you need to create a new virtual directory for the folder where you have the webproject files.

Creating a virtual directory in IIS 7.5 and 7.0

Since IIS 7, there exists a separate concept for a and an .virtual directory application

You can map a virtual directory to a physical directory that is located on a local or a remote computer. The physical directory (underthe specified name of the virtual directory) then becomes part of the application's URL.An application, on the other hand, is a group of files that provides services over protocols. So if you want to run your website as http:

, you have to and specify KenticoCMSDemo as the//localhost/KenticoCMSDemo use an application instead of a virtual directoryapplication's alias.

 To create a virtual directory:

1. Open IIS Manager

On Windows 7: Open category Start -> Control Panel -> System and Security -> Administrative Tools -> Internet Information.Services (IIS) Manager

On Windows Server 2008 or Windows Vista: Open category Start -> Control Panel -> System and Maintenance -> .Administrative Tools -> Internet Information Services (IIS) Manager

2. Expand right-click on (or other website if you're running multiple websites on the samelocal computer -> Sites -> Default Web Sitecomputer) and choose Add Virtual Directory... 

An dialog appears. Add Virtual Directory

3. Enter the Virtual Directory . If you want the website to run as , enter alias .Alias http://localhost/KenticoCMSDemo KenticoCMSDemo

4. Type a path or browse to the physical directory that contains the chosen directory.

Application rootThe root of the website or the virtual directory must be the same as the folder that contains the file of Kentico. Thisweb.configfolder is called .application root

You can find more information about virtual directories in .Understanding Sites, Applications, and Virtual Directories on IIS 7

5. Click .OK

The system creates a new virtual directory.

6. Right-click the virtual directory and choose .Convert to Application

An appears.Add Application dialog

7.Click and choose the application pool from the drop-down menu.Select... ASP.NET v4.0

8. Click .OK

The system converts the virtual directory to an application.

Alternatively, you can create an application in one step by right-clicking a web site and choosing and filling the requiredAdd Application...information in the dialog as mentioned above.Add Application

Configuring application pools in IIS 7 and IIS 7.5

Application Pools provide you with additional level of website management. They are supported only by Windows Server 2003/2008/Vista/7.You can configure them in the under Internet Information Services (IIS) Manager local computer -> Application Pools.

 

You can check and change the assigned application pool by right-clicking an application under local computer -> Sites -> Default Web Site(or other web site) and selecting Manage Application -> Advanced Settings...

 

You can set the Recycling and other options by right-clicking on an application pool under andlocal computer -> Application Poolsselecting .Advanced Settings...

 

Recommended Application Pool Configuration

It's highly recommended that you run Kentico in a separate application pool. If you share the pool with other websites, the systemmay behave unpredictably.We do not recommend to run multiple websites in a single pool.It's recommended that you specify some value in the processes on the tab. This value shouldn't be tooRecycle worker Recyclingshort (less than ) or too long (more than /1 day). Setting this value ensures that the 60 minutes 1440 minutes memory is recycled

by regular restart. time to time, you canand the application is automatically recovered from failures If your website freezestemporarily set the value to 30 minutes to ensure that the website is restarted automatically. may lead to high serverShort intervalsload and slow response since after each recycling, the application needs to be restarted and data reloaded to the cache.It's recommended that you . If you need to use some value, use do not limit the maximum virtual or used memory at least 100

. If your website is being , it may be caused by low maximum memory limit. You can check the frequency ofMB restarted too oftenapplication restarts in Kentico .Event logThe on the tab must be set to 1. If you set a higher value, the workerMaximum number of worker processes Performance processes will not be synchronized and Kentico website will not work correctly. This may lead to unexpected caching of content

.and system objectsYou can configure the under which the application runs on the tab. This information is useful if you need touser account Identitytroubleshoot issues with , such as disk write permissions.permissionsKentico . Therefore, the has to be set to .does not support Web garden Maximum number of worker processes 1

  

Additional database installationIf you chose not to install the database during the installation process, you can install it later. To trigger the database installation, access anypage of your web project in a browser. The system will redirect you to the database installation wizard.

Step 1 - SQL Server and Authentication Mode

Specify the SQL Server and authentication mode used to access the server:

SQL Server name or IP address - enter the name of the server. You will typically use one of these:the name of the server (such as DBSERVER1)the IP address of the server (such as 192.168.1.105)(local) (if you're using Microsoft SQL Server Express Edition)<SERVERNAME>\sqlexpress

Use SQL Server account - use this option if your server is configured for with SQL logins.SQL Server AuthenticationUse integrated Windows authentication (ASP.NET account) - use this option if your SQL Server is configured for Windowsintegrated authentication. In this case, you need to use SQL Server Management Studio to create a new login for user accountunder which you currently run the web application (for example, the for Windows 7 - theNT AUTHORITY\NETWORK SERVICEactual ASP.NET account name is displayed on the screen).

Click .Next 

Step 2 - Database Instance

Now you can decide if you want to use an or . In both cases, you need to enter the name of theexisting database create a new databasedatabase into the appropriate field.

In case you are using an existing database, you can choose if you want to .Create Kentico database objects

If the existing database already contains Kentico objects (tables, stored procedures, views), then clear the check box.If the database does not contain these objects (typically when you are installing into an empty database), leave the check boxenabled.

Database Collation

When using an existing database, you may also come across the dialog. It is displayed if the isDatabase Collation database collationdifferent from . The dialog lets you choose if you want to change the collation or leave the original one.SQL_Latin1_General_CP1_CI_AS

We recommend that you change the collation to .SQL_Latin1_General_CP1_CI_AS

Step 3 - Database Creation Log

The installer displays a log, showing the progress of database creation.

Step 5 - License Key

If you run Kentico on a domain other than or (where is between 1 and 255), you will be asked to insert a license key.localhost 127.0.0.x xSince the trial version works only with and (where is between 1 and 255), the same dialog is displayed ifhttp://localhost http://127.0.0.x xyour trial period has expired.

Enter a valid license key and click .Next

Alternatively, you can click and continue to the . You can enter a license key later in the applicatioSkip this dialog New site wizard Licensesn. See for more information.License management

1. 2. 3.

4. 5. 6.

Step 6 - Starter Site

The installer offers you the following options:

Choose a starter site - select this option if you want to install a site that demonstrates the capabilities of Kentico.Continue to the New site wizard - this option is recommended if you're starting a new site from scratch; learn more in the New site

chapter.wizardImport existing Kentico website - use this option if you have already created an export package with a website and you need toimport it into a new installation (e.g., on the production server).

If you're new to Kentico, it's highly recommended that you start with the sample Corporate Site.

Step 7 - Starter Site Creation Log

The installer displays a log showing the progress of website creation.

Step 8 - Finished

Once the website is created, the installer displays a confirmation and you can follow the link to access the new live website.

This is the final step of the necessary installation procedure.

Further reading

Using the Kentico interfaceDefining website data structureLoading and displaying data on websitesManaging website content

 

Adding and removing components from an installed Kentico webprojectAfter you have installed Kentico web project using the Quick installation or the Custom installation, you can additionally modify itscomponents using the Installer. You can add components which you did not install or you can remove components which you no longerneed.

Adding and removing components after the installation

Run the Installer from Windows  .Start -> All programs -> Kentico 8.0 -> Kentico Installer 8 On the home page of the Installer, click .Modify   Select the web project you want to modify.

Either select an already registered project from the list or select any other folder containing a web project of Kentico 8 usingthe button.Select another

Check the components you want to install and uncheck the components you want to uninstall.  You can also additionally install Windows services or register performance counters or event logging.Click .Apply changes 

The Installer now installs and uninstalls components according to your specification. 

Installing Kentico from the command lineYou can install Kentico from the command line without any user interface and user interaction involved using the . TheKentico Installercommand line installation also allows you to modify an existing installation and add or remove components contained in this installation. Youwill need to prepare a configuration XML file and execute a command from the command line with this XML file as a parameter.

Default user name and password

The default user name is , the default password is blank.administrator

It's highly recommended that you after you finish the installation.change the password

The default URL of your site is: http://localhost/Kentico

The default URL of the administration interface is: http://localhost/Kentico/Admin.

Learn how to navigate the user interface

You can find more information about the and Register performance counters for Health Monitoring Install Windows services options in .for Scheduler and Health Monitoring Installing Kentico (Questions and Answers)

1.

2. 3.

The main purpose of the command line installation is the possibility of automated installation and modification of Kentico.

The command line installation is capable of substituting the whole procedure including the installation of:

the program files,new web project and IIS configuration,new database on your SQL server,sample websites based on available web templates.

  

Command line installation procedure

Create an XML configuration file during the custom installation process using the link. This way, you canSave XML configurationcomfortably set all the options you need in the Installer UI and the XML file will be generated automatically for you.

You can also create the XML file according to the .specifications

Move the XML file to the folder containing Kentico Installer (Kentico<version>.exe).Execute a command with the syntax in the folder:Kentico<version>.exe <configuration XML file name>.xml

Kentico_8_0.exe KenticoInstallationProfile.xml

The installation will be executed and carried out according to the configuration in the XML file.

 

Command line installation - XML configurationThis topic provides reference on the format of the XML file used as a source of configuration for the command line installation.

You can create the XML file from scratch or during the installation procedure using the link.Save XML configuration

Boolean attribute values

You can enter the boolean attribute values in these ways:

True value False value Usability

true false currently used

Yes No obsolete

1 0 obsolete

All of these values are recognized as the respective boolean values at the moment. Keep in mind though, that in future versions, we willgradually stop supporting the and values.No/Yes 1/0

  

Supported macros in attribute values

You can use macros in the following XML attributes to get the respective values dynamically:

SilentInstall -> LogFileSetup -> SetupFolderIIS -> TargetFolderSQL -> Database

Macro expression Description Sample resolved value

{%productversion%} Kentico version number according to Sema.ntic Versioning

8.0.0-alpha

{%fileversion%} Full version number of the installed Kenticoversion.

8.0.5191.17572

{%programfiles%} Path to the folder on yourProgram Fileslocal drive.

c:\Program Files (x86)\

The log file

If the command line Installation crashes without explanation, try searching for the log file in the default locations: C:\Program Files or the Installer folder.(x86)\Kentico\8.0\

{%machine%} Name of the current machine. PC01

{%username%} User name of the currently used account. Andy

{%date%} Current date in format .yyyy-mm-dd 2014-01-21

{%time%} Current time in format .hh-mm-ss 14-53-23

Note that these macros are completely independent of standard Kentico macros that can be used in the system's user interface.

SilentInstall XML element

The root element of the XML file is . Using the attributes of this element, you can configure general options of the installation:SilentInstall

Attribute name Description Accepted values Required?

ShowProgress Determines if the Silent Installtool displays the progress of theinstallation or not.

No - the progress is notshown.CommandPrompt - theprogress is shown in thecommand line.

No | CommandPrompt Yes

Log Enables logging of importprogress to a file.

true | false Yes

OnError Determines the action the toolperforms when an error occursduring the installation.

Stop | Continue Yes

LogFile File where the log is saved. Thedefault value is <installation

.path>\setup.log

full path to a file Yes

CheckRequirements Indicates, if the tool checkswhether the correct .NETversion is installed on the targetmachine before executing theinstallation. If the installed .NETversion is not matching, theinstallation is aborted.

true | false No

Setup XML element

The first sub-element that should be present under is . This element allows you to configure the general options by meansSilentInstall Setupof attributes:

Attribute name Description Accepted values Required?

NET .NET version installed on thetarget machine.

4.0 | 4.5 Yes

SetupFolder Folder where the tool installsthe Kentico setup files (not theweb project).

full path to a folder Yes

Location Determines where will the toolinstall the web files:

Local - on a local IISserver.VisualStudio - on abuild-in server which isincluded in Visual Studio orVisual Web DeveloperExpress Edition.Remote - copies the filesinto a temporary folder onyour disk. You will need tocopy these files to yourproduction server.Modify - modifies anexisting installation (addsor removes components)on a local machine.

See  forInstalling Kentico (Q&A)more details.

Local | VisualStudio | Remote |Modify

Yes

WebProject Determines if the project isinstalled as an ASP.NET website, ASP.NET web application,or as a Windows Azure project.

WebSite | WebApplication |WindowsAzure

No

OpenAfterInstall Indicates, if the tool opens thenewly installed website in a newbrowser window when theinstallation finishes.

true | false No

RegisterCounters Indicates, if performancecounters for Health Monitoringshould be registered.

true | false No

InstallWinServices Indicates, if the tool installsKentico Windows services inWindows.

true | false No

RegisterApplicationToEventLog Indicates, if the tool registersthe Kentico application inWindows Event Log.

true | false No

DeleteExisting Indicates, if the the tool deletesthe existing setup files in afolder with the same name asset in the attribute.SetupFolder

true | false No

KillRunningProcesses If the tool deletes existing setupfiles, this parameter indicates, ifit can also kill already runningprocesses related to these files.

true | false No

InstallOnlyProgramFiles Indicates, if only the programfiles should be installed. Thisoption ignores all other settings.

true | false No

DoNotOverwriteInstallation If set to , then the files offalsethe existing installation will beoverwritten. The default value is

(do not overwrite).true

true | false No

IIS XML element

The sub-element is also located directly under . Its attributes allow you to adjust IIS-related settings of the installation:IIS SilentInstall

Attribute name Description Accepted values Required?

AppPool Type of IIS application poolwhich the new website will use.

Native - the applicationpool uses the mode that isdefault in the installed IISversion ( for IISClassicversions prior to 7 and Inte

for IIS 7 andgratedhigher).

Native | Classic | Integrated No

WebSite Name of the website in IIS. string value Yes

TargetFolder Path to the folder where IISwebsites are stored (typically C:

).\Inetpub\wwwroot\

full path to a folder Yes

DeleteExisting Indicates, if the the tool deletesan existing website with thesame name as set in the WebSi

attribute.te

GetUnique - if a websitewith the same name exists,the tool will not delete itand it will create a newwebsite folder with asimilar name.

true | false | GetUnique No

KillRunningProcesses If the tool deletes existingwebsites, this parameterindicates, if it can also killalready running processesrelated to these files.

true | false No

AllowISAPIAndCGI Indicates, if the tool shouldinstall ISAPI and CGIrestrictions in IIS, which arenecessary to run a webapplication in the Classicapplication pool mode.

true | false No

SQL XML element

The sub-element of the element allows you to configure database-related settings of the installation. This element is notSQL SilentInstallrequired and if you do not include it in your XML file, the database will not be installed.

Attribute name Description Accepted values Required?

InstallDatabase Indicates, if the tool will installthe database. If you do notinstall the database, you will notbe able to install sample sites (

element).WebSites

true | false No

Database Name of the target database. string value No

SqlName User name of the account usedfor access to the SQL server.

string value No

SqlPswd Password for the SQL serveraccount.

string value No

Server Name of the target SQL server. string value No

Operation Determines whether the toolcreates a new database ormodifies an existing one. Thedefault value is .New

New | Modify No

Authentication Type of the authentication usedto access the SQL server.

SQL | Windows No

DeleteExisting Indicates, if the tool deletes anexisting database with thesame name as set in the Datab

attribute.ase

GetUnique - if a databasewith the same name exists,the tool will not delete itand it will create a newdatabase with a similarname.

true | false | GetUnique No

Schema Our default database schema is. If you have a differentdbo

schema on your SQL server(e.g., db_owner), specify ithere, so that the installation toolcan make adjustments to thedatabase.

string value No

Notification XML element

The sub-element allows you to configure the automatic notification e-mail messages. The system sends them to the specifiedNotificatione-mail address when an error occurs during the installation.

Attribute name Description Accepted values Required?

Enabled Indicates, if the tool sendsnotification e-mails when anerror occurs during theinstallation.

true | false Yes

From E-mail address of the sender ofthe notification e-mail. Thisvalue is required in the Notificati

element.on

e-mail address Yes

To E-mail address of the recipientof the notification e-mail. Thisvalue is required in the Notificati

element.on

e-mail address (or multipleaddresses separated by asemicolon (;))

Yes

Server Name of the SMTP server usedto send out the notificatione-mail.

string value Yes

Subject Subject of the notification e-mailmessage.

string value Yes

UserName User name of the SMTP serveraccount used to send out thenotification e-mail.

string value No

Password Password for the SMTP serveraccount used to send out thenotification e-mail.

string value No

SSL Indicates, if SSL is used whensending the notification e-mail.

true | false No

AttachLogFile Indicates, if the tool includes acompressed installation log fileas an attachment.

true | false No

WebTemplates, UICultures, Modules and Dictionaries XML elements

The , , and elements allow you to configure which web templates, UI cultures, modules andWebTemplates UICultures Modules Dictionariesdictionaries will be installed by the tool. If you chose to modify an existing Kentico installation (by specifying the value for the Modify Locationattribute), you can also use these elements to add new components to the existing installation or to remove unwanted components.

Each of these elements only has a single attribute:

Attribute name Description Accepted values Required?

type InstallAll - the tool adds allcomponents of the type tothe installation. However,you can limit addedcomponents in thesub-elements by specifying

or in their No Remove oper attribute.ation

RemoveAll - the toolremoves all components ofthe type from theinstallation. However, youcan limit removedcomponents in thesub-elements by specifying

or in their No Add operatio attribute.n

Mix - only configuration inthe attribute ofoperationthe sub-elements will betaken into account.

Mix | InstallAll | RemoveAll Yes

Each of the , , and elements can have any number of sub-elements named , WebTemplates UICultures Modules Dictionaries WebTemplate UI, or . These sub-elements represent particular web templates, UI cultures, modules or dictionaries and have theCulture Module Dictionary

following attributes:

Attribute name Description Accepted values Required?

name Name of the web template, UIculture, module or dictionary.

string value Yes

operation The operation that should beperformed with the component:

Add - the component isadded to the installation.Remove - the componentis removed from theinstallation.No - no action is taken.

Add | Remove | No Yes

WebSites XML element

The element lets you configure which websites will be installed based on available web templates. It has no attributes itself – it onlyWebSitescontains sub-elements representing particular websites to be installed. Each sub-element has the following attributes:WebSite WebSite

Attribute name Description Accepted values Required?

domain Domain used by the website. string value Yes

displayname Name of the website used inKentico user interface.

string value Yes

webtemplatename Code name of the chosen webtemplate.

available web template codename

Yes

runsite Indicates, if the tool should runthe website after it is importedto the system.

true | false No

rebuildsearchindexes Indicates, if the search indexesshould be rebuilt after installingthe website.

true | false No

Licenses XML element

You can add any number of sub-elements under the element. These sub-elements represent particular licenses forLicense Licensesseparate domains. You should state the domain in the attribute and add the actual key as a sub-element wrapped in a CDATAdomainenclosure.

Example

Here you can find an example of the configuration file. The file configures installation of Kentico with the sample Corporate site website and

1. 2.

all the available web templates, UI cultures, modules and dictionaries.

<SilentInstall ShowProgress="CommandPrompt" Log="true" OnError="Stop"LogFile="{%programfiles%}\Kentico\8.0\setup.log" CheckRequirements="False" > <Setup NET="4.5" SetupFolder="{%programfiles%}\Kentico\8.0" Location="Local"InstallOnlyProgramFiles="False" OpenAfterInstall="true" DeleteExisting="False"DoNotOverwriteInstallation="True" RegisterCounters="False"InstallWinServices="False" RegisterApplicationToEventLog="False"WebProject="WebSite" KillRunningProcesses="False" /> <IIS AppPool="Native" Website="Default Web Site"TargetFolder="C:\inetpub\wwwroot\Kentico8_{%fileversion%}"DeleteExisting="GetUnique" KillRunningProcesses="False" /> <Sql InstallDatabase="true" Server="Artemis" Authentication="SQL" SqlName="login"SqlPswd="password" Database="Kentico8_{%fileversion%}" Operation="New"DeleteExisting="false" /> <WebTemplates type="InstallAll"> </WebTemplates> <UICultures type="InstallAll"> </UICultures> <Modules type="InstallAll"> </Modules> <Dictionaries type="InstallAll"> </Dictionaries> <WebSites> <WebSite domain="localhost" displayname="Corporate site"webtemplatename="CorporateSite" /> </WebSites> <Licenses> <License domain="localhost"><![CDATA[DOMAIN:localhostPRODUCT:CF08EXPIRATION:00000000PACKAGES:SERVERS:1ODWrIUyRdEv3Ko+7kLCN2WD4jEsOl3l0+au1AJ3zU0Jw5b3Q1h1eBlWh1fNAWAe2NbSb6gm1qUhJHdUTI4rBPANDgmYvEBFZRqpYbDYVCYsXEeQy4H2ipwXfASGFMI5UuKvHRTJ5KBo9OE4k4ZJmPVratLjOcSvFVERhGubZl7MZghwCBSHQNNvN3RWN3mwi1+vgou+N/Z1XDWXtfprzDEwFFJHyl/4NOoKbNzvGhuV1Jmq1XbGiT8Od0Y2vufeqzcM4VdFRRAOlIoQHFwwfyEah2kSw1z9zUbqWj3nZqZUD6jXi8FokOWKWzZeybg9NQgZ1+vtd7jg1B1+bz/Te+w==]]></License> </Licenses></SilentInstall>

 

Troubleshooting installation issuesIf you encounter issues during the installation, the following topics may help you solve them out:

 

Application stops after being idleIn the default IIS configuration, the application pool in which Kentico runs stops the application's worker process after a 20-minute period ofinactivity. This behavior causes the Kentico Event log to log warnings with the following message:

HostingEnvironment initiated shutdown

This shutdown period is determined by the setting in the application pool's advanced settings.Idle time-out

To change or disable the time-out period:

Open and select in the Connections tree.IIS Manager Application PoolsClick the application pool in which Kentico runs and click .Advanced Settings

2.

3.

4.

1. 2.

In the section, locate the setting and change its value. To disable the time-out altogether, enter (zerProcess Model Idle Time-out 0o).

Click to save the settings.OK

If you set the Idle time-out setting to a non-zero value, IIS stops your application if the application doesn't receive any request in the specifiedtime period. If you set the setting to zero, the application will run without shutting down even if it is idle. 

Disk permission problemsKentico performs most operations without writing to the disk. However, there are situations when the web application needs to access thedisk, such as:

importing/exporting sitesstoring uploaded files in the file system (optional)

If you receive an error message, saying that the web application cannot write to disk, you need to:

Identify the user account under which your web application is runningGrant the Modify permissions for the whole web project folder to the account

 

User account of the web application

IIS 6.0 introduced the concept of application pools (you can find more information at ). The name of the userhttp://technet.microsoft.comaccount is based on the application pool that your web application is using.

You can find the user account name:

In the error/information message.

If you're using built-in web server, the application runs under your Windows user account.Visual Studio's

1. 2. 3. 4. 5.

In the application, under . System ASP.NET accountIn :IIS Manager

Open the and select the page. According to the value in the column, determine theIIS Manager Application Pools Identityuser account of your application.

Application pool identity User account name

Local Service Service

LocalSystem System

NetworkService Network Service

ApplicationPoolIdentity IIS AppPool\<app pool name>

Granting disk permissions

It is a best practice to grant the permissions to the previously determined account.Modify

However, in case your application pool uses the application pool identity, you can grant the permissions to the built-inApplicationPoolIdentitygroup account instead. This group account contains all accounts with the application pool identity.IIS_IUSRS ApplicationPoolIdentity

How to configure file and folder permissions (Microsoft documentation) 

Uninstalling KenticoIf you need to uninstall Kentico from your computer, you can use the three options provided in the Installer.

Uninstalling everything related to Kentico

To remove Kentico after your evaluation of the system, choose the option. This option will NOTRemove Kentico 8 from my computeruninstall .NET Framework, IIS or SQL server.

Select Windows  .Start -> All programs -> Kentico 8.0 -> Uninstall Kentico 8.0Select   in the Programs and Features list.Kentico 8.0Click  .UninstallSelect  .Remove Kentico 8 from my computerClick  .Uninstall

1. 2. 3. 4. 5.

1. 2. 3. 4.

Uninstalling only the program files

There may be a few cases, when you will want to remove only the Kentico program files (the files needed to install the web projects). Forexample, when you want to move the program files to a different hard drive or when you want to launch a live site and you no longer needthe program files on your server. For this purpose, choose the option.Remove only Kentico program files

Uninstalling the program files will also remove external utilities, like Kentico Installation Manager or Kentico Import Toolkit.

Select Windows  .Start -> All programs -> Kentico 8.0 -> Uninstall Kentico 8.0Select   in the Programs and Features list.Kentico 8.0Click  .UninstallSelect  .Remove only Kentico 8 program filesClick  .Uninstall

Uninstalling individual web projects (instances)

If you have installed multiple web projects (instances) and you want to remove only some of them, use the third option Remove one or more. Using this approach, you can also choose to remove only the web project files (this option will also removeregistered web projects

Windows services, performance counters and event log sources) and keep the database for further use.

Run the Installer from Windows  .Start -> All programs -> Kentico 8.0 -> Kentico Installer 8On the Home page of the Installer select  .UninstallSelect the instances you want to remove.Click  .Uninstall

 

For managing individual web projects you can also use the utility.Kentico Installation Manager