How to install the Hippo Management Maven plugin, so you can easily deploy your sites and the Hippo CMS to remote unix and linux servers.

Hippo Management Maven plugin

The Management plugin is a Maven plugin to assist you to build and remotely deploy your Hippo Site projects.

Get Maven

This plugin is designed for Maven 1.0.n, if you do not already have it, the latest version, currently 1.0.2, can be downloaded from http://maven.apache.org/maven-1.x/start/download.html. Decompress the archive to a suitable location. Add this location as MAVEN_HOME to your environment variables and for convenience, add it to the $PATH variable.

In your user directory, create a build.properties file and add the following line

maven.repo.remote=http://repository.hippocms.org/maven/,http://www.ibiblio.org/maven/

Current version: 1.01.01

Installing

To install the Hippo Management plugin:

maven -Dversion=1.01.01 -DartifactId=hippo-management-plugin -DgroupId=hippo-management-plugin plugin:download -Dmaven.repo.remote=http://repository.hippocms.org/maven

Windows users need to install:

• plink.exe from the putty download page and put it in your putty directory
• patch.exe http://gnuwin32.sourceforge.net/packages/patch.htm

Sometimes maven refuses to download and install the new plugin. You'll need to delete the plugin on your computer in three places: Linux and MacOSX ~/dev/maven/plugins (or wherever you installed maven) ~/.maven/cache (change username) ~/.maven/repository/hippo-cocoon/plugins Windows C:\apache\maven\plugins (or where you installed maven) C:\Documents and Settings\username\.maven\cache C:\Documents and Settings\username\.maven\repository\hippo-cocoon\plugins

Usage

To show the options of the plugin type:

maven -P management

Goals are:

• maven management:init (show parameters used to do the distribute2server)
• maven management:distribute2server (distribute the site to the remote server)
• maven management:undo (undo to the previous version)
• maven management:showundos (show all backups)
• maven management:stop
• maven management:start
• maven management:restart
• maven management:showlog (shows wrapper.log)
• maven management:create-scripts (creates startup / stop / restart scripts in homedir - called by distribute2server)

build.properties

maven.distribute.user=username
maven.distribute.password=passowrd
maven.distribute.path=/home/username
maven.distribute.server=servername
maven.distribute.port=portnumber (optional, default 22)

The port number property was added in 1.01.01.

Possible problems

• if you get a message "The server's host key is not cached in the registry. etc.", cancel (Ctrl-C), type plink SERVER_IP (where SERVER_IP is the IP address of the server you want to distribute to) at the command line. You will get the same message, only this time you will be able to answer the question with "y". Type "y" and ENTER. Everything should work fine from now.

Code

The code is in the public SVN at:
http://svn.hippocms.org/repos/hippo/hippo-tools/hippo-management-plugin