Introduction

Setup

The following directories on the Zones server are involved:

lenya@lenya.zones.apache.org
  /docu
    /apache-tomcat-5.5.26  The Tomcat instance for the authoring environment.
      /conf
        /Catalina
          /localhost
            /lenya.xml     The context file referencing the web application.
    /data
      /docu                All data (content, user accounts, access policies, …)
    /lenya
      /docu                The documentation publication and modules.
      /trunk               The Lenya instance for the authoring environment.

Creating an Account

To be able to edit the Lenya website on the Zones server, you have to create an account:

1. Create your .iml file. Don't forget to add yourself to the groups editor, reviewer, sitemanager, and admin.
2. Copy your .iml file to the Zones server:

   scp {yourname}.iml {user}@lenya.zones.apache.org:docu/data/docu/access-control/passwd/.

Now you can log in to the authoring environment.

Understanding the Apache infrastructure

The Website at http://lenya.apache.org/ is a static site, which is served from the checkout dir lenya.apache.org on the server based on http://svn.apache.org/repos/asf/lenya/site/ by an Apache httpd server.

The content of lenya.apache.org is a static export of the live area of the Zones server. This has to be done on your local machine because we cannot commit to SVN on the Zones server.

Editing the Banner Column

Roundtrip Website Update

The typical roundtrip process to update the website has the following steps:

1. Log in to the authoring area and make your changes.

2. Update the SVN changes via the menu item File → Update Code Changes. This can take a while, depending on the timespan since the last update.

3. Publish the edited pages, including the SVN change pages.

4. Dowload the live area to your machine using the following command:

   wget -t 1 -T 5 --no-check-certificate -p --cut-dirs=3 -nH -r -L -e robots=off \
     https://lenya.zones.apache.org/cms/docu/live/index.html

5. Copy the exported pages to $SITE_SVN.

6. Create and copy the Javadoc for all branches:

   cd $LENYA_HOME_{$VERSION}
   ./build.sh javadocs
   cp build/webapp/site/apidocs/* $SITE_SVN/apidocs/{$VERSION}/

7. Commit the changes to $SITE_SVN.

Updating the Apache httpd Server on people.apache.org

There is a cron job on people which will do svn update in the server lenya.apache.org directory every 24 hours (see /x1/home/thorsten/thorsten.ct). If you want to invoke the script manually then ...

ssh people.apache.org
/x1/home/thorsten/bin/lenya-update.sh

Alternatively you can do the following (this is basically what the script does):

ssh people.apache.org
cd /www/lenya.apache.org
umask 0002
svn update