Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
excludeTable of Contents

General description

CHARON-AXP provides the following set of utilities:

...

All these utilities are invoked from Linux console command line.

 Back to Table of Contents

Anchor
mkdskcmd
mkdskcmd
'mkdskcmd' utility

Creating disk images

The "mkdskcmd" utility:

...

To get all the available parameters please use the "–help"switch:

mkdisk for CHARON utility v. 1.14
Copyright14Copyright: STROMASYS, 2015Usage2015Usage:
mkdskcmd [Options]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-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--list <full_name> - to display AVDISK table
-l <full_name> - to display AVDISK table--silent - silent mode running
-s - silent mode runningReturn runningReturn value:
0 - for Success
Non zero - in case of failureExamplesfailureExamples:
mkdskcmd -h
mkdskcmd -l
mkdskcmd -a /opt/charon/utils/mkdsk.vtable -o /etc/rk07.vdisk -d rk07
mkdskcmd -o /etc/custom.vdisk -z 512 -c 16384
mkdskcmd -t /etc/rz22.vdisk rz25 -a /opt/charon/utils/mkdsk.vtable
mkdskcmd -t /etc/rz22.vdisk rz25 -a /opt/charon/utils/mkdsk.vtable -z 512 -c 262134

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).

...

Warning

There is a certain delay between the moment when the utility reports that a disk image has been transferred and its actual availability to CHARON. This delay can reach to several minutes in case of very big disks transfers. It happens because the host operating systems needs some time for actual allocation of the enlarged file on HDD.

Back to Table of Contents

Div
classpagebreak


Anchor
mtd
mtd
'mtd' utility

The "mtd" utility is used to:

...

$ mtd /charon/tapes/tape1.vtape /dev/st5

Back to Table of Contents

Div
classpagebreak


Anchor
hasp_srm_view
hasp_srm_view
'hasp_srm_view' utility

The "hasp_srm_view" utility displays content of CHARON-AXP licenses.

...

Run the utility without any options to display the license details.

# hasp_srm_view -helpCHARON helpCHARON Sentinel HASP utility
Copyright: STROMASYS, 2016Options2016Options:
-? or -h or -help - to see help screen-l - to see CHARON license details (for default key)
-all - to see CHARON license details (for all available keys)
-key <key number> - to see CHARON license details (for specific key)-c2v <C2V file> - to collect the key status information (C2V file)
-fgp <C2V file> - to collect the host fingerprint information (C2V file)

The specific type of CHARON license defines what switches may be used in each case.

...

# ssh root@CHARON_HOST /opt/charon/bin/hasp_srm_view -c2v /opt/charon/bin/my_hasp_key.c2v
# ssh c2v# ssh root@CHARON_HOST /opt/charon/bin/hasp_srm_view -fgp /opt/charon/bin/my_host_fingerprint.c2v

...

To collect license text to an output file on host server:

# ssh root@localhost /opt/charon/bin/hasp_srm_view > /opt/charon/bin/hasp_srm_view.txt

The "hasp_srm_view" utility always reports the ID and IP address of the host(s) where active licenses are found.

...

ParameterValueDescription
<option>uUpdates a Sentinel protection key / attaches a detached license
iRetrieves Sentinel protection key information
dDetaches a license from a Sentinel Software License (SL) key
rRehost a license from a Sentinel Software License (SL) key
hDisplay help
[filename]Path to the V2C/H2R file when used with the 'u' option

Optional path to the C2V file when used with the 'i' option

Uses "stdout" if file name is not specified

Example:

# hasp_update u license_update.v2c
Info

We recommend to use this tool only for "Update a Sentinel protection key / attach a detached license" function ("u" option). For the rest use "hasp_srm_view" utility.

...