Execute the server installation

After the WindowsInstaller onion.net has been installed, you will find the current distribution of onion.net in your program directory. The distribution directory now contains the following directories:

Component/directory Type of service Short description
onion.net Information Server Windows service Central server for any XML scheme-based data, users and rights etc.
onion.net Editor ASP.NET Web-based editing surface for content collaboration. Additionally, it serves as administrative tool of the data model and for the administration of users, groups and rights.
onion.net Render Engine ASP.NET Web-based unit for processing any onion.net-based information and other data sources
onion.net Image Server Windows service Unit for automatic image editing. Is included via an extended command of the onion.net Render Engine (extension).
onion.net Sharepoint Integration Windows service Server and data source for integration of information from the Microsoft SharePoint into the onion.net Render Engine.
onion.net Datasource Server Windows service Out-of-process data source cache for the onion.net Render Engine
onion.net Management Service Windows service Asynchronous organisation and clean-up unit. Is used by the onion.net Editor and the onion.net Render Engine.

The next steps show how to execute a basic installation. This is the kind of installation usually found in a preview environment. In this manual, the installation of the following components will be described:

A basic installation is made assuming that all components are to be installed on one server. You are, however, free to install and scale the components on different servers. For the configuration options of the components, we refer to the respective configuration details provided on the learners' website.

The chapter onion.net Render Engine (Live) informs you how to configure an onion.net Render Engine for a live environment.

To prepare the installation, an unpacked distribution in the program directory under "onion" is required. In the following, we will explain how to create the directories for the onion.net components and what they are used for. This structure only serves as a guideline, it can be adjusted to your own requirements.

In the empty directory "c:\onion.net", four directories will be created. The first directory called "services" will contain the onion.net services that the onion.net Information Server stores there. In the second directory "web", the web applications - the onion.net Editor(s) and the onion.net Render Engine(s) - will be installed. The other directories "logs" and "cache" will later be used by the components themselves. In the logs directory, the applications should be able to store the log data. The path needs to be configured in the respective configuration files. The cache directory is used by the onion.net Reader Engine to build up the cache. This path also needs to be set up in the configuration file. 

At the end of the installation process, the directory structure sould be as follow:

If only one entity of onion.net is to be installed on the server, a directory with the project name (contoso in our example) can, of course, be left out.