How to start Hippo server processes on Windows (this includes: Hippo Repository, Hippo CMS and Hippo Sites)

Introduction

Apache Excalibur Fortress is a standalone container for Java server processes.

Each of the Hippo components: the Hippo Repository, the Hippo CMS and sites you develop using the Hippo-Cocoon Maven plugin (optional), run in their own Fortress processes.

The distributions all come with wrappers that work on Windows.

Installation

If you have not already done so, you need to install Java.

You can determine if Java is already installed by typing java -version   At the Command Prompt, if Java is installed it will tell you it's version number

• Go to http://java.sun.com and install the latest version of the J2SE 1.4.2 SDK (currently this is 1.4.2_10).
• Please read Sun's documentation on http://java.sun.com/j2se/1.4.2/install-windows.html about how to set your PATH environment variable and guidelines to perform the installation correctly.
• Set the JAVA_HOME environment variable (See Flash guide here: Windows - setting JAVA_HOME environment variable.swf)

Next you need to identify the relevant \bin directories of the Hippo components, eg.

• Where you have downloaded the components as binaries, the directory is:

  [component directory]\bin\
  

   

• Where you have built the components from source, the directory is:

  [component directory]\target\hippo-[component name]-[version]\bin\
  

   

• Where you have built your own site using the Hippo-Cocoon plugin, the directory is:

  [site directory]\target\hippo-cocoon-[version]\bin\
  

Launching

Each component is launched as a separate process, you will need to use the Command Prompt to do this.

• Launch the Command Prompt (Start > Run > cmd)
• The easiest way to work is to have one window for each component. Open more Command Prompt windows until you have enough.
• In each of the windows, cd to one of the components' \bin directories
• The Hippo Repository should be started first, followed by the Hippo CMS, then your projects
• to start a component, type:

  wrapper -c wrapper.conf
  

   

• to stop a component

  hit ctrl-c
  

   

After you start a Hippo component, the Command Prompt should report "Starting Hippo Fortress...", then give you a prompt again.

Depending on the speed of your PC, you will have to wait a few moments until each newly launched component is ready to receive requests from a web browser. You will see error messages in the web browser if you hit it too soon.

If you choose you may now log out of your account on that PC and the Hippo Components will keep running.

Running the Fortress as a windows service

• to install a component as a service

  wrapper -i wrapper.conf
  

• to run a component as a service

  wrapper -t wrapper.conf
  

• to stop a component from running

  wrapper -p wrapper.conf
  

• to remove

  wrapper -r wrapper.conf