Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
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 - 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 -{{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 too74 +# 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}}