Note: This guide describes Kentico CMS version 7. Unfortunately, we cannot support this guide from version 8 forward. Go to latest documentation

Skip to end of metadata
Go to start of metadata

 Although installing Kentico on a local machine is now unbelievably easy with the new Installer, you might still need some additional information about the choices you can make.

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

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 install web projects on your computer. The installation of program files is separated from the rest, so you can install only the program files in those cases, 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 not have 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 Uninstall -> Remove only Kentico CMS program files option of the installer. 
  • For moving the program files, uninstall them first and then use the Custom installation -> Program files -> Install only program files option to install them again in a different location.

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

How to choose the target location?

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

  • The Local IIS/IIS Express option is practical, because the live site will also run under IIS.
  • The Built-in web server in Visual Studio option is suitable for developing and debugging of your web project. It is intended for developers, who are used to working with Visual Studio web server.
  • Prepare for installation on a remote server option only copies the web project files into the chosen location on your local computer to prepare them for deployment to your production server over FTP. See Deploying Kentico to a live server.

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

When to check the Installation to the root option?

Check this option (use the website's root virtual directory for the application):

  • If you want to have only one application under the website.
  • If you want to set different bindings for your applications (to have your applications under different domains and IPs). You can set bindings only for websites, so you will have to use multiple websites.
  • When you want to deploy your web application to a hosting server, as it might be easier to export the IIS settings this way.

Uncheck this option (create a virtual directory):

  •  If you want to install more applications under one website (best for developing purposes). 

Concerning Kentico, there are not any differences between these two options.

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 recommend using this mode, because it means that ASP.NET will be completely integrated in IIS. Using the Classic mode is not so beneficial, but it may be required by some legacy code. You can learn more about the application pools in the Managing Application Pools in IIS 7 article.

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 convert one 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 Windows Azure project, see the 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 can always install it later. You only have to access any page of your web project in a browser and you will be redirected to the database installation wizard (see Additional database installation).

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

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 performance counters 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 this purpose (for example the Windows Performance Monitor). See the Health monitoring chapter for more information about monitoring the performance 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 Health Monitoring service - some performance counters require database access for collecting values, which can slower down the 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 the Scheduler 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 Adding and removing components from an installed Kentico web project for more information.

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 can also install some of the preconfigured sample sites and then adjust them accordingly.

If you want to install sample sites after the installation, use the New site wizard. Keep in mind, though, that you must have the Sample site templates 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. You can also use the XML file to install Kentico through the command line. See the Installing Kentico from the command line topic and the Silent Install xml configuration, where you can also learn how to adjust the XML file manually.

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

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

To run the Kentico Installer with all options:

  1. Open Windows Start -> All programs -> Kentico CMS 7.0 -> Uninstall Kentico CMS 7.
  2. Select Kentico CMS 7.0 in the Programs and Features list.
  3. Click Change.

The Windows system opens the 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 CMS 7.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 you restart 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 C:\Program Files (x86)\KenticoCMS\7.0\ or the location of the program files.

Where can I get more information?

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

 

  • No labels