Author: steveh
Date: Tue Apr 12 12:55:54 2005
New Revision: 161103
URL: http://svn.apache.org/viewcvs?view=rev&rev=161103
Log:
New instructions for changing file permissions on 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&r1=161102&r2=161103
==============================================================================
--- incubator/beehive/trunk/docs/updating_livesite.txt (original)
+++ incubator/beehive/trunk/docs/updating_livesite.txt Tue Apr 12 12:55:54 2005
@@ -38,10 +38,13 @@
the SCP client with a SFTP (Secure File Transfer Protocol) 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. This insures that there are no permissions problems,
-if someone else performs the next site update.
-
+cvs.apache.org) is set to "0002" so that group write is set on the uploaded
+ZIP file. This insures that there are no permissions problems,
+if someone else performs the next site update.
+
+Note, however, a umask setting of 0002 will not affect the files extracted
from the ZIP file!
+This is because files extracted via UNZIP do not have group-write permission
by default!
+You must change the permissions on this extracted files manually! See step
(4) for details.
Process for Updating the Live Site
---------------------------------------
@@ -51,13 +54,14 @@
(1) Make a ZIP file of the latest docs on your local machine.
(2) Upload the ZIP file to the remote (live) machine.
(3) Unzip the ZIP file on the remote (live) machine.
+ (4) Change the unzipped files to allow group-write permissions!
(1) Make a ZIP file of the latest docs
--------------------------------------
Run the following Ant command (assuming that your shell is pointed at the
'beehive/trunk' directory):
- ant -f distribution.xml build.dist.docs build.livesite
+ ant -f distribution.xml clean.dist build.dist.docs build.livesite
This will build a ZIP file called "site.zip" and save it at
@@ -108,10 +112,31 @@
For example, to recursively remove the all contents of the directory 'foo',
use the
following command:
- rm -r foo.
+ rm -r foo
To ignore write-protection in the directory, use:
- rm -r -f foo.
+ rm -r -f foo
Obviously: be careful when deleting content from the site!
+
+(4) Change the unzipped files to allow group-write permissions
+--------------------------------------------------------------
+
+After you have unzipped the files, the permissions on the
+unzipped file is:
+
+ -rw-r--r--
+
+which doesn't allow other users to overwrite the unzipped file.
+
+Execute the following command
+to change the file permissions to group-write:
+
+ chmod -R 775 .
+
+This will change file permissions on every file in the directory to:
+
+ -rwxrwxr-x
+
+If you don't do this, no one else will be able to upload and unzip the live
site!
\ No newline at end of file
