Skip to content

Commit

Permalink
This commit was manufactured by cvs2svn to create tag
Browse files Browse the repository at this point in the history
'rel-2-4-4-RC1'.

git-svn-id: https://source.jasig.org/uPortal/tags/rel-2-4-4-RC1@10857 f5dbab47-78f9-eb45-b975-e544023573eb
  • Loading branch information
infrastructure@lists.ja-sig.org committed Dec 5, 2005
1 parent 880bb63 commit 475f471
Show file tree
Hide file tree
Showing 274 changed files with 8,539 additions and 5,485 deletions.
1 change: 1 addition & 0 deletions .cvsignore
Expand Up @@ -2,3 +2,4 @@ build
dist
.project
.classpath
.settings
30 changes: 30 additions & 0 deletions LICENSE.txt
@@ -0,0 +1,30 @@
Copyright 2000-2005 The JA-SIG Collaborative. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.

3. Redistributions of any form whatsoever must retain the following
acknowledgment:
"This product includes software developed by the JA-SIG Collaborative
(http://www.jasig.org/)."

THIS SOFTWARE IS PROVIDED BY THE JA-SIG COLLABORATIVE "AS IS" AND ANY
EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JA-SIG COLLABORATIVE OR
ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
111 changes: 111 additions & 0 deletions README.txt
@@ -0,0 +1,111 @@
$Id$

uPortal Distribution
--------------------------

Purpose
-------
This distribution is targeted towards
people who would like to install
uPortal in a development or production
environment. It contains uPortal source
code and properties files, but not a servlet
container, directory, or relational database,
which are required. Use of this distribution
requires knowledge of J2EE environments and the
Ant tool from the Apache Jakarta project.


Contents
--------
1) uPortal
2) uPortal dependencies (Xalan, Pluto, etc).
3) uPortal Architecture overview and JavaDoc API


System requirements
-------------------
JDK 1.4 or higher
JAVA_HOME environment variable must be set
Installation of Ant from Jakarta:
http://ant.apache.org/


Instructions
------------
Modify build.properties with local settings.

Use the following ant targets:

initportal - installs uPortal into a servlet container,
prepares a relational database with uPortal schema and data,
publishes channels and layout fragments,
deploys portlet applications
dist - creates JavaDoc, uPortal jar, and uPortal WAR files.

For descriptions of other Ant targets,
see docs/uPortal_tools_overview.txt.

Make sure the database and servlet container are running and
access uPortal with http://localhost:8080/uPortal/
Your URL may be different if you have configured a different port
and/or context name.

You can login to uPortal with the following user name/password
combinations:

demo, demo
student, student
faculty, faculty
staff, staff
developer, developer

Each user may have a slightly different layout.


Notes
-----
-Several properties files and one database table changed
since uPortal 2.3.x. If you are upgrading from this version,
you will need to see to it that your properties files and
database data are upgraded appropriately. The difficulty
of upgrading from 2.3.x to 2.4.x is expected to be much lower
than similar upgrades in past versions.

-uPortal does not strictly require the use of connection
pooling, but it is highly recommended for production
installations. If your servlet container does not provide
connection pooling, try something like Yet Another Poolman.
For information about Yet Another Poolman,
see http://yapoolman.sourceforge.net/.

-Bug fixes from 2.3.x releases have been implemented in 2.4.x
whenever they were appropriate

-If you experience XML/XSLT-related errors, there is a good
chance that your environment is not using the version of
Xalan/Xerces that comes with this release. If you are using
Tomcat, try copying the following files into Tomcat's
common/endorsed directory: xalan.jar, xercesImpl.jar, xml-apis.jar.
Alternatively, you can specify the use of these jar files
via a java parameter when starting your servlet container:
-Xbootclasspath/p:xalan.jar;xercesImpl.jar;xml-apis.jar
For more information, see Version section of
http://xml.apache.org/xalan-j/faq.html

-JSR 168 Portlets are supported in this version of uPortal.
For information on installing Portlets, see
http://www.uportal.org/implementors/portlets/workingWithPortlets.html.

-WSRP functionality was included in uPortal as early as uPortal 2.2.
However, beginning with uPortal 2.4, the WSRP consumer has been replaced with
one based on WSRP4J. The WSRP producer has been deprecated but may
be reintroduced in a future release.

