To add additional disk storage to your Charon host instance in AWS (for example, for storing virtual disk containers), perform the steps described below.

Please note: the GUI may look slightly different depending on which version of the GUI you use. However, the available options should be the same.

AWS Storage Environment

In the AWS environment, you can, for example,

create a new storage volume,
attach an existing storage volume to your instance,
detach a storage volume from your instance.

These steps are shown below.

For more details, please refer to the AWS documentation.

Creating a New Volume

Step	Details
*Open the Volumes* configuration from the EC2 dashboard**	This will open the volume overview screen.
Create a new volume	Click on the Create Volume button on top of the volume overview screen. This will open the volume creation window.
	Select Volume type Volume size Availability zone (Please note: must be the same as the Charon AWS host instance!) Optionally, encrypt the device and/or add a name tag. Then click on Create Volume at the bottom of the window.
	You will receive a confirmation window. Close it to return to the volume overview screen where you should now see the new volume.

Attaching an Existing Volume to an Instance

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

Step	Details
Attach the volume to your instance	In the volumes overview screen, check that your volume has the state available. Right-click on it and select Attach Volume. This will open a small input screen.
	Select the instance to which the volume is to be attached. Optionally, you can change the device name that will be presented to the Charon AWS instance. Click on Attach to confirm the configuration and to attach the volume to the instance. The status of the volume in the volume overview screen will change from available to in-use.
Verify success in the instance description	Go to the instance overview list and select your instance. In the storage tab at the bottom, you will see that the instance now has two block devices.

Detaching a Volume from an Instance

If the volume is the root device of the instance, you must stop the instance before detaching the volume.

If the volume is not the root device of the instance, unmount the volume in the Charon host system before detaching it (see Steps on the Charon Host System below).

Then detach the volume from your instance:

Go to the Elastic Block Store volumes list.
Select the volume to be detached.
Use the menu Actions > Detach volume.

Steps on the Charon Host System

Mounting a Newly Attached Volume Using the Storage Manager (SSP AL only)

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

Open the Charon-SSP Manager on your local system and connect to your Charon cloud instance.
Select Tools > AWS Cloud > Storage Manager.
In the Storage Manager window, perform the following steps:
1. Select the new device.
2. Click on the cog-wheel symbol.
3. Only if required, select Format Volume to create a filesystem on the new device.
  Please note: This will delete all data on the volume.
4. Click on the cog-wheel symbol and select Mount the Filesystem.

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

Charon in the AWS Cloud - Getting Started > Storage Management > storage-manager.png

Please note: The device on the host system is called /dev/xvdf (XEN virtual block device). This is equivalent to an /dev/sdf volume shown in AWS. The device naming depends on the instance type and the kernel storage drivers. For example, a device may be presented to LInux as a nvme device as well.

Once the filesystem has been mounted, the space is available to the Charon-SSP host system. After the first mount via the Storage Manager, the filesystem will be automatically mounted after a restart of the Charon host instance.

Mounting a Newly Attached Volume Manually

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 AL images:
- In Charon Manager go to Tools > AWS 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.

Contents