Summary

• Page properties (2 modified, 0 added, 0 removed)
• Attachments (0 modified, 1 added, 0 removed)
  • bigattach.png

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.mflorea
	1	+XWiki.Caleb_James_DeLisle

Content

...	...	@@ -53,6 +53,57 @@
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	+Practically, this was tested using a 1GB attachment which uploaded with no problem. A 4GB attachment failed
	64	+but the exception message suggests the web browser is to blame.
	65	+
	66	+=== Set up ===
	67	+To try this out for yourself, you will need a copy of XWiki 3.0M2.
	68	+Download the 5 parts of the filesystem storage:
	69	+* [[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]]
	70	+* [[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]]
	71	+* [[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]]
	72	+* [[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]]
	73	+* [[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]]
	74	+
	75	+{{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}}
	76	+
	77	+Place these files in your ##xwiki/WEB-INF/lib## directory.
	78	+
	79	+Then make the following changes to your xwiki.cfg file:
	80	+Under the "Storage" section:
	81	+
	82	+{{code language="none"}}
	83	+#-# The attachment storage.
	84	+xwiki.store.attachment.hint=file
	85	+
	86	+#-# The attachment versioning storage. Use 'void' to disable attachment versioning.
	87	+xwiki.store.attachment.versioning.hint=file
	88	+
	89	+#-# Whether the attachment recycle bin feature is activated or not
	90	+storage.attachment.recyclebin=0
	91	+{{/code}}
	92	+
	93	+Then start your wiki and as Admin, open this page:
	94	+##<your site>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object##
	95	+
	96	+Scroll down until you find:
	97	+##Maximum Upload Size##
	98	+and change that number to something huge like:
	99	+99999999999999999 ;)
	100	+Press save at the bottom of the page.
	101	+
	102	+Now go on and upload your giant attachments.
	103	+
	104	+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.
	105	+Without a recycel bin store, deletion of attachments is final, rolling back a document will not bring the attachments back.
	106	+
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