Please report bugs and suggestions:

http://www.uportal.org/bugzilla/

uPortal website:

http://www.uportal.org
196 changes: 196 additions & 0 deletions RELEASE_NOTES.txt
@@ -0,0 +1,196 @@
$Id$

uPortal Release Notes
---------------------
Release Notes - uPortal - Version 2.4.4-RC1

** Bug
* [UP-812] - resource-ref not properly parsed in portlet Deployer
* [UP-924] - PersonDirNameFinder getName() may return null
* [UP-927] - PersonDirNameFinder not threadsafe
* [UP-1088] - PortletPreferencesStoreFactory double checked locking [2-4]
* [UP-1091] - UserLayoutStoreFactory double checked locking [2-4]
* [UP-1142] - deployPortletApp can't install correctly web.xml utf-8 encoding.
* [UP-1167] - GuestUserPreferencesManager loses non-Exception cause
* [UP-1227] - WebProxy does not close urlconnection inputstream
* [UP-1252] - Change processing order for uP_save
* [UP-1305] - LoginServlet doesn't cope with ISE from multiply invalidating session
* [UP-1309] - LogoutServlet doesn't cope with ISE on sesion.invalidate().

** New Feature
* [UP-1024] - add CAbstractXslt
* [UP-1246] - Dynamic channel titles

** Improvement
* [UP-1135] - JavaDoc UserInstance.systemCache
* [UP-1136] - JavaDoc UserInstance.systemCharacterCache
* [UP-1137] - eliminate use of concat operator in default persondirs query to support more dbs by default
* [UP-1168] - RemoteUserPersonManager support security chains in security.properties
* [UP-1195] - Make SoftHashMap inherently threadsafe
* [UP-1240] - upgrade to JAXP 1.3 XML APIs (for uPortal 2.4.x)
* [UP-1245] - SAX2FilterImpl provide protected Log instance
* [UP-1261] - Implement layout cachekey optimization to improve layout caching.
* [UP-1306] - Include URI of missing resource in XSLT missing resource exception message
* [UP-1308] - ChannelRuntimeProperties protected Log instance

Notes:

This is the first 2.4.x release to include support for being compiled or
running under JDK 1.4 or 1.5. For those not familiar, JDK 1.4 includes support
for JAXP 1.2 and JDK 1.5 supports JAXP 1.3. JAXP[1] is an API that allows an
application to process an XML document independent of the underlying XML
processing engine[2]. The support for DOM Level 3[3] was a main driver for
introducing the JAXP 1.3 release. Unfortunately, the JAXP 1.3 API is not
backwards compatible with JAXP 1.2[4].

This means that an application programmed to use the JAXP 1.3 API will compile/run
with no problems under JDK 1.5, but fails under an out-of-the-box JDK 1.4 install.
To remedy this problem (JAXP 1.3 with JDK 1.4), Sun makes available the JAXP 1.3
libraries, which must be referenced by the JDK 1.4 Java Compiler or Application
BEFORE the JAXP 1.2 libraries that ship with the JDK.

