Cluster File Handlers
A cluster file handler is the class through which Exponential stores, reads, renames and removes the files of var/: images, binary files and the content caches. The handler is set in file.ini [ClusteringSettings] FileHandler; the name is case sensitive.
Handlers in Exponential 6
eZFSFileHandler
The default (kernel/classes/clusterfilehandlers/ezfsfilehandler.php). It uses the local file system directly. It is the right choice for one web server, and the only handler that needs no database table and no mount.
eZDFSFileHandler
The distributed handler (kernel/private/classes/clusterfilehandlers/ezdfsfilehandler.php), for several web servers:
- the reference copy of every file is on an NFS mount (MountPointPath), the same path on every server;
- its metadata (name, size, modification time, expiry) is in the ezdfsfile table, reached through a database backend; database transactions keep operations atomic;
- cache files are copied to each server's own var/ and used from there; images and binary files are streamed from the mount by index_cluster.php.
The backends are listed on Cluster configuration settings. The table definitions are in kernel/sql/mysql/cluster_dfs_schema.sql.
Removed handlers (historical)
- eZDBFileHandler stored the files themselves as BLOBs in the database. It was removed with eZ Publish 5.1. Move a site that still uses it to the DFS handler; see Migrating from 4.x, section "The cluster".
- eZFS2FileHandler was an experimental local handler with better concurrency handling. It was removed with eZ Publish 5.1; use eZFSFileHandler.
- The handler names before 4.1 (ezfs, ezdb) are not recognized.
Related pages
Contributors
- Ester Heylen
- Sarah Haïm-Lubczanski Maintainer
- Geir Arne Waaler Maintainer
- Andrea Melo Maintainer
- André Rømcke Maintainer
- Ricardo Correia Maintainer
- Graham Brookins Updated Maintainer
Comments
Add a comment