portals-jetspeed-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From tay...@apache.org
Subject cvs commit: jakarta-jetspeed-2/site/xdocs/stylesheets project.xml
Date Wed, 05 May 2004 21:11:53 GMT
taylor      2004/05/05 14:11:53

  Added:       site/xdocs database.xml index.xml
               site/xdocs/stylesheets project.xml
  Log:
  database configuration documentation
  
  PR:
  Obtained from:
  Submitted by:	
  Reviewed by:	
  CVS: ----------------------------------------------------------------------
  CVS: PR:
  CVS:   If this change addresses a PR in the problem report tracking
  CVS:   database, then enter the PR number(s) here.
  CVS: Obtained from:
  CVS:   If this change has been taken from another system, such as NCSA,
  CVS:   then name the system in this line, otherwise delete it.
  CVS: Submitted by:
  CVS:   If this code has been contributed to Apache by someone else; i.e.,
  CVS:   they sent us a patch or a new module, then include their name/email
  CVS:   address here. If this is your work then delete this line.
  CVS: Reviewed by:
  CVS:   If we are doing pre-commit code reviews and someone else has
  CVS:   reviewed your changes, include their name(s) here.
  CVS:   If you have not had it reviewed then delete this line.
  
  Revision  Changes    Path
  1.1                  jakarta-jetspeed-2/site/xdocs/database.xml
  
  Index: database.xml
  ===================================================================
  <?xml version="1.0"?>
  <!--
  Copyright 2004 The Apache Software Foundation
  
  Licensed 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.
  -->
  <document>
    <properties>
      <title>Jetspeed 2 Home Page</title>
      <subtitle>Welcome to Jetspeed 2</subtitle>
      <authors>
        <person name="David Sean Taylor" email="taylor@apache.org"/>
      </authors>
    </properties>
    <body>
  <section name="Default Database">
  <p>
  The default database distributed with Jetspeed-2 is the Hypersonic SQL Java Database (HSQL).
  HSQL runs in process with Jetspeed-2. It is not a production-ready database, however it
allows you 
  to get up and running quickly. To move on to a more robust database, follow the instructions
in the
  next section.
  </p>
  </section>
  <section name="MySQL">
  <p>
  To run with My SQL, add the following properties to your $HOME/build.properties:
  </p>
  <source test=""><![CDATA[
  
  # -------------------------------------------------------------------------
  # configure MySQL Test DB
  # -------------------------------------------------------------------------
  org.apache.jetspeed.test.database.default.name=mysql
  org.apache.jetspeed.test.database.url = jdbc:mysql://j2-server/j2test
  org.apache.jetspeed.test.database.driver = com.mysql.jdbc.Driver
  org.apache.jetspeed.test.database.user = jetspeed2
  org.apache.jetspeed.test.database.password = whatever
  # -------------------------------------------------------------------------
  # configure MySQL Production DB
  # -------------------------------------------------------------------------
  org.apache.jetspeed.production.database.default.name=mysql
  org.apache.jetspeed.production.database.url = jdbc:mysql://j2-server/j2
  org.apache.jetspeed.production.database.driver = com.mysql.jdbc.Driver
  org.apache.jetspeed.production.database.user = jetspeed2
  org.apache.jetspeed.production.database.password = whatever
  # -------------------------------------------------------------------------
  
  ]]></source>
  <p>
  In the example above, you will need to have a MySQL server running on a host named 'j2-server'.
  Also, you will need 2 databases, one called 'j2test' for running the unit tests,
  and a second called 'j2' for the production database.
  A user named 'jetspeed2' should be granted access to both the 'j2' and 'j2test' databases.
  </p>
  
  <subsection name ='Known Issues'>
  <p>
  The script 'populate-entities-for-default-psml.sql', fails to execute.
  It will fail out, since My SQL doesn't support the SQL syntax in the statements there.
  Until we get a solution for this, try running the populate-entities-for-default-psml-mysql.sql
from My SQL directly.
  <b>NOTE:</b> this script may fail, check your foreign keys values referencing
