Changes for page Attachments

Last modified by Thomas Mortagne on 2023/10/10

<
From version < 31.1 >
edited by Thomas Mortagne
on 2018/02/19
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,16 +44,12 @@
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 59  {{info}}
... ... @@ -62,10 +62,8 @@
62 62  
63 63  === Enabling Filesystem attachment store ===
64 64  
65 -==== 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.
66 66  
67 -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.
68 -
69 69  These settings should read as follows:
70 70  
71 71  {{code language="none"}}
... ... @@ -77,7 +77,7 @@
77 77  ## Before 9.10RC1
78 78  xwiki.store.attachment.recyclebin.hint = file
79 79  
80 -# 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
81 81  xwiki.store.recyclebin.content.hint = file
82 82  {{/code}}
83 83  
... ... @@ -110,3 +110,15 @@
110 110  ==== Directory cleanup ====
111 111  
112 112  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