Since users may decide not to use cluster anymore, or even choose to use another file handler, this chapter would show how to uninstall an existing eZDFS cluster.

The following procedures may cause loss of information, since this is a cluster removal guide. Before proceeding, please be sure to make a complete backup of your site, cluster folder and database, to avoid losing data.

Removing an eZDFS cluster

1. Clear the cache

Before starting it's better to clear the eZ Publish's cache, by running the following command from your ezpublish_legacy/ folder:

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

2. Unclusterize your eZDFS cluster

Run the following shell command from your ezpublish_legacy/ folder:

php bin/php/clusterize.php -u

This will move cluster cache and binaries from the cluster path to the original locations.

3. Remove the images serving script

Remove the config.cluster.php file, which has been created while setting up the cluster environment. For that, you can use the following command from your ezpublish_legacy/ folder:

rm config.cluster.php

4. Remove the cluster database table

On MySQL the database table can be removed by executing the following shell command:

mysqladmin -u <user> -p<password> drop ezdfsfile
mysqladmin -u <user> -p<password> drop ezdfsfile_data

Note: On Oracle the same ezdfsfile and ezdfsfile_data tables need to be removed.

5. Remove the Clustering Setting from your file.ini.append.php:

Simply edit your file.ini.append.php file and remove the ClusteringSettings and eZDFSClusteringSettings blocks completelly. You can see an example below:

[ClusteringSettings]
FileHandler=eZDFSFileHandler
 
[eZDFSClusteringSettings]
MountPointPath=/media/nfs
DBBackend=eZDFSFileHandlerMySQLiBackend
DBHost=dbhost
DBPort=3306
DBSocket=
DBName=cluster
DBUser=root
DBPassword=
DBConnectRetries=3
DBExecuteRetries=20
MaxCopyRetries=5

6. Disable kernel clustering debug

Disable the kernel-clustering setting from debug.ini, by setting its value to disabled, as in the following example:

[GeneralCondition]
 
kernel-clustering=disabled

7. Remove the cluster rewrite rules from the Apache configuration

Edit your apache configurations file and remove the following rules:

RewriteRule ^/var/([^/]+/)?storage/images-versioned/.* /index_cluster.php [L]
RewriteRule ^/var/([^/]+/)?storage/images/.* /index_cluster.php [L]
RewriteRule ^/var/([^/]+/)?cache/public/(stylesheets|javascript) /index_cluster.php [L]
RewriteRule ^/index_cluster.php - [L]

8. Restart Apache and test the site

Restart the Apache web server. After it has been restarted, the system should be up and running in cluster mode. Verify that the site works correctly, content images are displayed and content binary files are accessible (open the site pages in a web browser, log in to the administration interface, try clicking around and so on).

9. Clear the cache files

Clear the cache files again, to make sure your sites generate clean caches. To do so, use the following command:

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