Symptoms or Error
An unexpected interruption in the operation of an ESX host or an underlying datastore in VMware can damage the root file systems of the Unidesk appliances (CachePoint Appliances and the Management Appliance). This damage can prevent them from booting automatically. When an operational interruption occurs, the startup process prompts the user to enter the root password in order to repair the damaged file system.
If you open the vSphere console for the appliance, you see an error and prompt similar to the following:
root: UNEXPECTED INCONSISTENCY: RUN fsck MANUALLY.
(i.e., without -a or -p options)
*** An error occurred during the file system check.
*** Dropping you to a shell: the system will reboot
*** when you leave the shell.
Give root password for maintenance
(or type Control-D to continue):
Solution
NOTE: You may not always see, "Repair filesystem". If the noted error is the same go ahead and follow the procedure.
- When prompted to do so, enter the root password---the password that you choose when you installed the appliance (this password is different from the one you use to log in to the Unidesk Management Console). The default root password in version 2 and 3 is v9Yx*6uj. The default root password for V4 is Unidesk1. The root password should have been changed at installation/appliance creation. If not, use the instructions on the Installation topic under Secure the appliances to log in. If you are using V2 or V3, Make sure you've changed the Administrator and root passwords for each appliance after you have recovered. The system displays the following prompt (this prompt waits for a command, not part of the error message):
(Repair filesystem) 1 # - If you are running Unidesk 2.5 or earlier, enter the fsck -y / command at the Repair filesystem prompt to repair the file system. For example:
(Repair filesystem) 1 # fsck -y /
The fsck utility displays several messages during the repair process. - If you are running Unidesk 2.6 through 4.0, there are now two partitions on the boot disk, and you must run two commands:
(Repair filesystem) 1 # fsck -y /dev/sda1
(Repair filesystem) 1 # fsck -y /dev/sda3 - If you originally installed Citrix App Layering 4.1 or higher, run these two commands:
(Repair filesystem) 1 # fsck -y /dev/sda1
(Repair filesystem) 1 # fsck -y /dev/sda2 - At the (Repair filesystem) prompt, enter reboot to restart the system. For example:
(Repair fileysystem) 2 # reboot
Ignore messages about read-only file systems.
When the appliance restarts, it should return to normal operations. It's possible; however, that additional cleanup work is required. - If the appliance does not seem to be operating normally, contact Technical Support immediately.