Installing SRC on Linux

Installing the SRC on Linux

Provisioning Your TagNet System

Prior to installation of the SRC it is best to provision your TagNet server. This involves creating the necessary profiles so that the SRC can immediately sync with the server and start reading tags. At a minimum, a Physical Reader and Logical Reader profile must be created that uses the same Reader ID that is configured on the SRC. For a triggered deployment, Event Scripts will need to be configured as well. Refer to the QuickStart section on how to create the required configuration objects for an SRC to operate with or without a GPIO trigger.

Things You Will Need

1.A Smart Reader Client (SRC) supported device. See the supported devices section for more details.

2.SSH access to the device along with Internet access. If this a new Raspberry Pi follow these steps to flash the device.

3.Web access to your TagNet server instance.

4.Access to a reader and GPIO if using an external SRC host.

5.If this is a brand new Pi device, you will need to install the Raspbian OS as detailed here.

Debian Linux

The following instructions apply to the ThingMagic Sargas/IZAR reader and Raspberry Pi SRC host, which both run a distribution of Debian Linux. Also note that Ubuntu 16.4 supporting Systemctl service control will work as well. If this is a first-time setup you may want to provision your TagNet server prior to performing these steps so it is ready to communicate with the SRC when installation is complete. Additionally, if you are deploying to a Raspberry Pi or other host device you will need to configure your reader (and GPIO if setting up a triggered model). These steps will work for both new installations and upgrades. For new installations, you will be prompted to enter in basic reader information, and for upgrades the existing parameters will remain in place.

1.Connect to the device using PuTTY or another SSH client. Be sure to login with an account that has root access – the default login for a Sargas is debian/rootsecure and the default password for a Raspberry Pi is pi/raspberry.

2.From the terminal, enter the following command:

sudo bash -c "$(wget -O - http://download.stratumglobal.com/src/setup.sh)"

3.Upon executing the above command, the SRC setup script will be brought down to the device and immediately executed. During the first part of the installation all the required software will be downloaded. This includes the SRC application files, the Java runtime, and any required firmware upgrades (if deploying to a Sargas).

4.If this is a first time install you will be prompted to enter in several SRC configuration parameters. The first prompt will be to enter the TagNet server IP address. This will be the external IP address of your TagNet server that the SRC will be able to reach. Be sure to prefix the IP with http://.

5.Once the server IP address has been entered another prompt will ask for the Location ID. This is the ID of the Logical Reader linked with your Physical Reader. If a your TagNet server has not yet been provisioned now would be a good time to do so.

6.The next prompt will be for the Reader ID. This is the ID of the Physical Reader that you wish to link with the this SRC.

7.Once all parameters have been entered the SRC service will start. If this is a Sargas and the firmware has been upgraded, the device will reboot and the SRC will begin at start up.

8.To quickly verify if the services started successfully, run the following command. If the service is not active at this point refer to the useful commands section of this document.

systemctl status tagnet-src.service

Useful Shell Commands

Below are several useful shell commands that will assist for administration and troubleshooting:

Check service status	sudo systemctl status tagnet-src.service
Restart the SRC	sudo systemctl restart tagnet-src.service
Start the SRC	sudo systemctl start tagnet-src.service
Stop the SRC	sudo systemctl stop tagnet-src.service
Disable the SRC	sudo systemctl disable tagnet-src.service
Enable the SRC	sudo systemctl enable tagnet-src.service
Monitor reader log	f
Modify Basic Settings	sudo bash /opt/stratumglobal/src/setup_props.sh
Edit Full Settings	To gain full access to all settings, open the parameters file in a text editor with this command sudo nano /opt/stratumglobal/src/reader_profile.txt After making any desired changes, press Ctrl-X to close the file. If any changes were detected, press Y to save them and N to discard them. If saving changes, press Enter to accept the filename
Shut down SRC and Reader	1) Ensure the Queue sub-folder is built 2) the tagnet-src.service needs to be disabled 3) Start the service as normal 4) Issue this cmd set to stop reader + ending the service curl http://localhost:54000 && sleep 2 && sudo systemctl stop tagnet-src.service 5) option when changing reader properties on the fly curl http://localhost:54000 && sleep 2 && sudo systemctl restart tagnet-src.service
Edit Network Settings	sudo nano /etc/network/interfaces
Assign Pi Host name	sudo nano /etc/hostname
Edit Network Settings	sudo nano /etc/dhcpcd.conf

Supported Devices

ThingMagic Sargas

The Sargas supports an onboard SRC deployment with firmware levels 5.1.3 or higher. The SRC installer will update the firmware if needed.

