Installation of the onion.net Management Server

The onion.net Management Server is installed only once on computer systems operating an onion.net Editor or an onion.net Render Engine.

1. Installation of the service

Copy the directory „onion.net Management Server" of the distribution into your desired target directory. .NET-based Windows services are installed via the command line program installutil.exe. To do this, simply open a command line and change into the copied directory „onion.net Management Server". In our example, it is called „c:\onion.net\services\onion.net Management Server".

The required program installutil.exe is already stored on your computer in the directory „%WINDIR%\microsoft.net\framework\v2.0.50727\". For the installation, execute this program with the following arguments:

%WINDIR%\Microsoft.NET\Framework\v2.0.50727\installutil.exe Onion.Management.WindowsService.exe

Switch the start type of the service in the service management of the server from "manual" to "automatic".

We will now proceed with the required configuration steps. In the target directory, you will find the configuration file „Onion.Management.WindowsService.exe.config". 

2. Configuration of the onion.net Management Server

The cache directories are configured in the onion.net Render Engine. Files that are no longer used will be cleaned up by this service in a background process with low priority.

In our installation example, the directories "c:\onion.net\cache" and "c:\onion.net\cache\web" need to be configured. 

3. Access rights of the user account

The user account used for executing the service must have the respective read and write rights in the configured directories.

If an onion.net Editor is configured with the onion.net Management Server, the user account must have the rights to read and write in the functions directory of the onion.net Editor. In our example, this is the directory "c:\onion.net\web\contoso\editor\functions".