[{ALLOW view All}]
[{ALLOW edit Authenticated}]

[{TableOfContents }]


!Upgrade OpenCms from 9.0.0 to 9.0.1

# Download [opencms-upgrade-to-9.0.1.zip|http://www.opencms.org/downloads/opencms/opencms-upgrade-to-9.0.1.zip] at [Distribution Version|http://www.opencms.org/de/download/opencms.html]
# Unzip opencms-upgrade-to-9.0.1.zip
# Read file "readme.txt"

! Comments and my own instructions
1. Create backup (!)

2. There is a bug in version 15 of the guava.jar that comes with the upgrade bundle:
{{{
Feb 24, 2014 7:39:40 AM org.apache.openejb.cdi.OpenEJBLifecycle startApplication
Schwerwiegend: CDI Beans module deployment failed
org.apache.webbeans.exception.inject.DeploymentException: javax.enterprise.inject.UnsatisfiedResolutionException: Api type [java.util.Set] is not found with the qualifiers 
Qualifiers: [@javax.enterprise.inject.Default()]
for injection into Constructor Injection Point, constructor name :  com.google.common.util.concurrent.ServiceManager, Bean Owner : [ServiceManager, Name:null, WebBeans Type:MANAGED, API Types:[java.lang.Object,com.google.common.util.concurrent.ServiceManager], Qualifiers:[javax.enterprise.inject.Any,javax.enterprise.inject.Default]]
	at org.apache.webbeans.config.BeansDeployer.deploy(BeansDeployer.java:213)
	at org.apache.openejb.cdi.OpenEJBLifecycle.startApplication(OpenEJBLifecycle.java:183)
...	
}}}
__Solution:__ Change in <opencms>\WEB-INF\lib\:
* delete guava-14.0.1.jar
* delete guava-15.0.jar
* delete guava-gwt-14.0.1.jar
* delete guava-gwt-15.0.jar
* add [guava-16.0.1.jar|http://code.google.com/p/guava-libraries/]
* add [guava-gwt-16.0.1.jar |http://code.google.com/p/guava-libraries/]

3. Copy "update" and "WEB-INF" (merge+overwrite) into existing <opencms> webapp folder\\
4. Delete in <opencms>/WEB_INF/lib/ again:
{{{
rm commons-logging-1.0.4.jar
rm commons-logging-1.1.1.jar
rm commons-logging-1.1.jar
}}}
5. Edit <opencms>\WEB-INF\config\opencms.properties => wizard.enabled=true\\
6. Open http://localhost:8080/opencms/update/ and follow instructions\\
7. Shutdown servlet container\\
8. Update solr (note: otherwise the image gallery won't work anymore!)\\
* Navigate to <opencms>\WEB-INF\solr-update\
* Pick up schema.xml + solrconfig.xml 
* Navigate to <opencm<>\WEB-INF\solr\conf\ 
* Overwrite existing files with these two here
* Edit <opencms>\WEB-INF\config\opencms-search.xml => <solr enabled="true">
9. Restart servlet container\\

! Error "Deserialization of core data failed"

Follow this [solution|http://comments.gmane.org/gmane.comp.cms.opencms.devel/38580],
which is
* reimport all modules org.opencms.ade.* (from ..\opencms-upgrade-to-9.0.1\update\modules\)
* clear your browser cache 
* try again

! Error "org.opencms.file.CmsVfsResourceNotFoundException"
{{{
Fehler beim Lesen der Ressource aus dem Pfad "/opencmsPlay/system/workplace/views/explorer/explorer_fs.jsp"
}}}

URL should be /opencmsPlay/opencms/system/workplace/views/explorer/explorer_fs.jsp.\\
It is a rewrite problem ...