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.
