Digi IX14 User manual

IX14
User Guide

Revision history—90002291
Revision Date Description
A January 2019 Initial release of DigiIX14 firmware version 19.1.
B September 2019 DigiIX14 firmware version 19.8 release.
Trademarks and copyright
Digi, Digi International, and the Digi logo are trademarks or registered trademarks in the United
States and other countries worldwide. All other trademarks mentioned in this document are the
property of their respective owners.
© 2019 Digi International Inc. All rights reserved.
Disclaimers
Information in this document is subject to change without notice and does not represent a
commitment on the part of Digi International. Digi provides this document “as is,” without warranty of
any kind, expressed or implied, including, but not limited to, the implied warranties of fitness or
merchantability for a particular purpose. Digi may make improvements and/or changes in this manual
or in the product(s) and/or the program(s) described in this manual at any time.
Warranty
To view product warranty information, go to the following website:
www.digi.com/howtobuy/terms
Customer support
Gather support information: Before contacting Digi technical support for help, gather the following
information:
Product name and model
Product serial number (s)
Firmware version
Operating system/browser (if applicable)
Logs (from time of reported issue)
Trace (if possible)
Description of issue
Steps to reproduce
Contact Digi technical support: Digi offers multiple technical support plans and service packages.
Contact us at +1 952.912.3444 or visit us at www.digi.com/support.
IX14 User Guide 2

IX14 User Guide 3
Feedback
To provide feedback on this document, email your comments to
[e-mail]
Include the document title and part number (IX14 User Guide, 90002291 ) in the subject line of your
email.

Contents
What's new in Digi IX14 version 19.8
Digi IX14 hardware reference
IX14 features and specifications 12
IX14 front view 12
IX14 back view 12
IX14 power supply requirements 13
IX14 LEDs 13
Digi IX14 serial connector pinout 14
IX14 accessory kits 14
IX14 antennas 15
IX14 quick start
Quick start with Digi Remote Manager mobile app
Step 1: What's in the box 17
Step 2: Gather accessories 17
Step 3: Connect hardware 18
Step 4: Quick setup using the Digi Remote Manager mobile app 19
Next steps 19
Quick start with IX14 local WebUI
Step 1: What's in the box 20
Step 2: Gather accessories 20
Step 3: Connect hardware 21
Step 4: Sign up for Digi Remote Manager 22
Step 5: Access the IX14 local web interface 22
Step 6: Configure cellular connection using the web interface 23
Step 7: Add your IX14 to your Digi Remote Manager account 23
Next steps 24
Hardware setup
Install SIM cards 26
Attach and position antennas 26
Connect the WAN/ETH1 port 27
IX14 User Guide 4

IX14 User Guide 5
Connect the serial port 27
Power on the IX14 27
Configuration and management
Review IX14 default settings 29
Reset default password for root 29
Configuration Options 30
Using the Digi Remote Manager 31
Access the Digi Remote Manager 31
Using the web interface 31
Log out of the web interface 31
Using the command line 32
Access the command line interface 32
Log in to the command line interface 32
Exit the command line interface 33
Initial configuration
Configure cellular modem APNs 35
Change the default LAN subnet 37
Change the LAN address type 38
Configure SIM PIN 39
Configure system settings 39
Enable or disable Bluetooth service 46
User authentication
About IX14 user authentication 49
Configure user authentication methods 49
Change the predefined authentication method 50
Add a new authentication method 51
Delete an authentication method 53
Rearrange the position of authentication methods 54
Configure authentication groups 57
Add an authentication group 57
Change the access rights for a predefined group 61
Delete an authentication group 62
Local users 64
Change a local user's password 64
Configure a local user 65
Delete a local user 71
Terminal Access Controller Access-Control System Plus (TACACS+) 73
TACACS+ user configuration 73
TACACS+ server failover and fallback to local authentication 74
Configure your IX14 device to use a TACACS+ server 74
Remote Authentication Dial-In User Service (RADIUS) 78
RADIUS user configuration 78
RADIUS server failover and fallback to local configuration 79
Configure your IX14 device to use a RADIUS server 79
Set the idle timeout for IX14 users 82
Example user configuration 84
Example 1: Administrator user with local authentication 84

IX14 User Guide 6
Example 2: RADIUS, TACACS+, and local authentication for one user 85
Firewall
Firewall configuration 91
Create a custom firewall zone 91
Configure the firewall zone for a network interface 92
Show firewall zones 93
Delete a custom firewall zone 95
Configure port forwarding 96
Enable or disable a port forwarding rule 99
Show port forwarding rules 101
Delete a port forwarding rule 102
Configure packet filtering 104
Enable or disable a packet filtering rule 107
Show packet filtering rules 108
Delete a packet filtering rule 109
Configure custom firewall rules 111
Configure Quality of Service options 112
Enable the preconfigured bindings 112
Create a new binding 114
System administration
Review device status 117
Configure system information 118
Update system firmware 119
Manage firmware updates using Digi Remote Manager 119
Certificate management for firmware images 120
Update the system firmware from the WebUI 120
Update cellular module firmware 122
Reboot your IX14 device 122
Reboot your device immediately 122
Schedule reboots of your device 123
Reset the device to factory defaults 124
Configuration files 126
Save configuration changes 126
Save configuration to a file 127
Restore the device configuration 128
Schedule system maintenance tasks 130
Create a Virtual LAN (VLAN) route 135
Example: Configure VPN access with IPSec tunnels 137
Task One: Configure the Tunnel 137
Task two: Configure the firewall 138
Serial port 143
Configure the serial port 143
Show serial status and statistics 145
Services
Allow remote access for web administration and SSH 148
Configure the web administration service 149
Configure SSHaccess 155

