[Commits] (bcm) update the install docs and release notes.

commits at osafoundation.org commits at osafoundation.org
Tue Apr 26 15:07:01 PDT 2005


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

Log message:
update the install docs and release notes.


ViewCVS links:
http://cvs.osafoundation.org/index.cgi/server/docs/BUILD.txt.diff?r1=text&tr1=1.1&r2=text&tr2=1.2
http://cvs.osafoundation.org/index.cgi/server/docs/INSTALL.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.2&r2=text&tr2=1.3

Index: server/docs/RELEASE-NOTES.txt
diff -u server/docs/RELEASE-NOTES.txt:1.2 server/docs/RELEASE-NOTES.txt:1.3
--- server/docs/RELEASE-NOTES.txt:1.2	Tue Feb 15 15:01:47 2005
+++ server/docs/RELEASE-NOTES.txt	Tue Apr 26 15:07:00 2005
@@ -1,8 +1,8 @@
 
-                        OSAF Chandler Sharing Server 0.1
-                                 Release Notes
+                            Cosmo Sharing Server 0.1
+                                  Release Notes
 
-$Id: RELEASE-NOTES.txt,v 1.2 2005/02/15 23:01:47 bcm Exp $
+$Id: RELEASE-NOTES.txt,v 1.3 2005/04/26 22:07:00 bcm Exp $
 
 
 ============================
@@ -10,25 +10,4 @@
 ============================
 
 
