Introduction
After installing a QRadar update, you may find that several core services fail to start even though the upgrade itself completed successfully. One common cause is a filesystem exceeding the utilization threshold required for QRadar services to initialize.
This guide explains how to identify the affected partition, determine what is consuming disk space, and free enough space for the services to start successfully.
Symptoms
- Multiple QRadar core services fail to start after an upgrade.
- The system appears healthy, but QRadar remains unavailable.
- Services remain in a stopped or failed state after rebooting.
- The upgrade completes successfully, but QRadar never becomes operational.
Cause
QRadar requires sufficient free disk space before core services will initialize. If a critical partition exceeds the supported utilization threshold (approximately 95%), services such as Hostcontext, Tomcat, and various ECS services may fail to start.
In this case, accumulated core dump files consumed enough disk space to prevent the services from starting.
Resolution
Check Core Service Status
Begin by monitoring the startup process.
/opt/qradar/upgrade/util/setup/upgrades/wait_for_start.sh
If services continue to fail, verify available disk space.
df -Th
If a critical partition is at or above approximately 95% utilization, determine what is consuming the available space.
Identify Large Files
Temporarily bind the root filesystem.
mount -o bind / /media/cdrom
Navigate to the mounted filesystem.
cd /media/cdrom
Review directory sizes.
du -hs * | less
Locate any core dump files.
ls -l core.*
If necessary, gather system information before moving the files.
dmidecode -t system | less
Move Core Dump Files
Create a directory for the collected core files.
mkdir -pv /store/ibm_support/<directory_name>
Move the core dump files.
mv -fv core.* /store/ibm_support/<directory_name>
Field Note
Rather than deleting the core dump files, move them to the
/store/ibm_supportdirectory. This preserves the files for future analysis while freeing space on the affected filesystem.
Verify that disk utilization has decreased.
df -Th
Unmount the temporary bind mount.
cd
umount /media/cdrom
Verify disk utilization once more.
df -Th
Restart QRadar Services
Restart the Hostcontext service.
systemctl restart hostcontext
Verify the status of the primary services.
systemctl status hostcontext
systemctl status tomcat
systemctl status ecs-ec-ingress
systemctl status ecs-ec
systemctl status ecs-ep
Verify Tomcat connectivity.
/opt/qradar/bin/test_tomcat_connection.sh
Verification
After moving the core dump files and restarting services:
- Verify the affected partition is below the critical utilization threshold.
- Confirm
hostcontextis running. - Confirm
tomcatis running. - Verify the ECS services have started successfully.
- Confirm
test_tomcat_connection.shcompletes successfully. - Log in to the QRadar web interface and verify the Console loads normally.
If the Problem Persists
If services still fail to start:
- Verify no other filesystems exceed the utilization threshold.
- Look for additional large files consuming disk space.
- Review the service logs for startup failures.
- Confirm no new core dump files are being generated due to another underlying issue.
- If services continue to fail, collect the contents of
/store/ibm_supportbefore opening a case with IBM Support.
Additional Resources
- IBM QRadar Upgrade Documentation
- IBM QRadar Support Troubleshooting Guides
- IBM QRadar Service Management Documentation