FORT CLI Tools

This appendix describes the fort_cli_cfg tool, lists the commands it provides for listing devices and applying configurations and firmware, and explains how to install fort_cli_cfg on a Linux computer.

Table 1. FORT CLI Tool
Tool	Use Case	Works Offline	Download Location
`fort_cli_cfg`	Loading a configuration from FORT Manager, updating firmware, rebooting a device, and the interactive device menu.	No. Loading a configuration requires connectivity to FORT Manager.	The Downloads card on the Firmware page in FORT Manager. For more information, see Loading A Configuration with the CLI Tool.

FORT CLI Configuration Tool

You can use the FORT CLI Configuration tool (fort_cli_cfg) on a Linux computer to:

Load a configuration onto a FORT device.
Update device firmware.
Reboot a device.
Spawn an interactive menu for a device.

This appendix explains how to download and install the CLI Configuration tool and provides an overview of its functions.

Note:

fort_cli_cfg versions 3.8.0 and older used pip to install Python packages. Newer versions are standalone scripts installed directly into the system outside of pip. The next section provides current installation instructions. If you are installing a pre 3.8.1 version, use the Legacy Installation instructions.

Download and Install the CLI Configuration Tool

To install and use the CLI Configuration tool you need the following items:

Linux computer running Debian 11 or 12, or Ubuntu 20, 22, or 24 with Ethernet networking capability.
Latest FORT CLI Configuration Tool installation package (fort_cli_cfg-<version>.zip).
The Python Package installer (pip) is installed in your environment. Only required if you have a previously installed version of the tool (3.8.0 or older) that you must uninstall.

To download & install fort_cli_cfg

Download the tool from FORT Manager:
1. Launch FORT Manager and enter your username and password when prompted.
2. Click Firmware in the left navigation pane.
3. In the Downloads card, click CLI Tool and note the version shown on the button (requires DeviceManager or Admin role).
4. FORT Manager downloads the file: fort_cli_cfg-<version>.zip to the Downloads folder on your computer.
Copy the installation package fort_cli_cfg-<version>.zip from the Downloads folder on your Windows or Linux computer (depending on which system you are running FORT Manager) to a location on your Linux computer.
If you have installed a previous version of the tool where version≤3.8.0, you must uninstall the old version now before you can install the new one; open a terminal and enter the following command:
```
pipuninstallfort_cli_cfg
```
Open a new terminal on your Linux computer, navigate to the directory containing the installation package, and unzip it.
Run the installation script:
```
./install.sh
```
If the installation script fails, give it execution permissions with the following command:
```
chmod+xinstall.sh
```
When prompted, type y to add ~/.local/bin/ to your PATH.

The installer copies fort_cli_cfg to ~/.local/bin/ and makes it available system-wide if you answered yes to the prompt.

To verify installation:

fort_cli_cfg-\-version

If you see the version displayed, the tool is ready to use.

To see a list of all options:

fort_cli_cfg-\-help

To connect to an EPC device and access an interactive menu (Device Info, Reboot, etc.)

fort_cli_cfg-e192.168.3.10-m

Your IP address may be different.

To connect to an NXP device (SRCPro, WESPro, NSCPro) and access an interactive menu (Device Info, Reboot, etc.)

fort_cli_cfg-n/dev/ttyACM0-m

Your serial interface (/dev/ttyACM0) may be different.

Note:

For convenience, if you don’t specify a serial interface in the command, the CLI tool connects to the first FORT device it finds. Therefore, if you are connected to a single FORT (USB) device, you can simply run the following command to connect:

fort_cli_cfg -n

For step-by-step instructions on using this tool to load a configuration or update firmware, see:

Important:

If you are installing fort_cli_cfg version 3.8.0 or older, use the Legacy Installation instructions below.

Legacy Installation – fort_cli_cfg versions 3.8.0 and Older

Note:

These instructions are for fort_cli_cfg versions 3.8.0 or older. For newer versions, see Download and Install the CLI Configuration Tool.

To install and use the CLI Configuration tool you need the following items:

Linux computer running Ubuntu 20 with Ethernet networking capability.
Latest FORT CLI Configuration Tool installation package (fort_cli_cfg-<version>.zip).
The Python Package installer (pip) is installed in your environment.

Download the tool from FORT Manager:
1. Launch FORT Manager and enter your username and password when prompted.
2. Click Firmware in the left navigation pane.
3. Click Download CLI Tool Version: x.x.x (requires DeviceManager or Admin role).
FORT Manager downloads the file: fort_cli_cfg-<version>.zip to the Downloads folder on your computer.
Copy the tar archive file (fort_cli_cfg-<version>.tar.gz) from a directory on your Windows machine to the home directory on your Linux computer by using the secure copy command (scp):
1. Open a terminal on a Windows machine.
2. Type the following (replace the values in brackets with your values):
```
scpC:\\<myDir>\\fort_cli_cfg-<version>.tar.gzmuser1@<ipaddress>:/home/<username>
```
Open a terminal on your Linux machine.
Install the tool by using pip and the .tar file; navigate to the appropriate directory and use the following command:
```
pipinstall./fort_cli_cfg-<version>.tar.gz
```
Add yourself to the dialout user group so you won’t need sudo permission when using the fort_cli_cfg tool to access the serial device:
```
sudo usermod -a -G dialout $USER
```
Reboot your Linux machine .
To verify that the tool has been successfully installed and that you can run it, type the following command in a terminal window:
```
fort_cli_cfg-\-version
```
If you see the version displayed, the tool is ready to use.
If you get a command not found error, verify that your $PATH variable contains .local/bin, which is where pip installs applications. For example, in a terminal, type:
```
echo $PATH (Enter)
-bash: /home/user/.local/bin:/home/<username>/.local/bin:/usr/local/sbin: …
```
If .local/bin is not in your $PATH, add the following line to your .bashrc file:
```
exportPATH="$HOME/.local/bin:$PATH"
```
Restart the terminal.
To get help with the options for this tool, open a terminal and type:
```
fort_cli_cfg –-help
```