Changes between Version 2 and Version 3 of Software/Install/MuaAndWebWindows


Ignore:
Timestamp:
12/18/11 03:09:22 (9 years ago)
Author:
smith@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Software/Install/MuaAndWebWindows

    v2 v3  
    11= Installing the Raptor Server Components (MUA & Web) on Windows = 
    22 
    3 Coming soon... A windows MSI installer package and associated instructions. 
     3All 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. 
     4 
     5== 1. MSI Installation Instructions == 
     6 
     7The 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. 
     8 
     9For Raptor Server, you are looking for raptor-server-vx-rx.msi (where vx-rx is the latest version!). 
     10 
     11=== 1.1 Run the MSI 
     12 
     13Download the file for this Raptor component, and double click (as Administrator) to run the MSI. 
     14 
     15[[Image(RaptorMSISS-Server-Start.png)]] 
     16 
     17Simply click through the MSI installer, choosing where to install Raptor, until you are asked for configuration details. 
     18 
     19=== 1.2. Configuration through the MSI === 
     20 
     21The Raptor Windows Installers perform a certain amount of configuration automatically for you, based on your answers to questions during the install process. 
     22 
     23==== 1.2.1 Configuring Metadata for the MUA ==== 
     24 
     25You will be asked to provide the following information: 
     26 
     27* EntityID - This uniquely identifies your instance of a Raptor MUA, and should follow the suggested format of !https://YOURSERVERNAME/raptor-mua. 
     28 * ''e.g. !https://raptor.example.com/raptor-mua'' 
     29* Organisation Name - This identifies the organisation that owns the service that you are monitoring. 
     30 * ''e.g. Example University'' 
     31* Service Name - This identifies the name of the service itself that you are monitoring. 
     32 * ''e.g. Raptor MUA'' 
     33* Contact Email - An email address for someone responsible for this Raptor component's upkeep. 
     34 * ''e.g. !someone@example.com'' 
     35 
     36[[Image(RaptorMSISS-MUA-Metadata.png)]] 
     37 
     38==== 1.2.2 Configuring Metadata for Web ==== 
     39 
     40You will be asked to provide the following information: 
     41 
     42* EntityID - This uniquely identifies your instance of Raptor Web, and should follow the suggested format of !https://YOURSERVERNAME/raptor-web. 
     43 * ''e.g. !https://raptor.example.com/raptor-web'' 
     44* Organisation Name - This identifies the organisation that owns the service that you are monitoring. 
     45 * ''e.g. Example University'' 
     46* Service Name - This identifies the name of the service itself that you are monitoring. 
     47 * ''e.g. Raptor Web'' 
     48* Contact Email - An email address for someone responsible for this Raptor component's upkeep. 
     49 * ''e.g. !someone@example.com'' 
     50 
     51[[Image(RaptorMSISS-Web-Metadata.png)]] 
     52 
     53=== 1.3. Finally === 
     54 
     55When the installation options have been chosen and the configuration has been modified appropriately, hit Install and away it goes. 
     56 
     57[[Image(RaptorMSISS-Server-Finally.png)]] 
     58 
     59 
     60== 2. Installation Details == 
     61 
     62The MSI will: 
     63 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}}} 
     64 1. Set up their SSL keystones (in {{{Raptor\MUA\keys}}} and {{{Raptor\Web\keys}}}) 
     65 1. 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). 
     66 
     67 
     68The installed program will have installed the following file structure: 
     69 
     70* {{{C:\Program Files\Raptor}}} 
     71 * {{{C:\Program Files\Raptor\MUA}}} 
     72  * {{{C:\Program Files\Raptor\MUA\raptor-mua.jar}}} - The main Raptor MUA classfile 
     73  * {{{C:\Program Files\Raptor\MUA\batchimport\}}} - Where historical log files can be dropped (see [Software/Productionalisation/ImportingOldLogs this page]) 
     74  * {{{C:\Program Files\Raptor\MUA\conf\}}} - Contains all configuration files for the Raptor MUA 
     75  * {{{C:\Program Files\Raptor\MUA\data\}}} - Contains the HSQL database, if you haven't switched to using a "real" database 
     76  * {{{C:\Program Files\Raptor\MUA\lib\}}} - Contains all libraries used by the Raptor MUA 
     77  * {{{C:\Program Files\Raptor\MUA\keys\}}} - Contains the Raptor MUA's keystore and truststore 
     78  * {{{C:\Program Files\Raptor\MUA\logs\}}} - Contains the Raptor MUA log files 
     79 * {{{C:\Program Files\Raptor\Web}}} 
     80  * {{{C:\Program Files\Raptor\Web\raptor-web.jar}}} - The main Raptor Web classfile 
     81  * {{{C:\Program Files\Raptor\Web\conf\}}} - Contains all configuration files for the Raptor Web 
     82  * {{{C:\Program Files\Raptor\Web\lib\}}} - Contains all libraries used by the Raptor Web 
     83  * {{{C:\Program Files\Raptor\Web\keys\}}} - Contains Raptor Web's keystore and truststore 
     84  * {{{C:\Program Files\Raptor\Web\logs\}}} - Contains Raptor Web log files 
     85 
     86See [Software/Configuration/Files this wiki page] for a complete listing of files along with a description of what they do.