This article describes a scenario where the root filesystem is full, resulting in Web UI inaccessibility and failure to boot Machines.
Problem
The ggRock Web UI is inaccessible.
No ggRock Machines are able to boot.
The root filesystem '/' on which the Debian OS is installed is full.
Confirm the root filesystem is indeed full by issuing the "df" command at the console:
Solution
Free up space on the root filesystem.
An easy candidate for freeing up disk space is the /var/log directory.
Issue the
"du -ah /var/log | sort -h"
command at the console to show log files and their sizes, sorted with the largest at the bottom.
NOTE:
The following steps require running commands that irreversibly modify the filesystem contents. Please do not proceed unless you are confident in what you are doing, otherwise please reach out to support staff for assistance.
In the case of this example, the largest file is kern.log, which should not be deleted, but may be cleared by issuing the
"echo > /var/log/kern.log"
command, freeing up 4.9GB of space.
The second largest file is syslog.1 which may safely be deleted by issuing the
"rm /var/log/syslog.1"
freeing up 764MB of space.
Since the root filesystem ran out of space, it is pertinent to check for updates to ggRock and the Debian OS, following the Updating ggRock from the Command Line article.
Additionally, it will be necessary to re-run the ggrock-linux-configurator tool following the necessary steps in the "Re-run ggrock-linux-configurator" section of the linked guide.
Finally, reboot your ggRock server after all of the above steps have been completed by issuing the
"shutdown -r now"
command.
Once the server boots back up, attempt to boot a Machine again.
Additional Information
If the root filesystem runs out of space, basic OS functionality as well as ggRock server functionality will be impacted. If running out of space on the root filesystem is a common issue, it may be pertinent to move to a larger drive for your root filesystem.