Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: replace manual mount section with common page

...

Mounting a Newly Attached Volume Manually

This is an example of how to mount (and if necessary format) an additional disk on the Charon host system. Please refer to the Linux manual pages for details.

The general tasks on the Charon host system require to identify the disk, add a file system to it (if this has not been done before), and mount the disk under a suitable mount-point.

Step 1: Identify new disk

After logging in on the system, you can identify the new disk using the lsblk command:

Code Block
languagetext
# lsblk
NAME   MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
sda      8:0    0   20G  0 disk 
├─sda1   8:1    0  200M  0 part /boot/efi
└─sda2   8:2    0 19,8G  0 part /
sdb      8:16   0  200G  0 disk 

...

Step 2: Partition disk (fdisk or parted)

Please note: This step is only required for new disks. It will delete all data on an existing disk.

Please refer to the manual pages of your Linux distribution for details on the disk-partitioning commands.

After creating one partition on disk with fdisk (fdisk /dev/sdb), the lsblk output shows the new partition:

Code Block
languagetext
# lsblk
NAME   MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT
sda      8:0    0   30G  0 disk
├─sda1   8:1    0  500M  0 part /boot
└─sda2   8:2    0 29,5G  0 part /
sdb      8:32   0   64G  0 disk
└─sdb1   8:33   0   64G  0 part

Step3: Create a filesystem on the new partition(s)

Use the mkfs command to create a new filesystem. For example, to create an XFS filesystem, use

# mkfs.xfs /dev/sdb1

...

classpagebreak

Step 4: Create a mount-point and mount the new filesystem

The following example shows how to create a mount-point and mount the file system. Please note that this is just a basic example. As the /dev/sdX device names are not guaranteed to be persistent, it is better to use names from the /dev/disk/by-* hierarchy (for example by-uuid) for permanent use.

# mkdir /space
# mount /dev/sdb1 /space

The df command shows the mounted filesystem:

Code Block
languagetext
# df
Filesystem     1K-blocks    Used Available Use% Mounted on
devtmpfs         4065684       0   4065684   0% /dev
tmpfs            4077556      16   4077540   1% /dev/shm
tmpfs            4077556    9224   4068332   1% /run
tmpfs            4077556       0   4077556   0% /sys/fs/cgroup
/dev/sda2       30929148 1677416  29251732   6% /
/dev/sda1         508580   65512    443068  13% /boot
tmpfs             815512       0    815512   0% /run/user/1000
/dev/sdb1       65923628   53272  62498580   1% /space

Please note: To mount the filesystem at boot, add it to /etc/fstab.

Include Page
PDC:__Include: Charon-SSP Manual Mounting of New Disk Device v4.2.x
PDC:__Include: Charon-SSP Manual Mounting of New Disk Device v4.2.x

Unmounting a Volume

To unmount a volume before perform the following steps:

  • Stop all Charon instances that might use the volume that is about to be unmounted.
  • On host systems based on Marketplace images:
    • in Charon Manager go to Tools > Google Cloud > Storage Manager.
    • Select the volume.
    • Click on the cogwheel symbol and select Unmount the Filesystem.
  • On other systems:
    • Use the command # umount <device-path> or # umount <mount-point>
    • To make this permanent, remove the corresponding entry in /etc/fstab.


Div
classpagebreak


Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc