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#HPrerequisi... 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#HSocialLo.... 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+Applicatio... 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+Applicatio... 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+Applicatio... (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). 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 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

See below, On 30 Aug 2015 at 15:15:45, vincent@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#HPrerequisi...

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#HSocialLo.... 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+Applicatio... 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+Applicatio... 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+Applicatio... (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).

2) you create a jira issue at http://jira.xwiki.org/browse/AUTHSL and maybe someone will pick it up and fix it. 

Actually I’ve created it at http://jira.xwiki.org/browse/AUTHSL-3 and I’ll try to fix it now, it seems easy enough to fix. Thanks -Vincent

...

- 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

Note: I just fixed two issue and released a new 2.2 version that should be a better fit for 7.x. I did not test it so it's possible there is other not yet reported issues. On Sun, Aug 30, 2015 at 3:53 PM, vincent@massol.net <vincent@massol.net> wrote:

On 30 Aug 2015 at 15:28:30, vincent@massol.net (vincent@massol.net(mailto:vincent@massol.net)) wrote:

...

See below,

On 30 Aug 2015 at 15:15:45, vincent@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#HPrerequisi...

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#HSocialLo.... 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+Applicatio... 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+Applicatio... 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+Applicatio... (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).

2) you create a jira issue at http://jira.xwiki.org/browse/AUTHSL and maybe someone will pick it up and fix it.

Actually I’ve created it at http://jira.xwiki.org/browse/AUTHSL-3 and I’ll try to fix it now, it seems easy enough to fix.

I spoke too fast… This was only the tip of the iceberg. I’ve commented at http://jira.xwiki.org/browse/AUTHSL-3?focusedCommentId=87597&page=com.atlass...

Since someone reported it to work with XWiki 6.0.1, I guess it should work fine in 6.4.4 (LTS).

Thanks -Vincent

...

Thanks -Vincent

...

...

- 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

---

users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users

-- Thomas Mortagne