Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: RHEL6 support removed

...

  • Red Hat Enterprise Linux 8.x - 64bit
  • Red Hat Enterprise Linux 7.x - 64bit
  • Red Hat Enterprise Linux 6.5 to 6.10 - 64bit
  • Linux Centos 8.x - 64bit
  • Linux Centos 7.x - 64bit
  • VMware ESXi 5.5 and 6.0 up to 6.7 (requires a supported Linux operating system on top of a ESXi virtual machine)

...

  1. Login as the superuser ("root") on the host system. Because Sentinel HASP runtime relies on 32-bit compatibility libraries to run on Linux, the 32-bit compatibility libraries must be installed before continuing. If the emulator host has access to a package repository, either local or remote, use the following command:

    # yum install glibc.i686

    (info) Sometimes it is not possible to use an online repository for the installation of 32-bit glibc package. In this case the procedure described in the appendixes has to be used: glibc.i686 installation without Internet connection

    .

  2. Create a directory for the CHARON-AXP distribution as shown in the following example:

    # mkdir /charon_dist

    .

  3. On RHEL/CentOS 7 and 8, the "libev" package is required. If it is reported as missing during CHARON installation on RHEL 7/8, check that the repository "extras" is included and enabled, if not, include and enable it. Please refer to your Linux distribution administrator's guide.
    Example for RHEL 7.x:

    yum-config-manager --enable rhel-7-server-extras-rpms


Warning
titleWARNING
  • If you plan to install CHARON-VAX on the same server, both products, CHARON-AXP and CHARON-VAX, will have to be the same build number.
  • If you upgrade from a previous version of CHARON-AXP, please stop all running CHARON virtual machines and , uninstall CHARON products and reboot the Linux server (recommended) before proceeding with the installation steps described below.

...

Copy the download kit (in /tmp for example) to the folder created in the previous chapter:

# cp cp /tmp/charon-axp-<VER>-<BN>.<ZZ>.tar.gz /charon_dist# cd /charon_dist

where:

ItemDescription

VER

Version of CHARON-AXP product, for example 4.11

BN

Build Number of CHARON-AXP product, for example 20404

ZZ

CHARON-AXP target operating system identifier where:

  • ZZ = "el8" for CentOS/Red Hat Enterprise Linux 8
  • ZZ = "el74" for CentOS/Red Hat Enterprise Linux 7
  • ZZ = "el65" for Red Hat Enterprise Linux 6

Extract the contents of the distribution .tar.gz file to the current directory:

# cd /charon_dist
tar -xvzf charon-axp-<VER>-<BN>.<ZZ>.tar.gz

Example:

tar -xvzf charon-axp-4.11-20404.el74.tar.gz 

...

classpagebreak

...

The distribution directory contains the following RPM files:

File nameDescription
aksusbd-7.63-1.i386.rpmHASP Run-time
charon-axp-VER-BN.ZZ.x86_64.rpmCHARON-AXP

charon-license-VER-BN.ZZ.x86_64.rpm

CHARON Libraries

charon-mtd-VER-BN.ZZ.x86_64.rpmMTD utility

charon-utils-VER-BN.ZZ.x86_64.rpm

CHARON Utilities

Example:

# ls
aksusbd-7.63-1.i386.rpm
charon-axp-4.11-20404.el74.x86_64.rpm
charon-license-4.11-20404.el74.x86_64.rpm
charon-mtd-4.11-20404.el74.x86_64.rpm
charon-utils-4.11-20404.el74.x86_64.rpm

...

If "putty" terminal emulator is going to be used as an additional option copy the following file to your home directory:

# mkdir -p $HOME/.config/putty/sessions (if it does not already exist)
cp /opt/charon/putty/sessions/CHTERM-VT100 $HOME/.config/putty/sessions

...

usermod -G disk,tape,cdrom,dialout,lock -g tommy tommy


Div
classpagebreak


Re-login to apply changes.

...

  1. Invoke the system default web browser and enter the URL http://localhost:1947 to display the "Sentinel Admin Control Center" (ACC) web interface.
  2. Click on "Sentinel Keys" link to open the corresponding page.
  3. Make sure that one and only one CHARON HASP or SL license is present.