For compilation in uPortal, this is done by installing the JAXP 1.3 libraries
(/portal/lib/jaxp/*.jar) into the $JDK_HOME/jre/lib/endorsed directory. For
running Tomcat, this is done by copying these libraries into the
$TOMCAT_HOME/common/endorsed directory[5]. Both of these actions are performed
by the ant JAXP-Install target. Technically, the JAXP 1.3 JAR files are being added
to the Java bootclasspath, which tells Java to look in there for a class before
looking in the runtime JAR ($JAVA_HOME/jre/lib/rt.jar).

Note that all generated .class file compatibility is 1.4.

1. Compile under JDK 1.4:
- ant JAXP-Install
- ant initportal (or deploy)
2. Compile under JDK 1.5:
- ant initportal (or deploy)
3. Run under JDK 1.4/Tomcat 5.0.x:
- must do step 1
4. Run under JDK 1.5/Tomcat 5.0.x:
- must do step 2
- must remove $TOMCAT_HOME/common/endorsed/xercesImpl.jar
- must remove $TOMCAT_HOME/common/endorsed/xml-apis.jar
5. Run under JDK 1.5/Tomcat 5.5.x:
- must do step 2

[1] http://java.sun.com/webservices/jaxp/index.jsp
[2] http://java.sun.com/webservices/jaxp/reference/faqs/index.html
[3] http://www.w3.org/DOM/
[4] http://java.sun.com/j2se/1.5.0/docs/guide/xml/jaxp/JAXP-Compatibility_150.html
[5] http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html

[a] https://clearinghouse.ja-sig.org/wiki/display/UPC/XML+API+standardization
[b] https://clearinghouse.ja-sig.org/wiki/display/UPC/Compiling+under+JDK+1.5
[c] https://clearinghouse.ja-sig.org/wiki/display/UPC/Practical+uP25+XML+Changes

----------------------------------------------------------------
uPortal Release Notes
---------------------
Release Notes - uPortal - Version 2.4.3.1

**Bug

* [UP-1253] - CWebProxy security exploit: proxies file system content
* [UP-245] - CPD default="true" not functional

Notes:

1. CWebProxy and CGenericXSLT changed for this release to address
security vulnerabilities. These channels honor fewer
ChannelRuntimeParameters now. This will not affect most deployments.
A few deployments will need to re-examine CWebProxy and re-implement the
insecure features that were removed in more secure ways. CWebProxy
also changed to require that the xmlUri be an http:// or https:// URI.
You can make this rule more or less restrictive by publish-time
configuration of CWebProxy instances. [UP-1253]

2. This release and all prior uPortal releases do NOT support JAXP 1.3.
This means that it will not compile/run under JDK 1.5 OR JDK 1.4 with
JAXP 1.3 installed. It will compile/run under JDK 1.4. uPortal 2.4.4
is scheduled to include support for JAXP 1.3.

Support for JDK 1.5 or JDK 1.4 w/ JAXP 1.3 is provided in and after
the uPortal 2.5.0 release.


----------------------------------------------------------------
uPortal Release Notes
---------------------
Release Notes - uPortal - Version 2.4.3

**Bug

* [UP-694] - NPE persists after publishing fragment with no name and description
* [UP-735] - Content Subscriber exception when searching for "what's"
* [UP-754] - Problem on deleting non-empty tabs
* [UP-818] - HttpProxyServlet ignores query string
* [UP-823] - MInesweeper codebase web site moved.
* [UP-849] - RDBMPortletPreferencesStore doesn't support MS-SQL
* [UP-865] - simple layout manager won't start
* [UP-921] - very long time to connect: AggregatedUserLayoutStore SQL
* [UP-931] - ChannelRenderer finalizer is causing lots of loitered objects in memory causing a serious memory leak.
* [UP-1016] - BoundedThreadPool infinite loop or deadlock [2-4-patches]
* [UP-1102] - Restore safety to channel rendering
* [UP-1119] - memory leak happens under stress when CPortletAdapter portlets are asked to clean themselves up when the session ends.
* [UP-1123] - PortletStateManager.clearState(PortletWindow) implementation is buggy and can lead to ConcurrentModificationException under stress.
* [UP-1145] - access to SoftHashMap systemCache across threads is not synchronized

**Improvement

* [UP-734] - Make "Cannot start uPortal" message give HTTP 500 status code
* [UP-815] - ChannelFactory should log source exception on instantiation failure
* [UP-992] - MultipartDataSource.finalize( ) is not implemented properly.
* [UP-1079] - StaticInformationProvider.getPortletDefinition() should give helpful exception if portletGUID doesn't have a "."
* [UP-1146] - javadoc SoftHashMap to say it isn't synchronized
* [UP-1177] - org.jasig.portal.MultipartDataSource incorrectly implemented finalize ( ) method.
* [UP-1178] - HTMLdtd.fromChar(int) method creats un-necessary objects during the lookup.
* [UP-1179] - Debug statements in the codebase causes un-necessary creation of string objects.
* [UP-1180] - Reduce object creation in SubstitutionIntegerFilter.java
* [UP-1181] - Reduce number of MediaManager objects created
* [UP-1187] - Enhance ChannelRuntimeData by adding a new method that generates the functional-name-focusing URL for channels.

----------------------------------------------------------------
Release Notes - uPortal - Version 2.4.2

** Bug
* [UP-338] - RENDERING_DONE Event never sent
* [UP-476] - User's LDAP groups not loaded if username contains uppercase
* [UP-512] - User agent too long for db column
* [UP-685] - wrong fname in fragment produces exception with no useful error
message
* [UP-744] - PersonDirectory has a memory leak related to caching IPersons in
a WeakHashMap
* [UP-745] - ChannelManager has a memory leak, when it swaps out a channel
for the CError channel, the end session events never progagate
to the original channel
* [UP-746] - CSecureInfo has a memory leak, when ChannelManager swaps out a
channel for the CSecureInfo channel, the to end session events
never propagate to the original channel
* [UP-747] - Change to portlet parameter encoding breaks download worker URLs
* [UP-748] - Infinite recursion in RestrictedPerson
* [UP-749] - render parameter does not survive refresh
* [UP-753] - ChannelFactory should not expose internal map of static channels,
not create more than one instance of a multithreaded channel
* [UP-758] - CContentSubscriber prints exception to stdout instead of log
* [UP-759] - Xalan jar should be deployed to endorsed directory
* [UP-760] - Entity locks not expired correctly
* [UP-761] - A lock owner is limited to single READ lock on an entity
* [UP-772] - Classpath resources not being copied to build
* [UP-775] - Duplicate read locks for a single owner not permitted.
* [UP-776] - WebApplicationMarshaller.java turns resource-ref into
resource-env-ref
* [UP-778] - AggregatedLayoutManager.loadUserLayout() fails to log stack
trace for exception
* [UP-779] - ChannelRenderer declares constants that are already declared
in its base class
* [UP-780] - Eliminate "unknown additional descriptor warning" when using
ChainingSecurityContext
* [UP-796] - contains() doesn't always work for PAGS groups
* [UP-798] - GroupService.isComposite always returns null
* [UP-811] - NPE when Data tag not present in DatabaseTagHandler

** Improvement
* [UP-770] - Document hsqldb version included with uPortal
* [UP-800] - Add comment to clarify usage of Logger.properties
* [UP-809] - Move portlet request attribute configuration to helper method
* [UP-810] - Log logging implementation
11 changes: 6 additions & 5 deletions build.properties
Expand Up @@ -15,10 +15,10 @@
#==================== File and Directory Names ========================

app.name=uPortal
app.version=2.4
app.version=2.4.4-RC1

lib.path=lib
server.home=/JavaClasses/jakarta-tomcat-5.0.25
server.home=/JavaClasses/jakarta-tomcat-5.0.28

deploy.home=${server.home}/webapps/uPortal

Expand All @@ -32,7 +32,7 @@ compile.optimize=true

#==================== External Dependencies ===========================

xalan.jar=${lib.path}/xalan.jar
xalan.jar=${lib.path}/xalan-2-6-0.jar
xercesImpl.jar=${lib.path}/xercesImpl.jar
xml-apis.jar=${lib.path}/xml-apis.jar
tidy.jar=${lib.path}/tidy.jar
Expand All @@ -49,12 +49,13 @@ wsdl4j.jar=${lib.path}/wsdl4j.jar
commons-discovery.jar=${lib.path}/commons-discovery.jar
commons-logging.jar=${lib.path}/commons-logging.jar
portlet-api.jar=${lib.path}/portlet-api-1.0.jar
pluto.jar=${lib.path}/pluto-1.0.1.jar
pluto.jar=${lib.path}/pluto-1.0.1-rc1.jar
wsrp4j-shared.jar=${lib.path}/wsrp4j-shared-0.3.jar
wsrp4j-consumer.jar=${lib.path}/wsrp4j-consumer-0.3.jar
proxyportlet.jar=${lib.path}/proxyportlet.jar
jdbc2_0-stdext.jar=${lib.path}/jdbc2_0-stdext.jar
jdbcDriver.jar=${lib.path}/hsqldb.jar
junit.jar=${lib.path}/junit.jar
servlet.jar=${lib.path}/servlet.jar

backport.jar=${lib.path}/backport-util-concurrent.jar
jaxp.lib=${lib.path}/jaxp

0 comments on commit 475f471

Please sign in to comment.