You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by ta...@apache.org on 2004/05/05 23:11:53 UTC
cvs commit: jakarta-jetspeed-2/site/xdocs/stylesheets project.xml
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