9:42 p.m.
Author: smumford
Date: 2012-10-11 22:42:20 -0400 (Thu, 11 Oct 2012)
New Revision: 8875
Added:
epp/docs/branches/5.2/Migration_Guide/en-US/chapter-6-Site_Publisher.xml
Log:
BZ#846281: Added content about installing SP upgrade binaries
Added: epp/docs/branches/5.2/Migration_Guide/en-US/chapter-6-Site_Publisher.xml
===================================================================
--- epp/docs/branches/5.2/Migration_Guide/en-US/chapter-6-Site_Publisher.xml
(rev 0)
+++ epp/docs/branches/5.2/Migration_Guide/en-US/chapter-6-Site_Publisher.xml 2012-10-12
02:42:20 UTC (rev 8875)
@@ -0,0 +1,78 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Migration_Guide.ent">
+%BOOK_ENTITIES;
+]>
+
+<chapter>
+ <title>Installing Site Publisher upgrade binaries</title>
+ <para>
+ During the migration from JBoss Enterprise Portal Platform Site Publisher 5.1.x
to Site Publisher 5.2.x the templates stored in the JCR database needs to be updated to
the new version.
+ </para>
+ <para>
+ An archive of upgrade binaries is available for download <ulink
type="http"
url="http://intranet.exoplatform.org/rest/jcr/repository/collaborati...
to facilitate this change. <remark>DOCS NOTE: Is this archive available on the CSP?
Or anywhere other than eXo's repo?</remark>
+ </para>
+ <procedure>
+ <title>Installing upgrade binaries</title>
+ <step>
+ <para>
+ Download the archive containing the upgrade binaries from the link
above.
+ </para>
+ </step>
+ <step>
+ <para>
+ Copy data from your old Portal installatin
(<filename>epp-sp-5.1.1</filename>, for example) to your new installation
<remark>DOCS NOTE: Is 'data' in this sentence referring to unique client
data (from the JCR database) or config data?</remark>
+ </para>
+ </step>
+ <step>
+ <para>
+ Extract the archive into
<filename><replaceable><JBOSS_HOME></replaceable>/server/default/lib</filename>
+ </para>
+ </step>
+ <step>
+ <para>
+ Start (or restart) your new installation.
+ </para>
+ </step>
+ </procedure>
+ <remark>DOCS NOTE: I assume the most recently updated zip file
(upgrade-plugins-2.3.6-CP01-SPUB-185.zip) makes the following workaround unnecessary,
however I'm including anyway, just in case.</remark>
+ <important>
+ <para>
+ There is a known issue with this upgrade method that returns incorrect paths
from Quick Search results. The results are returned with a
<emphasis>parameterizedviewer?</emphasis> URL, rather than a
<emphasis>detail?</emphasis> URL.
+ </para>
+ <para>
+ A workaround is included below.
+ </para>
+ </important>
+ <procedure>
+ <title>Workaround</title>
+ <step>
+ <para>
+ Log in as an administrator.
+ </para>
+ </step>
+ <step>
+ <para>
+ Open the Quick Search page in the
<emphasis>classic</emphasis> portal.
+ </para>
+ </step>
+ <step>
+ <para>
+ Edit the page as follows:
+ </para>
+ <substeps>
+ <step>
+ <para>
+ Edit the <guilabel>Search result</guilabel> portlet.
+ </para>
+ </step>
+ <step>
+ <para>
+ Update <guilabel>Base path</guilabel> to point to the
<emphasis>detail?</emphasis> page.
+ </para>
+ </step>
+ </substeps>
+ </step>
+ </procedure>
+
+</chapter>
\ No newline at end of file