Linux - Driver Install - Real Port Coordinator

OVERVIEW

In order to get the Ethernet connected Real-Port Coordinator to communicate with the VersaVision software, you will need to install the drivers.

Prior to receiving the Coordinator, you will need to have either provided VersaCall with the Static IP information or have your IT team setup a DHCP Reserved IP Address.

When using a Static IP Address, the Coordinator will be pre-programmed before shipping from VersaCall.

When using a DHCP Reserved IP Address, VersaCall Technician will provide you with the MAC Address prior to shipment.

The guide below will explain uploading the files via an SSH Client, feel free to use a different SSH Client or upload the files using the Terminal if you have physical access.

REQUIREMENTS

Computer/Server/VM must be loaded with Ubuntu Server 22.04 LTS.

IT must assign an Administrator level user name and password for VersaCall Installation/User.

Internet Access Required for the Installation process. Access can be removed after installation.

SSH Client is required if the User/Installer does not have physical access to the server.

Server/Computer/VM must have a Static IP Address or a DHCP Reserved IP Address.

Coordinator must have a Static IP Address or a DHCP Reserved IP Address.

Link for Driver file provided by VersaCall Technician.

TOOL TIP

There is specific Code that needs to be entered in on the steps below. The Paste function in Terminal works differently from Windows.

To Copy - select the Code/Text in the cell so that it is highlighted. Press the Control Key & C Key on your keyboard at the same time. Alternatively, you can right click on the highlighted text and select Copy from the pop-up menu.

To Paste - Right Click on the Cursor next to the User Prompt in the Terminal. The copied text will fill in automatically.

INSTRUCTIONS

Download the Real-Port driver file from the link provided by the VersaCall Technician.

For ease of navigation, we suggest downloading the file to your Downloads folder.

After the download has been completed, you will see the driver file in the folder.

The icon will look like a Zip file icon.

The driver file will need to be uploaded to the Linux, Windows WSL or Red Hat Computer/Server/VM.

Our guide will show using an FTP inside of an SSH Client.

Upload all files to the /home/<username> location.

The driver file should now show in the VersaVision Computer/Server/VM.

Open the Terminal on the VersaVision Computer/Server/VM.

Terminal can be accessed on the physical Computer/Server/VM or by using an SSH Client.

Copy the Code/Text from the cell below.

sudo apt-get install devscripts

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

You will be prompted for a Y or N response to continue with the install.

Press the letter Y and press the Enter key to continue.

Depending on the system, there could be many updates to install which will take some time to complete.

Once the updates are installed/completed, Copy the Code/Text from the cell below.

sudo apt-get install debhelper

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

You will be prompted for a Y or N response to continue with the install.

Press the letter Y and press the Enter key to continue.

Copy the Code/Text from the cell below.

sudo apt-get install ncurses-dev

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

sudo tar xvfz 40002086_AB.tgz

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

cd ./dgrp-1.9

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

./configure

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

sudo make all

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

sudo make install

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Copy the Code/Text from the cell below.

sudo make postinstall

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

Before copying this code, you will need to know the Static or DHCP Reserved IP Address that has been assigned to the Coordinator.

This step will assign a port for the Coordinator IP Address.

If the IP Address is entered incorrectly, VersaVision will not be able to communicate with the Coordinator.

Copy the Code/Text from the cell below.

dgrp_cfg_node init RP <coordinator ip address here> 01

Paste the Code/Text into the Terminal.

Replace the "<coordinator ip address>" section of the code with the Static or DHCP Reserved IP Address assigned to the Coordinator.

Press the Enter key on your keyboard after the Code/Text is pasted in and the IP Address has been entered.

You will need to verify that the port created is connected to the Real-Port Coordinator.

Copy the Code/Text from the cell below.

sudo dpa.dgrp

Paste the Code/Text into the Terminal.

Press the Enter key on your keyboard after the Code/Text is pasted in.

The digi connection portal interface will load.

Press any key on your keyboard to continue.

The Digi Port Authority interface will load and the RP Port that was added will display.

Verify that the Port Status shows as Connected.

You should see that the port shows as connected - proceed to the next step of adding the Coordinator to VersaVision.

If the system does NOT show as connected, ensure the device is powered and plugged into the network.

Please contact VersaCall for assistance if you cannot resolve the connection.

Press the ESC key on your keyboard to exit the Digi Port Authority interface.

You will be returned to the Terminal.

Close the Terminal if you are using an SSH Client.

Move on the next installation step - Adding the Remote Coordinator to VersaVision.

---