- more info on how to switch to the new multi level content directory

This commit is contained in:
steinm 2011-12-08 19:52:27 +00:00
parent 78b4bcc713
commit df6b7de165

View File

@ -41,28 +41,33 @@ of subdirectories in a directory of the filesystem. The currently most used
filesystem on Linux (ext3) supports only 31998 directories. In order to filesystem on Linux (ext3) supports only 31998 directories. In order to
overcome this limitation another level of directories has been put inbetween overcome this limitation another level of directories has been put inbetween
the content directory and the document directory numbered from 1 to the content directory and the document directory numbered from 1 to
maxDirID. This allows a theorethical maximum of sq(maxDirID) documents. The maxDirID. This allows a theorethical maximum of square(maxDirID) documents.
path to the document folder consists of the new path id and the document id The path to the document folder consists of the new path id and the document
(<pathid>/<docid>). The path id is derived from the document id by the id (<pathid>/<docid>). The path id is derived from the document id by the
formula formula
floor(docid/maxDirID) + 1 floor(docid/maxDirID) + 1
Hence, all documents with an id from 1 to maxDirID have the path '1/<docid>'. Hence, all documents with an id from 1 to maxDirID have the path '1/<docid>'.
The limiting factor of this schema is the number of document ids. It cannot The limiting factor of this schema is the number of document ids. It cannot
be higher than sq(maxDirID). be higher than square(maxDirID).
If you intend to switch to the new content directory format, you will have If you intend to switch to the new multi level content directory format, you
to set maxDirID to a value > 0 (possibly 31998) and create a new directory will have to set maxDirID to a value > 0 (possibly 31998) and create one or
with name '1' below the content dir and move all document directories into more new directories starting with name '1' below the content dir and move
it. If you have already a document with id 1, you must choose a different all document directories into it. How many new directories are needed
name for your new sub directory and rename to 1 after all document depends on the maximum document id already used. If the maximum document id
directories have been moved. If you want to keep the current content is <= maxDirID, then you will only need one directory named '1'. If the
directory structure set maxDirID to 0. Make sure the maxDirID remains maximum document id is <= 2*maxDirID you will need another directory named
unchanged for a content directory. '2'. If you have already a document with id 1 (or 2, 3, 4, ...), you must
choose a different name for your new sub directory and rename to 1 (or 2, 3,
4, ...) after all document directories have been moved.
If you want to keep the current content directory structure set maxDirID to
0. Make sure the maxDirID remains unchanged for a content directory.
After finishing update After finishing update
---------------------- ----------------------
Once you are done with the update, log in as administrator and make an Once you are done with the update, log in as administrator and make an
object check in the admin tools. This will fill the new database field object check in the admin tools. This will fill the new database field
needed for the folder search. needed for the folder search and fill it with the appropriate value.