wiki:Software/Install/MuaAndWebWindows
Last modified 7 years ago Last modified on 12/18/11 03:13:51

Installing the Raptor Server Components (MUA & Web) on Windows

All Raptor components are made available on linux as Windows Installer (.msi) files, allowing easy installs and upgrades. These MSIs are made available at the following location: https://iam.cf.ac.uk/downloads/raptor.

1. MSI Installation Instructions

The MSI repository can be found at https://iam.cf.ac.uk/downloads/raptor. Each MSI file has a corresponding GPG signature, signed with the private key of Rhys Smith.

For Raptor Server, you are looking for raptor-server-vx-rx.msi (where vx-rx is the latest version!).

1.1 Run the MSI

Download the file for this Raptor component, and double click (as Administrator) to run the MSI.

MSI Screenshot - Start

Simply click through the MSI installer, choosing where to install Raptor, until you are asked for configuration details.

1.2. Configuration through the MSI

The Raptor Windows Installers perform a certain amount of configuration automatically for you, based on your answers to questions during the install process.

1.2.1 Configuring Metadata for the MUA

You will be asked to provide the following information:

  • EntityID - This uniquely identifies your instance of a Raptor MUA, and should follow the suggested format of https://YOURSERVERNAME/raptor-mua.
    • e.g. https://raptor.example.com/raptor-mua
  • Organisation Name - This identifies the organisation that owns the service that you are monitoring.
    • e.g. Example University
  • Service Name - This identifies the name of the service itself that you are monitoring.
    • e.g. Raptor MUA
  • Contact Email - An email address for someone responsible for this Raptor component's upkeep.
    • e.g. someone@example.com

MSI Screenshot - Configuring Metadata for MUA

1.2.2 Configuring Metadata for Web

You will be asked to provide the following information:

  • EntityID - This uniquely identifies your instance of Raptor Web, and should follow the suggested format of https://YOURSERVERNAME/raptor-web.
    • e.g. https://raptor.example.com/raptor-web
  • Organisation Name - This identifies the organisation that owns the service that you are monitoring.
    • e.g. Example University
  • Service Name - This identifies the name of the service itself that you are monitoring.
    • e.g. Raptor Web
  • Contact Email - An email address for someone responsible for this Raptor component's upkeep.
    • e.g. someone@example.com

MSI Screenshot - Configuring Metadata for Web

1.3. Finally

When the installation options have been chosen and the configuration has been modified appropriately, hit Install and away it goes.

MSI Screenshot - Finally

2. Installation Details

The MSI will:

  1. Install the Raptor MUA and Web into the default (but overridable) locations of C:\Program Files\Raptor\MUA and C:\Program Files\Raptor\Web
  2. Set up their SSL keystones (in Raptor\MUA\keys and Raptor\Web\keys)
  3. Installing Windows Services on the machine (raptormua and raptorweb which are set to start automatically on server boot. The services will be running a web service (using embedded jetty) listening on port :8111 (for the MUA) and :8112 (for Web).

The installed program will have installed the following file structure:

  • C:\Program Files\Raptor
    • C:\Program Files\Raptor\MUA
      • C:\Program Files\Raptor\MUA\raptor-mua.jar - The main Raptor MUA classfile
      • C:\Program Files\Raptor\MUA\batchimport\ - Where historical log files can be dropped (see this page)
      • C:\Program Files\Raptor\MUA\conf\ - Contains all configuration files for the Raptor MUA
      • C:\Program Files\Raptor\MUA\data\ - Contains the HSQL database, if you haven't switched to using a "real" database
      • C:\Program Files\Raptor\MUA\lib\ - Contains all libraries used by the Raptor MUA
      • C:\Program Files\Raptor\MUA\keys\ - Contains the Raptor MUA's keystore and truststore
      • C:\Program Files\Raptor\MUA\logs\ - Contains the Raptor MUA log files
    • C:\Program Files\Raptor\Web
      • C:\Program Files\Raptor\Web\raptor-web.jar - The main Raptor Web classfile
      • C:\Program Files\Raptor\Web\conf\ - Contains all configuration files for the Raptor Web
      • C:\Program Files\Raptor\Web\lib\ - Contains all libraries used by the Raptor Web
      • C:\Program Files\Raptor\Web\keys\ - Contains Raptor Web's keystore and truststore
      • C:\Program Files\Raptor\Web\logs\ - Contains Raptor Web log files

See this wiki page for a complete listing of files along with a description of what they do.

Attachments