Kentico CMS 6.0 Developer's Guide

Instance registration

Instance registration

 Previous topic Next topic Mail us feedback on this topic!  

Instance registration

 Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

Installed Kentico CMS instances need to be registered in Kentico Installation Manager in order for their management by the utility to be possible. Information about registered instances is stored in c:\ProgramData\KIM\kim.xml. Within the root <sites> element, it contains a number of <item> elements which represent particular registered instances. The <item> elements have the following sub-elements representing properties of the registered instances:

 

•<guid> - unique identifier of the instance. Its value is taken from the CMSApplicationGuid key in the appSettings section of the instance's web.config file.

•<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 CMS.

•<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> - version of .NET Framework used by the instance.

•<showlist> - indicates if a pop-up window where the website to be opened can be selected is displayed after executing the Livesite Browse action.

 

Here is a sample extract from the file:

 

<?xml version="1.0"?>

<sites>

 <item>

   <guid>3720a09b-43f7-4d26-8fec-e4b26637a2f3</guid>

   <url>http://localhost/KenticoCMS_4269.16734</url>

   <name>Kentico CMS 6</name>

   <version>6.0</version>

   <path>c:\inetpub\wwwroot\KenticoCMS_4269.16734</path>

   <created>2011-09-09T14:21:17</created>

   <hotfix>0</hotfix>

   <netversion>4</netversion>

   <showlist>1</showlist>

 </item>

 ...

</sites>

 

Registering a Kentico CMS instance

 

Registration of newly installed Kentico CMS instances is performed automatically. In case that you have Kentico CMS instances from versions prior to 6.0 already installed on your machine, you can register them by performing the following steps:

 

1. Click Register_kim Register in the main toolbar.

 

devguide_clip1774

 

2. In the pop-up window, enter the following details:

 

•Name: identifying name of the instance displayed in the Name column in the list of instances.

•URL: 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, a pop-up window where the website to be opened can be selected is displayed after executing the Livesite Browse action (useful for multi-site instances).

 

devguide_clip1765

 

3. The instance should now be registered and visible in the list of managed instances.

 

devguide_clip1773