You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by st...@apache.org on 2005/01/26 18:38:15 UTC
svn commit: r126519 - /incubator/beehive/trunk/docs/updating_livesite.txt
Author: steveh
Date: Wed Jan 26 09:38:13 2005
New Revision: 126519
URL: http://svn.apache.org/viewcvs?view=rev&rev=126519
Log:
Refining the instructions for undating the live site.
Modified:
incubator/beehive/trunk/docs/updating_livesite.txt
Modified: incubator/beehive/trunk/docs/updating_livesite.txt
Url: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/updating_livesite.txt?view=diff&rev=126519&p1=incubator/beehive/trunk/docs/updating_livesite.txt&r1=126518&p2=incubator/beehive/trunk/docs/updating_livesite.txt&r2=126519
==============================================================================
--- incubator/beehive/trunk/docs/updating_livesite.txt (original)
+++ incubator/beehive/trunk/docs/updating_livesite.txt Wed Jan 26 09:38:13 2005
@@ -18,42 +18,75 @@
Process for Updating the Live Site
----------------------------------
-In brief, the process for updating the live site goes as follows:
+To update the live site, you must have the following three software installations:
- (1) Make a ZIP file of the latest docs on your local machine.
- (2) Upload and and unzip the file on the live, remote machine.
+ (a) a Beehive SVN enlistment (See beehive/trunk/BUILDING.txt)
+ (b) a secure FTP (SFTP) client installed on your machine
+ (c) a SSH client
-To update the live site, you must have both (a) a Beehive SVN enlistment and (b) a secure FTP (SFTP) client installed on your machine.
-The following instructions assume that you have the Putty SFTP client installed.
+The following instructions assume that you have the Putty SFTP and SSH clients installed.
(Downloadable from http://www.putty.nl/download.html)
-If you have a different SFTP client, the instructions can be easily modified to work with
-that client (using a bit of common sense).
+If you have different clients, the instructions can be easily modified to work with
+that client (using a bit of common sense). For example, you could easily replace
+the SFTP client with a SCP client.
+
+Before proceding, it is important that your umask (on
+cvs.apache.org) is set to "0002" so that group write is set on all the
+files. That way, if the next site update is done by someone else,
+they don't run in to permissions problems because you alone own the files and
+disallow any other member of the "beehive" group from modifying them.
+
+In brief, the process for updating the live site goes as follows:
+
+ (1) Make a ZIP file of the latest docs on your local machine.
+ (2) Delete the old site from the live, remote machine.
+ (3) Upload the ZIP file to the live, remote machine.
+ (4) Unzip the ZIP file on the live, remote machine.
(1) Make a ZIP file of the latest docs
--------------------------------------
Run the following Ant command:
- ant -f distribution.xml build.livesite
+ ant -f distribution.xml build.dist.docs build.dist.docs.zip -Ddist.name=site
-This will build a ZIP file called "site.zip" and save it at /trunk/build/docs/site.zip
+This will build a ZIP file called "site-docs.zip" and save it at /beehive/trunk/build/jars/site-docs.zip
-(2) Upload and Unzip site.zip
+
+(2) Delete the old site from the live, remote machine.
-----------------------------
-Place the SFTP client on your PATH (set PATH=C:\path\to\psftp.exe;%PATH%).
+Open a SSH connection to cvs.apache.org.
+
+cd to www/incubator.apache.org/beehive
+
+Delete the content to be refreshed (rm -r [directory])
+
+Re-create the deleted directory (mkdir [directory]). You will upload and unzip into this directory.
+
+
+(3) Upload the ZIP file to the live, remove machine
+---------------------------------------------------
+
+Place the SFTP client on your PATH (e.g., set PATH=C:\path\to\psftp.exe;%PATH%).
psftp cvs.apache.org (You will be prompted for your username and password.)
-cd to www/incubator.apache.org/beehive (This is the target directory on the remote machine. You may cd to a subdirectory if appropriate.)
+cd to www/incubator.apache.org/beehive/[directory] (This is the target directory on the remote machine.)
+
+lcd to the directory where site-docs.zip resides on your local machine. ( = trunk/build/docs/)
+
+put site.zip (Uploads the new site-docs.zip to the remote machine.)
+
-rm -r [directory] (Deletes the old content from the remote machine.)
+(4) Unzip the ZIP on the live, remote machine
+---------------------------------------------
-lcd to the directory where site.zip resides on your local machine. ( = trunk/build/docs/)
+Return to the SSH client.
-put site.zip (Uploads the new site.zip to the remote machine.)
+unzip site-docs.zip
-Make a putty SSH connection, cd to the www/incubator.apache.org/beehive (or whichever subdirectory is appropriate), and unzip the file.
+The content is now live.