Raspberry Pi

The Raspberry Pi IoT Board can be used as an external SRC host. Below are the current supported details:

Raspberry Pi Model 3

Raspbian Jessie Lite Kernel Version 4.4

TRENDnet USB 3.0 to Gigabit Ethernet LAN TU3-ETG with ASIX AX88179 Chipset

Zebra FX7500 RFID Reader

ADAM 6060 GPIO

Before the SRC should be installed on the Pi, the SRC profile should be provisioned on your TagNet server, and the FX7500 reader and ADAM 6060 GPIO should be configured with static IP addresses. By default, the SRC will configure the USB to Ethernet adapter to a static IP address of 192.168.253.2 – which means the FX7500 and ADAM 6060 should be configured with an address in that same subnet. Below are the suggested IPs to use when configuring these devices:

FX7500/FX9600 (Host IP Address in TagNet Physical Readers): 192.168.253.3

ADAM 6060 (GPIO IP Address in TagNet Physical Readers): 192.168.253.4

It is important to note that the IP address of the SRC appliance does not have to match any configuration on the TagNet Server. As it is acting as a broker between the reader and the Server, as it long as it matches the subnet of the LTE gateway or local switch.

When using dataplicity, to get full root access type in 'su pi', and then when prompted enter in your pi Password (e.g. 'raspberry')

Installing the SRC Heartbeat

In order for the SRC to log any errors, the following script needs to be installed on the SRC device, Copy and paste the text below

1.Connect to the device using Putty or another SSH client. Be sure to login with an account that has root access – the default login for a Sargas is debian/rootsecure and the default password for a Raspberry Pi is pi/raspberry.

2.From the terminal, enter the entire following command:

cd /opt/stratumglobal/ && sudo rm -f src_status_client_dev.py && curl http://download.stratumglobal.com/src-status/cron-setup-dev.sh | bash && sudo wget http://download.stratumglobal.com/src-status/src_status_client_dev.py

3.From the terminal, enter the following command:

sudo nano /opt/stratumglobal/src_status_client_dev.py

❖ Note that in this editor, you must scroll down using the arrow keys to make changes to a given line.

❖After making any desired changes, press Ctrl-X to close the file. If any changes were detected, press Y to save them and N to discard them. If saving changes, press Enter to accept the filename

❖Ensure that the heartbeat job is scheduled to report at intervals consistent with what the server is expecting. For example if the SRC client is reporting every (5) minutes then the server SRC heartbeat threshold value should be set to (6) minutes. If it is less in will then be issuing erroneous email alerts. This time parameter s managed by the Unix cron utility that runs based on commands specified in a cron table (crontab). to list what user jobs are use the crontab -l command as shown below.

❖To edit the cron table value use the crontab -e command as shown below. In the example the wakeup time is (5) minutes

❖The software utility cron is a time-based job scheduler in Unix-like computer operating systems. Users that set up and maintain software environments use cron to schedule jobs to run periodically at fixed times, dates, or intervals

Flashing your Raspberry Pi

The instructions below provide steps for flashing and configuring a Raspberry Pi for a base SRC installation.

Hardware BOM:

❖Raspberry Pi 3

❖5V 2.5A Power Supply

❖Cat 5 or 6 network cable

❖8GB Class 10 SD Card

❖Eleduino Aluminum Case (or other enclosure)

❖TRENDnet USB 3.0 to Ethernet ASIX AX88179 Chipset (optional for local reader comms)

❖OS: Raspbian Lite 2017-03-02 Kernel Version 4.4 (other versions will likely work but have not been fully tested)

Raspberry Flashing Steps:

1.Download and unzip the Raspbian OS image

2.Download Etcher (this will be used to flash the image to SD card)

3.Download Putty

4.Plug in the SD card to your PC and verify it is formatted with a FAT32 file system. If not, use Disk Management to format the SD card

5.Launch Etcher and flash the OS to the SD card

6.Once the image has been flashed, create an empty file called "ssh" in the boot partition. open a DOS shell and use the command [type nul > D:/ssh] (replace the drive letter with whatever Windows has assigned the SD card). This will enable SSH connections.

7.Seat the Micro SD card in the Pi device

8.Connect the power supply and network cables

9.Determine the device IP address by running a network scan or checking the DHCP server. The default host name will be "raspberrypi"

10.Launch PuTTY and SSH to the device using the IP address

11.Execute sudo raspi-config and configure the following:

•Password

•Hostname

•Expand the disk

•Install any updates

•Reboot the device

11.Dataplicity is a great tool for remote access

12.Continue on with the SRC installation and configuration steps found here