...

(info) To facilitate troubleshooting, Stromasys recommends to enable logging from the Sentinel Admin Control Center as described in this article: Enabling logging in Sentinel Admin Control Center.

ProblemAction
No license is displayedMake sure that all the recommendations above about remote access to the host are fulfilled (if remote access takes place), that the HASP USB key is not broken and its LED indicator is lit (meaning that it is used by the host).
Only one License key / SL is seen and its content is incorrectContact STROMASYS to request a new license update.
Several License keys / SLs are displayedRemove all of them except the one provided by STROMASYS for the just installed version of CHARON.

...

# ncu
CHARON Network Configuration Utility, 
STROMASYS (c) 2020 Version 1.6. Copyright (C) 2014-2019 STROMASYS SA.7


Interfaces Dedicated to State
---------- ------------ ------------
eth0         host         connected to host
eth1         host         disconnected from host
lo           host         unmanaged by host
virbr0-nic   bridge       unmanaged by bridge

==================================================================
bridge name bridge id          STP enabled   interfaces
==================================================================
virbr0     8000.5254004608c0  yes            virbr0-nic

==================================================================

select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit
:> 1

...

To choose an interface to be used for CHARON networking, do the following:

# ifconfigifconfig
eth0 Link encap:Ethernet HWaddr 00:60:52:0A:A9:1E
... 
eth1 Link encap:Ethernet HWaddr 00:C0:26:60:FB:15 
...
eth2 Link encap:Ethernet HWaddr 00:1A:92:E1:3F:7F

...

Determine what additional parameters are currently set to "on" on the host network adapter to be used by CHARON using the following command:

# eethtool -k <device>

Example:

# ethtool ethtool -k eth1
Offload parameters for eth1:
rx-checksumming: on
tx-checksumming: on
scatter-gather: on
tcp-segmentation-offload: off
udp-fragmentation-offload: off
generic-segmentation-offload: on
generic-receive-offload: off
large-receive-offload: off

Use "ethtool" to switch off all the offload parameters:

# e# ethtool -K <device> <parameter> off

Example:

# ethtool ethtool -k eth1
Offload parameters for eth1:
rx-checksumming: on
tx-checksumming: on
scatter-gather: on
tcp-segmentation-offload: off
udp-fragmentation-offload: off
generic-segmentation-offload: on
generic-receive-offload: off
large-receive-offload: off

...

Let's suppose the name of the file is "offload_off_eth1.txt". To execute it on system startup, execute the following command (example):

cat offload_off_eth1.txt >> /etc/rc.d/rc.local

...

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

Upgrade

...

from previous version

To upgrade an already installed CHARON-AXP kit to a more recent one:

  1. Ensure your license allows you to upgrade to that version. If not, please generate a C2V file and send it to STROMASYS for update. See CHARON-AXP for Linux utilities - 'hasp_srm_view' utility
  2. Prepare the new kit RPM files as it is described in "Before installation695402677" and "Distribution preparation695402677" sections.
  3. Stop all running CHARON-AXP instances.
  4. Make sure that no template files (i.e. "es40.cfg.template") have been used for your specific configuration otherwise copy those files to a dedicated folder.
  5. Login as "root" user.
  6. Remove the old CHARON-AXP version as described in the "CHARON-AXP for Linux deinstallation" chapter and reboot the Linux server (recommended).
  7. Proceed with the instructions on the new kit installation as described in the "695402677" section.Install
  8. Once installation is completed, it is recommended to reboot the Linux server (possible issues with licenses detection could occur).
  9. Install the license for the new CHARON-AXP as described in the "License installation695402677" section.

  10. Start all the CHARON-AXP services stopped at step #3.
Note

If you did not reboot your Linux server at step 6, you may experience issues with 'aksusbd' service installation and then license detection.

Example:

  Installing : aksusbd-8.13-1.x86_64 1/5
Failed to execute operation: Access denied
Failed to restart aksusbd.service: Access denied

To solve this problem, remove all Charon installed product and restart from step 6 above.

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