Info | ||
---|---|---|
| ||
3.2 has been released! These notes are outdated, but remain here for future reference. |
This is our up-to-the-minute "punch list" of items to be resolved for the 3.2 release. We're currently aiming to release on May 8th.
Outstanding Issues
...
ISSUE-1: Ingest of demo:5,18,29,14 fail with non-fedora context
CAUSE: Hardcoded URLs that don't use local.fedora.server.
ACTION: Review all demo objects and use local.fedora.server where possible. As per the solution for issue-2, use local.fedora.server/fedora/ (contiguous, not split up) where appropriate.
WHO: Aaron
STATUS: Committed to trunk. This also had the consequence of removing entirely the need to convert demo objects (script has been removed and noted in docs as 3.1 and below only) before running tests with alternate ports, hostnames, and app server context.
...
? *ISSUE-2:* Smiley demo "list" dissemination doesn't work with non-fedora context Wiki Markup
*CAUSE:* The SDep, demo:CollectionImpl requires the "fedora" part of the path to be specified: <http:operation location="fedora/risearch\[...\]"> *.
ACTION:* Modify Fedora so that, when the service URL is constructed, if it is not an http\[s\] URL: 1) If it starts with /, assume [http
- (Required) Modify Fedora so that http[s]/local.fedora.server/fedora/ is interpreted at runtime (and translated when appropriate at export time) with protocol://host:port
...
- /context/ and all other occurances of http[s]://local.fedora.server/ are interpreted/translated as protocol://host:port/
- In content of WSDL and other "special" datastreams identified in DOTranslationUtility, when in the "migration" export context (in the same spirit as is done currently with local.fedora.server). This solution will be backward compatible.
- For E and R datastreams
- At runtime when reading the WSDL to decide which URL to send the dissemination request to. In this case, "splitting up" the URL in the WSDL should work, so doing the local.fedora.server[/fedora] substitution should happen after the operation URL is constructed from the two places in the WSDL. But it's not required for the translation at export (with "public" context) to do the replacement.
- (Required) Make sure all demo objects use this where appropriate (See ISSUE-1)
- (Required) Document this behavior where appropriate in the user docs. Note that it's not recommended to "split up" local.fedora.server/fedora/ in the WSDL because replacement won't be done on export (with "public" context) that case.
- (Optional) Create src/test-objects to make sure it works (with possible unit tests)
- (Optional) Find a way to avoid the hardcoding of "/fedora" in the stylesheet used by the smiley demos. Ideally, the correct URL for the images can be constructed without the stylesheet knowing where Fedora is mounted.
WHO: Aaron
STATUS: Code work is committed to trunk. Will probably not have time to address stylesheet, so image links in 'view' dissemination will be broken (
this is now documented as a known issue). But at least it no longer returns a 500 error. TODO: document in wiki.] is prefix.
*WHO:* Aaron
*STATUS:* ?
...
ISSUE-3: System tests don't pass with non-fedora context
CAUSE: Not fully determined, but ISSUE-1 above is one probable cause. At least ConfigA was failing for Eddie when he tried it. Eddie also saw strange references to 127.0.1.1, but grepping the code for this turned up no result. Also, Andrew noticed a failure with testBatchModify, which Kai has fixed, and Andrew has updated the documentation.
ACTION: Re-run tests, making sure to set the correct fedora.appServerContext in build.xml and webapp_name in env-server.sh beforehand.
WHO: Eddie
STATUS: For Kai and Andrew all test suites with different contexts are passing. Eddie ?
- (Aaron) I think the changes in FCREPO-487 may have fixed this. Also note that running system tests with alternate configs has changed slightly.
- If fedora app server context is non-default (i.e. not 'fedora'), need to set environment variable "WEBAPP_NAME" to the new context name in order for tests involving commandline utils to succeed. (Same technique enables the validator, rebuilder, etc to work without editing env-server.sh/.bat file).
- Conversion of demo objects or passing additional properties is not necessary any more. Just run ant juit -Dtest=[system test class A, B, Q], and it should work automatically.
- My tests are passing now (Eddie)
...
ISSUE-4: fedora-ingest-demos doesn't work with non-fedora context and usage message is incorrect.
CAUSE: Doesn't pass optional parameters, so the ctx param is never passed in.
ACTION: Fix usage message and allow it to take ctx
WHO: Kai
STATUS: ?
...
ISSUE-5: fedora-rebuild gives confusing error message with non-fedora context when WEBAPP_NAME is not changed in env-server.sh/bat
CAUSE: The fedora-rebuild script uses this info to determine what the classpath is, in order to run the right java ... command.
ACTION: Give better error message. (Also see DOC-1)
WHO: Kai
STATUS: (Aaron) env-server.bat has been modified as part of FCREPO-487 to use environment variable WEBAPP_NAME (if defined) to set alternate context. If WEBAPP_NAME is not set, it defaults to 'fedora'. If that is incorrect, then the error message is the same.. I didn't change any messages
(Kai) changed error message so that it is more meaningful in case the wrong context is set.
?
...
ISSUE-6: Some commandline scripts not covered by tests (Kai noticed)
ACTION: Identify which ones
WHO: Kai
STATUS: ? fedora-dsinfo (DatastreamConduit)
...
ISSUE-7: Ingest and add managed datastream not working with new admin ui.
CAUSE: Repeatable in Chris' environment when AuthN off for API-A and first attempt to POST to rest api is via one of these actions. This appeared to be happening because the popup window closes before the browser has a chance to prompt for credentials. So we were aiming for a solution that ensured credientials would be prompted for beforehand. However, it now appears to be happening regardless of the credentials... the data just doesn't make it into Fedora in some cases. Keeping the upload popup open after submit has been pressed (manually removing onSubmit="window.close()") seems to consistently allow this to succeed, regardless of credentials.
ACTION: ?? Keeping it open for only two seconds causes the upload to fail when sending in a large file, so it clearly needs to remain open while the upload is in progress.
ACTION:
- (Required) Wait until the response has been received after an upload request to close the upload dialog
- (Optional) Examine the response, provide appropriate feedback a) while the upload is in progress, b) if the upload fails, c) if the upload succeeds
WHO: Bill
STATUS: ? Chris tested with success in Windows w/Firefox, Ubuntu w/Firefox, and OSX with Firefox and Safari. When running remotely: had to disable the deny-apim-if-not-localhost.xml policy, as expected. When running in Safari, had to disable popup blocking, as expected.
...
ISSUE-8: Analyzer issues (harmless) issues warning when running with Derby embedded
CAUSE: Derby embedded requires the database to be shutdown through java code before the vm exits, or it issues a warning.
ACTION: Document that this is a harmless warning in the migration doc
WHO: Chris
STATUS: ?
...
ISSUE-9: Upgrade from 3.1 still needs to be tested.
ACTION: Normal install (point new fcfg to old db+data/ dir), then run RI rebuilder for Mulgara
WHO: Eddie
STATUS: ?
...
ISSUE-10: Journal RMI Reciever not distributed or acknowledged in docs or distributed
ACTION: Make a build.xml target for a self-contained jar distribution (with version=3.2) and note it's existence in journaling documentation.
WHO: Aaron
STATUS: build targets created. ant rmi-journal-receiver will build a zip file in dist containing the executable jar + a README. TODO:Documentation on Wiki
...
ISSUE-11: ConfigA test fails with alternate context
CAUSE: repeatable in Eddie's env (configA + postgres + Java6 + alternate context). Not repeating when using the default webapp context. Fails in TestManyDisseminations with
java.lang.RuntimeException: Error getting Fedora Client<br/> at fedora.test.api.TestManyDisseminations.<clinit>(TestManyDisseminations.java:63)<br/>Caused by: java.io.IOException: Request failed 500 Internal Server Error : http://localhost:8080/asdf/describe?xml=true
Stacktrace yields java.net.SocketException: Broken pipe that traces back to fedora.server.access.FedoraAccessServlet.getDissemination(FedoraAccessServlet.java:816).
ACTION: Verify behavior
WHO: Eddie
STATUS: I tried this same configuration and test in WinXP this afternoon, and Ubuntu tonight and the test passed. Anyone else? - Chris
...
Outstanding Documentation
...
DOC-1: Finish doc updates for webapp context configuration (with note that it's experimental)
- Update installer text to note "experimental"
- Write a new doc that gives:
a) General description (with note that it's experimental)
b) Instruction
...
re: WEBAPP_NAME
...
when running server scripts or system tests
c) Instruction re: extra args for client scripts
Link to this doc from install/config guide and commandline utils doc.
WHO: Andrew, with help from Kai
STATUS: Installer text updated. New doc started here
...
DOC-2: Update rebuilder documentation to note
- Review for accuracy
- Note that Java 1.6 is needed if running with MySQL
WHO: Chris
STATUS: Revamped rebuilder doc entirely; it was out of date and overly verbose.
...
DOC-3: New doc: "Configuring Lowlevel Storage" (covers Akubra), linked from install/config
WHO: Chris
STATUS: Started here
...
DOC-4: New doc: "Web-Based Admin UI"
WHO: Bill
STATUS: https://fedora-commons.org/confluence/display/FCR30/Fedora+Web+Administrator
...
DOC-5: Release Notes
- Take things in from JIRA
- Make 2.x support announcement with 3.2 release
WHO: Chris, Andrew
STATUS: Imported all issues from Jira, alpha order for now. still need descriptions
...
DOC-6: Review migration guide for accuracy with 3.2
WHO: Chris
STATUS: Updated 2.x migration guide to be version-neutral where possible, and using 3.2 in the examples. Also updated 3.x upgrade guide to be clear that the same steps can be followed whether going from 3.0 to 3.1, 3.0 to 3.2, or 3.1 to 3.2 (in each case, an RI rebuild is necessary).
...
DOC-7: SWORD-Fedora integration guide (FCREPO-404)
WHO: Eddie
STATUS: ?: Started at SWORD-Fedora 1.2
...
Remaining Release Steps as of 5/8:
--------
- kai - checkin usage
- chris - tag + release software
- chris - put static 3.1 docs on fedora-commons.org
- all - remove 3.1-specific stuff (remove 3.2 "tags")
- release notes by monday (andrew working on most of these, chris will to intro)
During
--------
- remove previous release notes
- title for fcr30 space: (change to fedora repository 3.2)
- notice: we're in transition, if you want the 3.1 docs go here
----
After:
- change global include:
remove "Current released version" header
- documentation for previous releases can be found here:
- for documentation on previous versions
...