--- title: Kentico Xperience Service Manager related: - https://docs.kentico.com/13/external-utilities/kentico-xperience-installation-manager.md - https://docs.kentico.com/13/configuring-xperience/scheduling-tasks.md - https://docs.kentico.com/13/configuring-xperience/scheduling-tasks/installing-the-scheduler-windows-service.md --- > Agent instructions: > **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown. > > - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version. > - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt). Kentico Xperience Service Manager is an external Windows utility which allows you to manage external Windows services used by Xperience. Via the utility, you can: - Install - Uninstall - Start - Stop - Restart **Windows services** for individual instances of Xperience. You can perform the installation and uninstallation of Windows services from the command line and stop and restart them from Windows Service manager (_services.msc_). However, this utility integrates these tasks into a single tool, where you can manage Xperience services separately from other services running in Windows. ### Launching the utility Kentico Xperience Service Manager **is automatically installed** with Xperience installations. There are two ways to launch the Kentico Xperience Service Manager: #### From Windows 1. Launch the **Kentico Xperience Service Manager** from Windows Start menu. 2. Select the root of the Xperience instance, whose services you want to manage, in the **Browse For Folder** dialog box. 3. Click **OK**. #### From KIM 1. Run [Kentico Xperience Installation Manager](https://docs.kentico.com/13/external-utilities/kentico-xperience-installation-manager.md). 2. Select an instance of Xperience. 3. Click the **Services** button on the toolbar. ### Using the utility to manage Xperience services After launching the utility (and successful selection of the managed Xperience instance when launched from Start menu), available services are listed in the main area. The following information is listed for each services: - **Name** – name of the Windows service in format ** ()**. - **Installed** – shows if the service is installed or not. - **Status** – shows if the service is running or stopped, or intermediate statuses when the service is being started, stopped or restarted. If you select a service in the listing, the following management actions are available in the top toolbar. The same actions are also available in a context menu accessible by right-clicking a service. - **Install** – installs the selected service. Only available if the service is not installed. - **Uninstall** – uninstalls the selected service. Only available if the service is installed. - **Start** – starts the selected service. Only available if the service is installed and not running. - **Stop** – stops the selected service. Only available if the service is installed and running. - **Restart** – restarts the selected service. Only available if the service is installed and running. ![Kentico Service Manager toolbar](https://docs.kentico.com/docsassets/13/kentico-xperience-service-manager/Kentico_service_manager.png "Kentico Service Manager toolbar") ### Defining custom services in the definition XML file All Windows services that can be managed by Kentico Xperience Service Manager are defined in _\~/App\_Data/CMSModules/WinServices/services.xml_ file. If you want to add a custom service, which should work with the respective Xperience instance, you have to define it in this file. The XML has a root **** element containing any number of **** elements, each of which represents a single Windows service. Each **** element contains the following sub-elements: - **** – identifying name of the service, identical for all instances of Xperience. - **** – the same as __, with the {0} part appended. The {0} part gets replaced with the value of the _CMSApplicationName_ or alternatively _CMSApplicationGuidweb.config_ keys to differentiate services of particular Xperience instances. - **** – name of the Windows service in friendly format, displayed in user interfaces of Windows Services manager (_services.msc_) and Kentico Xperience Service Manager. - **** – text describing the functionality provided by the service. - **** – name of the service's executable file stored inside the _bin_ folder in the application root. Here you can see the default content of the _services.xml_ file with the [Scheduler](https://docs.kentico.com/13/configuring-xperience/scheduling-tasks.md) service defined. ```html KenticoCMSScheduler KenticoCMSScheduler{1} Kentico CMS Scheduler ({0}) Processes Xperience scheduled tasks that have the 'Use external service' option enabled. Processing is performed in regular intervals and only tasks with the mentioned option enabled are processed by the service. SchedulerService.exe ``` ### Problems with required web.config keys Xperience Windows services require the **CMSApplicationName** or **CMSApplicationGuid** keys to be added in the configuration file of the related project (_web.config_ or _appsettings.json_ file by default). The values of these keys are used in the names of the Windows services and for identification of the Xperience instance. These keys are included in the configuration file of new installations by default. If neither of the two keys is present for the selected instance (after being removed manually), you will encounter an error message with two options. ![Error message about missing application keys](https://docs.kentico.com/docsassets/13/kentico-xperience-service-manager/KSM_App_Key_Error.png "Error message about missing application keys") - **Yes** – the Service Manager generates and adds the keys so that services can work with the selected Xperience instance. - **No** – services cannot be managed for the selected instance. In this case, you can select another instance after clicking **Select** on the toolbar.