rave-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ja...@apache.org
Subject svn commit: r1144668 - in /incubator/rave/site/trunk/content/rave/installing: ./ host-configuration.mdtext index.mdtext
Date Sat, 09 Jul 2011 13:11:07 GMT
Author: jasha
Date: Sat Jul  9 13:11:07 2011
New Revision: 1144668

URL: http://svn.apache.org/viewvc?rev=1144668&view=rev
Log:
RAVE-45 start of documentation for changing host/ip configuration (needs a place somewhere
in the navigation)

Added:
    incubator/rave/site/trunk/content/rave/installing/
    incubator/rave/site/trunk/content/rave/installing/host-configuration.mdtext
    incubator/rave/site/trunk/content/rave/installing/index.mdtext

Added: incubator/rave/site/trunk/content/rave/installing/host-configuration.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/installing/host-configuration.mdtext?rev=1144668&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/installing/host-configuration.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/installing/host-configuration.mdtext Sat Jul  9
13:11:07 2011
@@ -0,0 +1,50 @@
+Title:  Host configuration
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+The default configuration uses the following URL's:
+
+  * Portal: http://localhost:8080/portal
+  * OpenSocial engine gadgets rendering http://localhost:8080/gadgets
+
+## Override portal configuration
+First configure the portal to call a different URL for the OpenSocial engine:
+
+  * Make a copy of [portal.properties][1]
+  * Change the properties 'portal.opensocial\_engine.protocol', 'portal.opensocial\_engine.root'
and/or 'portal.opensocial\_engine.gadget\_path'
+  * Set a system property 'portal.override.properties' that points to the location of the
custom properties file. 
+    * File system: 'portal.override.properties=/new/location/of/myportal.properties'
+    * Classpath: 'portal.override.properties=classpath:myportal.properties'
+
+After a (re)start of Tomcat, the portal will now try to fetch gadget rendering data from
your configured location.
+
+## Override OpenSocial engine configuration
+The OpenSocial engine (Shindig) has several locations for the host, port and gadget context
path.
+
+  * Make a copy of [container.js][2] (check if this version is still valid for your release)
+  * Make a copy of [shindig.properties][3] (check if this version is still valid for your
release)
+  * Change the properties that point to localhost, port 8080 or http
+  * Change the reference in 'shindig.properties' to 'container.js': 'shindig.containers.default=/new/location/of/container.js'
+  * Set a system property 'shindig.override.properties' that points to the location of the
custom properties file. 
+    * File system: 'shindig.override.properties=/new/location/of/myshindig.properties'
+    * Classpath: 'shindig.override.properties=classpath:myshindig.properties'
+
+Note: if the OpenSocial engine still points to localhost, also set a system property 'shindig.host'
to change the host.
+
+[1]: http://svn.apache.org/repos/asf/incubator/rave/trunk/rave-portal/src/main/resources/portal.properties
+[2]: http://svn.apache.org/repos/asf/shindig/tags/shindig-project-3.0.0-beta2/config/container.js
+[3]: http://svn.apache.org/repos/asf/shindig/tags/shindig-project-3.0.0-beta2/java/common/conf/shindig.properties
\ No newline at end of file

Added: incubator/rave/site/trunk/content/rave/installing/index.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/installing/index.mdtext?rev=1144668&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/installing/index.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/installing/index.mdtext Sat Jul  9 13:11:07 2011
@@ -0,0 +1,64 @@
+Title:  Installing Rave
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+Releases of Apache Rave are available for [download][1]. 
+
+## Build a distribution package
+To build your own distribution with default settings follow these steps:
+
+Check out the source code
+
+    $ svn co https://svn.apache.org/repos/asf/incubator/rave/trunk rave
+
+Build your distribution package with
+
+    $ mvn -Pdist
+
+## Deploy the distribution
+In the directory rave-portal/target you can find the rave-<version>-bin.tar.gz and

+rave-<version>-bin.zip file that contains the full Apache Tomcat 6 installation. 
+The contents of these archives are identical. Unpack one of these archives on your server
+and go to the Tomcat directory in the console or command prompt.
+
+### Start Tomcat
+Unix
+
+    $ ./bin/startup.sh
+
+Windows
+
+    > bin\startup.bat
+
+## Visit the portal
+Open url [http://localhost:8080/portal][2] in a browser.
+
+### Stop Tomcat
+Unix
+
+    $ ./bin/shutdown.sh
+
+Windows
+
+    > bin\shutdown.bat
+
+For more Tomcat options, see the [Tomcat 6.0 documentation][3].
+
+ 
+[1]: ../downloads.html
+[2]: http://localhost:8080/portal
+[3]: http://tomcat.apache.org/tomcat-6.0-doc/index.html
\ No newline at end of file



Mime
View raw message