On 30 Aug 2015 at 15:15:45, vincent(a)massol.net
(vincent@massol.net(mailto:vincent@massol.net)) wrote:
Hi Johan,
On 30 Aug 2015 at 14:40:38, Johan Eriksson
(johan@moulinsart.org(mailto:johan@moulinsart.org)) wrote:
Hi!
I performed my first install ever of xwiki today using the latest
stable. Running with mysql (on separate hosts) as database. I've
installed my servlet container on Centos 7, with java and tomcat
versions as below:
What version of XWiki did you install? 7.1.2?
[root@tomcat-01]# java -version
java version "1.7.0_85"
OpenJDK Runtime Environment (rhel-2.6.1.2.el7_1-x86_64 u85-b01)
OpenJDK 64-Bit Server VM (build 24.85-b03, mixed mode)
Installed Packages
Name : tomcat
Arch : noarch
Version : 7.0.54
Release : 2.el7_1
Since this is my first xwiki installation ever, I would like to share my
experience, problems I faced and unanswered questions below.
That’s great that you are doing so; this helps us improve XWiki and the documentation.
From
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationTomcat
I thought that as per example, java settings:
JAVA_OPTS="-Xmx800m -XX:MaxPermSize=192m"
would allow me to install and play around with the application, since
that recommendation is higher than the "small installation" (512M)
reference found here
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Performances#HMemory
* My first problem appeared when I right after successful installation,
in the sandbox, created an empty testpage with one attachment of 3M in
size. I got an OutOfMemory exception when deleting that attachment.
- Are the documented java memory recommendations still applicable or
should they be considered as outdated for latest stable?
so I updated the java settings to solve the problem:
JAVA_OPTS="-Xmx1400m -XX:MaxPermSize=192m”
So the memory requirements is indicated on
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HPrerequis…
As you can see there, for medium installs we recommend -Xmx1024m -XX:MaxPermSize=196m
(and -Xmx512m -XX:MaxPermSize=196m for small).
Indeed in your case you should use the small install recommendation since at this stage
it’s only to play with XWiki.
Now your problem is with attachments. If you check
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Performances#HMemory you’ll see a
warning box with explanations about the memory requirements and a link that leads you
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Attachments
I’ve also checked
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/InstallationTomcat
and it does point to the same memory doc as I referenced above, so normally you should
have seen the issue with the memory required for large attachments.
What we need to do in the future is enable the filesystem store by default but we
currently have a limitation with it (as indicated on that page): "restoring
attachments from the recycle bin via UI”. This is why we haven’t made it the default just
yet.
* My second problem appeared when I created my
first page. The intention
was to create a page with a bunch of image attachments, using an
extension for displaying these images as an image gallery. When
uploading 116 images of individual size ~ 3M, a total size of 374M.
Uploading of files failed after 80 something files had been uploaded to
the page. The disk space on the servlet container server host was full.
In
/var/cache/tomcat/work/Catalina/localhost/xwiki/xwiki-temp/attachment-cache
a total of 6.3G of data had been stored.
- Looking at the checksum of the 2000 something files stored in this
directory there are 86 unique files some of which stored in 29 copies
during the upload process. Is this a desired behavior of the attachment
cache, or is this a bug?
We have performance problems when uploading attachments in the DB (it’s very
memory-hungry) but I didn’t know that the temporary directory was used that much. This
looks like a bug. It would be great if you could open a jira issue at
http://jira.xwiki.org with your details so that we could look at this into more details.
Now since you seem to be wanting to have a lot of attachments and possibly or large size,
I’d highly recommend you turn on filesystem storage for attachments.
* My third problem was when trying to install an
extension. I was really
curious about, and wanted to test, the social login application, that
even is referred to from the administration guide
http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Authentication#HSocialL….
This extension does not install at all on the latest stable. My java
knowledge is limited, but, I interpret the error message as failure to
satisfy requirement of servlet api version 2.5 (maybe since latest
stable xwiki has servlet version prereq of 3.0+).
Unfortunately it seems you were not lucky and you picked one extension for which its
author and the community have not updated to work on the latest version of XWiki :(
As you can see on
http://extensions.xwiki.org/xwiki/bin/view/Extension/Social+Login+Applicati… this
extension has been contributed by Jerome Velocity but this person is not active anymore on
it AFAIK and I don’t know anyone else who’s active on it at the moment (although Thomas
Mortagne seems to have fixed some issues and released the last version - see
http://jira.xwiki.org/browse/AUTHSL).
I’d suggest 2 things:
1) you rate it quite poorly at
http://extensions.xwiki.org/xwiki/bin/view/Extension/Social+Login+Applicati… so that
others know what to expect. You can also help future users by commenting on
http://extensions.xwiki.org/xwiki/bin/view/Extension/Social+Login+Applicati… (or even
editing the page if you’re logged in) to add the information about the fact that it
doesn’t work with XWiki 7.x. EDIT: I’ve just added that information on the page (haven’t
tested myself, I’ve based my edit on your feedback).
The truth is that we’re doing a bad job of separating high-quality extensions that have
been tested to work fine with latest versions with oldish extensions either not working
well or not of good quality. We’re relying on the community to provide that information
but it’s not working well so far. We need something better. If you have some ideas, please
let me know!
Thanks
-Vincent
2) you create a jira issue at
http://jira.xwiki.org/browse/AUTHSL and maybe someone will pick it up and fix it.
- Since the documentation only exist in one
latest version, should I as
user assume that the documentation is applicable for latest
development-, stable- or long term release?
All documentation on xwiki.org(http://xwiki.org) is always for the latest version unless
mentioned explicitly.
Now, it might be bad luck, or my failure to
understand the xwiki release
process, that my first three tests of the software failed with problems.
Yes I believe you were not lucky and I’m really sorry that XWiki didn’t make a good first
impression as a result. Try to persevere a bit more and I’m sure it’ll go uphill from now
on :)
I will now try the long term support release
hoping that I successfully
can add attachments and install extensions according to my requirements.
Most extensions should work fine with 7.1.2. You can also verify this by using extensions
that have had recent versions released.
Thanks a lot for your feedback! If you have more ideas on things we could/should do to
improve the user experience, please share them here. You’ve already helped a lot with this
report.
Thanks
-Vincent
> Best regards
> Johan Eriksson