|
|
1 |
|
|
|
2 |
|
|
|
3 |
1 Upgrade from 1.7.2 to 1.8.4 |
|
|
4 |
|
|
|
5 |
|
|
|
6 |
|
|
|
7 |
#toc("2" "" "") |
|
|
8 |
|
|
|
9 |
|
|
|
10 |
1.1 The xWiki Upgrade Process |
|
|
11 |
* Analyze documentation for new features and retrieve resources |
|
|
12 |
* Analyze and merge [xWiki Configuration>TheFridge.XWikiConfiguration] ~~xwiki.cfg~~ and [Hibernate Configuration>TheFridge.XWikiConfiguration] ~~hibernate.cfg.xml~~ |
|
|
13 |
* Analyze and merge [skin modification > XWiki.DefaultSkin] |
|
|
14 |
* Set the test environment up and upgrade application |
|
|
15 |
* Check [Database >TheFridge.DatabaseIssue] |
|
|
16 |
|
|
|
17 |
|
|
|
18 |
1.1 Upgrade Documentation and Resources |
|
|
19 |
* [Upgrading an XWikiInstallation>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HUpgradinganXWikiInstallation] |
|
|
20 |
* [Latest ReleaseNotes>http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/] or the [Archived Release Notes>http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/Archives/] |
|
|
21 |
* download the [ latest WAR distribution|http://www.xwiki.org/xwiki/bin/view/Main/Download] or previous versions can be found here [here|http://forge.objectweb.org/project/showfiles.php?group_id=170] |
|
|
22 |
|
|
|
23 |
|
|
|
24 |
|
|
|
25 |
1.1 Release Notes for XWiki Enterprise 1.8.4 |
|
|
26 |
|
|
|
27 |
The focus on 1.8 branch was on making the new rendering architecture and the new GWT based WYSIWYG able to fully replace the "old" rendering and TinyMCE based WYSIWYG. |
|
|
28 |
#warning("This version introduce conditional loading of JavaScript and StyleSheet in order for pages to load faster, sending to the browser only the files it needs to display the requested pages. This might break existing applications developed on top of XWiki that relied on such JavaScript and CSS files being present all the time. See [Applications migration section>#HApplicationsmigration] for more details") |
|
|
29 |
|
|
|
30 |
1.1 Changes since XWiki Enterprise 1.7 |
|
|
31 |
|
|
|
32 |
1.1.1 1. First usable versions of new Rendering and new WYSIWYG editor |
|
|
33 |
|
|
|
34 |
* Add ability to [configure XWiki to use the XWiki Syntax 2.0 as default when creating new pages>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Configuration#HConfiguringWikiSyntaxesanddefaultSyntax]. |
|
|
35 |
* First usable version of the new GWT WYSIWYG editor. |
|
|
36 |
* New [UserAvatar>http://extensions.xwiki.org/xwiki/bin/view/Extension/User+Avatar+Macro] macro for 2.0 syntax. |
|
|
37 |
* new [RSS>http://extensions.xwiki.org/xwiki/bin/view/Extension/RSS+Macro] macro for 2.0 syntax. |
|
|
38 |
* Added [wiki syntax for embedded documents>http://platform.xwiki.org/xwiki/bin/view/Main/XWikiSyntax#HEmbeddeddocuments28XWikisyntax20only29] |
|
|
39 |
* Syntax API to convert a document from one syntax to another + new converter from XWiki Syntax 1.0 to XWiki Syntax 2.0. #info("You can try it by changing the syntax identifier of a page.") |
|
|
40 |
|
|
|
41 |
1.1.1 2. Usability Improvements |
|
|
42 |
|
|
|
43 |
* *New Wiki Dashboard* on the home page: |
|
|
44 |
** Spaces: all the spaces within your wiki (technical spaces are hidden): |
|
|
45 |
*** Links to the list of pages within each spaces. |
|
|
46 |
*** Links to the administration of each space. |
|
|
47 |
*** Allows to create new spaces. |
|
|
48 |
** Tags: all the tags in the wiki under the form of a tag cloud. |
|
|
49 |
** Recent changes: all the recent modifications in the wiki, grouped by author and by date. |
|
|
50 |
* *New way of displaying tags*, with 2 new features: |
|
|
51 |
** Tag rename. |
|
|
52 |
** Tag delete. |
|
|
53 |
|
|
|
54 |
* *Improved information section in document footer*, including document children |
|
|
55 |
|
|
|
56 |
1.1.1 3. Performance Improvements |
|
|
57 |
|
|
|
58 |
* *Page loading time reduced by 30%*. Statistics on Sandbox.WebHome, ~~without client-side file caching~~ (most of the downloaded files are cached on the client after the first request):\\{table} |
|
|
59 |
- | XE 1.8M1 | XE 1.8M2 |
|
|
60 |
Requests number | 37 | 25 |
|
|
61 |
Total size | 332Ko | 200Ko |
|
|
62 |
Download @ T1 (seconds) | 9.16 | 6.06 |
|
|
63 |
{table} |
|
|
64 |
|
|
|
65 |
|
|
|
66 |
1.1.1 4. Office Importer |
|
|
67 |
|
|
|
68 |
* *[New Office Importer>http://extensions.xwiki.org/xwiki/bin/view/Extension/Office+Importer+Application]*: makes use of a running OpenOffice server to convert Office documents (MS Office or OO) into HTML before they are transformed into XWiki 2.0 syntax |
|
|
69 |
|
|
|
70 |
1.1.1 5. REST API |
|
|
71 |
|
|
|
72 |
* New *[REST API>http://platform.xwiki.org/xwiki/bin/view/Features/XWikiRESTfulAPI]*. Currently implemented: |
|
|
73 |
** Access to wikis, spaces and pages |
|
|
74 |
** Access to page history, translations and page children |
|
|
75 |
** Access to tags, comments, objects and classes in general |
|
|
76 |
** Access to attachments |
|
|
77 |
|
|
|
78 |
1.1.1 6. New Blog Application |
|
|
79 |
|
|
|
80 |
* *[New Blog application>http://extensions.xwiki.org/xwiki/bin/view/Extension/Blog+Application]* |
|
|
81 |
** Lightweight publishing workflow |
|
|
82 |
** Category and sub-category support |
|
|
83 |
** Ability to change published date |
|
|
84 |
** Panels to display blog categories and unpublished posts |
|
|
85 |
|
|
|
86 |
1.1.1 7. Others |
|
|
87 |
|
|
|
88 |
* Upgrade to Groovy 1.6 final. |
|
|
89 |
* + lots of other changes, see [Platform details>http://jira.xwiki.org/jira/secure/ReleaseNote.jspa?version=10696&styleName=Text&projectId=10010&Create=Create]. |
|
|
90 |
|
|
|
91 |
|
|
|
92 |
1.1 Common Migration notes |
|
|
93 |
|
|
|
94 |
* In order to benefit from improvements listed above, import the default wiki XAR |
|
|
95 |
* Add <tt>xwiki.store.migration=1</tt> so that XWiki will attempt to automatically migrate your current database to the new schema. |
|
|
96 |
|
|
|
97 |
1.1.1 Applications migration |
|
|
98 |
|
|
|
99 |
XE 1.8M2 has introduced [conditional loading of JavaScript and StyleSheet files>http://jira.xwiki.org/jira/browse/XWIKI-3177] in order for pages to load faster, sending to the browser only the files it needs to display the requested pages. This might break existing applications developed on top of XWiki that relied on such JavaScript and CSS files being present all the time. Concerned files and libraries are the following: |
|
|
100 |
* scriptaculous files |
|
|
101 |
* accordions files |
|
|
102 |
* chart wizard files |
|
|
103 |
* usersandgroups.js and usersandgroups.css |
|
|
104 |
* livetable.js and livetable.css |
|
|
105 |
* lightbox.js |
|
|
106 |
* tablefilterNsort.js and table.css |
|
|
107 |
* fullscreenEdit.js and fullscreenEdit.css |
|
|
108 |
|
|
|
109 |
Applications that relies on one or several of these libraries, need to explicitly make them request the desired files using the *Skin Extension plugin*. For example, if your application needs the live-table feature (the dynamic AJAX grid), add the following lines to the code page that requires it: |
|
|
110 |
|
|
|
111 |
{code} |
|
|
112 |
$xwiki.jsfx.use('js/xwiki/table/livetable.js') ## Inject livetable.js <script> tag in the header |
|
|
113 |
$xwiki.ssfx.use('js/xwiki/table/livetable.css') ## Inject livetable.css <link> tag in the header |
|
|
114 |
{code} |
|
|
115 |
|
|
|
116 |
|
|
|
117 |
All the changes in the [JIRA site>http://jira.xwiki.org/jira/secure/ReleaseNote.jspa?projectId=10010]: |
|
|
118 |
|
|
|
119 |
http://jira.xwiki.org/jira/secure/ReleaseNote.jspa?projectId=10010 |
|
|
120 |
|
|
|
121 |
1.1 Set the test environment up |
|
|
122 |
* retrieve latest virtual machine tar file from file server, |
|
|
123 |
* create new Virtual Machine to a virtualization host, |
|
|
124 |
* uncompress and import in the Datastore |
|
|
125 |
* [clone the VM|Apice.VMClone], |
|
|
126 |
* start the VM Virtual Machine |
|
|
127 |
* take snapshot |
|
|
128 |
* rotate /usr/local/tomcat/logs (7GB per year!!) |
|
|
129 |
* The APR based Apache Tomcat Native library for optimal performance i not found on the java.library.path: TO DO |
|
|
130 |
* update-upgrade linux OS distribution |
|
|
131 |
|
|
|
132 |
|
|
|
133 |
1.1 Skin analysis |
|
|
134 |
|
|
|
135 |
1. Many differences to previous skin (some file moved in templates directory) |
|
|
136 |
1. modified *register.vm*: __redirection to login__ |
|
|
137 |
1. Modified Skin (172 vs 184) |
|
|
138 |
11. __style.css *differ*__ |
|
|
139 |
11. footer.vm (Identical) |
|
|
140 |
11. view.vm (Identical) |
|
|
141 |
11. viewheader.vm (Identical) |
|
|
142 |
11. logo (Identical) |
|
|
143 |
11. __menuview.vm *differ*__ |
|
|
144 |
11. __space.vm (Identical) |
|
|
145 |
11. --contentview.vm (removed)-- |
|
|
146 |
11. --classes.css (removed)-- |
|
|
147 |
11. --javascript (removed)-- |
|
|
148 |
11. __stylesheets *differ*__ |
|
|
149 |
11. login.vm (Identical) |
|
|
150 |
|
|
|
151 |
1. removed other than albatross skin directory from webapps/skins |
|
|
152 |
1. modified classes section removed 132 migration (import wiki.css and xwikicss in Style section) |
|
|
153 |
1. modified javascript section removed in 122 migration (keep default) |
|
|
154 |
1. modified content view.vm section removed during 162 migration |
|
|
155 |
1. updated Menuview section with 172 changes |
|
|
156 |
1. updated Space section with 172 changes |
|
|
157 |
1. not updated Login section (Forgot Password section not included) |
|
|
158 |
|
|
|
159 |
|
|
|
160 |
|
|
|
161 |
|
|
|
162 |
1.1 Current test release |
|
|
163 |
|
|
|
164 |
To test the newly upgraded release (v1.8.4) go to |
|
|
165 |
* http://137.204.107.27/xwiki/bin/view/Main/ |
|
|
166 |
|
|
|
167 |
1.1 *Test LIST* |
|
|
168 |
1.1.1 Logged out |
|
|
169 |
1. check *Register* link |
|
|
170 |
1. http://apice.unibo.it/xwiki/bin/view/People/ |
|
|
171 |
11. compare style layout |
|
|
172 |
11. check People spaces |
|
|
173 |
|
|
|
174 |
1. Publications |
|
|
175 |
11. check http://apice.unibo.it/xwiki/bin/view/Publications/PapersPerYear |
|
|
176 |
11. check of http://apice.unibo.it/xwiki/bin/view/Publications/PapersPerStatus |
|
|
177 |
11. check http://apice.unibo.it/xwiki/bin/view/Publications/All |
|
|
178 |
11. check http://apice.unibo.it/xwiki/bin/view/Publications/Search |
|
|
179 |
|
|
|
180 |
1. Talks |
|
|
181 |
1*. All talks ordered by year or by category |
|
|
182 |
|
|
|
183 |
1. Courses |
|
|
184 |
1*. check All, CoursesPerYear |
|
|
185 |
|
|
|
186 |
1. Theses |
|
|
187 |
1*. check Available thesis, Ongoing thesis, Completed thesis, Tags, Theses by People |
|
|
188 |
1*. try modify status Theses/TheseName?editor=object |
|
|
189 |
|
|
|
190 |
1. Projects |
|
|
191 |
1*. check Show All, Search |
|
|
192 |
|
|
|
193 |
1.1.1 Logged in |
|
|
194 |
1. Test DSA Unibo Login |
|
|
195 |
1. Publications |
|
|
196 |
11. check http://apice.unibo.it/xwiki/bin/view/Publications/Insert |
|
|
197 |
11*. try Get BibTeX from data |
|
|
198 |
11*. try Get data from BibTeX |
|
|
199 |
|
|
|
200 |
1. Talks |
|
|
201 |
1*. edit inline form |
|
|
202 |
1*. insert Talk |
|
|
203 |
|
|
|
204 |
1. Courses |
|
|
205 |
1*. edit inline form |
|
|
206 |
|
|
|
207 |
1. Theses |
|
|
208 |
1*. check Available thesis, Ongoing thesis, Completed thesis, Tags, Theses by People |
|
|
209 |
1*. try modify status Theses/TheseName?editor=object |