cattaDoc Installation Step 3:
Create document, library and image repositories

4 repositories are required for storing cattaDoc files and should be writable for cattaDoc

cattaDoc stores documents, library files and images in separate folders accessible by the web server. They are called repositories to distinguish them from the MySQL database.

The folders containing the file repositories can be part of the cattaDoc folder structure, but need not be so.

The current document repository folder can be changed over time, e.g. each year, or quarterly, or monthly, dependent on your needs and requirements (backup etc.).

The library repositories are divided into categories each residing in a separate sub-folder.

 

It is vital to set permissions correctly on the folders and files cattaDoc is writing to. If not, files are simply not written.

At least the 4 repositories (folders) should be made writable for cattaDoc. If you want to use the file manager for remote file management, all the folders you will administer remotely should be made writable for cattaDoc.

For Apache on OpenSUSE Linux, the web process user/owner is wwwrun and the group is nogroup - in Ubuntu it is www-data / nogroup.

Example:
chown -R www-data:nogroup /cddocuments

It might be otherwise on other Linux distributions. The web process owner shall have full rights to the writable folders whereas the group and others shall only have read permissions - or 40755 as it is shortened in Linux.

 

For example, create a folder cddocuments - the cattaDoc document root - in the root web folder, and a sub-folder for the first year, e.g. 2016, ref. the cattaDoc configuration files. The current document path will thus be /cddocuments/2016.

Check and set file and folder permissions for the repository folder, ref. above.

The cattaDoc document repository folder should only be accessible through the cattaDoc application. Therefore, it is recommended:

  • NOT to make the cattaDoc document repository folder accessible as a shared file service - or part of a shared drive

  • NOT to allow directory listing of the folder in a web browser (in Apache, define Options -Indexes for the folder).

 

For example, create a folder cdlibrary - the online cattaDoc library file root - in the root web folder, and two initial sub-folders project and prince2. And two additional sub-folders images and css under each of the sub-folders. Ie. the follewing folder structure:

  • cdlibrary/project
  • cdlibrary/project/images
  • cdlibrary/project/css
  • cdlibrary/prince2
  • cdlibrary/prince2/images
  • cdlibrary/prince2/css

The sub-folders are only examples, but the two sub-folders mentioned correspond to library categories initially created in the MySQL database creation script, ref. step 2.

Permissions are the same as for the document repository.

 

For example, create a folder cdarchive - the archive cattaDoc library file root - in the root web folder, and two initial sub-folders project and prince2.

The sub-folders are only examples, but the two sub-folders mentioned correspond to library categories initially created in the MySQL database creation script, ref. step 2.

Permissions are the same as for the document and online library file repositories.

The two library file repositories, online and archive, correspond to the two first location types.

 

Finally - and again as an example - create a folder images - the global cattaDoc image file folder - in the root web folder.

Permissions are the same as for the document and library file repositories.

 

Comments

1 comment for this page


1 alejandro (lima - peru) wrote 2013-04-10 17:08:12 :

fatal error al instalar
Warning: require(/system/incLangConst.php) [function.require]: failed to open stream: No such file or directory in /home/misitio/public_html/document4/system/cdStart4.inc.php on line 55

Fatal error: require() [function.require]: Failed opening required '/system/incLangConst.php' (include_path='.:/usr/lib/php:/usr/local/lib/php') in /home/misitio/public_html/document4/system/cdStart4.inc.php on line 55

Leave a Comment

 
Revised: 2020-05-22