Changes for page Attachments

Last modified by Thomas Mortagne on 2023/10/10

<
From version < 30.1 >
edited by Thomas Mortagne
on 2017/11/13
To version < 32.1 >
edited by Thomas Mortagne
on 2018/04/20
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -44,30 +44,22 @@
44 44  
45 45  No matter what type of attachment store you use, the meta-data for the attachment will be saved in the [[xwikiattachment>>platform:DevGuide.DsXWikiAttachment]] table for faster loads.
46 46  
47 -== Database Attachment Store (Default) ==
47 +== Filesystem Attachment Store ==
48 48  
49 -This attachment storage mechanism stores your attachments in database entries in the [[xwikiattachment_content>>platform:DevGuide.DsXWikiAttachmentContent]], [[xwikiattachment_archive>>platform:DevGuide.XWikiAttachmentArchive]] and [[xwikiattrecyclebin>>platform:DevGuide.DsXwikiRecycleBin]] tables. This system allows for easy backup of your attachments by dumping the database and keeping all of your data together, but attachment size is memory constrained since the attachment content and archive must all be held in memory. As a general rule, attachments larger than 30MB are not possible.
50 -
51 51  {{info}}
52 -When using this attachment store with a MySQL database, you must set the ##max_allowed_packet## to about 3 times the size of your largest attachment since the attachment and its version history must be saved. See the [[MySQL Installation guide>>Documentation.AdminGuide.InstallationMySQL]] for more information.
50 +The default since 10.3
53 53  {{/info}}
54 54  
55 -== Filesystem Attachment Store ==
56 -
57 57  The Filesystem attachment store saves your attachments in files in a directory tree. This means you will have one more thing to do when you back up your data but it also means you can save larger (over one gigabyte) files. Filesystem attachment store implements a two stage commit mechanism to maintain integrity even if the database fails to commit the attachment meta-data.
58 58  
59 -{{error}}
60 -The following limitations currently exist when using the filesystem for storing attachments:
55 +{{info}}
56 +Case insensitive filesystems are only supported since XWiki 10.1. In previous version you might have expected behavior when manipulating document or attachments which are the same from a case insensitive point of view since XWiki will always see them as different on its side.
57 +{{/info}}
61 61  
62 -* You must be on a case-sensitive Filesystem. For example if you're on Windows then you might have issue if you create pages with the same name but different case (e.g. ##abc## vs ##Abc##). XWiki is case-sensitive and will end up overwriting attachments if you have several pages with the same name (but different case).
63 -{{/error}}
64 -
65 65  === Enabling Filesystem attachment store ===
66 66  
67 -==== New users ====
61 +Before 10.3 you will need to enable it. All you need to do for enabling Filesystem Attachment Store is to change some settings in the [[xwiki.cfg>>Documentation.AdminGuide.Configuration#HSamplexwiki.cfg]] file.
68 68  
69 -If you are a new XWiki user, all you need to do for enabling Filesystem Attachment Store is to change some settings in the [[xwiki.cfg>>Documentation.AdminGuide.Configuration#HSamplexwiki.cfg]] file.
70 -
71 71  These settings should read as follows:
72 72  
73 73  {{code language="none"}}
... ... @@ -79,7 +79,7 @@
79 79  ## Before 9.10RC1
80 80  xwiki.store.attachment.recyclebin.hint = file
81 81  
82 -# Attachments being also stored in the deleted documents it's safer to also enable filesystem storage for it too
74 +# Attachments being also stored in the deleted documents it's safer to also enable filesystem storage
83 83  xwiki.store.recyclebin.content.hint = file
84 84  {{/code}}
85 85  
... ... @@ -112,3 +112,15 @@
112 112  ==== Directory cleanup ====
113 113  
114 114  Since [[XWiki 6.0M2>>xwiki:ReleaseNotes.ReleaseNotesXWiki61M2]], it is possible to save time on startup by preventing XWiki from cleaning up empty directories in the Filesystem Attachment Store. To do this, edit ##xwiki.properties## and set **store.fsattach.cleanOnStartup** to false. If you do this, you will be responsible for cleanup of empty directories yourself.
107 +
108 +== Database Attachment Store ==
109 +
110 +{{info}}
111 +The default until 10.2.
112 +{{/info}}
113 +
114 +This attachment storage mechanism stores your attachments in database entries in the [[xwikiattachment_content>>platform:DevGuide.DsXWikiAttachmentContent]], [[xwikiattachment_archive>>platform:DevGuide.XWikiAttachmentArchive]] and [[xwikiattrecyclebin>>platform:DevGuide.DsXwikiRecycleBin]] tables. This system allows for easy backup of your attachments by dumping the database and keeping all of your data together, but attachment size is memory constrained since the attachment content and archive must all be held in memory. As a general rule, attachments larger than 30MB are not possible.
115 +
116 +{{info}}
117 +When using this attachment store with a MySQL database, you must set the ##max_allowed_packet## to about 3 times the size of your largest attachment since the attachment and its version history must be saved. See the [[MySQL Installation guide>>Documentation.AdminGuide.InstallationMySQL]] for more information.
118 +{{/info}}

Get Connected