Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: PDF layout

...

To add additional disk storage to your Charon-SSP GCP SSP  instance (for example, for storing virtual disk containers), perform the steps described below.

...

Table of Contents
excludeContents
stylesquare

Steps in the

...

IBM Storage Environment

In the GCP IBM environment, you can, for example,

...

For more details, please refer to the GCP IBM documentation

Creating a New Volume

...

To create a new

...

Step 1: open the disk creation window.

As shown in the example below, select Compute Engine > Disks to get to the disk overview page. On this page click on Create Disk to open the disk creation window.

Image Removed

Step 2: enter the disk information in the disk creation window.

Once the disk creation window has been opened, add the required information and select the disk size and characteristics appropriate for your project. The image below shows an example:

Image Removed

When done with entering the information, click on Create at the bottom of the screen.

The new disk will be listed on the disk overview page:

Image Removed

volume, start with the following steps:

  • Open the Block storage volume page in the Storage section of the VPC environment. This opens a list of available disks.
  • To create a new disk, click on the Create button.

The image below illustrates these steps:

Image Added

The Create button opens a block storage volume creation window. Add the necessary parameters, for example:

  • Name of the volume
  • Resource group of the volume
  • Disk performance
  • Disk size
  • Encryption configuration

The following image shows the upper part of the volume creation window:

Image Added

When all the necessary data has been entered, create the volume by clicking on Create volume on the right.

Attaching an Existing Volume to an Instance

Once To attach a volume has been created, you can attach it to your instance.

Step 1: open the editor for your instance.

To edit your instance,

  • select it to open the details page,
  • then click on Edit at the top of the details page.

Image Removed

Step 2: add disk to configuration.

In the editor window, scroll down to the disk section.

Image Removed

Here you can either create and add a new disk or, as shown in the image above, attach and existing disk by clicking on Attach existing disk.

  • Select your disk in the drop-down menu.
  • Adjust the other parameters as needed.
  • Click on Done to complete the configuration.

To save the changes, click on Save at the bottom of the editor window.

Detaching a Volume from an Instance

If the volume is not the root device of the instance, unmount the volume in the Charon host system before detaching it (see Charon-SSP Manager section below).

Then detach the volume from your instance:

  • Open the editor for instance.
  • Go to the disk section.
  • Select the wastebasket symbol next to the disk.
  • Save the changes by clicking on Save at the bottom of the editor page.

Steps on the Charon-SSP Host System

Mounting a Newly Attached Volume Using the Storage Manager (Marketplace images only)

After the volume has been attached to the instance, it must be included in the Charon-SSP host system configuration. This is achieved via the Charon-SSP Manager.

...

to an instance, perform the following steps:

  • Open the list of Block storage volumes.
  • Click on the disk you want to assign to an instance. This opens the disk details view.
  • In the details view, click on Attach instance as illustrated below.

    Image Added
  • In the pop-up window select your instance and click on Attach volume:

    Image Added
  • The instance will be listed in the Attached instances section.
Div
classpagebreak


Detaching a Volume from an Instance

Before detaching a volume from an instance, make sure that the volume is not needed and your applications will not run into problems if the volume is detached. Then, perform the following steps:

...

  • Unmount the volume if it is mounted, and remove it from /etc/fstab if needed.
  • Open the list of Block storage volumes.
  • Click on the disk in question to open the details view.
  • Click on the

...

This will mount the new volume under /charon/storage/media/<UUID>/. The following image shows a sample:

Image Removed

...

  • round delete symbol next to the instance in the Attached instances section.

    Image Added
Div
classpagebreak


Steps on the Charon-SSP Host System

Mounting a Newly Attached Volume

...

On the Charon host system you will need to identify the disk, add a file system to it, and mount it 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 

In the example above, the new disk is /dev/sdb.

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

Please refer to the documentation of your Linux distribution for details about the mkfs command.

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.4.x
PDC:__Include: Charon-SSP Manual Mounting of New Disk Device v4.4.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.

...


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