Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: information added on disk resizing vs operating system

Anchor
TopUtilPageTOCTopUtilPage
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

Table of Contents
excludeTable of Contents

...

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

General Description

The "MkDskCmd" utility:

...

To start the utility open "cmd.exe" from Administrator in the Start menu and switch to the CHARON installation folder then the "\Build_XXX\xXX" child folder where the utility is located.

...

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

 

Creating disk images

The first step is to obtain the disk type of the disk that needs to be created:

...

For a list of all available parameters use the "–help" switch:


...> mkdskcmd -help

mkdisk for CHARON utility v. 1.17

Usage: mkdskcmd

Copyright: STROMASYS, 2017

Usage:
     mkdskcmd [Options]

   -t - please see the '-transform' options description
-transform <source_disk_name> <source_disk_params> - to transform the the disk image (change actual size)
   <source_disk_name> - the file name of the disk image to be transformed
<source_disk_params> - the name of the disk from the list of available at the Disk table
   The source disk size will changed accordingly the reach the specified parameters.
To specify the transform parameters manually, follow the option below:
   -transform <source_disk_name> -blsize <number> -blcount <number>
  -shrink - parameter which needs to be EXPLICITLY provided, if the disk size is to be decreased
-k - parameter which needs to be EXPLICITLY provided, if the disk size is to be decreased
Return value:
   0        - for Success
   Non zero - in case of failure

Examples:
mkdskcmd -help
mkdskcmd -list
mkdskcmd -avtable \etc\mkdsk.vtable -output "\etc\rk07.vdisk" -disk rk07
mkdskcmd -output \etc\disks\custom.vdisk -blsize 512 -blcount 16384
mkdskcmd -t

Options:

-help - to see help screen -h - to see help screen -output <full name> - to specify output file name -o <full name> - to specify output file name -disk <disk name> - to specify the disk name from Disk table -d <disk name> - to specify the disk name from Disk table -blsize <number> - to specify the block size in bytes (custom disk image) -z <number> - to specify the block size in bytes (custom disk image) -blcount <number> - to specify number of the blocks (custom disk image) -c <number> - to specify number of the blocks (custom disk image) -avtable <full_name> - to specify AVDISK table file -a <full_name> - to specify AVDISK table file -list <full_name> - to display AVDISK table -l <full_name> - to display AVDISK table -silent - silent mode running -s - silent mode running


    -h, -help - display help screen

    -o, -output <file> - specify output file name

    -d, -disk <name> - specify the disk name from Disk table

    -z, -blsize <value> - specify the block size in bytes (custom disk image)

    -c, -blcount <value> - specify number of the blocks (custom disk image)

    -a, -avtable <file> - specify AVDISK table file

    -r, -resize <file> [<disk-name>]
           - resize the disk image
       <file> - file name of the disk image to be resized
       <disk-name> - name of the disk from the Disk table

      <file> will either have the specified number of blocks added to the
      end or be truncated at the new smaller size.

      To specify a custom disk size, use the following parameters:
      -resize <file> -blsize <value> -blcount <value>

   -s, -shrink - mandatory parameter when resizing to smaller disk

   -l, -list - to display AVDISK table

   -q, -quiet - run in quiet mode

Return value:
   0 - Success
   Non zero - Failure

Examples:
mkdskcmd -help
mkdskcmd -list
mkdskcmd -avtable mkdsk.vtable -output rk07.vdisk -disk rk07
mkdskcmd -output disks\custom.vdisk -blsize 512 -blcount 16384
mkdskcmd -r E:\disks\rz22.vdisk

rz59

-a

"C:\Program

Files\CHARON\disks\mkdsk.vtable"

The "-avtable" parameter is used to work with an alternative disk specification database or to point to the standard database ("mkdsk.vtable") if it is in a location other than the current directory.

The "-blcount" (blocks count) and "-blsize" (blocks size) switches are used to create custom disk images.

...

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

Div
classpagebreak

...


Resizing disk images

The "MkDskCmd" utility is able to transfer resize (copy) disk images of one type to a disk image of another type.

This operation is needed, for example, to obtain more free space on a disk image that already contains data.(warning)

Notes:

  • It is not possible to add more free space dynamically. The

...

  • virtual machine must be stopped before performing this operation.
  • Resizing a disk image requires the operating system running on the Charon virtual machine to be able to handle Dynamic Volume Expansion. Please refer to the documentation of your operating system version. If this is not supported, please create a new virtual disk then backup and restore the existing data.


Info

If a source disk image is larger than the target disk image, the extra data is lost. If the source disk image is smaller, it will be extended and padded with null bytes ('\0').

An example of the syntax follows:

...> mkdskcmd -transferresize <source disk file name> <source disk parameters> [-shrink] [-k]

...

  • <source disk file name> - the file name of the disk image to be transferredresized

  • <source disk parameters> - the disk type taken from the list of available disk types displayed by the "mkdskcmd -list" command or the disk geometry specification (see below).

  • -shrink or -k - used to force the shrink when the target disk size is smaller than the source disk size.


Example:

...> mkdskcmd -transferresize "C:\My Disks\rz22.vdisk" rz25

It is also possible to specify the disk parameters manually with "-blcount / -c" (blocks count) and "-blsize / -z" (blocks size) switches:

...> mkdskcmd -transferresize <source disk file name> -blsize <number> -blcount <number>

Example:

...> mkdskcmd -tr "C:\My Disks\custom.vdisk" -z 512 -c 262134

...

Warning

There is a certain delay between the moment when the utility reports that a disk image has been transferred resized and its actual availability to CHARON. This delay can reach up to several minutes in the case of very large disk transfersvery large disk resizes. This is because the host operating system needs time for the actual allocation of the enlarged file on HDD.

...

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