CenturyLink Cloud supports the ability to add additional disks to Linux machines. This automated task can fail for various reasons requiring manual intervention on the customer machine in order to complete. These are the manual steps required to detect and mount a new disk.
- NOC Engineers, Customers
New drive will be detected, formatted, and mounted
- Must have root access to the machine in question
- Must have basic Linux knowledge
- Must understand the format and options for fstab in Linux
- After the disk addition has failed with the message "manual intervention required" log on as root to the machine.
- On the machine run:
This will show all current drives/ partitions on the machine. In most cases the newly added drive will not show up here as it has not yet been detected.
- To get the OS to detect the new drive we must rescan the SCSI bus, in order to do this we must first Identify the host bus number. This can very depending on the type of controller used on any particular system. Run the following command:
All our current Linux templates use the LSI parallel controller, in which case the controler name we are looking for is mptspi
grep mptspi /sys/class/scsi_host/host?/proc_name
The returned value should look something like: "/sys/class/scsi_host/host3/proc_name:mptspi" From these results you can see we are dealing with "host3"
In the case of another SCSI controler type this value will differ, the VMware para-virtual controller for example would be named vmw_pvscsi so we would run
grep scsi /sys/class/scsi_host/host?/proc_name
The returned value should look something like: "/sys/class/scsi_host/host2/proc_name:vmw_pvscsi" From these results you can see we are dealing with "host2"
Now run the following command to rescan the host number we identified
echo "- - -" > /sys/class/scsi_host/host3/scan
- Run "fdisk -l" again and you should now see the new drive detected in the OS. Make a note of the device name (for this example we will assume /dev/sdd)
- The control site normally deploys partition-less file systems and as that is what the control site is compatible with we will do the same here (advanced users may create any partitioning they like however it may not be compatible with the control site)
The following command creates a new ext4 filesystem directly on the drive with no partitioning.
mkfs -t ext4 /dev/sdd
- Now that the drive has been added and formatted we must mount it somewhere. For this example we will mount it to "/data"
Run the following command to create a mount point (/data can be replaced with whatever you like)
- As the control site normally mounts by UUID we will do the same here. Run the following command and take note of the UUID for the new drive
- Edit the fstab, adding the UUID, mount point and necessary options as per the normal fstab format (<device> <mountpoint> <filesystemtype><options> <dump> <fsckorder>)
- Mount using the new entry in the fstab by running:
- Confirm everything looks correct by checking the free space on the drives