[Commits] (bcm) add README.txt. add notes about tomcat bundle vs standalone webapp in

[commits at osafoundation.org]

Commit by: bcm
Modified files:
server/docs/README.txt None 1.1
server/docs/BUILD.txt 1.3 1.4
server/docs/INSTALL.txt 1.3 1.4
server/docs/LICENSE.txt 1.1 1.2
server/docs/RELEASE-NOTES.txt 1.3 1.4

Log message:
add README.txt. add notes about tomcat bundle vs standalone webapp in
INSTALL.txt.


ViewCVS links:
http://cvs.osafoundation.org/index.cgi/server/docs/README.txt?rev=1.1&content-type=text/vnd.viewcvs-markup
http://cvs.osafoundation.org/index.cgi/server/docs/BUILD.txt.diff?r1=text&tr1=1.3&r2=text&tr2=1.4
http://cvs.osafoundation.org/index.cgi/server/docs/INSTALL.txt.diff?r1=text&tr1=1.3&r2=text&tr2=1.4
http://cvs.osafoundation.org/index.cgi/server/docs/LICENSE.txt.diff?r1=text&tr1=1.1&r2=text&tr2=1.2
http://cvs.osafoundation.org/index.cgi/server/docs/RELEASE-NOTES.txt.diff?r1=text&tr1=1.3&r2=text&tr2=1.4

Index: server/docs/RELEASE-NOTES.txt
diff -u server/docs/RELEASE-NOTES.txt:1.3 server/docs/RELEASE-NOTES.txt:1.4
--- server/docs/RELEASE-NOTES.txt:1.3	Tue Apr 26 15:07:00 2005
+++ server/docs/RELEASE-NOTES.txt	Tue Apr 26 15:51:19 2005
@@ -2,8 +2,6 @@
                             Cosmo Sharing Server 0.1
                                   Release Notes
 
-$Id: RELEASE-NOTES.txt,v 1.3 2005/04/26 22:07:00 bcm Exp $
-
 
 ============================
 KNOWN ISSUES IN THIS RELEASE
@@ -11,3 +9,6 @@
 
 
  * Bug #2584: OS X WebFS does not interoperate with Cosmo. 
+
+
+$Id: RELEASE-NOTES.txt,v 1.4 2005/04/26 22:51:19 bcm Exp $

Index: server/docs/INSTALL.txt
diff -u server/docs/INSTALL.txt:1.3 server/docs/INSTALL.txt:1.4
--- server/docs/INSTALL.txt:1.3	Tue Apr 26 15:23:46 2005
+++ server/docs/INSTALL.txt	Tue Apr 26 15:51:19 2005
@@ -2,10 +2,12 @@
                             Cosmo Sharing Server 0.1
                             Installation Instructions
 
-$Id: INSTALL.txt,v 1.3 2005/04/26 22:23:46 bcm Exp $
 
+TOMCAT BUNDLE
+=============
 
-In order to install and run Cosmo, perform the following steps:
+In order to install and run Cosmo bundled with Tomcat, perform the
+following steps:
 
 
 (1) Download and install a Java Runtime Environment
@@ -107,7 +109,8 @@
     for more information on Tomcat Access Log Valve configuration.
 
     catalina.out is not rotated. It simply captures STDOUT output for
-    the Tomcat java process. It will very rarely contain any data.
+    the Tomcat java process. It will very rarely contain anything
+    other than Tomcat startup notices.
 
 
 (5) Use Cosmo
@@ -128,14 +131,28 @@
         https://localhost:8443/home/           (if you enabled SSL)
 
 
-(6) Read the Release Notes
+STANDALONE WEBAPP
+=================
+
+Future releases of Cosmo will provide a standalone webapp distribution
+that you can deploy into an existing application server. Advanced
+users should be able to do this today by examining the customized
+config files in the Tomcat bundle distribution.
+
+
+TROUBLESHOOTING
+===============
+
+ *** First read the Release Notes! ***
 
     You can find the release notes for Cosmo at
     $COSMO_HOME/RELEASE_NOTES.txt. Please read them and become
-    familiar with all of the known issues before asking for help.
+    familiar with all of the known issues before asking for help. If
+    your question is not answered there, check README.txt for mailing
+    list and bug tracker information.
 
 
-(7) Troubleshooting
+Common Gotchas:
 
     * If another process is listening on port 8080, you will need to
       change the port on which Tomcat's connector listens. Edit the
@@ -145,7 +162,10 @@
 
         <Connector port="8080" enableLookups="false"/>
 
-    * Issues are tracked at <http://bugzilla.osafoundation.org/>.
+      If you are running another instance of Tomcat, you may also need
+      to change this instance's shutdown port:
+
+        <Server port="8005" shutdown="SHUTDOWN">
+
 
-    * Feel free to ask questions and report problems to
-      cosmo at osafoundation.org.
+$Id: INSTALL.txt,v 1.4 2005/04/26 22:51:19 bcm Exp $

Index: server/docs/BUILD.txt
diff -u server/docs/BUILD.txt:1.3 server/docs/BUILD.txt:1.4
--- server/docs/BUILD.txt:1.3	Tue Apr 26 15:23:46 2005
+++ server/docs/BUILD.txt	Tue Apr 26 15:51:19 2005
@@ -2,8 +2,6 @@
                             Cosmo Sharing Server 0.1
                                Build Instructions
 
-$Id: BUILD.txt,v 1.3 2005/04/26 22:23:46 bcm Exp $
-
 
 SETUP
 =====
@@ -149,3 +147,6 @@
     jcr.jar=${maven.repository}/jsr170/jars/jcr-0.16.2.jar
     jcr-server.jar=${maven.repository}/jcr-server/jars/jcr-server-0.16.2.jar
     jcr-webdav.jar=${maven.repository}/jcr-server/jars/jcr-webdav-0.16.2.jar
+
+
+$Id: BUILD.txt,v 1.4 2005/04/26 22:51:19 bcm Exp $

Index: server/docs/LICENSE.txt
diff -u server/docs/LICENSE.txt:1.1 server/docs/LICENSE.txt:1.2
--- server/docs/LICENSE.txt:1.1	Thu Feb 10 12:37:36 2005
+++ server/docs/LICENSE.txt	Tue Apr 26 15:51:19 2005
@@ -0,0 +1,2 @@
+
+Coming soon...