USB License Dongle (Only for DFSI/ISSI)
To run a DFSI or ISSI Gateway, the license dongle must be plugged into a USB port accessible by the VM where the radio gateway will be deployed. This is not required for Telephony. If you are deploying a Telephony Gateway then skip to the Organizing Directories section.
To prepare for license dongle connection
1. Navigate to /etc/udev/rules.d/ and open z95_keylok.rules.
2. Verify the contents is identical to the following:
# KEYLOK Security Dongle Rules to remove root/su restriction
ATTRS{idVendor}=="07f2", ATTRS{idProduct}=="0001", MODE="0666"
ATTRS{idVendor}=="0471", ATTRS{idProduct}=="485d", MODE="0666"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="07f2", ATTRS{idProduct}=="0003", MODE="0666"
If the contents are not identical, or the file is missing, then run the following command:
sudo nano /etc/udev/rules.d/z95_keylok.rules
Use the following command to reload the keylok rules.
sudo udevadm control --reload-rules
When docker is run, LicenseStatusInd in the icegw.log file should be set to Valid. To ensure this execute command:
grep -E 'LicenseStatusInd' icegw.log
Output should appear as follows:
<-- LicenseStatusInd : Valid maxVoiceStreams 200 CSSI, 200 DFSI, 200 DFSI (via CAR), S/W crypto true, H/W crypto false, OTNR true, Phase 2 true
To connect the license dongle
Determine the address of the license dongle. This address must be provided in a specific format as shows below where <bus> and <device> must be replaced:
/dev/bus/usb/<bus>/<device>:/dev/bus/usb/<bus>/<device>
To determine the address of the license dongle, log in to the VM that you intend to host the Radio Gateway and enter the lsusb command. This command returns a list of all USB devices on the VM. The license dongle contains KEYLOK II as shown below:
iceadmin@ice:~$ lsusb
Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 003 Device 003: ID 07f2:0001 Microcomputer Applications, Inc. KEYLOK II
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 003: ID 8087:0aa7 Intel Corp. Wireless-AC 3168 Bluetooth
Use the Bus and Device ID for the license dongle and update the address as shown in the following example:
/dev/bus/usb/003/003:/dev/bus/usb/003/003
Save this string for future use.