RebuildSites

Rebuild the various Velocity sites

We use Apache Maven 2 for building a number of sites related to the Velocity TLP. This used to be somewhat tricky but with Maven 2.0.6, the complexity has been reduced a lot. And with our Solaris Zone, it became even less.

Prerequisites

You need a login on velocity.zones.apache.org. If you are a committer, you can request this from the PMC. See ZonesLogin on how to do this.

To deploy the site, you must use the same SSH key to log into velocity.zones.apache.org as you use to log into people.apache.org. If you use different keys, make sure that you have an SSH Agent that forwards your keys.

You must be able to log into people.apache.org from velocity.zones.apache.org without any password or confirmation questions required. The deploy process is non-interactive and will fail otherwise. If you can not deploy the site, please check whether you can run ssh -l <your apache id> people.apache.org. You must do this once anyway, because the first time the authenticity of people.apache.org needs to be verified.

You also need a local settings file (typically located in /export/home/<your apache id>/.m2/settings.xml) that references your Apache Id for the deployment:

<settings> 
  <servers>
    <server>
      <id>velocity.apache.org</id>
      <username>YOUR LOGIN HERE</username>
    </server>
  </servers>
</settings>

Maven installation on velocity.zones.apache.org

Maven 2.0.6 is installed on velocity.zones.apache.org in /usr/local/bin. This is a standard Maven installation.

Local velocity user

There is a special user velocity for rebuilding the sites. In its local maven repository are the patched plugins required to correctly build the sites. The source to the changes is located in the /export/home/velocity/scratch directory.

Rebuilding the sites

All Velocity related sites are rebuilt in the same way:

• Do your site changes on your local computer, not velocity.zones.apache.org

• If you are satisfied, check them into the Subversion repository

• Log into velocity.zones.apache.org

• Change your group Id to read velocity by running newgrp velocity

• Verify by running the id command. It should look like this:

bash-3.00$ id 
uid=1234(apache-user-id) gid=5543(velocity)

• Now run the desired rebuild script as listed below. This script updates the local copy of the site source (in /export/home/velocity/deploy), builds the site and deploys it under your Apache User id to velocity.apache.org.

Please do not try to run maven manually. Due to the patched plugins, the site building and deployment happens in Maven offline mode and we do not want to have some random incompatible plugin version downloaded from the maven repo to mess up the build process. If any of the scripts fail, please report it to the Velocity development list.

Available site scripts

Release Scripts

There are no scripts yet to build the release sites. When the next release comes up, this will be addressed.