attach-disk

Attaches an existing iSCSI disk to some system

This command adds a virtual disk that is exported by an iSCSI server to a system managed by Cloudmin, typically a Xen or KVM instance. The iSCSI server must be selected with the --iscsi-host flag, and must be already registered with Cloudmin. The target on the iSCSI server must be selected with the --iscsi-target flag.

If the virtual system does not already have any iSCSI disks, a username and password for connecting to the iSCSI server must be specified with the --iscsi-user and --iscsi-pass flags respectively.

The system to add the disk to is specified with the --host parameter. The device file on the virtual system can either be set with --virt followed by a device name, or you can use --auto-virt to have Cloudmin choose an un-used device.

If you want the new disk formatted with a filesystem, use the --format flag followed by a type like ext3. To have it mounted on the virtual system, use --mount flag followed by a mount point like /mnt/disk2.

For some virtualization types, you can specify if the disk is a hard disk or CD-ROM with the --media flag. This allows you to attach an existing ISO image as a CD, which will appear as a actual CD-ROM drive within the virtual system. On KVM the supported media types are disk and cdrom.

Some virtualization types allow you to specify the caching type for the disk image with the --cache flag, followed by a mode like on or off or writeback. This can be used to trade of disk performance for host memory usage.

If possible, Cloudmin will add the new disk to a running system and mount it on the specific directory. However, in some cases this may not be possible without rebooting the system - to have this done automatically, use the --reboot flag.

Example usage

  cloudmin attach-disk --host kvmoniscsi.home --auto-virt --iscsi-host fudu.home --iscsi-target attachtest
  Attaching virtual disk for /dev/vdc ..
  .. done

Command Line Help

Attaches an existing iSCSI disk to some system.

cloudmin attach-disk --host hostname
                     --iscsi-host hostname
                     --iscsi-target name
                     --iscsi-user username
                     --iscsi-pass password
                     --virt device | --auto-virt
                    [--format filesystem]
                    [--mount directory|"swap"]
                    [--media type]
                    [--cache mode]
                    [--reboot]