- * When stopping Chandler server, Slide does not clean itself up
-   properly, causing the java process to not shut down. After
-   executing `chandlerctl stop', you must manually kill the java
-   process. See the Apache bug database for more information:
-
-     http://issues.apache.org/bugzilla/show_bug.cgi?id=33517
-
- * The server only supports access by the root user. There are no
-   home directories or access controls. The sharing store is rooted
-   at /share/files/, but the root user has read/write access to all
-   collections within /. Please do not modify any of the collections
-   outside /share/files/ unless you know what you are doing.
-
- * If you do insist on mucking about with users, roles, actions,
-   etc. and lock yourself out or corrupt your store, you may destroy
-   and re-initialize the store by taking the following steps:
-
-     1) Stop Chandler server (chandlerctl stop)
-
-     2) Fully remove $CHANDLER_HOME/store and $CHANDLER_HOME/work.
-
-     3) Start Chandler server (chandlerctl start)
+ * Bug #2584: OS X WebFS does not interoperate with Cosmo. 

Index: server/docs/BUILD.txt
diff -u server/docs/BUILD.txt:1.1 server/docs/BUILD.txt:1.2
--- server/docs/BUILD.txt:1.1	Tue Apr 26 14:04:40 2005
+++ server/docs/BUILD.txt	Tue Apr 26 15:07:00 2005
@@ -1,8 +1,8 @@
 
-                              Cosmo Sharing Server
+                            Cosmo Sharing Server 0.1
                                Build Instructions
 
-$Id: BUILD.txt,v 1.1 2005/04/26 21:04:40 bcm Exp $
+$Id: BUILD.txt,v 1.2 2005/04/26 22:07:00 bcm Exp $
 
 
 SETUP

Index: server/docs/INSTALL.txt
diff -u server/docs/INSTALL.txt:1.1 server/docs/INSTALL.txt:1.2
--- server/docs/INSTALL.txt:1.1	Thu Feb 10 12:37:36 2005
+++ server/docs/INSTALL.txt	Tue Apr 26 15:07:00 2005
@@ -1,12 +1,11 @@
 
-                        OSAF Chandler Sharing Server 0.1
-                           Installation Instructions
+                            Cosmo Sharing Server 0.1
+                            Installation Instructions
 
-$Id: INSTALL.txt,v 1.1 2005/02/10 20:37:36 bcm Exp $
+$Id: INSTALL.txt,v 1.2 2005/04/26 22:07:00 bcm Exp $
 
 
-In order to install and run the Chandler Sharing Server, perform the
-following steps:
+In order to install and run Cosmo, perform the following steps:
 
 
 (1) Download and install a Java Runtime Environment
@@ -22,7 +21,7 @@
       directory into which you installed the JDK release.
 
 
-(2) Download and install the Chandler server binary distribution
+(2) Download and install the Cosmo binary distribution
 
     NOTE: As an alternative to downloading a binary distribution, you
     can create your own from the source repository, as described in
@@ -31,51 +30,37 @@
 
     * Download a binary distribution from:
 
-        http://wiki.osafoundation.org/bin/view/Chandler/ChandlerServer
+        http://wiki.osafoundation.org/bin/view/Cosmo/GettingCosmo
 
     * Unpack the binary distribution into a convenient location so
       that the distribution resides in its own directory
-      (conventionally named chandler-server-0.1).  For the purposes of
+      (conventionally named cosmo-0.1).  For the purposes of
       the remainder of this document, the symbolic name
-      "$CHANDLER_HOME" is used to refer to the full pathname of the
+      "$COSMO_HOME" is used to refer to the full pathname of the
       release directory.
 
 
-(3) Change the root password (OPTIONAL)
-
-    The default root password may be changed by editing
-    $CHANDLER_HOME/chandler/WEB-INF/Domain.xml. Find the following
-    section and replace the default password ("chsrv"):
-
-      <!-- /users/root represents the administrator -->
-      <objectnode classname="org.apache.slide.structure.SubjectNode" uri="/users/root">
-        <revision>
-          <property namespace="http://jakarta.apache.org/slide/" name="password">chsrv</property> 
-        </revision>
-      </objectnode>
-
-
-(4) Configure SSL (OPTIONAL)
+(3) Configure SSL (OPTIONAL)
 
     * Create a certificate keystore by executing the following
-      command as the user which will run Chandler Server, specifying
-      a password value of "chandler" for both the keystore password
+      command as the user which will run Cosmo, specifying
+      a password value of "cosmo" for both the keystore password
       and the key (certificate) password:
 
         Unix:
 
-        $JAVA_HOME/bin/keytool -genkey -alias chandler -keyalg RSA
+        $JAVA_HOME/bin/keytool -genkey -alias osafcosmo -keyalg RSA
 
         Windows:
 
-        %JAVA_HOME%\bin\keytool -genkey -alias chandler -keyalg RSA
+        -- not yet supported --
 
     * Uncomment the SSL Connector entry in
-      $CHANDLER_HOME/tomcat/conf/server.xml:
+      $COSMO_HOME/tomcat/conf/server.xml:
 
         <Connector port="8443" enableLookups="false" secure="true"
                    scheme="https" clientAuth="want"
-                   keystorePass="chandler"/>
+                   keystorePass="osafcosmo"/>
 
     For more information on creating a keystore, importing an
     existing certificates into a keystore, and configuring the SSL
@@ -84,44 +69,52 @@
         http://jakarta.apache.org/tomcat/tomcat-5.0-doc/ssl-howto.html
 
 
-(5) Start Chandler Server
+(4) Start Cosmo
 
-    Chandler Server can be started by executing the following
-    command:
+    Cosmo can be started by executing the following command:
 
         Unix:
 
-        $CHANDLER_HOME/bin/chandlerctl start
+        $COSMO_HOME/bin/cosmoctl start
 
         Windows:
 
-        $CHANDLER_HOME\bin\chandlerctl.bat start
+        -- not yet supported --
 
-    After startup, the server's welcome page will be viewable at:
+    After startup, the server's welcome page will be viewable at
+    (username 'root', password 'cosmo'):
 
         http://localhost:8080/
         https://localhost:8443/                (if you enabled SSL)
 
-    Files may be shared at (username "root", password "chsrv" [or
-    whatever you changed it to]):
+    You should immediately change the root user's password in the
+    "Users" section of the admin console.
 
-        http://localhost:8080/share/files/
-        https://localhost:8443/share/files/    (if you enabled SSL)
+    You can use a WebDAV client to view the user home directory
+    workspace (same credentials as above):
 
-(6) Read the Release Notes
+        http://localhost:8080/home/
+        https://localhost:8443/home/           (if you enabled SSL)
 
-    You can find the release notes for Chandler Server at
-    $CHANDLER_HOME/RELEASE_NOTES.txt. Please read them and become
+
+(5) 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.
 
 
-(7) Troubleshooting
+(6) Troubleshooting
 
     * If another process is listening on port 8080, you will need to
-      change the port on which the Chandler server's Tomcat connector
-      listens. Edit the Connector entry in
-      $CHANDLER_HOME/tomcat/conf/server.xml and change the port
-      attribute to specify a port that isn't in use (and that the
-      user running the Chandler server has the privilege to use):
+      change the port on which Tomcat's connector listens. Edit the
+      Connector entry in $COSMO_HOME/tomcat/conf/server.xml and change
+      the port attribute to specify a port that isn't in use (and that
+      the user running the Cosmo server has the privilege to use):
 
         <Connector port="8080" enableLookups="false"/>
+
+    * Issues are tracked at <http://bugzilla.osafoundation.org/>.
+
+    * Feel free to ask questions and report problems to
+      cosmo at osafoundation.org.



More information about the Commits mailing list