IX14 User Guide 7
Use SSH with key authentication 160
Generating SSH key pairs 160
Configure telnet access 162
Configure DNS 166
Simple Network Management Protocol (SNMP) 172
SNMP Security 172
Configure Simple Network Management Protocol (SNMP) 172
Use the SNMP service 176
System time 176
Configure the system time 177
Network Time Protocol 179
Configure the device as an NTP server 179
Configure a multicast route 184
Enable service discovery (mDNS) 186
Applications
Configure applications to run automatically 191
Task one: Upload the application 191
Task two: Configure the application to run automatically 192
Run a Python application at the shell prompt 196
Start an interactive Python session 197
Digidevice module 199
Use digidevice.cli to execute CLI commands 200
Use digidevice.datapoint to upload custom datapoints to Remote Manager 201
Use digidevice.config for device configuration 203
Use Python to respond to DRM SCI requests 205
Use digidevice runtime to access the runtime database 212
Central management with Digi Remote Manager
Digi Remote Manager support 217
Configure Digi Remote Manager 217
Collect device health data and set the sample interval 219
Log into Digi Remote Manager 220
Use Digi Remote Manager to view and manage your device 221
Add a device to Digi Remote Manager 222
View Digi Remote Manager configuration and connection status 222
Use the Digi Remote Manager mobile app 223
Configure multiple devices using profiles 224
Learn more 224
Monitoring
Enable IntelliFlow 226
System resources chart 227
Top data users chart 228
Top servers accessed chart 229
Data over time chart 229
Port usage chart 230
Change chart view options 230
Export chart to PNG 231
Print a chart 231

IX14 User Guide 8
Configure NetFlow Probe 231
Diagnostics
Generate a support report 236
View event and system logs 237
Configure syslog servers 239
Configure options for the event and system logs 240
Analyze network traffic 245
Start capturing packets 245
Define filters for capturing data traffic 246
Example filters for capturing data traffic 246
Show captured traffic data 247
Save captured data traffic to a file 248
Download captured data to your PC 249
Clear captured data 249
Use the ping command to troubleshoot network connections 250
Ping to check internet connection 250
Stop ping commands 250
Use the traceroute command to diagnose IProuting problems 250
File system
File system 253
Display directory contents 253
Create a directory 253
Display file contents 254
Copy a file or directory 255
Move or rename a file or directory 255
Delete a file or directory 256
Upload and download files 257
Upload or download files using the Secure Copy command 257
Upload or download files using SFTP 258
Digi IX14 regulatory and safety statements
RF exposure statement 261
Federal Communication (FCC) Part 15 Class B 261
Radio Frequency Interference (RFI) (FCC 15.105) 261
European Community - CE Mark Declaration of Conformity (DoC) 261
CE mark (Europe) 261
Maximum transmit power for radio frequencies 263
Innovation, Science, and Economic Development Canada (IC) certifications 263
RoHS compliance statement 264
Safety statements 264
Special safety notes for wireless routers 265
Product disposal instructions 266
Command line interface
Access the command line interface 269
Log in to the command line interface 269
Exit the command line interface 270

IX14 User Guide 9
Execute a command from the web interface 270
Display help for commands and parameters 271
The help command 271
The question mark (?) command 271
Display help for individual commands 272
Use the Tab key or the space bar to display abbreviated help 273
Auto-complete commands and parameters 273
Available commands 274
Use the scp command 275
Display status and statistics using the show command 276
show config 276
show system 277
show network 277
Device configuration using the command line interface 278
Execute configuration commands at the root Admin CLI prompt 278
Display help for the config command from the root Admin CLI prompt 278
Configuration mode 280
Enable configuration mode 280
Enter configuration commands in configuration mode 280
Save changes and exit configuration mode 281
Exit configuration mode without saving changes 281
Configuration actions 281
Display command line help in configuration mode 282
Move within the configuration schema 285
Manage elements in lists 285
The revert command 288
Enter strings in configuration commands 289
Example: Create a new user by using the command line 290
Command line reference 292
cp 293
ls 294
mkdir 295
modem at 296
modem at-interactive 297
modem pin change 298
modem pin disable 299
modem pin enable 300
modem pin status 301
modem pin unlock 302
modem puk status 303
modem puk unlock 304
modem reset 305
modem sim-slot 306
more 307
mv 308
ping 309
reboot 310
rm 311
scp 312
show arp 313
show cloud 314
show config 315
show dhcp-lease 316
show event 317
show ipsec 318

IX14 User Guide 10
show log 319
show manufacture 320
show modem 321
show network 322
show openvpn client 323
show openvpn server 324
show route 325
show serial 326
show system 327
show version 328
show wifi ap 329
show wifi client 330
system backup 331
system factory-erase 332
system restore 333
system support-report 334
traceroute 335
update firmware 338