Last modified by Thomas Mortagne on 2023/10/13

<
From version < 16.1 >
edited by Marius Dumitru Florea
on 2011/02/08
To version < 19.1 >
edited by Caleb James DeLisle
on 2011/02/10
>
Change comment: added .img

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.mflorea
1 +XWiki.Caleb_James_DeLisle
Content
... ... @@ -10,7 +10,7 @@
10 10  
11 11  * We have redesigned the administration application providing a new layout and new icons for the administrator sections.
12 12  
13 -[[[[image:Administration.png||style="border:1px solid black" width="500px"]]>>attach:Administration.png]]
13 +[[[[image:Administration.png||style="border:1px solid #D6E1E7" width="500px"]]>>attach:Administration.png]]
14 14  
15 15  * Several XWiki forms have been modified in order to be consistent with our form standards: [[vertical>>platform:DevGuide.VerticalForms]] and [[inline>>platform:DevGuide.InlineForms]] layout (added in this release).
16 16  
... ... @@ -53,6 +53,59 @@
53 53  
54 54  * The following translations have been updated: ##fr##, ##sv##, ##ca##, ##cs##, ##de##, ##es##, ##gl##, ##lv##, ##ro##, ##ru##, ##sk##, ##uk##, ##vi##, ##zh_tw##
55 55  
56 +== Experimental Filesystem Attachment Storage ==
57 +Storage isn't flashy and it isn't exciting, as a user you only have to think about it when it breaks.
58 +Filesystem attachment storage provides you with a means to store large attachments. All data is streamed
59 +from the upload to the filesystem without being held in memory on the way through.
60 +
61 +This means that the only limit on the size of attachments which can be stored is the size of your hard disk.
62 +
63 +[[[[image:bigattach.png||style="border:1px solid #D6E1E7"]]>>attach:bigattach.png]]
64 +
65 +Practically, this was tested using a 1GB attachment which uploaded with no problem. A 4GB attachment failed
66 +but the exception message suggests the web browser is to blame.
67 +
68 +=== Set up ===
69 +To try this out for yourself, you will need a copy of XWiki 3.0M2.
70 +Download the 5 parts of the filesystem storage:
71 +* [[Api>>http://hudson.xwiki.org/job/xwiki-platform-core/lastBuild/org.xwiki.platform$xwiki-core-store-api/artifact/org.xwiki.platform/xwiki-core-store-api/3.0-SNAPSHOT/xwiki-core-store-api-3.0-SNAPSHOT.jar]]
72 +* [[Transaction>>http://hudson.xwiki.org/job/xwiki-platform-core/lastBuild/org.xwiki.platform$xwiki-core-store-transaction/artifact/org.xwiki.platform/xwiki-core-store-transaction/3.0-SNAPSHOT/xwiki-core-store-transaction-3.0-SNAPSHOT.jar]]
73 +* [[Serialization>>http://hudson.xwiki.org/job/xwiki-platform-core/lastBuild/org.xwiki.platform$xwiki-core-store-serialization/artifact/org.xwiki.platform/xwiki-core-store-serialization/3.0-SNAPSHOT/xwiki-core-store-serialization-3.0-SNAPSHOT.jar]]
74 +* [[Filesystem Storage>>http://hudson.xwiki.org/job/xwiki-platform-core/lastBuild/org.xwiki.platform$xwiki-core-store-filesystem/artifact/org.xwiki.platform/xwiki-core-store-filesystem/3.0-SNAPSHOT/xwiki-core-store-filesystem-3.0-SNAPSHOT.jar]]
75 +* [[Filesystem Attachment Storage>>http://hudson.xwiki.org/job/xwiki-platform-core/lastBuild/org.xwiki.platform$xwiki-core-store-filesystem-attachments/artifact/org.xwiki.platform/xwiki-core-store-filesystem-attachments/3.0-SNAPSHOT/xwiki-core-store-filesystem-attachments-3.0-SNAPSHOT.jar]]
76 +
77 +{{info}}Development is still progressing and these links will always point to the latest versions of the files so check back from time to time. {{/info}}
78 +
79 +Place these files in your ##xwiki/WEB-INF/lib## directory.
80 +
81 +Then make the following changes to your xwiki.cfg file:
82 +Under the "Storage" section:
83 +
84 +{{code language="none"}}
85 +#-# The attachment storage.
86 +xwiki.store.attachment.hint=file
87 +
88 +#-# The attachment versioning storage. Use 'void' to disable attachment versioning.
89 +xwiki.store.attachment.versioning.hint=file
90 +
91 +#-# Whether the attachment recycle bin feature is activated or not
92 +storage.attachment.recyclebin=0
93 +{{/code}}
94 +
95 +Then start your wiki and as Admin, open this page:
96 +##<your site>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object##
97 +
98 +Scroll down until you find:
99 +##Maximum Upload Size##
100 +and change that number to something huge like:
101 +99999999999999999 ;)
102 +Press save at the bottom of the page.
103 +
104 +Now go on and upload your giant attachments.
105 +
106 +An attachment recycle bin store is in the works but remains unfinished, the existing code **should** work with the old recycle bin (and it's memory consumption issues) but as of this writing, there exists a bug in the conversion from the new format to the old.
107 +Without a recycel bin store, deletion of attachments is final, rolling back a document will not bring the attachments back.
108 +
56 56  = Known issues =
57 57  
58 58  * [[Bugs we know about>>http://jira.xwiki.org/jira/secure/IssueNavigator.jspa?reset=true&&type=1&pid=10010&resolution=-1&sorter/field=updated&sorter/order=DESC]]
bigattach.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Caleb_James_DeLisle
Size
... ... @@ -1,0 +1,1 @@
1 +29.0 KB
Content

Get Connected