the portlet definition table.
  I hope to get this resolved soon.
  </p>
  </subsection>
  
  </section>
  
  <section name="Oracle">
  <p>
  To run with Oracle, add the following properties to your $HOME/build.properties:
  </p>
  
  <source test=""><![CDATA[
  
  # -------------------------------------------------------------------------
  # configure Oracle Test DB
  # -------------------------------------------------------------------------
  # org.apache.jetspeed.test.database.default.name=oracle
  # org.apache.jetspeed.test.database.ojb.platform=oracle9i
  # org.apache.jetspeed.test.database.url = jdbc:oracle:thin:@j2-sever:1521:j2db
  # org.apache.jetspeed.test.database.driver = oracle.jdbc.driver.OracleDriver
  # org.apache.jetspeed.test.database.user = j2test
  # org.apache.jetspeed.test.database.password = whatever
  # -------------------------------------------------------------------------
  # configure Oracle Production DB
  # -------------------------------------------------------------------------
  # org.apache.jetspeed.production.database.default.name=oracle
  # org.apache.jetspeed.production.database.ojb.platform=oracle9i
  # org.apache.jetspeed.production.database.url = jdbc:oracle:thin:@j2-server:1521:j2db
  # org.apache.jetspeed.production.database.driver = oracle.jdbc.driver.OracleDriver
  # org.apache.jetspeed.production.database.user = j2
  # org.apache.jetspeed.production.database.password = whatever
  # -------------------------------------------------------------------------
  
  ]]></source>
  <p>
  In the example above, you will need to have a Oracle server running on a host named 'j2-server'
  and have an Oracle database SID named 'j2db' installed on that server.
  Also, you will need 2 database users (schemas), one called 'j2test' for running the unit
tests,
  and a second called 'j2' for the production database.
  </p>
  
  <subsection name ='Known Issues'>
  <p>
  Only for the first time you create the database for Oracle, there is an issue with the drop
statements.
  To get around this problem, set your properties as above in your $HOME/build.properties,
and then 
  run these commands:
  </p>
  <source test=""><![CDATA[
  
  maven db.scripts.gen
  maven dropdrops
  
  ]]></source>
  </subsection>
  
  </section>
    </body>
  </document>
  
  
  
  1.1                  jakarta-jetspeed-2/site/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  <?xml version="1.0"?>
  <!--
  Copyright 2004 The Apache Software Foundation
  
  Licensed 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.
  -->
  <document>
    <properties>
      <title>Jetspeed 2 Home Page</title>
      <subtitle>Welcome to Jetspeed 2</subtitle>
      <authors>
        <person name="David Sean Taylor" email="taylor@apache.org"/>
      </authors>
    </properties>
    <body>
  <section name="Overview">
        <p>
      Jetspeed-2 is the next-generation enterprise portal at Apache.
      Jetspeed-2 offers several architectural enhancements and improvements over Jetspeed
1.0. 
      First, Jetspeed-2 is conformant to the <a href="http://www.jcp.org/en/jsr/detail?id=168">Java
Portlet Standard</a> and will provide a standard mechanism for the deployment of portlets.
 
      Second, Jetspeed-2 has matured to a more scalable architecture featuring multi-threaded
functionality.  
      Third, Jetspeed-2 is decoupled from several legacy open source projects.  
      Fourth, Jetspeed-2 is based on a component architecture.      
        </p>
  </section>
  <section name="What is Jetspeed?">
        <p>        
  Jetspeed is an Open Source implementation of an Enterprise Information Portal, using Java
and XML.
  A portal makes network resources (applications, databases and so forth) available to end-users.
The 
  user can access the portal via a web browser, WAP-phone, pager or any other device. Jetspeed
acts 
  as the central hub where information from multiple sources are made available in an easy
to use manner. 
  </p>
        <p>
  
  The data presented via Jetspeed is independent of content type, This means that content
from for example
  XML,RSS or SMTP can be integrated with Jetspeed. The actual presentation of the data is

  handled via ates XSL and delivered to the user for example via the combination of Java Server
Pages (JSPs) 
  and HTML. Jetspeed provides support for templating and content publication frameworks such
as 
  <a href="http://xml.apache.org/cocoon/">Cocoon</a>, <a href="http://www.webmacro.org/">WebMacro</a>
and 
  <a href="http://jakarta.apache.org/velocity/">Velocity</a>. Note that outside
of regualar browser Jetspeed also supports WAP devices.
  </p>
        <p>
  Jetspeed helps you build portal applications quickly. The goal is to make Jetspeed a tool
for both portal developers as well 
  as user interface designers. Currently the focus is on providing developers with a set of
tools that facilitates building
  the base for the portal. With Jetspeed you can quickly build an XML
  portal and also syndicate your own content.
  
  </p>
        
  </section>
    </body>
  </document>
  
  
  1.1                  jakarta-jetspeed-2/site/xdocs/stylesheets/project.xml
  
  Index: project.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <!--
  Copyright 2004 The Apache Software Foundation
  
  Licensed 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.
  -->
  <project name="Jetspeed" href="http://portals.apache.org/jetspeed-2">
  	<title>Jetspeed 2</title>
  	<logo href="images/logo.gif">Jetspeed 2</logo>
  	<body>
  		<menu name="Essentials">
  			<item name="Overview" href="/index.html"/>
  			<item name="Database" href="/database.html"/>
  		</menu>
  	</body>
  </project>
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: jetspeed-dev-help@jakarta.apache.org


Mime
View raw message