RavenDB version 2.5. Other versions:

Installer

Since version 2.5 the installation of RavenDB can be accomplished by using a GUI installer. The setup wizard will guide you through an installation process where you just need to select the type of an installation and provide configuration options.

Figure 1: Welcome screen

Target environment

You need to choose what kind of the environment you are targeting. The licensing requirements are different depending on the selected option:

  • Production / Test - you have to provide a valid license in next step,
  • Development - no license is required.

Installation type

You can install the RavenDB either as a Windows service or as IIS application. Next steps will guide you through a configuration of a chosen deployment strategy.

Windows Service configuration

The configuration of the RavenDB service is straight-forward. You only have to provide the name and the port number of the service.

Figure 2: Windows Service

IIS Application configuration

The configuration of RavenDB run on IIS requires you to go throught a few screens.

Web site

In the first dialog you need to enter a web site configuration. You have here two possibilities:

  • Create a new web site
  • Use an existing one

If you choose first option you will need to fill up the following fields:

Figure 3: New IIS site configuration

If you decided to use the already existing site you just need to choose which one:

Figure 4: Existing IIS site

The Virtual Directory field can be empty. Then it means that RavenDB will be installed at the root of the web site.

Optionally you can select a checkbox to configure a custom application pool for RavenDB application instead of using the default one configured for the web site.

Application Pool (optional)

This optional dialog (shown when the checkbox on the previous screen was selected) allows you to set up a custom application pool. As previously you can either create a new or use an existing one.

Figure 5: Application Pool

Performance counters

The next screen is to configure permissions of the application pool user to the performance counters access. This is needed to ensure that RavenDB hosted by IIS will be able to create own counters and provide performance stats there.

Figure 6: Performance counters

Upgrade

The RavenDB installer supports upgrades. The previously used settings (like a service name or an installation path) will be recovered by the wizard. The installation process first will automatically remove the old version and then will install the new one.

Uninstall

Uninstallation can be accomplished by Programs and Features in Control Panel . Only the files created during an installation process will be removed, so all of database data will remain untouched on a disk.

Quiet mode installation from command line

The RavenDB installer can also be run from a command line with administrative privileges. In order to do that you will have to specify all required installation settings. Below there is a command which installs RavenDB as a windows service:

    
       > ravendb-[version].exe /quiet /log C:\Temp\raven_log.txt /msicl RAVEN_TARGET_ENVIRONMENT=DEVELOPMENT /msicl TARGETDIR=C:\ /msicl INSTALLFOLDER=C:\RavenDB /msicl RAVEN_INSTALLATION_TYPE=SERVICE /msicl REMOVE=IIS /msicl ADDLOCAL=Service
    

The list of RavenDB specific settings:

  • RAVEN_INSTALLATION_TYPE - available options: IIS (default) or SERVICE
  • RAVEN_TARGET_ENVIRONMENT - available options: PRODUCTION (default), DEVELOPMENT
  • RAVEN_LICENSE_FILE_PATH
  • SERVICE_NAME - default: RavenDB
  • SERVICE_PORT - default: 8080
Comments add new comment

The comments section is for user feedback or community content. If you seek assistance or have any questions, please post them at our support forums.

No comments found
SUBMIT COMMENT