[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