Wiki source code of Installing XWiki Watch 1.0

Last modified by Thomas Mortagne on 2023/10/10 14:36

Show last authors
1 {{toc/}}
2
3 = Installing =
4
5 == XWiki Watch over an existing wiki (installing the .xar) ==
6
7 * You need to have XWiki 1.4.1 (or one of the 1.5 releases) installed (you can download it from the [[download page>>xwiki:Main.Download]]).
8 * Download the [[XWiki Watch XAR file>>XWiki Watch||anchor="HDownloads"]].
9 * Start the wiki and [[import>>xwiki:Documentation.AdminGuide.ImportExport]] the downloaded XAR in the wiki.
10 * In "Administration > Preferences > Advanced", add ##WatchCode.Translations## as an Internationalization Document Bundle.
11
12 Your XWiki Watch installation is now ready, just access the Watch space and enjoy the collaborative experience!
13
14 {{info}}
15 If you do not have XWiki 1.4.1 nor can/wish to install it but still want to enjoy XWiki Watch 1.0, check out [[Installing XWiki Watch 1.0 on XE 1.4>>||anchor="HInstallingXWikiWatch10onXWikiEnterprise14"]] or [[Installing XWiki Watch 1.0 on XE 1.3>>||anchor="HInstallingXWikiWatch10onXWikiEnterprise13"]] for details on how you can do that.
16 {{/info}}
17
18 == Using the standalone package ==
19
20 * Download the [[XWiki Watch ZIP file>>XWiki Watch||anchor="HDownloads"]].
21 * Unzip it and start the wiki (using ##start_xwiki.bat## on windows systems and ##start_xwiki.sh## on unix systems).
22
23 Your XWiki Watch installation is now ready, just access the Watch space and enjoy the collaborative experience!
24
25 {{info}}
26 You can log in using the default Admin user (first letter is capitalized). The default password is 'admin' (lowercase).
27 {{/info}}
28
29 == Using the Windows installer for standalone package ==
30
31 * Download the [[XWiki Watch .exe file>>XWiki Watch||anchor="HDownloads"]].
32 * Execute it and follow the instructions.
33
34 Your XWiki Watch installation is now ready, just access the Watch space and enjoy the collaborative experience!
35
36 {{info}}
37 You can log in using the default Admin user (first letter is capitalized). The default password is 'admin' (lowercase).
38 {{/info}}
39
40 == Using the platform independent installer (the .jar installer) for standalone package ==
41
42 * Download the [[XWiki Watch .jar file>>XWiki Watch||anchor="HDownloads"]].
43 * Run the .jar file (You need to have Java to be able to run the installer) and follow the instructions: depending on your system settings you can do this either by double-clicking it or by explicitly invoking ##java -jar xwiki-watch-installer-generic-1.0.jar## in a command line.
44
45 Your XWiki Watch installation is now ready, just access the Watch space and enjoy the collaborative experience!
46
47 {{info}}
48 You can log in using the default Admin user (first letter is capitalized). The default password is 'admin' (lowercase).
49 {{/info}}
50
51 == Installing XWiki Watch 1.0 on XWiki 1.4 ==
52
53 If you are using a lower version of XWiki (1.4 final or a 1.4 rc or one of the 1.4 milestones) but still want to run XWiki Watch 1.0, you need to replace a couple of libraries in the XWiki you are running. To enjoy the experience of XWiki Watch 1.0 in XWiki 1.4, follow the next steps:
54
55 * get ##xwiki-web-gwt-1.4.1.jar## from [[our maven repository>>http://maven.xwiki.org/releases/com/xpn/xwiki/platform/xwiki-web-gwt/1.4.1/xwiki-web-gwt-1.4.1.jar]]
56 * go to ##webapps/xwiki/WEB-INF/lib## folder in your XWiki installation
57 * replace the ##xwiki-web-gwt-1.4-*.jar## library (1.4-* corresponding to the version of XWiki you are running) with the jar you just downloaded
58 * restart your wiki
59 * install the ##xwiki-watch-1.0.xar## into your wiki following the [[instructions above>>||anchor="HXWikiWatchoveranexistingwiki28installingthexar29"]], if you haven't already. {{warning}}If you are upgrading from an older version of XWiki Watch and you are using an XWiki version lower than XWiki 1.4 milestone 2, because of [[this attachment import bug>>https://jira.xwiki.org/browse/XWIKI-1937]] you will get an error while importing the XWiki Watch .xar. Delete the document Watch.GWT before importing the XWatch .xar. Don't forget to refresh the RSS Reader page after the import.{{/warning}}
60
61 Your XWiki Watch installation is now ready, just access the Watch space and enjoy the collaborative experience!
62
63 == Installing XWiki Watch 1.0 on XWiki 1.3 ==
64
65 If you have a lower version of XWiki but still want to run XWiki Watch 1.0, you need to replace a couple of libraries in the XWiki you are running. **Note that** this will upgrade the XWiki GWT API in your installation to the 1.4.1 version, which uses GWT-1.4.61 instead of 1.3.3. If you have developed your own applications on top of XWiki that use GWT and / or the XWiki GWT API and they are not compatible with GWT 1.4.61, you should not do this.
66
67 To enjoy the experience of XWiki Watch 1.0 in XWiki 1.3, follow the next steps:
68
69 * get ##xwiki-web-gwt-1.4.1.jar## from [[our maven repository>>http://maven.xwiki.org/releases/com/xpn/xwiki/platform/xwiki-web-gwt/1.4.1/xwiki-web-gwt-1.4.1.jar]]
70 * get ##gwt-servlet-1.4.61.jar## from [[gwt maven repository>>http://gwt-maven.googlecode.com/svn/trunk/mavenrepo/com/google/gwt/gwt-servlet/1.4.61/gwt-servlet-1.4.61.jar]]
71 * go to ##webapps/xwiki/WEB-INF/lib## folder in your XWiki installation
72 * remove the ##gwt-servlet-1.3.3.jar## and ##xwiki-web-gwt-1.3.x.jar## libraries (1.3.x corresponding to the version of XWiki you are running).
73 * copy the two jars you just downloaded to this folder
74 * restart your wiki
75 * install the ##xwiki-watch-1.0.xa##r into your wiki following the [[instructions above>>||anchor="HXWikiWatchoveranexistingwiki28installingthexar29"]], if you haven't already. {{warning}}If you are upgrading from an older version of XWiki Watch, because of [[this attachment import bug>>https://jira.xwiki.org/browse/XWIKI-1937]] you will get an error while importing the XWiki Watch .xar. Delete the document Watch.GWT before importing the XWatch .xar. Don't forget to refresh the RSS Reader page after the import.{{/warning}}
76
77 Your XWiki Watch installation is now ready, just access the Watch space and enjoy the collaborative experience!
78
79 = Setting up =
80
81 * For Press Review email feature, set the SMTP server and admin email preferences in "Administration > Preferences > Registration".

Get Connected