Reverting a cluster setup

You can go back from a DFS cluster to plain files on one server at any time. These steps copy the files back from the cluster into var/ and switch the handler back to eZFSFileHandler. Take a backup of the database, the cluster tables and the mount first.

1. Clear the caches (optional)

php bin/php/ezcache.php --clear-all --purge

2. Copy the files back

On the server that stays, with enough free disk space for all images and files:

./console exp:clusterize -u --allow-root-user
# the same script: php bin/php/clusterize.php -u

3. Switch the handler back

In settings/override/file.ini.append.php, remove the [eZDFSClusteringSettings] block and set the default handler (or remove the block, since it is the default):

[ClusteringSettings]
FileHandler=eZFSFileHandler

4. Serve files from the disk again

• Restore the rewrite rules of .htaccess_root that serve var/.../storage/images and var/.../cache/(texttoimage|public) directly, instead of sending them to index_cluster.php.
• Unset the CLUSTER_* constants: ./console exp:config:unset CLUSTER_STORAGE_BACKEND --apply and so on.

5. Reload

Clear the INI cache, reload PHP-FPM, restart Exponential Velocity if you use it, and check pages with images.

To also remove the cluster tables and files, continue with Uninstalling an eZDFS cluster.