Perle Iolan SDS Cli Reference Manual

Hide thumbs Also See for Iolan SDS:

User manual (491 pages)

Reference manual (162 pages)

Cli reference manual (164 pages)

Table Of Contents

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

page of 187

/ 187
Contents
Table of Contents
Bookmarks

Table of Contents

Quick Links

Download this manual See also: Reference Manual, User Manual

IOLAN

SDS/SCS/STS/MDC

Command Line Interface

Reference Guide

Version A1.04.04.2017

Part #5500210-49 (Rev E)

April 2017

Table of Contents

Need help?

Do you have a question about the Iolan SDS and is the answer not in the manual?

Questions and answers

Summary of Contents for Perle Iolan SDS

Page 1: Command Line Interface
IOLAN SDS/SCS/STS/MDC Command Line Interface Reference Guide Version A1.04.04.2017 Part #5500210-49 (Rev E) April 2017...
Page 2 Markham, ON Canada L3R 0E1 Perle reserves the right to make changes without further notice, to any products to improve reliability, function, or design. Perle, the Perle logo, and IOLAN are trademarks of Perle Systems Limited. Perle Systems Limited, 2005-2017.
Page 3: Table Of Contents
Making a Technical Support Query ............16 Who To Contact ................. 16 Have Your Product Information Ready ..........16 Making a support query via the Perle web page ........ 16 Repair Procedure..................17 Feedback on this Manual............... 17 Chapter 1 Introduction............18 CLI Conventions ................
Page 4 Menu ......................21 Ping......................21 Resume....................21 Rlogin ...................... 21 Screen...................... 21 Set Termtype................... 22 Set User ....................22 Set User Session ..................23 Show Line Users..................24 SSH ......................24 Syslog Console..................25 Show Sessions ..................25 Show Termtype..................26 Start ......................
Page 5 Show Server.................... 45 Set Wlan ....................46 Add Wlan ....................51 Show Wlan ....................51 Delete Wlan ..................... 51 Set Wwan....................52 Show Wwan..................... 53 Set SSL Server..................53 Set Service ....................54 Set Web Manager..................55 Show Web-Manager ................55 Hardware Commands ..............
Page 6 Set Authentication RADIUS ..............67 Set Authentication TACACS+..............68 Set Authentication SecurID ..............69 Show Authentication................69 TruePort Baud Commands ............71 Set TruePort Remap-Baud..............71 Show TruePort ..................71 Email Commands............... 72 Set Email-Alert Server................72 Show Email-Alert Server................ 73 Clustering Commands...............
Page 7 Add Custom-IPv6..................83 Set Custom-IPv6 ..................84 Delete Custom-IPv6................84 IPv6 Router Advertisements ............. 85 Set IPv6-Router-Advertisement............. 85 Show IPv6-Router-Advertisement............85 Chapter 4 Line Commands..........86 1-Port vs. 2-Port+ Line Commands .......... 86 Line Commands ................. 86 Set Line....................86 Set Line Interface..................93 Set Line Service..................
Page 8 Set Line Initiate-Connection ..............116 Show Custom-App ................116 Show Interface ..................116 Show Power-Management ..............116 Show PPP....................116 Show Rlogin-Client................116 Show SLIP ..................... 116 Show SSH-Client .................. 116 Show Telnet-Client ................117 Show Modbus ..................117 Show UDP ..................... 117 Show Vmodem..................
Page 9 Set SNMP engine-id-string ..............126 Set SNMP inform-timeout ..............126 Set SNMP inform-retries ..............126 Show SNMP................... 126 TFTP Commands ..............126 Set Server TFTP..................126 SFTP Commands ..............127 Set Server SFTP..................127 Show SFTP.................... 127 Hosts Commands ..............128 Add Host....................
Page 10 Delete RIP....................133 Set RIP ....................133 Show RIP ....................134 Show RIP Peers ..................134 IPsec Commands ..............135 Add IPsec ....................135 Set IPsec....................135 Show IPsec.................... 138 IPsec ...................... 138 IPv6 Tunnels................138 Add IPv6tunnel ..................138 Set IPv6tunnel..................
Page 11 Set Timezone ..................146 Show Time..................... 146 Show Timezone ..................146 SNTP Commands..............147 Add SNTP ....................147 Delete SNTP ..................147 Set SNTP ....................147 Show SNTP ................... 148 Show SNTP-Info..................148 Time/Date Setting Commands ..........148 Set Date ....................148 Set Summertime ...................
Page 12 Snetload ....................154 Snetsave....................155 Custom Factory Default ............156 Netload ....................156 Snetload ....................157 Set ......................157 Keys and Certificates Commands.......... 158 Netload ....................158 Netsave....................159 Snetload ....................159 Snetsave....................161 MOTD Commands..............162 Set MOTD ....................162 Show MOTD ..................
Page 13 Show Routes..................166 Run-Time Statistics ..............166 Delete Arp....................166 Show Arp....................166 Show Serial ................... 166 Uptime ....................166 Chapter 10 I/O Commands ..........167 Global I/O Commands ............. 167 Set IO UDP..................... 167 Set IO Failsafe..................168 Set IO Modbus ..................168 Set IO Temperature-Scale..............
Page 14 Digital Output..................182 Digital Input................... 183 Relay ...................... 183 Analog Input..................183 Calibrating Analog Input (Analog/Temperature)....183 Calibrate Analog ................... 183 Reset Calibration .................. 183 Chapter 9 IOLAN+ User Commands ......184 IOLAN+..................184 Chapter 11 Power Commands ........185 Power Commands..............185 Glossary ................186...
Page 15: Preface
This typeface indicates a book or document title. About This Book for more This indicates a cross-reference to another chapter or information. section that you can click on to jump to that section. IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 16: Contacting Technical Support
Perle offers free technical support to Perle Authorised Distributors and Registered Perle Resellers. If you bought your product from a registered Perle supplier, you must contact their Technical Support department; they are qualified to deal with your problem. Have Your Product Information Ready...
Page 17: Repair Procedure
Contacting Technical Support Repair Procedure Before sending a IOLAN for repair, you must contact your Perle supplier. If, however, you bought your product directly from Perle you can contact directly. Customers who are in Europe, Africa or Middle East can submit repair details via a website form.
Page 18: Chapter 1 Introduction
Options—Provides an explanation of each of the options for a command and the default value if there is one. Some commands do not have any options, so this category is absent. IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 19: Command Shortcuts
CLI Conventions Command Shortcuts When you type a command, you can specify the shortest unique version of that command or you can press the key to complete the command. For example, the following command: set telnet-client map-to-crlf off can be typed as: set tel map off or, you can use the key to complete the lines as you go along:...
Page 20: Chapter 3 User Commands
Kill Session Description Kills an active session. User Level Restricted, Normal, Admin Syntax kill session 1|2|3|4 Options 1|2|3|4 The number of the session you want to kill. IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 21: Logout
Commands for Users Logged Into the IOLAN Logout Description Logs the user out from the IOLAN. User Level Restricted, Normal, Admin Syntax logout Menu Description Switches from a command line based interface to Menu mode of operation. User Level Restricted, Normal, Admin Syntax menu Ping...
Page 22: Set Termtype
Commands for Users Logged Into the IOLAN Set Termtype Description Sets the type of terminal being used for the current session. User Level Normal, Admin Syntax set termtype wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2| term3 Option wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2|term3 Specifies the type of terminal connected to the line: Dumb WYSE60 VT100...
Page 23: Set User Session
Commands for Users Logged Into the IOLAN routing Determines the routing mode used for RIP packets on the PPP and SLIP interfaces for this user. Values are: None—RIP packets are neither received nor sent by the IOLAN. Send—RIP packets can only be sent by the IOLAN. Listen—RIP packets can only be received by the IOLAN.
Page 24: Show Line Users
See Set SSH-Client in the IOLAN User’s Guide. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. strict-host-key-checking When enabled, a host public key (for each host you wish to SSH to) must be downloaded into the IOAN.
Page 25: Syslog Console
Commands for Users Logged Into the IOLAN authentication keyboard-interaction The user types in a password for authentication.Used for SSH2 only. compression Requests compression of all data. Compression is desirable on modem lines and other slow connections, but will only slow down things on fast networks. protocol Specify whether you are using SSH-1, SSH-2, or a combination of the two protocols, SSH-2, SSH-1.
Page 26: Show Termtype
Commands for Users Logged Into the IOLAN User Level Restricted, Normal, Admin Syntax show sessions Show Termtype Description Shows the terminal type for the current session. User Level Admin Syntax show termtype Start Description Starts a predefined session. Only inactive sessions are displayed. User Level Restricted, Normal, Admin Syntax start 1|2|3|4...
Page 27: Version
Configuring Users Defines the end-of-file character. When , entering the EOF character Line Mode as the first character on a line sends the character to the remote host. This value is in hexadecimal with a default value of (ASCII value erase Defines the erase character.
Page 28: Set Default User
Configuring Users Set Default User Description Configures the Default User. When adding a new user, the profile of the default user will be used to assign the values of the various parameters of the new user. For example if you set the parameter of the default user to , when a new user is added, service...
Page 29 Configuring Users framed-mtu Used for , specifies the maximum size of packets, in bytes, User Service PPP SLIP being transferred across the link. On noisy links it might be preferable to fragment large packets being transferred over the link, since there will be quicker recovery from errors. Depending on whether you have selected a , details are as User Service...
Page 30 Configuring Users level The access that a user is allowed: Admin—The admin level user has total access to the IOLAN. You can create more than one admin user account but we recommend that you only have one. They can monitor and configure the IOLAN. Normal—The Normal level user has limited access to the IOLAN.
Page 31: Set User
Configuring Users sess-timer The amount of time, in seconds, that the will run. Use this timer to Session Timer forcibly close a user’s session (connection). When the expires, the Session Timer IOLAN will end the connection. The default value is (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out).
Page 32 Configuring Users framed-compression Used for , determines whether Van Jacobsen Compression is User Service PPP SLIP used on the link. VJ compression is a means of reducing the standard TCP/IP header from 40 octets to approximately 5 octets. This gives a significant performance improvement, particularly when interactive applications are being used.
Page 33 The default is . or None. 0.0.0.0 tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. language You can specify whether a user will use as the language that English Customlang appears in the Menu or CLI.
Page 34 Configuring Users level The access that a user is allowed: Admin—The admin level user has total access to the IOLAN. You can create more than one admin user account but we recommend that you only have one. They can monitor and configure the IOLAN. Normal—The Normal level user has limited access to the IOLAN.
Page 35: Set User Session
Configuring Users sess-timer The amount of time, in seconds, that the will run. Use this timer to Session Timer forcibly close a user’s session (connection). When the expires, the Session Timer IOLAN will end the connection. The default value is (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out).
Page 36: Show User
Configuring Users Show User Description Shows user configuration settings. User Level Admin Syntax show user <configured_user>|. Options <configured_user> Show the settings for the specified user. Show the settings for the current user. User Commands 36...
Page 37: Chapter 2 Server Commands
Show Console Description For IOLAN models that have a dedicated console port, this command displays the configured parameters of the console port. User Level Admin Syntax show console IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 38: Set Custom-App
Server Commands Set Custom-App Description You can create a custom application that can run on the IOLAN using the Perle SDK. User Level Admin Syntax set custom-app server program-command-line <command> Options program-command-line The name of the SDK program executable that has been already been downloaded to the IOLAN, plus any parameters you want to pass to the program.
Page 39: Show Port-Buffering
Remote Both tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. time-stamp Enable/disable time stamping of the port buffer data. view-port-buffer-string The string (up to 8 characters) used by a a session connected to a serial port to display the port buffer for that particular serial port.
Page 40: Set Server
Server Commands Set Server Description Sets server parameters. User Level Admin Syntax set server [active-standby on|off] set server [auto-obtain-dns on|off] [auto-obtain-gw on|off] [auto-obtain-wins on|off] [set server banner on|off] set server [break on|off] set server [bypass-password on|off] set server [dhcp-update-dns on|off] set server [data-logging-buffer-size <integer>] set server [domain <string>] set server [flush-on-close on|off]...
Page 41 Server Commands auto-obtain-wins When DHCP/BOOTP is enabled, you can enable this option to have the IOLAN receive the WINS IP address from the DHCP/BOOTP server. banner This parameter concerns the banner information (product name/software version). This banner information is presented to a user with a login prompt. For security reasons, you can turn off the display of this information.
Page 42 Server Commands The Maximum Transmission Unit (MTU) size of an IP frame that will be sent over the network. If your IOLAN has more then one interface, each of the interfaces can be set separately, however only one MTU size can be set for both IPv4 and IPv6 frames. MTU sizes: 68-1500 bytes Default size: 1500 bytes name...
Page 43 Server Commands ip-filter A security feature that when enabled, the IOLAN can be configured to Allow all traffic, Allow only defined traffic from either hosts configured in the IOLAN’s Host Table with an IP address (hosts configured with a Fully Qualified Domain Name, FQDN, will not be able to access the IOLAN when this option is enabled) or defined IP address ranges.
Page 44 Server Commands power-management-menu-string Users accessing the IOLAN through reverse sessions can enter the string to bring up a power bar management menu. This string can be up to 8 characters. Control characters can be specified by putting their decimal value within angled brackets. The default value is on the keyboard.
Page 45: Show Server
Server Commands Show Server Description Shows the parameters set for the server. User Level Admin, Normal Syntax show server Server Commands 45...
Page 46: Set Wlan
Server Commands Set Wlan Description Sets wlan parameters. User Level Admin Syntax set wlan [global|profile|softap] global [diversity-mrc off|on] [in-range-scan-interval <0-65535>] [mode disabled|client|softap] [out-of-range-scan-interval <0-65535>] [passive-scan-only off|on] [radio-band 2.4+5|2.4|5] [region eu|japan|us-canada] [roaming off|on] | [roaming-decision balanced|bandwidth|distance] [wps off|on] [profile <profilename>] [active off|on] [connect-priority <1-8>] | [hidden-ssid off|on] | [scan-band 2.4+5|2.4|5] [scan-dfs off|on] [ssid <text string>] set wlan [profile <profilename>]...
Page 47 Server Commands set wlan softap [channel <number>] [dhcp off|on] [ip-address <ipV4address>] [netmask <netmask>] [security-type wpa-personal encryption-type [aes key <text string> | tkip key <text string>] [security-type wpa2-personal encryption-type [aes key <text string> | [tkip key <text string>] Options Configure parameters for: global profile softap...
Page 48 Server Commands radio-band (The mode parameter must be set to Client) The IOLAN can operate over 2.4GHz or 5GHz. To support connections to one or the other bands use 2.4+5. Values: 2.4, 5, 2.4+5 Default: 2.4+5 (dual-band) region Select your wireless region. Values: eu, japan, us-canada Default: us-canada roaming...
Page 49 Server Commands hidden-ssid If this profile is defined to connect to an AP that has a hidden SSID then this option must be enabled. This will force the IOLAN to send a directed proble to this AP with the specified SSID in order to discover it and determine the channel that it is using. Values: off or on Default: off scan-band...
Page 50 Server Commands authentication-protocol Select the authentication protocol type: chap, eap-gtc,eap-md5, eap-mschapv2, mschap, mschap2, pap. Default: eap-mschapv2 username Specify a username to identify the IOLAN to the Radius server. Values: max of 254 characters Default: none password Specify a password to identify the IOLAN to the Radius server. Values: max of 128 characters Default: none validate-server-cert...
Page 51: Add Wlan
Server Commands security-type In softap mode, the IOLAN supports wpa-personal and wpa2-personal encryption. wpa-personal: tkip, aes Default: aes wpa2-personal: tkip, aes Default: aes ssid This is the SSID that will need to be specified by the clients that wish to connect to this Soft-AP.
Page 52: Set Wwan
Server Commands Set Wwan Description Sets wwan parameters. User Level Admin Syntax set wwan apn [<text string>] | authentication [none|chap|pap] | [auto-obtain-dns on|off] | [enable yes|no] | [password <text string>] | [pin <text string>] | [radio-access-technology auto| lte|3g|2G] | [username <text string>] Options Enter the Access Point Name (APN).
Page 53: Show Wwan
Server Commands Show Wwan Description Shows configured wwan parameters or the status of the wwan. User Level Admin Syntax show wwan|status Set SSL Server Description Sets the default SSL/TLS parameters for the server. User Level Admin Syntax set ssl server [version any|tlsv1|sslv3|tlsv1.1|tlsv1.2] [type client|server] [verify-peer on|off] [validation-criteria country <code>|state-province <text>|locality <text>...
Page 54: Set Service
Server Commands organisation-unit Up to a 64 character entry for the unit in the organisation; for example, Payroll. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate. common-name Up to a 64 character entry for common name; for example, the host name or fully qualified domain name.
Page 55: Set Web Manager
Server Commands dmgrd DeviceManager daemon process in the IOLAN. If you disable this service, you will not be able to connect to the IOLAN with the DeviceManager application. DeviceManagerD listens on port 33812 and sends on port 33813. modbusd Modbus daemon process in the IOLAN on port 502. ipsec IPsec daemon process in the IOLAN listening and sending on UDP port 500.
Page 56: Hardware Commands
Options eth1|eth2 You must specify the Ethernet interface if you have an SCS model with dual Ethernet. Note: Rack Models and IOLAN SDS G models support 1000 Mbps. auto|10-half|10-full|100-half|100-full|1000-full Define the Ethernet connection speed: —automatically detects the Ethernet interface speed and duplex...
Page 57: Show Ssh-Server
SSH Server Commands Options authentication rsa An authentication method used by SSH version 1 and 2. Use RSA authentication for the SSH session. authentication dsa An authentication method used by SSH version 2. Use DSA authentication for the SSH session. authentication password The user types in a password for authentication.
Page 58: Ssl/Tls Commands
SSL/TLS Commands SSL/TLS Commands Set SSL Server Description Sets the default SSL/TLS parameters for the server. User Level Admin Syntax set ssl server [version any|tslv1|sslv3|tlsv1.1|tlsv1.2] [type client|server] [verify-peer on|off] [validation-criteria country <code>|state-province <text>|locality <text> |organisation <text>|organisation-unit <text> |common-name <text>|email <email_addr>] Options version Specify whether you want to use:...
Page 59: Set Ssl Server Cipher-Suite
SSL/TLS Commands organisation-unit Up to a 64 character entry for the unit in the organisation; for example, Payroll. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate. common-name Up to a 64 character entry for common name; for example, the host name or fully qualified domain name.
Page 60: Show Ssl
SSL/TLS Commands key-exchange The type of key to exchange for the encryption format: Any—Any key exchange that is valid is used (this does not, however, include ADH keys). RSA—This is an RSA key exchange using an RSA key and certificate. EDH-RSA—This is an EDH key exchange using an RSA key and certificate.
Page 61: Modbus Commands
Modbus Commands Modbus Commands Set Modbus Gateway Description Sets the Modbus parameters for the IOLAN when it is operating as a Modbus Gateway. User Level Admin Syntax set modbus gateway [addr-mode embedded|re-mapped] set modbus gateway [broadcast on|off] set modbus gateway [char-timeout <number>] set modbus gateway [next-req-delay <number>] set modbus gateway [exceptions on|off] set modbus gateway [idle-timer <number>]...
Page 62: Show Modbus
Modbus Commands req-queuing When enabled, allows multiple, simultaneous messages to be queued and processed in order of reception. The default is remapped-id Specify the UID that will be inserted into the message header for the Slave Modbus serial device. Valid values are 1-247. When enabled, messages over the TCP connection are encrypted via SSL/TLS.
Page 63: Authentication Commands
Authentication Commands Authentication Commands Set Authentication Description Sets the authentication method for the IOLAN. User Level Admin Syntax set authentication type primary|secondary none|local|radius|kerberos|ldap|tacacs+|securid|nis [secondary-as-backup on|off] [auth-admin-user-local on|off] Options primary The first authentication method that the IOLAN attempts. Some type of authentication must be done by the IOLAN, therefore, is not a valid option for the None...
Page 64: Set Authentication Kerberos
(with an IP address) or be resolvable by a DNS server. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. port The port that the Kerberos server listens to for authentication requests. If no port is specified, the default port 88 is used.
Page 65: Set Authentication Nis
389. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. encrypt-password When enabled, the IOLAN will encrypt the user’s and the IOLAN’s password strings using MD5 digest.
Page 66: Add Radius
The secondary NIS host that is used for authentication, should the primary NIS host fail to respond. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. Add RADIUS Description Adds an accounting or authentication RADIUS host. User Level Admin Syntax add radius accounting-host <config_host>...
Page 67: Set Authentication Radius
Authentication Commands Set Authentication RADIUS Description Sets RADIUS parameters. User Level Admin Syntax set authentication radius [accounting on|off] [acct-authenticator on|off] [acct-port <UDP_port>] [auth-port <UDP_port>] [nas-identifier <nas_id>] [nas-ip-address auto|specify <ipv4_address>] [nas-ipv6-address auto|specify <ipv6_address>] [retry <integer>] [timeout <integer>] Options accounting Enables/disables RADIUS accounting. acct-authenticator Enables/disables whether or not the IOLAN validates the RADIUS accounting response.
Page 68: Set Authentication Tacacs
TACACS+ host fail to respond. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. secret The TACACS+ shared secret is used to encrypt/decrypt TACACS+ packets in communications between two devices. The shared secret may be any alphanumeric string.
Page 69: Set Authentication Securid
The port number that SecurID listens to for authentication requests. The default port number is 5500. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. encryption You can specify either encryption for SecurID server communication. The default is encryption.
Page 70 Authentication Commands Option radius ldap tacacs+ kerberos securid Displays the authentication settings for the specified authentication method. Server Commands 70...
Page 71: Trueport Baud Commands
TruePort Baud Commands TruePort Baud Commands Set TruePort Remap-Baud Description This command allows for the remapping of the baud rate being specified by the Serial application to a different value on the physical serial port on the IOLAN. User Level Admin Syntax set trueport remap-baud 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200|...
Page 72: Email Commands
Email Commands Email Commands Set Email-Alert Server Description Configures email alert settings for the server. User Level Admin Syntax set email-alert server [from <email_addr>] [level emergency|alert|critical|error|warning|notice|info|debug] [mode on|off] [to <email_addr>] [reply-to <email_addr>] [smtp-host <string>] [subject <string>][encryption none|tls|ssl][verify-peer off|on][tcp-port <number>][domain <text>] Options from This will be the contents of the from field in the generated email.
Page 73: Show Email-Alert Server
Email Commands encryption Choose the type of encryption to be used. Valid options: None- All information is sent in the clear. SSL -Select this if you r email server requires SSL. TLS - Select this if your email server requires TLS. verify-peer Enable the validation of the certificate presented by the email server.
Page 74: Clustering Commands
Clustering Commands Clustering Commands Add Clustering Slave-IP Description Adds a slave IOLAN to the clustering group. User Level Admin Syntax add clustering slave-ip <IPv4_address> number-of-ports 1|2|4|8|16|24|32|48 [protocol telnet|ssh] [starting-master-tcp-port <10001-65535>] [starting-slave-ds-port <10001-65535>] Options <IPv4_address> Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group.
Page 75: Show Clustering Slave-Ip
Clustering Commands port Specify the port number that you wish to modify on this clustering slave. master-tcp-port Specify this parameter if you wish to change the name associated with this slave port. name Specify this parameter if you wish to change the name associated with this slave port. protocol Specify this parameter if you wish to change the protocol used to access this slave port.
Page 76: Dynamic Dns Commands
Dynamic DNS Commands Dynamic DNS Commands Set Dynamic-DNS Description Configures the dynamic DNS parameters. User Level Admin Syntax set dynamic-dns [on|off] [connection-method http|http-port-8245|https] [hostname <hostname>] [username <username>] [password <password>] [system-type dynamic|static|custom] [wildcard enable|disable|nochange] Options connection-method Specify how the IOLAN is going to connect to the DynDNS.org server, via HTTP, HTTP through Port 8245, or HTTPS.
Page 77: Set Dynamic-Dns Ssl Cipher-Suite
Dynamic DNS Commands country A two character country code; for example, US. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate. state-province Up to a 128 character entry for the state/province; for example, IL. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.
Page 78: Show Dynamic-Dns
Dynamic DNS Commands encryption Select the type of encryption that will be used for the SSL connection: Any—Will use the first encryption format that can be negotiated. 3DES ARCFOUR ARCTWO AES-GCM None—Removes any values defined for the cipher option. The default value is Any. min-key-size The minimum key size value that will be used for the specified encryption type.
Page 79: Pci Commands
WAN card. model Specify the wireless WAN card you are using. If the wireless WAN card you are using is not listed, try the standard driver. If that does not work, look at the Perle website for a custom driver. password Specify the password required by your internet provider to access their network.
Page 80: Show Wireless-Wan
PCI Commands Show Wireless-WAN Description Displays the wireless WAN settings. User Level Admin Syntax show wireless-wan Set pci usb Description Configures the usb modem stick parameters. User Level Admin Syntax set pci usb [access-point-name <name>] [init-string <modem_init_string>] [user <username>] [password <password>] [phone-number <phone_number>] [pin <pin>] Options...
Page 81: Usb Delete Modem-File
PCI Commands device This command will enable you to specify the "device name" which the driver uses to communicate with your usb modem. The device name would be (ttyUSBx or ttyACMx). x is in the range of 1-4. This should only be needed if the usb modem is not working and you suspect that the device name is wrong.
Page 82: Ipv6 Commands
IPv6 Commands IPv6 Commands Set IPv6 Description Configures the basic IPv6 settings. User Level Admin Syntax set ipv6 [dhcpv6-settings ipv6-address on|off] [dhcp-settings network-prefix on|off] [auto-obtain-dns-ipv6 on|off] [eth1|eth2|wan0] [enable-ipv6-addressing on|off] [obtain-using auto-ipv6|dhcpv6] Options dhcpv6-settings Determines the types of information that the IOLAN will accept from the DHCPv6 server, IPv6 address(es) and/or network prefix(es).
Page 83: Add Custom-Ipv6
IPv6 Commands Add Custom-IPv6 Description User Level Admin Syntax add custom-ipv6 [eth1|eth2|wan0] method auto network-prefix <network_prefix> [prefix-bits <0-64>] [router-advertisement on|off] add custom-ipv6 [eth1|eth2|wan0] method manual ipv6-address <ipv6_address> [prefix-bits <0-128>] [router-advertisement on|off] Options eth1|eth2|wan0 Configures the custom IPv6 settings for the IOLAN’s Ethernet interface 1 or Ethernet interface 2 (SCS models only) interface.
Page 84: Set Custom-Ipv6
IPv6 Commands Set Custom-IPv6 Description Configures custom IPv6 network and IP addresses. User Level Admin Syntax set custom-ipv6 [eth1|eth2|wan0] <config_ipv6_address> method auto network-prefix <network_prefix> [prefix-bits <0-64>] [router-advertisement on|off] set custom-ipv6 [eth1|eth2|wan0] <config_ipv6_address> method manual ipv6-address <ipv6_address> [prefix-bits <0-128>] [router-advertisement on|off] Options eth1|eth2|wlan0 Configures the custom IPv6 settings for the IOLAN’s Ethernet interface 1 or Ethernet...
Page 85: Ipv6 Router Advertisements
IPv6 Router Advertisements Option eth1|eth2|wan0 Deletes the specified custom IPv6 address. You must specify the Ethernet interface for SCS models. IPv6 Router Advertisements Set IPv6-Router-Advertisement Description Configures IPv6 router advertisements. User Level Admin Syntax set ipv6-router-advertisement [eth1|eth2|wan0] on|off [dhcpv6 off|on] [dhcpv6-cfg-options off|on] Options ipv6-router-advertisement When enabled, the IOLAN will periodically send IPV6 Router Advertisement messages...
Page 86: Chapter 4 Line Commands
Description Configures line parameters. The command does not work on modem set line ports/lines on models that have an internal modem. Note: When using IOLAN SDS G models, 5 databits is only supported with 1.5 stop bit. User Level Normal, Admin, Elevated User Syntax set line .
Page 87 Line Commands Admin User set line .|<number>|* speed Only 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19,200|38 ,400|57,600|115,200|230,400|28,800|custom [mode enabled|disabled] [map-cr-crlf on|off] [data-logging on|off] [flowin on|off] [flowout on|off] [hotkey-prefix <00-7f>] [initial cli|menu] [keepalive on|off] [lock on|off] [microsoft-sac-support on|off] [motd on|off] [multisessions <integer>] [reset on|off] [dial-timeout <number>] [dial-retries <number>] [user <name>] [nouser] [line-termination on|off] [internet-address <IPv4_address>] Elevated set line .|<number>|* speed...
Page 88 Line Commands parity Specifies if you are using , or on the line. If you want to force a Even No parity parity type, you can specify for 1or for 0. Mark Space phone-number The phone number to use when is set to Connection Method Dial Out...
Page 89 Line Commands break Specifies how a break is interpreted: off—The IOLAN ignores the break key completely and it is not passed through to the host. This is the default setting. local—The IOLAN deals with the break locally. If the user is in a session, the break key has the same effect as a hot key.
Page 90 Line Commands hotkey-prefix The prefix that a user types to lock a line or redraw the Menu. The default value is , which corresponds to ) (hex value 02 would be Ctrl-b (^b), etc.): Ctrl-a —(Lowercase L) Locks the line until the user unlocks it. The user is prompted ^a l for a password (any password, excluding spaces) and locks the line.
Page 91 Line Commands user line service, makes this a line that is dedicated to the specified user. Only DSLogin this user will be able to log in on this line and they won’t need to enter their login name - just their password. When the is set to , the Line Service...
Page 92 Line Commands break-length The length of time (in milliseconds) for which the break signal will be asserted on the serial port. Valid values are 0-65535. Default is 1000 ms A value of 0 will cause the "request to send a break signal" to be ignored. discard-characters-received-with-error When enabled, the IOLAN will discard characters received with a parity or framing error.
Page 93: Set Line Interface
Line Commands Set Line Interface The SCS, STS, and MDC IOLAN models support the EIA-232 interface only. Therefore, you do not need to specify in the command syntax; you only need to specify the interface eia-232 command options (e.g., monitor-dcd Description Configures line interface (hardware) parameters.
Page 94: Set Line Service
Line Commands duplex Specify whether the line is (communication both ways at the same time) or Full Duplex (communication in one direction at a time). Half Duplex echo-suppression This parameter applies only to mode. All characters will be EIA-485 Half Duplex echoed to the user and transmitted across the serial ports.
Page 95 Line Commands Options bidir This service allows the IOLAN listen for incoming TCP connection and if needed, initiate a TCP connection. <config_host> The name of the target host. The host must exist in the IOLAN host table. <server_port> The IOLAN port number. <host_port>...
Page 96 Line Commands Sets the port to a dedicated PPP line. slip Sets the port in SLIP mode. Sets the line to listen for and/or send UDP data. vmodem The IOLAN port behaves as if it were a modem to the attached device. server-tunnel Sets the line for a server tunnel connection.
Page 97: Set Modem
Line Commands tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. Set Modem Description Sets the modem initialization strings for a defined modem. If you wish to add a new modem, use the command.
Page 98: Line Service Commands
Line Service Commands Line Service Commands Set Custom-App Description You can create a custom application that can run on a specific serial line in IOLAN using the Perle SDK. User Level Admin Syntax set custom-app line .|<number>|* program-command-line <command> Options...
Page 99: Set Ssh-Client
Line Service Commands echo Defines the echo character. When , typing the echo character echoes Line Mode the text locally and sends only completed lines to the host. This value is in hexadecimal with a default value of (ASCII value Defines the end-of-file character.
Page 100 Line Service Commands auto-login Creates an automatic SSH login, using the values. Name Password name The user’s name when is enabled. Auto Login password The user’s password when is enabled. Auto Login ssh-1-cipher Select the encryption method (cipher) that you want to use for your SSH version 1 connection: 3DES Blowfish...
Page 101: Set Ppp
Line Service Commands Set PPP Description Configures the Line PPP settings. User Level Admin Syntax set ppp wireless-wan|line .|<number>|* [accm <8_hex_digits>] [address-comp on|off] [auth-tmout <integer>] [challenge-interval <integer>] [cr-retry <integer>] [cr-timeout <integer>] [ipaddr-neg on|off] [ipv6-global-network-address <IPv6_network_prefix>] [ipv6-local-interface <interface_id>] [ipv6-remote-interface <interface_id>] [lipaddr <IPV4_address>] [magic-neg on|off] [mru <64-1500>] [nak-retry <integer>] [netmask <IPV4_address>] [password <string>] [proto-comp on|off] [ripaddr <IPV4_address>] [roaming-callback on|off] [authentication none|pap|chap]...
Page 102 Line Service Commands ipaddr-neg Specifies whether or not IP address negotiation will take place. IP address negotiation is where the IOLAN allows the remote end to specify its IP address. The default value is . When , the IP address specified by the remote end will be used in preference to set for a .
Page 103 Line Service Commands netmask The network subnet mask. For example, 255.255.0.0. If your user is authenticated by RADIUS and the RADIUS parameter is set in the RADIUS file, the Framed-Netmask IOLAN will use the value in the RADIUS file in preference to the value configured here.
Page 104 Line Service Commands ruser This field is used to authenticate a user connecting to this line. It is used in conjunction with the field. By specifying a name here, this line becomes dedicated to rpassword that user only. If left blank, the internal user database will be used to authenticate the connection and any user configured will be able to access this line.
Page 105: Set Ppp Dynamic-Dns
Line Service Commands echo-retry The maximum number of times an request packet will be re-sent before the link is echo terminated. Range: 0-255 Default: 30 seconds Set PPP Dynamic-DNS Description This option is only available when IP address negotiation ( ) is .
Page 106: Set Udp
Line Service Commands netmask The network subnet mask. For example, 255.255.0.0. If your user is authenticated by RADIUS and the RADIUS parameter is set in the RADIUS file, the Framed-Netmask IOLAN will use the value in the RADIUS file in preference to the value configured here.
Page 107: Set Vmodem
Applicable when set to Both tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. any-port The IOLAN will receive messages from any port sending UDP packets. Applicable when set to...
Page 108 Line Service Commands Options echo When enabled, echoes back characters that are typed in (equivalent to ATE0/ATE1 commands). Disabled by default. failure-string String that is sent to the serial device when a connection fails. If no string is entered, then the string will be sent.
Page 109 Line Service Commands style One of the following: Verbose—Return codes (strings) are sent to the connected device. Numeric—The following characters can be sent to the connected device: 0 OK 1 CONNECTED 2 RING 3 NO CARRIER 4 ERROR 6 ITERFACE DOWN 7 CONNECTION REFUSED 8 NO LISTNER success-string...
Page 110: Set Vmodem-Phone
Deletes the specified entry from the phone number table. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. Set SSL Line Description Sets the SSL/TLS parameters for the line. SSL/TLS can be enabled for the following Line Services: DSLogin, Raw, Bidir, VModem, Server Tunnel, Client Tunnel, Modbus Master, Custom App and Trueport.
Page 111 Line Service Commands version Specify whether you want to use: Any—The IOLAN will try a TLSv1 connection first. If that fails, it will try an SSLv3 connection. If that fails, it will try an SSLv2 connection. TLSv1—The connection will use only TLSv1 SSLv3—The connection will use only SSLv3 TLSv1.1—The connection will use only TLSv1.1.
Page 112: Set Ssl Line Cipher-Suite
Line Service Commands Set SSL Line Cipher-suite Note: Not all SSH encryption options are available on all formware versions. Description Sets the SSL/TLS cipher suite parameters for the line. User Level Admin Syntax set ssl line .|<number>|* cipher-suite option1|option2|option3|option4|option5 encryption any|aes|3des|des|arcfour|arctwo|none min-key-size 40|56|64|128|168|256 max-key-size 40|56|64|128|168|256 key-exchange any|rsa|edh-rsa|edh-dss|adh...
Page 113: Set Modbus-Slave Line
Line Service Commands hmac Select the key-hashing for message authentication method for your encryption type: SHA1 SHA256 SHA384 The default is Any. Set Modbus-Slave Line Description Sets the Modbus slave parameters for the line. User Level Admin Syntax set modbus-slave line .|<number>|* [crlf on|off] [protocol rtu|ascii] [uid-range <uid_range>] Options crlf...
Page 114: Set Power-Management Line
Line Service Commands protocol Specify the protocol that is used between the Modbus Master and Modbus Slave(s), either TCP or UDP. range-mode If you specify , the IP address is used for the first UID specified in the range. The Host last octect in the IPv4 address is then incremented for subsequent UID’s in that range.
Page 115: Set Multihost Line
Specify the preconfigured host that will be in the multihost list. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. <TCP_port> Specify the TCP port that the IOLAN will use to communicate to the...
Page 116: Set Line Initiate-Connection
Line Service Commands Set Line Initiate-Connection Description Determines how the connection is initiated for Direct Telnet, Direct SSH, Direct Raw, and Direct Rlogin. User Level Admin Syntax set line <number>|* initiate-connection any-char|specific-char <hex> Options any-char Initiates a connection to the specified host when any data is received by the serial port. specific-char <hex>...
Page 117: Show Telnet-Client
Modem Commands Show Telnet-Client Description Shows the telnet client settings for a line. User Level Admin Syntax show telnet-client line <number> Show Modbus Description Shows the Modbus settings for a line. User Level Admin Syntax show modbus master|slave <number> Show UDP Description Shows the UDP settings for the line.
Page 118: Set Modem
Email Commands Set Modem Description Sets the modem initialization strings for a defined modem. If you wish to add a new modem, use the command. add modem User Level Admin Syntax set modem <modem_name> <init_string> Options <modem_name> Predefined modem name. <init_string>...
Page 119: Show Email-Alert Line
Packet Forwarding Commands reply-to The email address to whom all replies to the email notification should go. smtp-host The SMTP host (email server) that will process the email notification request. This can be either a host name defined in the IOLAN host table or the SMTP host IP address. subject A text string, which can contain spaces, that will display in the field of the...
Page 120 Packet Forwarding Commands Options minimize-latency This option ensures that any data received on the serial port will immediately be forwarded to the LAN. Select this option for timing-sensitive applications. optimize-network-throughput This option provides optimal network usage while ensuring that the application performance is not compromised.
Page 121 Packet Forwarding Commands end-trigger2 When enabled, creates a sequence of characters that must be received to specify when the packet is ready for transmission (if the End Trigger1 character is not immediately followed by the End Trigger2 character, the IOLAN waits for another End Trigger1 character to start the End Trigger1/End Trigger2 character sequence).
Page 122: Show Packet-Forwarding Line
Packet Forwarding Commands sof2 When enabled, creates a sequence of characters that must be received to create the start of the frame (if the SOF1 character is not immediately followed by the SOF2 character, the IOLAN waits for another SOF1 character to start the SOF1/SOF2 character sequence).
Page 123: Chapter 5 Network Commands
<config_host>|<IP_address> <version> <type> <tunnel_name> <Community> Options <Community> The trap receiver is the network management system (NMS) that should receive the SNMP traps. This NMS must have the same SNMP community string as the trap sender. IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 124: Delete Community
Select trap or inform. Inform requires the receiving host to acknowledge receipt of the trap. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. Delete Community Description Deletes an SNMP community (version 1 and version 2). User Level Admin Syntax delete community <config_community_number>...
Page 125: Set Snmp V3-Security
SNMP Commands readwrite user (SNMP version 3) Specify the name of the read/write user. trap user (SNMP version 3) Specify the name of the trap user. Set SNMP V3-Security Description Configures SNMP settings for the Version 3 read-write, read-only and trap user(s). User Level Admin Syntax set snmp v3-security [type readonly|readwrite|trap]...
Page 126: Set Snmp Engine-Id-String
TFTP Commands Set SNMP engine-id-string Description Configures SNMP v3 Engine ID. User Level Admin Syntax set snmp engine-id-string <string> Options string The string entered in this field will be combined with the defined string in hex of 800007AE04 to form the engine-id. Ensure each string is unique for each IOLAN on your network.
Page 127: Sftp Commands
SFTP Commands timeout The time, in seconds, that the IOLAN will wait for a successful transmit or receipt of TFTP packets before retrying a TFTP transfer. Enter a value between 3 and 10. The default is seconds. SFTP Commands Set Server SFTP Description Configures the IOLANs SFTP client settings.
Page 128: Hosts Commands
Hosts Commands Hosts Commands Add Host Description Adds a host to the IOLAN host table. User Level Admin Syntax add host <hostname> <IP_address> add host <hostname> fqdn <text> Options <hostname> The name of the host. <IP_address> The host IPv4 or IPv6 address. fqdn When you have DNS defined in the IOLAN, you can enter a DNS resolvable fully qualified domain name (note: FQDN’s are excluded as accessible hosts when...
Page 129: Dns/Wins Commands
DNS/WINS Commands DNS/WINS Commands Add DNS Description Adds a DNS entry. User Level Admin Syntax add dns <IP_address> Option < > IP_address You can specify the IPv4 or IPv6 addresses for up to four DNS (Domain Name Servers) hosts in your network. Add WINS Description Adds a WINS entry.
Page 130: Show Wins
Gateway Commands Show WINS Description Shows all WINS entries, even those supplied by DHCP/BOOTP when applicable. User Level Admin, Normal Syntax show wins Gateway Commands Add Gateway Description Adds a gateway. You can configure up to twenty gateways. User Level Admin Syntax add gateway <config_host>...
Page 131: Delete Gateway
Gateway Commands <subnet_bits>|<prefix_bits> When the gateway is a gateway, you must specify the network’s subnet mask Network (IPv4) or prefix bits (IPv6). Delete Gateway Description Deletes a gateway. User Level Admin Syntax delete gateway <config_gateway_host> Option <config_gateway_host> You can view the configured gateways that can be deleted by typing delete gateway ? Set Gateway Description Configures the gateway.
Page 132: Logging Commands
Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. Show Syslog Description Shows the syslog settings. User Level Admin...
Page 133: Rip Commands
RIP Commands RIP Commands Add RIP Description Adds a RIP MD5 key. After pressing , you will be prompted for the MD5 key Enter value. User Level Admin Syntax add rip md5 <integer_md5_id> <start_date> <start_time> <end_date> <end_time> Options < > integer_md5_id identification key.
Page 134: Show Rip
RIP Commands Options authentication Specify the type of RIP authentication: None—No authentication for RIP. Password—Simple RIP password authentication. MD5—Use MD5 RIP authentication. ethernet-mode Enable/disable RIP (Routing Information Protocol) mode for the Ethernet interface with one of the following options: None—Disables RIP over the Ethernet interface. Send—Sends RIP over the Ethernet interface.
Page 135: Ipsec Commands
IPsec Commands IPsec Commands Once there is an active VPN tunnel, the IOLAN expects all connections to be established through a VPN tunnel. To allows hosts to connect outside of the VPN tunnel, you must configure VPN exceptions, see VPN Exceptions for the command syntax.
Page 136 IPsec Commands boot-action Determines the state of the VPN network when the IOLAN is booted. Start—Starts the VPN network, initiating communication to the remote VPN. Add—Adds the VPN network, but doesn’t initiate a connection to the remote VPN. Ignore—Maintains the VPN network configuration, but the VPN network is not started and cannot be started through the IPsec command option.
Page 137 IPsec Commands remote-next-hop The IPv4 or IPv6 address of the router/gateway that will forward data packets to the IOLAN (if required). The router/gateway must reside on the same subnet at the remote VPN. remote-validation-criteria Any values that are entered in the remote validation criteria must match the remote X.509 certificate for a successful connection;...
Page 138: Show Ipsec
IPv6 Tunnels Show IPsec Description Displays an IPsec tunnel. User Level Admin Syntax show ipsec <config_tunnel_name> Option <config_tunnel_name> Displays the configuration information for the specified IPsec tunnel. IPsec Description Controls the state of all IPsec tunnels. User Level Admin Syntax ipsec start|stop|restart|status Options start...
Page 139: Show Ipv6Tunnel
IPv6 Tunnels Options mode The method or protocol that is used to create the IPv6 tunnel. Manual—When enabled, the IOLAN will manually create the IPv6 tunnel to the specified through the specified Remote Host Interface 6to4—When enabled, the IOLAN will broadcast to the multicast address 192.88.99.1 through the specified .
Page 140: L2Tp/Ipsec
L2TP/IPsec L2TP/IPsec Once L2TP/IPsec is enabled, the IOLAN expects all connections to be established through a VPN tunnel. To allows hosts to connect outside of the VPN tunnel, you must configure VPN exceptions, VPN Exceptions for the command syntax. Set L2TP Description User Level Admin Syntax...
Page 141 L2TP/IPsec country A two character country code; for example, US. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard. state-province Up to a 128 character entry for the state/province; for example, IL. This field is case sensitive in order to successfully match the information in the remote X.509 certificate.
Page 142: Show Lt2P
VPN Exceptions authentication-type Specify the authentication method that will be used for the L2TP tunnel. Data Options: CHAP, PAP, Both Default: Both Show LT2P Description Shows the L2TP settings. User Level Admin Syntax show l2tp VPN Exceptions VPN exceptions allows specific hosts or any host in a network to connect to the IOLAN outside of a VPN tunnel.
Page 143: Delete Vpn Exception
<text>|udp <text> <number> local-port<number> ipalias <ipv4address> |limit-access on|off] Options text Provide a name for this tunnel. This name must match the tunnel name on the tunnel peer IOLAN SDS. Range: 0-15 alpha-numeric characters. connection The number of the connection. Range: 1-100.
Page 144: Set Http_Tunnel
HTTP Tunnel Commands remote number The port number of the application on the final destination host. local-port The local port on the IOLAN that will send and receive data. ipalias Users can access the HTTP tunnel through this IP address. Typically this field is only needed if the IOLAN has a listener on the same local TCP port.
Page 145: Delete Http Tunnel
Provide the IP address of the listening Terminal Server SDS. mode Connect or listen connect Provide the Host name or IP address of the listening IOLAN SDS. listen Listen for connection requests generated from the connecting IOLAN SDS. Delete HTTP Tunnel Description Deletes a HTTP tunnel connection.
Page 146: Chapter 6 Time Commands
-12 to +14) and minutes mm (valid 0 to 59 minutes) for the offset from UTC. Show Time Description Shows the IOLAN’s system clock. User Level Normal, Admin Syntax show time Show Timezone Description Shows the time zone settings. User Level Admin Syntax show timezone IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 147: Sntp Commands
SNTP Commands SNTP Commands Add SNTP Description Adds an SNTP server. User Level Admin Syntax add sntp [server-1 <config_host>] [server-2 <config_host>] Options server-1 The name of the primary NTP/SNTP server from the IOLAN host table. Valid with modes, although in mode, the IOLAN will only accept Unicast Multicast...
Page 148: Show Sntp
Time/Date Setting Commands server-1 The name of the primary NTP/SNTP server from the IOLAN host table. Valid with modes, although in mode, the IOLAN will only accept Unicast Multicast Multicast broadcasts from the specified host NTP/SNTP server. server-2 The name of the secondary NTP/SNTP server from the IOLAN host table. Valid with modes, although in mode, the IOLAN will only accept Unicast...
Page 149: Set Summertime Fixed
Time/Date Setting Commands Options mode You can configure the summer time to take effect: None—No summer time change. Fixed—The summer time change goes into effect at the specified time every year. For example, April 15 at 1:00 pm. Recurring—The summer time changes goes into effect every year at same relative time.
Page 150: Show Date
Time/Date Setting Commands start-time The time to change to summer time from standard time; uses the format hh:mm for a 24-hour clock (00:00-23:59). start-week The week to change to summer time from standard time. end-day The day to end summer time and start standard time. end-month The month to end summer time and start standard time.
Page 151: Chapter 7 Administration Commands
Syntax reset serial-statistics [<line number>|*] Reset Factory Description Resets the IOLAN to the factory configuration. User Level Admin Syntax reset factory Save Description Saves the configuration to FLASH. User Level Admin Syntax save IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 152: Set Bootup
Bootup Commands Set Bootup Description Specifies remote the TFTP host and pathname for files to be loaded after a IOLAN reboot or indicates that SFTP should be used. User Level Admin Syntax set bootup firmware host <hostname> [firmware file <path_filename>] [firmware sftp on|off] set bootup configuration host <hostname>...
Page 153: Tftp File Transfer Commands
Download wireless WAN custom drivers to the IOLAN that have been downloaded from the Perle website. <hostname|IP_address> The IP address or host name where the file you are downloading to the IOLAN resides. If you are using a host name, it must be resolved in either the IOLAN’s...
Page 154: Netsave
SFTP File Transfer Commands <*> Select * to use the preconfigured HTTP tunnel. <filename> The complete path and file name of the file you are downloading to the IOLAN (this path should be relative to the default path of your TFTP server, which may or may not allow drive letters).
Page 155: Snetsave
Download wireless WAN custom drivers to the IOLAN that have been downloaded from the Perle website. <hostname|IP_address|user@host or > The IP address or host name where the file you are downloading to the IOLAN resides. If using SFTP, you must specify a user. Specify the host in the following format.
Page 156: Custom Factory Default
Custom Factory Default Options configuration Specifies that you are going to upload a configuration file from the IOLAN to the specified host or IP address. crash Specifies that you are going to upload a crash file from the IOLAN to the specified host or IP address.
Page 157: Snetload
Custom Factory Default <filename> The complete path and file name of the file you are downloading to the IOLAN (this path should be relative to the default path of your SFTP/TFTP server, which may or may not allow drive letters). Snetload Description Transfers a file from a remote host to the IOLAN using the SFTP protocol.
Page 158: Keys And Certificates Commands
Keys and Certificates Commands Keys and Certificates Commands Netload Description Loads certificates and keys into the IOLAN using TFTP. User Level Admin Syntax netload ssl certificate|private-key <hostname/IP_address> <filename> netload ldap certificate <hostname/IP_address> <filename>( netload ssh-client host <config_host> public-key ssh-1 rsa <hostname/IP_address>...
Page 159: Netsave
Keys and Certificates Commands ipsec <tunnel_name> When you configure an IPsec tunnel with an Authentication Method , you need to download the RSA key from the remote VPN gateway to the Signature IOLAN for that specific tunnel. < > hostname IP_address Enter the host or IP address that contains the certificate/key you are downloading to the IOLAN.
Page 160 Keys and Certificates Commands Syntax snetload ssl certificate|private-key <hostname/IP_address|*> <filename> snetload ldap certificate <hostname/IP_address> <filename> snetload ssh-client host <config_host> public-key ssh-1 rsa <hostname/IP_address> <filename> snetload ssh-client host <config_host> public-key ssh-2 rsa|dsa <hostname/IP_address> <filename> snetload ssh-client user <config_user> private-key ssh-1 rsa <hostname/IP_address>...
Page 161: Snetsave
Keys and Certificates Commands < > hostname IP_address The IP address or host name where the file you are downloading to the IOLAN resides. If using SFTP, you must specify a user. Specify the host in the following format. user@host where; user - the user name to use.
Page 162: Motd Commands
MOTD Commands MOTD Commands Set MOTD Description Specifies the server/file that contains the message of the day (MOTD) that is displayed when users log into the IOLAN. You can also retrieve the MOTD from a local file (it must already be downloaded to the IOLAN using the netload customapp-file command);...
Page 163: Wlan Commands
WLAN Commands WLAN Commands Wlan Description Wan commands allow the administrator to connect to a specify WLAN, restart all WLANs, scan for WLANs an start WPS mode. User Level Admin Syntax wan [connect profile <profilename> | restart | scan | wps-start] Options <profilename>...
Page 164: Ssl_Certificate
Delete Files ssl_certificate Description Deletes ssl_certificate. User Level Admin Syntax delete file ssl_certificate ssl_key Description Delete ssl_key. User Level Admin Syntax delete file ssl_key Administration Commands 164...
Page 165: Chapter 8 Statistics Commands
Displays UDP port statistics. tcpv6 Displays TCPv6 port statistics. udpv6 Displays UDPv6 port statistics. Show Netstat Statistics Description Shows protocol (IP/ICMP/TCP/UDP) counters. User Level Admin Syntax show netstat statistics [ip] [ipv6] [icmp] [icmpv6] [tcp] [udp] [udp6] IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 166: Show Modbus Statistics
Run-Time Statistics Show Modbus Statistics Description Shows the Modbus statistics. User Level Admin Syntax show modbus statistics master-tcp line *|<number> show modbus statistics master-udp line *|<number> show modbus statistics slave-tcp line *|<number> show modbus statistics slave-udp line *|<number> Show Routes Description Shows current information about IPv4 or IPv6 network routes.
Page 167: Chapter 10 I/O Commands
IOLAN will listen for messages from and/or send messages to. end_ip The last host IP address in the range of IP addresses (for IPV4, not required for IPV6) that the IOLAN will listen for messages from and/or send messages to. IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 168: Set Io Failsafe
Set Line Set IO Failsafe Description Sets the failsafe (watchdog) settings for I/O. User Level Admin Syntax set io failsafe [mode on|off] [timeout <seconds>] Options mode Enables/disables the Failsafe Timer. This is the global setting that must be enabled to set the Failsafe Action on the channel for digital outputs and relays.
Page 169: Set Iochannel
Set IOChannel Set IOChannel Set IOChannel Mode Description Sets general I/O channel settings for the specified channel, these settings are available to all channels and I/O serial pins. User Level Admin Syntax set iochannel <i/o_channel> [mode enabled|disabled] [description <string>] Options i/o_channel Specify the channel number, for example, d2 or a4.
Page 170: Set Iochannel Digital Input
Set IOChannel Set IOChannel Digital Input Description Sets the Digital input settings for the channel. User Level Admin Syntax set iochannel <digital_channel> [alarm [trigger disabled|inactive-input|active-input] [clear auto|manual] [email on|off] [syslog on|off] [snmp on|off]] [description <string>] [invert-signal on|off] [latch disabled|inactive-to-active|active-to-inactive] Options digital_channel Specify the Digital channel number, for example, d2.
Page 171: Set Iochannel Digital Input (Serial Pins)
Set IOChannel latch Latches (remembers) the activity transition (active-to-inactive or inactive-to-active). The latched status is maintained until it is read. Once it is read, it will revert to the current status. The default is disabled. Set IOChannel Digital Input (Serial Pins) Description Sets the Digital input settings for serial pins CTS, DSR, and DCD.
Page 172: Set Iochannel Digital Output
Set IOChannel invert-signal Inverts the actual condition of the I/O signal in the status; therefore, an inactive status will be displayed as active. latch Latches (remembers) the activity transition (active-to-inactive or inactive-to-active). The latched status is maintained until it is read. Once it is read, it will revert to the current status.
Page 173: Set Iochannel Digital Output (Serial Pins)
Set IOChannel output Specify how the channel output will be handled: Manual—You must manually manipulate the channel output. Pulse—Activates and deactivates the channel output activity in intervals after it is manually activated. Inactive-to-Active Delay—The channel output will remain inactive for the specified time interval after it is manually started.
Page 174: Set Iochannel Relay
Set IOChannel Set IOChannel Relay Description Sets the Relay output channel settings. User Level Admin Syntax set iochannel <relay_number> output [pulse continuous|counted <pulse_count>] [active-to-inactive-delay <delay>] [inactive-to-active-delay <delay>] set iochannel <relay_number> [active-signal-width <width>] [inactive-signal-width <width>] [failsafe-action none|activate|deactivate] Options relay_number Specify the Relay channel number, for example, r2. output Specify how the channel output will be handled: Manual—You must manually manipulate the channel output.
Page 175: Set Iochannel Analog (True Analog)
Set IOChannel Set IOChannel Analog (True Analog) Description Sets the Analog input channel settings. User Level Admin Syntax set iochannel <analog_channel> type current|voltage range <range_specifier> set iochannel <analog_channel> alarm [level 1|2|3|4|5 [mode on|off] [trigger-type disabled|low|high] [trigger-level <decimal_value>] [clear-mode auto|manual] [clear-level <decimal_value>] [email on|off] [snmp on|off] [syslog on|off]] Options analog_channel...
Page 176: Set Iochannel Analog (Temperature)
Set IOChannel trigger-level Specify the value that will trigger an alarm, the measurement is based on the Type that you specify. This value must not fall within the scope of the value used to Range clear an alarm. clear-mode Specifies whether an activated alarm must be cleared, or can be cleared when Manually the input drops below the specified value (when...
Page 177 Set IOChannel range Specify the temperature range that you want to measure. For RTD, the range is: 1 (Pt100 a=385 -50 to 150C) This is the default. 2 (Pt100 a=385 0 to 100C) 3 (Pt100 a=385 0 to 200C) 4 (Pt100 a=385 0 to 400C) 5 (Pt100 a=385 -200 to 200C) 6 (Pt100 a=392 -50 to 150C) 7 (Pt100 a=392 0 to 100C)
Page 178: Set Iochannel Ioextension
Set IOChannel clear-mode Specifies whether an activated alarm must be cleared, or can be cleared when Manually the input drops below the specified value (when ) or goes above Trigger Type High the specified value (when Trigger Type clear-level Specify that value that will clear an alarm, the measurement is based on the Type that you specify.
Page 179 Set IOChannel enabled When enabled, the digital input channel or DSR/DCD/CTS input serial signal pins can be connected to: A Digital output or relay (if the I/O model supports relay) channel on the same IOLAN Output Serial Signal Pins (DTR/RTS) A Digital output channel on another IOLAN(s) or output serial signal pins (DTR/RTS) on another IOLAN(s) A TCP/IP application(s) running on a host on the network...
Page 180: Set Iochannel Multihost
Digital/Relay output channel or output serial signal pin. tunnel_name Provide a name for this tunnel. This name must match the name on the tunnel peer IOLAN SDS. Set IOChannel Multihost Description Configures up to 49 hosts/IOLANs that the Digital input channel or input serial signal pins (DSR, DCD, or CTS-when the line is configured for signal-io) will connect to.
Page 181: Set Iochannel Ioextension Ssl
Set IOChannel Set IOChannel IOExtension SSL Not all SSL/TLS encryption options are available on all firmware versions. Description Configures the secure SSL/TLS connection between the Digital/Relay I/O channel or serial signal pin and the host/IOLAN. For an explanation of the parameters, see Set SSL Line User Level Admin...
Page 182: Show Io
I/O Channel Control Commands Show IO Description Shows global I/O information (for example, UDP, TruePort, Modbus). Temperature I/O is Analog. User Level Admin Syntax show iochannel <i/o_channel> show iochannel rts|cts|dtr|dsr|dcd Options i/o_channel Specify the channel number, for example, d2 or a4. Temperature models use Analog input, so the channel numbers are a1-a4.
Page 183: Digital Input
Calibrating Analog Input (Analog/Temperature) Digital Input Description Manages the Digital input channel status. User Level Admin Syntax iochannel d1|d2|d3|d4|rts|dtr output activate|deactivate Option output Manually deactivates the I/O channel. Relay Description Manages the Relay output channel status. User Level Admin Syntax iochannel r1|r2 output activate|deactivate Option output...
Page 184: Chapter 9 Iolan+ User Commands
See IOLAN+ Interface in the IOLAN User’s Guide for a list of changes to the IOLAN+ menu. IOLAN+ Description Displays the IOLAN+ configuration menu. User Level Admin Syntax iolan+ IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 185: Chapter 11 Power Commands
Turns the specified plug(s) on. Turns the specified plug(s) off. reset Resets all the RPS plugs to the default state as defined in the Power Management line settings. status Displays the status (on/off) of the plug(s). IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 186: Glossary
The broadcasting of messages to a specified group of workstations on a LAN, WAN, or internet. NAK (Negative A communication control character sent by the receiving destination indicating that the last Acknowledgment) message was not received correctly. IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version A1.04.04.2017...
Page 187 PAP (Password Standard authentication protocol for PPP connections. see CHAP Authentication Protocol) RADIUS (Remote An open standard network security server that communicates with the PAP protocol. Authentication Dial In Users Services) Reverse Connection Connections that originate from a host that go directly to a serial device through the IOLAN. RIP (Routing A protocol that allows gateways and hosts to exchange information about various routes to Information Protocol)

This manual is also suitable for:

Iolan scs Iolan sts Iolan mdc

Perle Iolan SDS Cli Reference Manual

Chapter 1 Introduction

Chapter 3 User Commands

Chapter 2 Server Commands

Chapter 4 Line Commands

Chapter 5 Network Commands

Chapter 6 Time Commands

Chapter 7 Administration Commands