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
on 2018/02/19
Change comment:
There is no comment for this version
To version 32.1
edited by Thomas Mortagne
on 2018/04/20
on 2018/04/20
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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 - Whenusing this attachment store with a MySQLdatabase, you must set the ##max_allowed_packet## to about 3 times the size of yourlargestattachmentsincethe 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 too74 +# 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}}