Versions Compared

Old Version 3

changes.mady.by.user Bruno Miretti

Saved on

compared with

New Version Current

changes.mady.by.user Kirill Nikolaev (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: NetworkManager note is added

Anchor
TopUtilPage
TopUtilPage

...

UtilityDescription
mkdskcmdUsed to create CHARON virtual disk containers of custom or standard types.
This utility also may be used to transfer virtual disks of one type to virtual disks of another type.
hasp_srm_viewUsed to display the CHARON license contents, to collect the host system fingerprint and to transfer software licenses from one host to another.
hasp_updateSentinel standard utility used to retrieve Sentinel protection key information, detache a license from a Sentinel SL key and rehost a license from a Sentinel SL key
ncuUsed to dedicate a host interface to CHARON-VAX, to release it back to the host and to manage CHARON virtual interfaces (TAPs).
mtdUsed to create CHARON tape images from physical tapes and to write tape images back to physical tapes.

...

This command results in a list of all supported disk types.Choose the desired

Div
classpagebreak

 

Choose the desired disk (for example "RZ22"), then use the "mkdskcmd" command  to create the virtual disk image as shown below:

...

Back to Table of Contents

Div
classpagebreak

 

Transferring disk images

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

...

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

  • <source disk parameters> - the name of the disk from the list of available on "mkdskcmd --list" request or the disk geometry specification (see below).

Example:

$ mkdskcmd --transfer /etc/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 --transfer <source disk file name> -blsize <number> -blcount <number>

Example:

$ mkdskcmd -t /etc/custom.vdisk -z 512 -c 262134

...

Back to Table of Contents

Div
classpagebreak

 

"mtd" utility

The "mtd" utility is used to:

...

Back to Table of Contents

Anchor
hasp_srm_view
hasp_srm_view
"hasp_srm_view" utility

The "hasp_srm_view" utility displays content of CHARON-VAX license.

...

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

...

Div
classpagebreak

 


# hasp_srm_view -help

CHARON Sentinel HASP utility
Copyright: STROMASYS SA, 2013Options:
    -? or -h or -help - to see help screen
   -l - to see CHARON license details
   -c2v <C2V file> - to collect the key status information (C2V file)
   -fgp <C2V file> - to collect the host fingerprint information (C2V file)
   -tfr <LicenseID> <recipient file> - to transfer HASP SL license (V2C file)
   -tfr <LicenseID> - to remove HASP SL license (V2C file) from the local host
   -idf - to get transfer recipient (ID) file "recipient.id"

...

  1. Run "hasp_srm_view" utility on the "RecipientHost" with the following parameters to collect the host ID info:

    $ hasp_srm_view -idf

    The "recipient.id" file will be created in the current directory.
     

  2. Copy the "recipient.id" file to the "SourceHost".

    Info

    "recipient.id" is an ASCII file, so use the "ascii" option for FTP transfer.

           

  3. On the "SourceHost", open the "Sentinel Admin Control Center" (ACC) ( http://localhost:1947). Note the number of the software license you are going to transfer.
     

  4. Run the "hasp_srm_view" utility in the following way to create a transfer license for the host "RecipientHost":

    $ hasp_srm_view -tfr <license number> recipient.id

    The "license number" is the value collected at the step 3.

    Example of collecting a transfer license:

    $ hasp_srm_view -tfr 12345678 recipient.id

    A "<license number>.v2c" file will be created in the current directory. In the example above, the name of the transfer license will be "12345678.v2c"
     

  5. Copy the resulting "<license number>.v2c" file to the "RecipientHost".

    Info

    "<license number>.v2c" is an ASCII file, so use the "ascii" option for FTP transfer.

          

  6. On the "RecipientHost", open "Sentinel Admin Control Center" (ACC) (http://localhost:1947) and apply the "<license number>.v2c" file as  described above.

...

  1. Open "Sentinel Admin Control Center" (ACC) (http://localhost:1947). Note the number of the software license you are going to remove.
     

  2. Run the "hasp_srm_view" utility in the following way to remove the license:

    $ hasp_srm_view -tfr <license number>

    The "license number" is the value collected at the step 1.

    Example:

    $ hasp_srm_view -tfr 12345678

    The "<license number>.v2c" file will then be created in the current directory. In the example above the name of the transfer license will be "12345678.v2c"
     

  3. It is always possible to re-apply the created ".v2c" file to restore the deleted software license.

Back to Table of Contents

...

Div
classpagebreak

 

Anchor
hasp_update
hasp_update
"hasp_update" utility

The "ncu" hasp_update" is a Sentinel standard utility for license management included in CHARON-VAX kit.

To invoke the "hasp_update" utility, login as "root" and use the following syntax:

# hasp_update <option> [filename]

where:

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 (in case of 'u'pdate/attach)

Path to the C2V file
Optional: uses "stdout" if file name is not specified (in case of 'i'nfo)

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.

Back to Table of Contents

Anchor
ncu
ncu
"ncu" utility

The "ncu" ("Network Control Utility") is used to dedicate a host interface to CHARON-VAX, to release it back to the host and to manage CHARON virtual interfaces (TAPs).The utility allocates chosen network interfaces (both physical and virtual) and configures the offload parametersto the host and to manage CHARON virtual interfaces (TAPs).

The utility allocates chosen network interfaces (both physical and virtual) and configures the offload parameters.

Note

The NetworkManager service must be running in order to have all the functionalities enabled with "ncu". If the service is not enabled please configure the network using the manual operations described in the section "Manual configuration of CHARON networking" of the Installation chapter of this Guide.


Dedication of a host physical interface to CHARON

...

Specify the interface to dedicate to CHARON:eth1
Turning off offloading for eth1.. Please wait
Cannot change rx-checksumming
Could not change any device features
Actual changes:
tx-checksumming: off
tx-checksum-ip-generic: off
tcp-segmentation-offload: off
tx-tcp-segmentation: off [requested on]
tx-tcp-ecn-segmentation: off [requested on]
tx-tcp6-segmentation: off [requested on]
udp-fragmentation-offload: off [requested on]
Actual changes:
scatter-gather: off
tx-scatter-gather: off
tx-scatter-gather-fraglist: off
generic-segmentation-offload: off [requested on]
Cannot change tx-vlan-offload
Cannot change rx-vlan-offload

select action:
D - Dedicate to CHARON
R - Release to host
B - Create Bridge with TAPs
C - Destroy Bridge
S - Print status
E - Exit
:> S


Div
classpagebreak

 

Now the interface "eth1" is dedicated to CHARON-VAX:

...

# ncu

Interfaces Dedicated to State
---------- ------------ ------------
eth0       host         connected to host
eth1       CHARON       disconnected from host
lo         host         unmanaged to host

select action:
D - Dedicate to CHARON
R - Release to host
B - Create Bridge with TAPs
C - Destroy Bridge
S - Print status
E - Exit
:> R


Div
classpagebreak

 

Let's say that we want to return the interface "eth1" (currently dedicated to CHARON) back to host. To do that enter "R" or "r" then "eth1":

...

# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2014

Interfaces Dedicated to State
---------- ------------ ------------
eth0       host         connected to host
eth1       host         connected to host
lo         host         unmanaged to host
select action:
D - Dedicate to CHARON
R - Release to host
B - Create Bridge with TAPs
C - Destroy Bridge
S - Print status
E - Exit
:> B


Div
classpagebreak

 

Enter "B" or "b" to create a bridge between the host physical network adapter and the LINUX virtual network Interfaces (TAP) and specify the physical network interface ("eth1" in our example) and a number of the virtual network Interfaces to be created (2 in our example):

...

Back to Table of Contents

Div
classpagebreak

 

Removal of a virtual network

...