My Oracle Support Banner

Troubleshooting a multi-node OCFS2 installation (Doc ID 806645.1)

Last updated on AUGUST 28, 2023

Applies to:

Linux OS - Version Oracle Linux 4.4 and later
Oracle Cloud Infrastructure - Version N/A and later
Linux x86-64
Linux Kernel - Version: 1.2.0 to 1.8

*** ***
This note applies to all versions of ocfs2.


This procedure will verify that a new or existing ocfs2 installation is configured correctly and operating properly across each node of a cluster.  Metalink note references at the end of this document provide additional troubleshooting resources. The test system used in the examples is also configured for multipath to provide examples that are similar to production environments.

A properly installed ocfs2 installation requires the following:

1. The minimal set of ocfs2 packages

2. A correctly formatted cluster definition file that is identical on all nodes

3. Private network connectivity to port 7777 on all nodes of the cluster

4. The shared devices (LUNs) for the ocfs2 filesystem must be initially formatted and available with consistent and repeatable naming (across reboots) on all nodes

5. The /etc/fstab entries must have the correct ocfs2 mount options and the o2cb/ocfs2 services must be running without errors on all nodes

The following provides a 15 minute, step-by-step verification procedure for each of these requirements. Commands in bold are shortcut indicators for experienced system administrators that highlight the most important steps.


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 1. Ocfs2 Installation Package checks
 2. Configuration file check
 3. Network checks
 4. Shared device checks
 5. Final service and mount check
 6. Filesystem Checks and Disaster Recovery
 7. Conclusion

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.