Registering an instance in KIM

When you install a new Kentico instance on a machine, it is automatically registered within Kentico Installation Manager. In some cases though, you may need to register instances manually. For example:

  • Instances transferred or copied onto the machine without going through the installation
  • Microsoft Azure projects

Registering an instance in KIM

Requirements:

  • KIM is compatible with Kentico instances starting from the previous major version. For example, you can register instances of Kentico 7 or 8 (any minor version) in KIM 8.1.
  • For instances of Kentico 8 or newer, you can only register complete web projects that use the standard folder structure (including the solution file, CMS and Lib sub-folders etc.). For example, you cannot add web site deployments of the CMS folder as instances in KIM.
  1. Click Register on the main toolbar.
    Click Register on the main toolbar

  2. Enter the following details:

    • Name - identifying name of the instance displayed in the Name column in the list of instances.
    • URL - the URL under which the instance is accessible.
    • Physical path - path to the instance’s web project root folder in the file system.
    • Show site selection after clicking Browse - if enabled, the tool displays a dialog with available web sites of the particular instance after clicking the Browse button (useful for multi-site instances).Registering an Azure instance in KIM
  3. Click OK.

The KIM registers your instance and displays it in the list of managed instances.

Where is the information stored

Information about registered instances is stored in c:\ProgramData\KIM\kim.xml. The root <sites> element contains <item> elements that represent individual registered instances. The <item> elements have the following sub-elements representing properties of the registered instances:

  • <guid> - unique identifier of the instance (not related to the application GUID in the web.config file of the given instance).

  • <url> - URL under which the instance is accessible.

  • <name> - identifying name of the instance displayed in the Name column in the list of instances.

  • <version> - version of Kentico.

  • <path> - path to the instance’s web project root folder in the file system.

  • <created> - date and time when the instance was registered in Kentico Installation Manager.

  • <hotfix> - number of the latest hotfix applied to the instance.

  • <netversion> - represents the .NET Framework version used by the instance. The stored number does not match the .NET version, using the following encoding instead:

    .NET version

    Encoding number

    2

    2

    3.5

    4

    4

    8

    4.5

    16

  • <showlist> - indicates if a dialog box with available web sites on the given instance is displayed after clicking the Browse button.

Example



<?xml version="1.0"?>
<sites>
  <item>
    <guid>6085ee02-8fff-4978-abd1-1a0261a57724</guid>
    <url>http://localhost/Kentico8/</url>
    <name>Kentico8</name>
    <version>8.0</version>
    <path>C:\inetpub\wwwroot\Kentico81</path>
    <created>2014-05-24T08:26:39</created>
    <hotfix>0</hotfix>
    <netversion>16</netversion>
    <showlist>1</showlist>
  </item>
  ...
</sites>