EN
Perle Systems logo
Official user manual

Perle Systems CSS

164 pages·2.1 MB·Network Card·PDF·ENDEFRITNLJA
Perle Systems CSS
Table of Contents 309 sections SDS/SCS/STS Command Line Interface Reference Guide · Table of Contents · Preface · About This Book · … ShowHide
SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 1 of the Perle Systems CSS user manual — September 2008
Page 1 · click to enlarge
Page 1

IOLAN

SDS/SCS/STS Command Line Interface

Reference Guide

Version 3.6

Part #5500210-13

September 2008

Page 2 of the Perle Systems CSS user manual — SDS/SCS/STS Command Line Interface Reference Guide
Page 2 · click to enlarge
Page 2

This document must not be reproduced in any way whatsoever, either printed or electronically, without the consent of:

Perle Systems Limited, 60 Renfrew Drive 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.

Microsoft, Windows 98, Windows NT, Windows 2000, Windows Server 2003, Windows XP, Windows Vista, and Internet Explorer are trademarks of Microsoft Corporation.

Perle Systems Limited, 2005-2008.

FCC Note The IOLAN Device Server has been found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instructions in this Guide, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case the user will be required to correct the interference at his/her own expense.

EN 550221998, Class A, Note

Copyright Statement

Page 3 of the Perle Systems CSS user manual — Table of Contents
Page 3 · Contents
Contents

Contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 4 of the Perle Systems CSS user manual — Table of contents
Page 4 · click to enlarge
Page 4

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 5 of the Perle Systems CSS user manual — Table of contents
Page 5 · click to enlarge
Page 5

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 6 of the Perle Systems CSS user manual — Table of contents
Page 6 · click to enlarge
Page 6

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 7 of the Perle Systems CSS user manual — Table of contents
Page 7 · click to enlarge
Page 7

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 8 of the Perle Systems CSS user manual — Table of contents
Page 8 · click to enlarge
Page 8

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 9 of the Perle Systems CSS user manual — Table of contents
Page 9 · click to enlarge
Page 9

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 10 of the Perle Systems CSS user manual — Table of contents
Page 10 · click to enlarge
Page 10

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 11 of the Perle Systems CSS user manual — Table of contents
Page 11 · click to enlarge
Page 11

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 12 of the Perle Systems CSS user manual — Table of contents
Page 12 · click to enlarge
Page 12

Table of contents

SDS/SCS/STS Command Line Interface Reference Guidep.1Table of Contentsp.3Prefacep.15About This Bookp.15Intended Audiencep.15Typeface Conventionsp.15Contacting Technical Supportp.16Making a Technical Support Queryp.16Repair Procedurep.17Feedback on this Manualp.17Introductionp.19CLI Conventionsp.19Command Syntaxp.19Command Shortcutsp.20Command Optionsp.20Server Commandsp.21Server Commandsp.21Set Consolep.21Set Custom-Appp.21Set Port-Bufferingp.22Set Serverp.23Set SSL Serverp.26Set Servicep.27Show Consolep.28Show Custom-Appp.28Show Serverp.28Show Port-Bufferingp.28Show Modbusp.29Hardware Commandsp.29Set Ethernetp.29Show Hardwarep.29SSH Server Commandsp.29Set SSH-Serverp.29Show SSH-Serverp.30SSL/TLS Commandsp.31Set SSL Serverp.31Set SSL Server Cipher-suitep.32Show SSLp.33Modbus Commandsp.33Set Modbus Gatewayp.33Show Modbusp.34Authentication Commandsp.35Set Authenticationp.35Set Authentication Localp.35Set Authentication Kerberosp.36Set Authentication LDAPp.36Set Authentication NISp.37Add RADIUSp.37Delete RADIUSp.37Set Authentication RADIUSp.38Set Authentication TACACS+p.39Set Authentication SecurIDp.39Show Authenticationp.40TruePort Baud Commandsp.40Set TruePort Remap-Baudp.40Show TruePortp.40Email Commandsp.41Set Email-Alert Serverp.41Show Email-Alert Serverp.41Clustering Commandsp.42Add Clustering Slave-IPp.42Delete Clustering Slave-IPp.42Set Clustering Slave-IPp.43Show Clustering Slave-IPp.43Dynamic DNS Commandsp.44Set Dynamic-DNSp.44Set Dynamic-DNS SSLp.44Set Dynamic-DNS SSL Cipher-Suitep.46Show Dynamic-DNSp.47PCI Commandsp.47Set PCI Cardp.47Show PCIp.47Set PCI Wireless-WANp.48Show Wireless-WANp.48IPv6 Commandsp.49Set IPv6p.49Show IPv6p.49Add Custom-IPv6p.50Set Custom-IPv6p.51Delete Custom-IPv6p.51IPv6 Router Advertisementsp.52Set IPv6-Router-Advertisementp.52Show IPv6-Router-Advertisementp.52User Commandsp.53Commands for Users Logged Into the IOLANp.53Adminp.53Helpp.53Kill Linep.53Kill Sessionp.53Logoutp.53Menup.54Pingp.54Resumep.54Rloginp.54Screenp.54Set Termtypep.55Set Userp.55Set User Sessionp.56Show Line Usersp.57SSHp.57Syslog Consolep.58Show Sessionsp.58Show Termtypep.58Startp.58Telnetp.59Versionp.60Configuring Usersp.60Add Userp.60Delete Userp.60Set Default Userp.61Set Userp.64Set User Sessionp.68Show Default Userp.68Show Userp.68Line Commandsp.691-Port vs. 2-Port+ Line Commandsp.69Line Commandsp.69Set Linep.69Set Line Interfacep.74Set Line Servicep.75Set Modemp.78Set Termtypep.78Show Linep.78Line Service Commandsp.79Set Custom-Appp.79Set Rlogin-Clientp.79Set Telnet-Clientp.79Set SSH-Clientp.80Set PPPp.82Set PPP Dynamic-DNSp.86Set SLIPp.86Set UDPp.87Set Vmodemp.88Set Vmodem-Phonep.91Set SSL Linep.91Set SSL Line Cipher-suitep.93Set Modbus-Slave Linep.94Set Modbus-Master Linep.94Set Power-Management Linep.95Set Multihost Linep.96Set Line Initiate-Connectionp.96Show Custom-Appp.96Show Interfacep.96Show Power-Managementp.96Show PPPp.97Show Rlogin-Clientp.97Show SLIPp.97Show SSH-Clientp.97Show Telnet-Clientp.97Show Modbusp.97Show UDPp.97Show Vmodemp.97Show Vmodem-Phonep.97Modem Commandsp.98Add Modemp.98Delete Modemp.98Set Modemp.98Show Modemsp.98Email Commandsp.99Set Email-Alert Linep.99Show Email-Alert Linep.100Packet Forwarding Commandsp.100Set Packet-Forwarding Linep.100Show Packet-Forwarding Linep.103Network Commandsp.105SNMP Commandsp.105Add Communityp.105Add Trapp.105Delete Communityp.106Delete Trapp.106Set SNMPp.106Set SNMP V3-Securityp.107Show SNMPp.108TFTP Commandsp.108Set Server TFTPp.108Hosts Commandsp.108Add Hostp.108Delete Hostp.108Set Hostp.109Show Hostsp.109DNS/WINS Commandsp.109Add DNSp.109Add WINSp.109Delete DNSp.110Delete WINSp.110Show DNSp.110Show Serverp.110Show WINSp.110Gateway Commandsp.111Add Gatewayp.111Delete Gatewayp.112Set Gatewayp.112Show Gatewaysp.112Logging Commandsp.113Set Syslogp.113Show Syslogp.113RIP Commandsp.114Add RIPp.114Delete RIPp.114Set RIPp.115Show RIPp.115Show RIP Peersp.116IPsec Commandsp.116Add IPsecp.116Set IPsecp.116Show IPsecp.119IPsecp.119IPv6 Tunnelsp.119Add IPv6tunnelp.119Set IPv6tunnelp.120Show IPv6tunnelp.120Delete IPv6tunnelp.120L2TP/IPsecp.121Set L2TPp.121Show LT2Pp.123VPN Exceptionsp.123Add VPN Exceptionp.123Set VPN Exceptionp.123Delete VPN Exceptionp.124Show VPN Exceptionp.124Time Commandsp.125Server Commandsp.125Set Timep.125Set Timezonep.125Show Timep.125Show Timezonep.125SNTP Commandsp.126Add SNTPp.126Delete SNTPp.126Set SNTPp.126Show SNTPp.127Show SNTP-Infop.127Time/Date Setting Commandsp.127Set Datep.127Set Summertimep.127Set Summertime Fixedp.128Set Summertime Recurringp.128Show Datep.129Show Summertimep.129Administration Commandsp.131Bootup Commandsp.131Rebootp.131Resetp.131Reset Factoryp.131Savep.131Set Bootupp.132Show ARPp.132Show Bootupp.132TFTP File Transfer Commandsp.132Netloadp.132Netsavep.133Custom Factory Defaultp.134Netloadp.134Setp.134Keys and Certificates Commandsp.135Netloadp.135Netsavep.136MOTD Commandsp.137Set MOTDp.137Show MOTDp.137Statistics Commandsp.139Configuration Statisticsp.139Show Netstatp.139Show Netstat Statisticsp.139Show Modbus Statisticsp.140Show Routesp.140Run-Time Statisticsp.140Delete Arpp.140Show Arpp.140Show Serialp.140Uptimep.140IOLAN+ User Commandsp.141IOLAN+p.141I/O Commandsp.143Global I/O Commandsp.143Set IO UDPp.143Set IO Failsafep.144Set IO Modbusp.144Set IO Temperature-Scalep.144Set Linep.144Set Line Servicep.144Set IOChannelp.145Set IOChannel Modep.145Set IOChannel Digital I/Op.145Set IOChannel Digital Inputp.146Set IOChannel Digital Input (Serial Pins)p.147Set IOChannel Digital Outputp.148Set IOChannel Digital Output (Serial Pins)p.149Set IOChannel Relayp.150Set IOChannel Analog (True Analog)p.151Set IOChannel Analog (Temperature)p.152Set IOChannel IOExtensionp.154Set IOChannel Multihostp.156Set IOChannel IOExtension SSLp.157Show IOChannel Statusp.157Kill IOChannelp.157Show IOp.158Show IOChannelp.158I/O Channel Control Commandsp.158Digital Outputp.158Digital Inputp.159Relayp.159Analog Inputp.159Calibrating Analog Input (Analog/Temperature)p.159Calibrate Analogp.159Reset Calibrationp.159Power Commandsp.161Power Commandsp.161Glossaryp.163
Page 13 of the Perle Systems CSS user manual — Power Commands.................................................................... 151
Page 13 · click to enlarge
Page 13

Chapter 11 Power Commands 151

Power Commands 151

Glossary...........................................................................153

Page 14 of the Perle Systems CSS user manual — Table of Contents
Page 14 · click to enlarge
Page 14
Page 14 of the Perle Systems CSS user manual — Table of Contents
Page 15 of the Perle Systems CSS user manual — Typeface Conventions
Page 15 · click to enlarge
Page 15
Perle Systems CSS — Preface diagram (page 15)
Fig. 1 · Preface

Preface

About This Book

This guide provides the information you need to:

z configure the IOLAN using the Command Line Interface (CLI)

Intended Audience

This guide is for administrators who will be configuring the IOLAN.

Some prerequisite knowledge is needed to understand the concepts and examples in this guide:

z If you are using an external authentication application(s), working knowledge of the authentication application(s).

z Knowledge of TFTP, the transfer protocol the IOLAN uses.

Typeface Conventions

Most text is presented in the typeface used in this paragraph. Other typefaces are used to help you identify certain types of information. The other typefaces are:

At the Cprompt, type: add host

This typeface is used for code examples and system-generated output. It can represent a line you type in, or a piece of your code, or an example of output.

Set the value to TRUE. The typeface used for TRUE is also used when referring to an actual value or identifier that you should use or that is used in a code example.

The italicized portion of these examples shows the typeface used for variables that are placeholders for values you specify. This is found in regular text and in code examples as shown. Instead of entering project, you enter your own value, such as stock_trader, and for yourcode, enter the name of your program.

run yourcode.exec

IOLAN User’s Guide This typeface indicates a book or document title.

See About This Book on page 15 for more information.

This indicates a cross-reference to another chapter or section that you can click on to jump to that section.

Typeface Example Usage · subscribe project subject

Page 16 of the Perle Systems CSS user manual — Who To Contact
Page 16 · click to enlarge
Page 16

Contacting Technical Support

Making a Technical Support Query

Who To Contact

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 When you make a technical support enquiry please have the following information ready:

Item Write Details Here

Company Name and Address

Making a support query via the Perle web page If you have an internet connection, please send details of your problem to Technical Support using the email links provided on the Perle web site in the Support/Services area.

Click here to access our website at the following URL:

http://www.perle.com

Show 8 more labels / short text on this page
Contacting Technical Support · Product Name · Problem Description · Your Name · Country · Phone Number · Fax Number · Email Address
Page 17 of the Perle Systems CSS user manual — Feedback on this Manual
Page 17 · click to enlarge
Page 17

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. This form is on the Perle website, www.perle.com, in the Support/Services area.

Click here to access our web site at the following URL:

http://www.perle.com/support_services/rma_form.asp

Feedback on this Manual

If you have any comments or suggestions for improving this manual please email Perle using the following address:

Emailptac@ perle.com

Please include the title, part number and date of the manual (you can find these on the title page at the front of this manual).

Contacting Technical Support

Page 18 of the Perle Systems CSS user manual — Repair Procedure
Page 18 · click to enlarge
Page 18

Contacting Technical Support

Page 19 of the Perle Systems CSS user manual — Command Syntax
Page 19 · click to enlarge
Page 19

Introduction Chapter 1 1

This book provides the command line interface (CLI) options available for the IOLAN. The commands are grouped by function.

CLI Conventions

This section explains how to interpret the CLI syntax. If you are an existing IOLAN+ customer and would like to configure the IOLAN in the native IOLAN+ interface, you can type the command iolan+ to display and use the native IOLAN+ interface (you must have User Level Admin). See your IOLAN+ User Guide for information on using the IOLAN+ interface.

Command Syntax

Each command is broken down into several categories:

z Description—Provides a brief explanation of how the command is used.

z User Level—Shows which user level(s) (Restricted, Normal, and/or Admin) can issue the command. Some commands have options that are available for one user level and not for another level; this usually occurs when a command is valid for both Normal and Admin user levels, where the Admin user level command will have extended options.

z Syntax—Shows the actual command line options. The options can be typed in any order on the command line. The syntax explanation will use the following command to break down the command syntax:

set service [dhcp/bootp on|off] [telnetd on|off] [httpd on|off] [snmpd on|off] [spcd on|off] [syslog on|off] [dmgrd on|off]

– Square brackets ([]) show the options that are available for the command. You can type a command with each option individually, or string options together in any order you want. For example,

set service dhcp/bootp on telnetd off

– Angle brackets () show that the text inside the brackets is a description for a variable value that you must fill in according to your requirements. In the set server command, you must determine the values for domain, internet, name, password-limit, and subnet-bit-length, if you wish to specify them and not use their defaults (default values provided in the Options description). The angle brackets can also contain a range that can be used.

– The pipe (|) shows an ’or’ condition. For example, valid values for telnetd are either on or off.

z 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.

Page 20 of the Perle Systems CSS user manual — Command Options
Page 20 · click to enlarge
Page 20

Command Shortcuts

When you type a command, you can specify the shortest unique version of that command or you can press the ESC or TAB 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 ESC key to complete the lines as you go along:

set telnet-client map-to-crlf off

where the ESC key was pressed to complete the option as it was typed.

Command Options

When you are typing commands on the command line (while connected to the IOLAN), you can view the options by typing a question mark (?), ESC, or TAB key after any part of the command to see what options are available/valid. For example:

DS$ set vmodem ? failure-string host port style success-string suppress DS$ set vmodem failure-string ? 30 characters maximum DS$ set vmodem failure-string "Vmodem failed" ? failure-string host port style success-string suppress Or press Enter to confirm command DS$ set vmodem failure-string "Vmodem failed" DS$ show vmodem Host Host Port Success String Failure String "Vmodem failed" Suppress Off Style Numeric DS$

CLI Conventions

Page 21 of the Perle Systems CSS user manual — Set Custom-App
Page 21 · click to enlarge
Page 21

Server Commands Chapter 2 2

This chapter defines all the CLI commands associated with configuring the IOLAN server parameters.

Server Commands

Set Console

Description Sets the flow control and baud rate on IOLAN models that have a dedicated console

port. User Level Admin Syntax set console [flow none|soft|hard]

For IOLAN models that have a dedicated console port, defines whether the data flow is handled by using software (Soft), hardware (Hard), or no (None) flow control.

For IOLAN models that have a dedicated console port, specifies the baud rate of the line connected to the console port.

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>

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. Maximum of 80 characters. Use the shell CLI command as described in the SDK Programmer’s Guide to manage the files that you have downloaded to the IOLAN. For example, using sample outraw program, you would type:

outraw -s 0 192.168.2.1:10001 Acct:10001 if you were starting the application on the Server (notice the -s 0 parameter specifies Line 1).

Show 4 more labels / short text on this page
[speed 9600|19200|38400|57600|115200] · Options flow · speed · Options program-command-line
Page 22 of the Perle Systems CSS user manual — Set Port-Buffering
Page 22 · click to enlarge
Page 22

Set Port-Buffering

Description Configures port buffering. User Level Admin Syntax set port-buffering [duplicate-nfs-to-syslog on|off]

[keys-stroke-buffering on|off] [mode off|local|remote|both] [nfs-directory <text>] [nfs-encryption on|off] [nfs-host <config_host>] [time-stamp on|off] [view-port-buffer-string <text>]

When enabled, buffered data is sent to the syslog host to be viewed on the host’s monitor. The default is off.

When enabled, key strokes that are sent from the network host to the serial device on the IOLAN’s serial port are buffered. The default is off.

Specifies where the port buffer log is kept, either Off, Local, Remote, or Both. If Remote or Both is selected, you must specify an NFS server location for the port buffer log.

The directory and/or subdirectories where the Remote Port Buffering files will be created. This field is used when Port Buffering Mode is set to Remote or Both. For multiple IOLANs using the same NFS host, it is recommended that each IOLAN have its own unique directory to house the remote port log files. The default is /device_server/portlogs.

Determines if the data sent to the NFS host is sent encrypted or in the clear across the LAN. The default is set of Off. NOTE: When NFS encryption is enabled, the Decoder utility software is required to be installed on the NFS host for decrypting the data to a readable format. The Decoder utility software can be found on the installation CD-ROM and on the www.perle.com website.

The NFS host that the IOLAN will use for its Remote Port Buffering feature. The IOLAN will open a file on the NFS host for each reverse SSH or reverse Telnet line, and send any port data to be written to those files. The default is None. This field is required when Mode is set to Remote or Both.

Enable/disable time stamping of the port buffer data.

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. You can specify control (unprintable) codes by putting the decimal value in angle brackets < > (for example, Escape b is <027>b). The default is ~view.

Show 9 more labels / short text on this page
Server Commands · Options duplicate-nfs-to-syslog · key-stroke-buffering · mode · nfs-directory · nfs-encryption · nfs-host · time-stamp · view-port-buffer-string
Page 23 of the Perle Systems CSS user manual — Set Server
Page 23 · click to enlarge
Page 23

Set Server

Description Sets server parameters. User Level Admin Syntax set server [auto-obtain-dns on|off] [auto-obtain-gw on|off]

[auto-obtain-wins on|off] [banner on|off] [break on|off] [bypass-password on|off] [dhcp-update-dns on|off] [domain <string>] [flush-on-close on|off] [line-menu-string <string>] [monitor-connection-every <1-32767>] [name <string>] [netmask <IPV4_address>] [oem-login on|off] [password-limit <0-10>] [prompt-with-name on|off] [ip-filter on|off] [session-escape-string <string>] [single-telnet on|off] [monitor-connection-every <seconds>] [active-standby on|off] [miimon <milliseconds>] [updelay <milliseconds>] [power-management-menu-string <string>]

set server internet [eth1|eth2] <IPV4_address> [netmask]

set server internet [eth1|eth2] dhcp/bootp on dhcp-update-dns on

domain-prefix <text>

set server internet [eth1|eth2] dhcp/bootp on dhcp-update-dns off

set server internet [eth1|eth2] dhcp/bootp off <IPV4_address>

set server tftp [retry <integer>] [timeout <integer>]

When DHCP/BOOTP is enabled, you can enable this option to have the IOLAN receive the DNS IP address from the DHCP/BOOTP server.

When DHCP/BOOTP is enabled, you can enable this option to have the IOLAN receive the Default Gateway IP address from the DHCP/BOOTP server.

When DHCP/BOOTP is enabled, you can enable this option to have the IOLAN receive the WINS IP address from the DHCP/BOOTP server.

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. The default is Off.

Enables/disables proprietary inband SSH break signal processing as well as the existing Reverse Telnet break signal. This parameter can also enable/disable the out-of-band break signals for TruePort. The default value is Off.

When set, authorised users who do not have a password set, with the exception of the Admin user, WILL NOT be prompted for a password at login with Local Authentication.

Show 10 more labels / short text on this page
Server Commands · [<netmask>] · set server ssl-passphrase · Options auto-obtain-dns · auto-obtain-gw · auto-obtain-wins · banner · break · bypass-password · Server Commands 23
Page 24 of the Perle Systems CSS user manual — Set Server
Page 24 · click to enlarge
Page 24

The DHCP server will update the DNS server when the IOLAN requests a DHCP IP address (the communication between the DNS server and the DHCP server must already be set up in your network).

Enables the DHCP/BOOTP client process in the IOLAN. By default, this is disabled/off. If this is enabled, the server IP address parameter is disabled.

Unique name for your domain, your location in the global network. Like Hostname, it is a symbolic, rather than a numerical, identifier.

(SCS models only) A domain prefix to uniquely identify the Ethernet interface to the DNS when the IOLAN has two Ethernet interfaces. The format of the Ethernet interface will take the form of .. or ., depending on what is configured.

When enabled, deletes any pending outbound data when a port is closed; as opposed to maintaining the port to send pending data. The default value is Off.

The IOLAN’s unique IPv4 network IP address. If you are using the IOLAN in an IPv6 network, use the set ipv6 command.

Dual Ethernet SCS models require that you specify which Ethernet connection you are setting, either eth1 or eth2.

You must supply a name for the IOLAN.

The network subnet mask. For example, 255.255.0.0.

The string used to access to the Easy Port Access menu without disconnecting the initial reverse SSH or reverse Telnet session.The default string is ~menu.

Specify how often, in seconds, the IOLAN will send a TCP keepalive. This only applies to line service types that support the keepalive feature. The default interval is every 30 seconds

When set, and a custom language file is in use, the login prompt will use the string defined in the language file as the login prompt instead of the default prompt, login:.

Show 13 more labels / short text on this page
Server Commands · dhcp-update-dns · dhcp/bootp · domain · domain-prefix · flush-on-close · internet · internet [eth1|eth2] · name · netmask · line-menu-string · monitor-connection-every · oem-login
Page 25 of the Perle Systems CSS user manual — Set Server
Page 25 · click to enlarge
Page 25

The number of attempts a user is allowed to enter a password for a serial port connection from the network, before the connection is terminated and the user has to attempt to login again. For users logging into the serial port, if this limit is exceeded, the serial port is disabled for 5 minutes. A user with Admin level rights can restart the serial port, bypassing the timeout, by issuing a kill on the disabled serial port. The default value is 3.

Displays the Server Name field value instead of default product name. When enabled, the Server Name is displayed in the IOLAN login prompt, CLI prompt, WebManager login screen, and the heading of the Menu. The default value is Off.

A security feature that when enabled, the IOLAN will only accept data from 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). The default value is Off.

Sets all reverse connections (raw, SSH, and telnet) to a one connection at a time mode. In this mode of operation, the IOLAN will only allow for a single TCP connection at a time to exist for each serial port configured for a reverse connection type. Subsequent connection attempts will be refused until all of the following conditions are met:

z No active connection to serial port exists and at least 1 second has passed since the last connection was terminated.

z All data from the previous connection on the serial port has been transmitted. The IOLAN has logic to automatically detect when a reverse connection is no longer active. When this happens, the connection is reset and the server can go back to a listening for an incoming connection state. Applications using Single Telnet need to be aware that there can be some considerable delay between a network disconnection and the port being available for the next connection attempt; this is to allow any data sent on prior connections to be transmitted out of the serial port. Application network retry logic needs to accommodate this feature. The default value is Off.

(SCS only) Enables/disables the feature of automatically assigning the Ethernet 1 IP address to Ethernet 2 if Ethernet 1 should fail to communicate to the network.

(SCS only) The interval in which the active interface is checked to see if it is still communicating. The default is 100 ms.

(SCS only) The time that the IOLAN will wait to make the secondary interface (Ethernet 2) active after it has been detected as up.

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 <016> or Ctrl-p on the keyboard.

Show 10 more labels / short text on this page
Server Commands · password-limit · prompt-with-name · ip-filter · single-telnet · active-standby · miimon · updelay · power-management-menu-string · Server Commands 25
Page 26 of the Perle Systems CSS user manual — Set SSL Server
Page 26 · click to enlarge
Page 26

A configurable string that allows access to a port to view the multisession screen options, allowing the various options while accessing the particular port on the IOLAN. You can specify control (unprintable) codes by putting the decimal value in angle brackets < > (for example, ESC-b is <027>b). The default value is Ctrl-z s (<026>s in decimal).

The number of times the IOLAN will retry to transmit a TPFT packet to/from a host when no response is received. Enter a value between 0 and 5. The default is 5. A value of 0 (zero) means that the IOLAN will not attempt a retry should TFTP fail.

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 3 seconds.

This is the SSL/TLS passphrase used to generate an encrypted RSA/DSA private key. This private key and passphrase are required for both HTTPS and SSL/TLS connections, unless an unencrpyted private key was generated, then the SSL passphrase is not required. Make sure that you download the SSL private key and certificate if you are using the secure HTTP option (HTTPS) or SSL/TLS. If both RSA and DSA private keys are downloaded to the IOLAN, they need to be generated using the same SSL passphrase for both to work.

Set SSL Server

Description Sets the default SSL/TLS parameters for the server. User Level Admin Syntax set ssl server [version any|tslv1|sslv3] [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>]

Specify whether you want to use:

z 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.

z TLSv1—The connection will use only TLSv1.

z SSLv3—The connection will use only SSLv3. The default is Any.

Specify whether the IOLAN will act as an SSL/TLS client or server. The default is Client.

Enable this option when you want the Validation Criteria to match the Peer Certificate for authentication to pass. If you enable this option, you need to download an SSL/TLS certificate authority (CA) list file to the IOLAN.

Show 8 more labels / short text on this page
Server Commands · session-escape-string · retry · timeout · ssl-passphrase · Options version · type · verify-peer
Page 27 of the Perle Systems CSS user manual — Set Service
Page 27 · click to enlarge
Page 27

Any values that are entered in the validation criteria must match the peer certificate for an SSL connection; any fields left blank will not be validated against the peer certificate.

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.

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.

Up to a 128 character entry for the location; for example, a city. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for the organisation; for example, Accounting. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

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.

Up to a 64 character entry for common name; for example, the host name or fully qualified domain name. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for an email address; for example, acct@anycompany.com. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Set Service

Description Sets server service parameters. User Level Admin Syntax set service [routed on|off] [telnetd on|off] [sshd on|off]

[httpd on|off] [snmpd on|off] [spcd on|off] [sntp on|off] [httpsd on|off] [syslog on|off] [dmgrd on|off] [modbusd on|off] [ipsec on|off]

Route daemon process in the IOLAN on port 520.

Telnet daemon process in the IOLAN on port 23.

SSH daemon process in the IOLAN on port 22.

Show 13 more labels / short text on this page
Server Commands · validation-criteria · country · state-province · locality · organisation · organisation-unit · common-name · email · Options routed · telnetd · sshd · Server Commands 27
Page 28 of the Perle Systems CSS user manual — Show Port-Buffering
Page 28 · click to enlarge
Page 28

HTTP daemon process in the IOLAN on port 80.

SNMP daemon process in the IOLAN on port 161.

SPC (TruePort) daemon process in the IOLAN that supports TruePort Full Mode on UDP port 668. You can still communicate with the IOLAN in Lite Mode when this service is disabled.

Simple Network Time Protocol client process in the IOLAN.

Secure HTTP daemon process in the IOLAN on port 443.

Syslog client process in the IOLAN.

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.

Modbus daemon process in the IOLAN on port 502.

IPsec daemon process in the IOLAN listening and sending on UDP port 500. This is disabled by default.

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

Show Custom-App

Description Shows the custom application server settings. User Level Admin Syntax show custom-app server

Show Server

Description Shows the parameters set for the server. User Level Admin, Normal Syntax show server

Show Port-Buffering

Description Shows the port buffering settings. User Level Normal, Admin Syntax show port-buffering

Show 10 more labels / short text on this page
Server Commands · httpd · snmpd · spcd · sntp · httpsd · syslog · dmgrd · modbusd · ipsec
Page 29 of the Perle Systems CSS user manual — Set SSH-Server
Page 29 · click to enlarge
Page 29

Show Modbus

Description Shows the Modbus settings for the gateway. User Level Normal, Admin Syntax show modbus gateway

Hardware Commands

Set Ethernet

Description Sets the hardware configuration for the Ethernet port(s). User Level Admin Syntax set ethernet [eth1|eth2] speed-and-duplex

You must specify the Ethernet interface if you have an SCS model with dual Ethernet.

Define the Ethernet connection speed at one of the following (desktop models don’t support 1000 Mbps):

z auto—automatically detects the Ethernet interface speed and duplex

z 10 Mbps Half Duplex z 10 Mbps Full Duplex z 100 Mbps Half Duplex z 100 Mbps Full Duplex z 1000 Mbps Full Duplex

Show Hardware

Description Shows the hardware resources, Ethernet link status, date and time. User Level Normal, Admin Syntax show hardware

SSH Server Commands

Set SSH-Server

See Keys and Certificates in the IOLAN User’s Guide for information about the keys and certificates that need to be uploaded or downloaded with the IOLANs SSH server.

Description Configures the IOLANs SSH server. User Level Admin Syntax set ssh-server [authentication rsa on|off]

[authentication dsa on|off] [authentication password on|off] [authentication keyboard-interactive on|off] [break-string <text>] [compression on|off] [ssh1 on|off] [verbose on|off]

set ssh-server cipher [3des on|off] [blowfish on|off]

[cast on|off] [aes on|off] [arcfour on|off]

An authentication method used by SSH version 1 and 2. Use RSA authentication for the SSH session.

Show 6 more labels / short text on this page
Hardware Commands · auto|10-half|10-full|100-half|100-full|1000-full · Options eth1|eth2 · auto|10-half|10-full|100-half|100-full|1000-full · Options authentication rsa · Server Commands 29
Page 30 of the Perle Systems CSS user manual — Show SSH-Server
Page 30 · click to enlarge
Page 30

An authentication method used by SSH version 2. Use DSA authentication for the SSH session.

The user types in a password for authentication.

The user types in a password for authentication.Used for SSH2 only.

Requests compression of all data. Compression is desirable on modem lines and other slow connections, but will only slow down things on fast networks.

Displays debug messages on the terminal.

The break string used for inband SSH break signal processing. A break signal is generated on a specific serial port only when the server's break option is enabled and the user currently connected using reverse SSH has typed the break string exactly. The default is set to ~break, where ~ is tilde; the break string can be up to eight characters.

Allows the user’s client to negotiate an SSH-1 connection, in addition to SSH-2.

Specify which ciphers the IOLAN’s SSH server can use to negotiate data encryption with an SSH client session.

Show SSH-Server

Description Shows the SSH server settings. User Level Admin Syntax show ssh-server

Show 9 more labels / short text on this page
SSH Server Commands · authentication dsa · authentication password · authentication keyboard-interactive · compression · verbose · break-string · ssh1 · cipher
Page 31 of the Perle Systems CSS user manual — Set SSL Server
Page 31 · click to enlarge
Page 31

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] [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>]

Specify whether you want to use:

z 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.

z TLSv1—The connection will use only TLSv1.

z SSLv3—The connection will use only SSLv3. The default is Any.

Specify whether the IOLAN will act as an SSL/TLS client or server. The default is Client.

Enable this option when you want the Validation Criteria to match the Peer Certificate for authentication to pass. If you enable this option, you need to download an SSL/TLS certificate authority (CA) list file to the IOLAN.

Any values that are entered in the validation criteria must match the peer certificate for an SSL connection; any fields left blank will not be validated against the peer certificate.

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.

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.

Up to a 128 character entry for the location; for example, a city. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for the organisation; for example, Accounting. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Show 10 more labels / short text on this page
SSL/TLS Commands · Options version · type · verify-peer · validation-criteria · country · state-province · locality · organisation · Server Commands 31
Page 32 of the Perle Systems CSS user manual — Set SSL Server Cipher-suite
Page 32 · click to enlarge
Page 32

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.

Up to a 64 character entry for common name; for example, the host name or fully qualified domain name. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for an email address; for example, acct@anycompany.com. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Set SSL Server Cipher-suite

Description Sets the default SSL/TLS cipher suite parameters. User Level Admin Syntax set ssl server 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 hmac any|sha1|md5

Options option1|option2|option3|option4|option5 Sets the priority of the cipher suite, with option1 being highest priority and option5 lowest priority.

Select the type of encryption that will be used for the SSL connection:

z Any—Will use the first encryption format that can be negotiated.

z None—Removes any values defined for the cipher option. The default value is Any.

The minimum key size value that will be used for the specified encryption type. The default is 40.

The maximum key size value that will be used for the specified encryption type. The default is 256.

Show 12 more labels / short text on this page
SSL/TLS Commands · organisation-unit · common-name · email · encryption · z AES · z 3DES · z DES · z ARCFOUR · z ARCTWO · min-key-size · max-key-size
Page 33 of the Perle Systems CSS user manual — Set Modbus Gateway
Page 33 · click to enlarge
Page 33

The type of key to exchange for the encryption format:

z Any—Any key exchange that is valid is used (this does not, however, include ADH keys).

z RSA—This is an RSA key exchange using an RSA key and certificate.

z EDH-RSA—This is an EDH key exchange using an RSA key and certificate.

z EDH-DSS—This is an EDH key exchange using a DSA key and certificate.

z ADH—This is an anonymous key exchange which does not require a private key or certificate. Choose this key if you do not want to authenticate the peer device, but you want the data encrypted on the SSL/TLS connection. The default is Any.

Select the key-hashing for message authentication method for your encryption type:

z SHA1 The default is Any.

Show SSL

Description Shows the SSL/TLS settings/information. User Level Normal, Admin Syntax show ssl

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]

[broadcast on|off] [char-timeout <number>] [req-next-delay <number>] [exceptions on|off] [idle-timer <number>] [mess-timeout <number>] [port <TCP/UDP_port>] [req-queuing on|off] [remapped-id <1-247>] [ssl on|off]

Determines if the original UID address will be embedded in the transmission header or if a specified (remapped) UID will be embedded in the transmission header.

When enabled, a UID of 0 (zero) indicates that the message will be broadcast to all Modbus Slaves. The default is Off.

Used in conjunction with the Modbus RTU protocol, specifies how long to wait, in milliseconds, after a character to determine the end of frame. The default is 30 ms.

Show 9 more labels / short text on this page
Modbus Commands · key-exchange · hmac · z Any · z MD5 · Options addr-mode · broadcast · char-timeout · Server Commands 33
Page 34 of the Perle Systems CSS user manual — Show Modbus
Page 34 · click to enlarge
Page 34

A delay, in milliseconds, to allow serial slave(s) to re-enable receivers before issuing next Modbus Master request. The default is 50 ms.

When enabled, an exception message is generated and sent to the initiating Modbus device when any of the following conditions are encountered: there is an invalid UID, the UID is not configured in the Gateway, there is no free network connection, there is an invalid message, or the target device is not answering the connection attempt. The default is On.

Specifies the number of seconds that must elapse without any network or serial traffic before a connection is dropped. If this parameter is set to 0 (zero), a connection will not be dropped (with the following exceptions: the TCP KeepAlive causes the connection to be dropped or the Modbus device drops the connection). The default is 10 seconds.

Time to wait, in milliseconds, for a response message from a Modbus TCP or serial slave (depending if the Modbus Gateway is a Master Gateway or Slave Gateway, respectively) before sending a Modbus exception. The default is 1000 ms.

The network port number that the Slave Gateway will listen on for both TCP and UDP messages. The default is 502.

When enabled, allows multiple, simultaneous messages to be queued and processed in order of reception. The default is On.

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 vis SSL/TLS.

Show Modbus

Description Displays the Modbus Gateway parameters. User Level Admin Syntax show modbus gateway

show modbus slave|master <line_number>

Show 9 more labels / short text on this page
Modbus Commands · req-next-delay · exceptions · idle-timer · mess-timeout · port · req-queuing · remapped-id · ssl
Page 35 of the Perle Systems CSS user manual — Set Authentication Local
Page 35 · click to enlarge
Page 35

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]

The first authentication method that the IOLAN attempts. Some type of authentication must be done by the IOLAN, therefore, None is not a valid option for the Primary Authentication Method.

If the Primary Authentication Method fails, the next authentication method that the IOLAN attempts. You can choose to use authentication methods in combination. For example, you can specify the Primary Authentication Method as Local and the Secondary Authentication Method as RADIUS. Therefore, some users can be defined in the IOLAN (Local) others in RADIUS.

none|local|radius|kerberos|ldap|tacacs+|securid|nis

Specify the authentication method that the IOLAN will use to authenticate users (this must already be set up in your network).

When enabled, the Secondary Authentication method will be tried only when the IOLAN cannot communicate with the Primary Authentication server.

When enabled, the IOLAN will only authenticate the admin user in the local user database, regardless of any external authentication methods configured. When disabled, a user called admin must exist when only external authentication methods are configured, or you will not be able to access the IOLAN as the admin user, except through the console port. The default is on.

Set Authentication Local

Description Configures local authentication settings. When you configure the IOLAN to

authenticate users locally, you can require that the users be configured in the User table. You can also enable the Guest mode. This mode allows users to log into the IOLAN using any user name, but they will only get authenticated if they match the password configured for the Guest account. User Level Admin Syntax set authentication local [guest-mode on|off] [password <text>]

Allow users who are not defined in the User database to log into the IOLAN with any user ID and the specified password. Guest users inherit their settings from the Default User’s configuration.

The password that Guest users must use to log into the IOLAN.

Show 8 more labels / short text on this page
Authentication Commands · Options primary · secondary · secondary-as-backup · auth-admin-user-local · Options guest-mode · password · Server Commands 35
Page 36 of the Perle Systems CSS user manual — Set Authentication LDAP
Page 36 · click to enlarge
Page 36

Set Authentication Kerberos

Description Configures Kerberos authentication settings. User Level Admin Syntax set authentication kerberos [kdc-domain <string>]

[port <TCP_port>] [realm <string>]

The name of a host running the KDC (Key Distribution Center) for the specified realm. The host name that you specify must either be defined in the IOLAN’s Host Table (with an IP address) or be resolvable by a DNS server.

The port that the Kerberos server listens to for authentication requests. If no port is specified, the default port 88 is used.

The Kerberos realm is the Kerberos host domain name, in upper-case letters.

Set Authentication LDAP

Description Configures LDAP authentication settings. User Level Admin Syntax set authentication ldap [base <string>]

[host <hostname/IP_addr>] [port <TCP_port>] [tls on|off] [tls-port <TCP_port>]

The domain component (dc) that is the starting point for the search for user authentication.

The name or IP address of the LDAP host. If you use a host name, that host must either have been defined in the IOLAN’s Host Table (with an IP address) or be resolvable by a DNS server. If you are using TLS, you must enter the same string you used to create the LDAP certificate that resides on your LDAP server.

The port that the LDAP host listens to for authentication requests. The default port is 389.

Enables/disables the Transport Layer Security (TLS) with the LDAP host.

Specify the port number that LDAP will use for TLS. The default is port 636.

Show 9 more labels / short text on this page
Authentication Commands · Options kdc-domain · port · realm · Options base · host · port · tls · tls-port
Page 37 of the Perle Systems CSS user manual — Delete RADIUS
Page 37 · click to enlarge
Page 37

Set Authentication NIS

Description Sets NIS authentication parameters. User Level Admin Syntax set authentication nis [domain <string>] [primary <config_host>]

[secondary <config_host>]

The NIS domain name.

The primary NIS host that is used for authentication.

The secondary NIS host that is used for authentication, should the primary NIS host fail to respond.

Add RADIUS

Description Adds an accounting or authentication RADIUS host. User Level Admin Syntax add radius accounting-host <config_host> secret add radius auth-host <config_host> secret

The first time this command is entered, this is the name of the primary RADIUS accounting host.

The second time this command is entered, this is the name of the secondary RADIUS authentication host.

The first time this command is entered, this is the name of the primary RADIUS authentication host.

The second time this command is entered, this is the name of the secondary RADIUS authentication host, should the first RADIUS host fail to respond.

The secret (password) shared between the IOLAN and the RADIUS authentication host. After typing the command secret and pressing Enter, you will be prompted to enter the secret and then re-enter the secret.

Delete RADIUS

Description Deletes an accounting or authentication RADIUS host. User Level Admin Syntax delete radius accounting <accounting_host> delete radius authentication <authentication_host>

Deletes the specified accounting host from the RADIUS authentication settings.

Deletes the specified authentication host from the RADIUS authentication settings.

Show 10 more labels / short text on this page
Authentication Commands · Options domain · primary · secondary · Options accounting-host · auth-host · secret · Options accounting · authentication · Server Commands 37
Page 38 of the Perle Systems CSS user manual — Set Authentication RADIUS
Page 38 · click to enlarge
Page 38

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>]

Enables/disables RADIUS accounting.

Enables/disables whether or not the IOLAN validates the RADIUS accounting response.

The port that the RADIUS host listens to for accounting requests. The default port is 1813.

The port that the RADIUS host listens to for authentication requests. The default port is 1812.

This is the string that identifies the Network Address Server (NAS) that is originating the Access-Request to authenticate a user. Field Format: Maximum 31 characters, including spaces

When specified, the IOLAN will send the IOLAN’s Ethernet 1 IPv4 address to the RADIUS server. This is the default.

nas-ip-address specify <ipv4_address>

When specified, the IOLAN will send the specified IPv4 address to the RADIUS server. The default is 0.0.0.0.

When specified, the IOLAN will send the IOLAN’s IPv6 address to the RADIUS server. This is the default.

nas-ipv6-address specify <ipv6_address>

When specified, the IOLAN will send the specified IPv6 address to the RADIUS server.

The number of times the IOLAN tries to connect to the RADIUS server before erroring out. Valid values are 0-255. The default is 5.

The time, in seconds, that the IOLAN waits to receive a reply after sending out a request to a RADIUS accounting or authentication host. If no reply is received before the timeout period expires, the IOLAN will retry the same host up to and including the number of retry attempts. Valid values are 1-255. The default is 3 seconds.

Show 10 more labels / short text on this page
Authentication Commands · Options accounting · acct-authenticator · acct-port · auth-port · nas-identifier · nas-ip-address auto · nas-ipv6-address auto · retry · timeout
Page 39 of the Perle Systems CSS user manual — Set Authentication SecurID
Page 39 · click to enlarge
Page 39

Set Authentication TACACS+

Description Configures TACACS+ authentication settings. User Level Admin Syntax set authentication tacacs+ [port <TCP_port>]

[primary <config_host>] [secondary <config_host>] [secret <string>]

The port number that TACACS+ listens to for authentication requests. The default port number is 49.

The primary TACACS+ host that is used for authentication.

The secondary TACACS+ host that is used for authentication, should the primary TACACS+ host fail to respond.

The TACACS+ shared secret is used to encrypt/decrypt TACACS+ packets in communications between two devices. The shared secret may be any alphanumeric string. Each shared secret must be configured on both client and server sides.

Set Authentication SecurID

Description Configures SecurID authentication settings. User Level Admin Syntax set authentication securid primary [host <config_host>]

[port <TCP_port>] [encryption des|sdi] [legacy on|off]

set authentication securid replica [host <config_host>]

[port <TCP_port>] [encryption des|sdi] [legacy on|off]

set authentication securid reset secret

The first SecurID server that is tried for user authentication.

If the first SecurID server does not respond to an authentication request, this is the next SecurID server that is tried for user authentication.

The port number that SecurID listens to for authentication requests. The default port number is 5500.

You can specify either SDI or DES encryption for SecurID server communication. The default is SDI encryption.

If you are running SecurID 3.x or 4.x, you need to run in Legacy Mode. If you are running SecurID 5.x or above, do not select Legacy Mode.

Resets the SecurID secret (password) in the IOLAN.

Show 12 more labels / short text on this page
Authentication Commands · Options port · primary · secondary · secret · Options primary host · replica host · port · encryption · legacy · reset secret · Server Commands 39
Page 40 of the Perle Systems CSS user manual — Show TruePort
Page 40 · click to enlarge
Page 40

Show Authentication

Description Shows the authentication settings. If you type just the show authentication

command, the configured primary and secondary authentication methods are displayed. User Level Admin Syntax show authentication radius|ldap|tacacs+|nis|kerberos|securid

Option radius|ldap|tacacs+|nis|kerberos|securid

Displays the authentication settings for the specified authentication method.

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| 38400 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200| 38400|57600|115200|230400|28800|[custom <baud_rate]

The configured baud rate of the TruePort client.

50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200|38400| 57600|115200|230400|28800|[custom <baud_rate>]

The actual baud rate that runs between the IOLAN and the connected serial device. You can also specify a custom baud rate; valid values are 50 - 1843200.

Show TruePort

Description Shows the IOLAN TruePort remapping table. User Level Normal, Admin Syntax show trueport

TruePort Baud Commands · Options 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19200|38400

Page 41 of the Perle Systems CSS user manual — Show Email-Alert Server
Page 41 · click to enlarge
Page 41

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>]

Options from This will be the contents of the from field in the generated email.

This field will be specified in the from field of the email message sent by the IOLAN.

Choose the event level that triggers an email notification:

z Debug The list is in decreasing order of priority (Emergency has the highest priority). You are selecting the lowest notification level; therefore, when you select Debug, you will get an email notification for all events that trigger a message.

Determines whether or not email notification is turned on. Default is Off.

An email address or list of email addresses that will receive the email notification.

The email address to whom all replies to the email notification should go.

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.

A text string, which can contain spaces, that will display in the Subject field of the email notification.

If the text string contains spaces, enclose the string in quotes.

Show Email-Alert Server

Description Shows how the server email alert is configured. User Level Admin Syntax show email-alert server

Show 15 more labels / short text on this page
Email Commands · level · z Emergency · z Alert · z Critical · z Error · z Warning · z Notice · z Info · mode · to · reply-to · smtp-host · subject · Server Commands 41
Page 42 of the Perle Systems CSS user manual — Delete Clustering Slave-IP
Page 42 · click to enlarge
Page 42

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>]

Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group. The IP address must be in a valid IPv4 format.

Specify the port number that you wish to modify on this clustering slave.

Specify the protocol that will be used to access the Slave IOLAN port, SSH or Telnet.

Specify this parameter if you wish to change the name associated with this slave port.

Specify this parameter if you wish to change the slave-ds-port associated with this slave port. This should match the port number configured for this port on the salve IOLAN.

Delete Clustering Slave-IP

Description Deletes a Slave IOLAN from the clustering group. Type

delete clustering slave-ip ? to get a list of Slave IOLAN IP addresses. User Level Admin Syntax delete clustering slave-ip <IPv4_address> Option <IPv4_address>

Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group. The IP address must be in a valid IPv4 format.

Show 6 more labels / short text on this page
Clustering Commands · Options <IPv4_address> · number-of-ports · protocol · starting-master-tcp-port · starting-slave-ds-port
Page 43 of the Perle Systems CSS user manual — Show Clustering Slave-IP
Page 43 · click to enlarge
Page 43

Set Clustering Slave-IP

Description Modify the parameter associated with a specific port in a clustering group. User Level Admin Syntax set clustering slave-ip <IPv4_address> port <number>

[master-tcp-port <10001-65535>] [name <port_name>] [protocol telnet|ssh|not-used] [slave-ds-port <10001-65535>]

Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group. The IP address must be in a valid IPv4 format.

Specify the port number that you wish to modify on this clustering slave.

Specify this parameter if you wish to change the name associated with this slave port.

Specify this parameter if you wish to change the name associated with this slave port.

Specify this parameter if you wish to change the protocol used to access this slave port. Valid options are SSH, Telnet or not used if you wish to disable access to this port.

Specify this parameter if you wish to change the slave-ds-port associated with this slave port. This should match the port number configured for this port on the salve IOLAN.

Show Clustering Slave-IP

Description Show a Slave IOLANs clustering group settings. Type

show clustering slave-ip ? to get a list of Slave IOLAN IP addresses. User Level Admin Syntax show clustering slave-ip <IPv4_address> [get-port-names]

Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group. The IP address must be in a valid IPv4 format.

get-port-names Retrieves the port/line names from the specified Slave IOLAN.

get-port-names-and-save Retrieves the port/line names from the specified Slave IOLAN and saves them in the Slave IOLAN clustering configuration.

Show 9 more labels / short text on this page
Clustering Commands · Options <IPv4_address> · port · master-tcp-port · name · protocol · slave-ds-port · [get-port-names-and-save] Options <IPv4_address> · Server Commands 43
Page 44 of the Perle Systems CSS user manual — Set Dynamic-DNS SSL
Page 44 · click to enlarge
Page 44

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]

Specify how the IOLAN is going to connect to the DynDNS.org server, via HTTP, HTTP through Port 8245, or HTTPS.

Specify the registered hostname with DynDNS.org that will be updated with the IOLAN’s IP address should it change. Put in the full name; for example, mydeviceserver.dyndns.org.

Specify the user name used to access the DynDNS.org server.

Specify the password used to access the DynDNS.org server.

Specify how your account was set up with DynDNS.org, using a Dynamic, Static, or Custom IP address schema.

Adds an alias to *.yourhost.ourdomain.ext pointing to the same IP address as entered for yourhost.ourdomain.ext.

Set Dynamic-DNS SSL

Description Sets the SSL/TLS parameters for the connection between the IOLAN and the DNS

server. User Level Admin Syntax set dynamic-dns ssl [verify-peer on|off]

[validation-criteria country <code>|state-province <text>|locality <text> |organisation <text>|organisation-unit <text> |common-name <text>|email <email_addr>]

Enable this option when you want the Validation Criteria to match the Peer Certificate for authentication to pass. If you enable this option, you need to download an SSL/TLS certificate authority (CA) list file to the IOLAN.

Any values that are entered in the validation criteria must match the peer certificate for an SSL connection; any fields left blank will not be validated against the peer certificate.

Show 9 more labels / short text on this page
Dynamic DNS Commands · Options connection-method · hostname · username · password · system-type · wildcard · Options verify-peer · validation-criteria
Page 45 of the Perle Systems CSS user manual — Dynamic DNS Commands
Page 45 · click to enlarge
Page 45

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.

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.

Up to a 128 character entry for the location; for example, a city. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for the organisation; for example, Accounting. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

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.

Up to a 64 character entry for common name; for example, the host name or fully qualified domain name. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for an email address; for example, acct@anycompany.com. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Show 9 more labels / short text on this page
Dynamic DNS Commands · country · state-province · locality · organisation · organisation-unit · common-name · email · Server Commands 45
Page 46 of the Perle Systems CSS user manual — Set Dynamic-DNS SSL Cipher-Suite
Page 46 · click to enlarge
Page 46

Set Dynamic-DNS SSL Cipher-Suite

Description Sets the SSL/TLS cipher suite parameters for the connection between the IOLAN and

the DNS server. User Level Admin Syntax set dynamic-dns ssl 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 hmac any|sha1|md5

Options option1|option2|option3|option4|option5 Sets the priority of the cipher suite, with option1 being highest priority and option5 lowest priority.

Select the type of encryption that will be used for the SSL connection:

z Any—Will use the first encryption format that can be negotiated.

z None—Removes any values defined for the cipher option. The default value is Any.

The minimum key size value that will be used for the specified encryption type. The default is 40.

The maximum key size value that will be used for the specified encryption type. The default is 256.

The type of key to exchange for the encryption format:

z Any—Any key exchange that is valid is used (this does not, however, include ADH keys).

z RSA—This is an RSA key exchange using an RSA key and certificate.

z EDH-RSA—This is an EDH key exchange using an RSA key and certificate.

z EDH-DSS—This is an EDH key exchange using a DSA key and certificate.

z ADH—This is an anonymous key exchange which does not require a private key or certificate. Choose this key if you do not want to authenticate the peer device, but you want the data encrypted on the SSL/TLS connection. The default is Any.

Show 10 more labels / short text on this page
Dynamic DNS Commands · encryption · z AES · z 3DES · z DES · z ARCFOUR · z ARCTWO · min-key-size · max-key-size · key-exchange
Page 47 of the Perle Systems CSS user manual — Show PCI
Page 47 · click to enlarge
Page 47

Select the key-hashing for message authentication method for your encryption type:

z SHA1 The default is Any.

Show Dynamic-DNS

Description Shows the dynamic DNS settings. User Level Admin Syntax show dynamic-dns

PCI Commands

Set PCI Card

Description Sets the type of card in the PCI slot. User Level Admin Syntax set pci card none|modem|wireless-wan

Specify the type of card which is inserted in the PCI slot. Choices are modem for an IOLAN modem card, wireless-wan for a wireless WAN card. Choose none or leave the default modem if no card is inserted in the PCI slot.

Show PCI

Description Displays the PCI line settings. User Level Admin Syntax show pci

Show 6 more labels / short text on this page
PCI Commands · hmac · z Any · z MD5 · Option card · Server Commands 47
Page 48 of the Perle Systems CSS user manual — Show Wireless-WAN
Page 48 · click to enlarge
Page 48

Set PCI Wireless-WAN

Description Configures the wireless WAN parameters. User Level Admin Syntax set pci wireless-wan [access-point-name <name>]

[init-string <modem_init_string>] [model sierra-wireless-aircard-881|sony-ericsson-pc300|sierra| sony-ericsson|standard|custom] [password <password>][phone-number <phone_number>] [user <username>]

Specify the APN required by your internet provider to access their network. See the internet provider documentation for more information.

Specify the initialisation string required by your internet service provider for your wireless WAN card.

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.

Specify the password required by your internet provider to access their network.

Specify the phone number provided by your service provider to access their wireless network. The phone number will probably take a format similar to *99***1#.

Specify the name required by your internet provider to access their network.

Show Wireless-WAN

Description Displays the wireless WAN settings. User Level Admin Syntax show wireless-wan

Show 7 more labels / short text on this page
PCI Commands · Options access-point-name · init-string · model · password · phone-number · user
Page 49 of the Perle Systems CSS user manual — Show IPv6
Page 49 · click to enlarge
Page 49

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] [enable-ipv6-addressing on|off] [obtain-using auto-ipv6|dhcpv6]

Determines the types of information that the IOLAN will accept from the DHCPv6 server, IPv6 address(es) and/or network prefix(es).

When enabled, the IOLAN will accept IPv6 address(es) from the DHCPv6 server. This is off by default.

When enabled, the IOLAN will accept the network prefix from the DHCPv6 server. This is off by default.

Configures the IPv6 settings for the IOLAN’s Ethernet interface 1 and/or Ethernet interface 2 (SCS models only) connection(s).

When enabled, you can configure the IOLAN to obtain the IPv6 address(es) using IPv6 Autoconfiguration or a DHCPv6 server. Default: Enabled

z auto-ipv6—When enabled, the IOLAN will send out a Router Solicitation message. If a Router Advertisement message is received, the IOLAN will configure the IPv6 address(es) and configuration parameters based on the information contained in the advertisement. If no Router Advertisement message is received, the IOLAN will attempt to connect to a DHCPv6 server to obtain IPv6 addresses and other configuration parameters. This is the default.

z dhcpv6—When enabled, requests IPv6 address(es) and configuration information from the DHCPv6 server.

Show IPv6

Description Shows the IPv6 settings. User Level Admin Syntax show ipv6 [eth1|eth2] Option eth1|eth2

Displays the configuration IPv6 information for the specified Ethernet interface.

Show 8 more labels / short text on this page
IPv6 Commands · Options dhcpv6-settings · ivp6-address · network-prefix · eth1|eth2 · enable-ipv6-addressing · obtain-using auto-ipv6|dhcpv6 · Server Commands 49
Page 50 of the Perle Systems CSS user manual — Add Custom-IPv6
Page 50 · click to enlarge
Page 50

Add Custom-IPv6

Description User Level Admin Syntax add custom-ipv6 [eth1|eth2] method auto

network-prefix <network_prefix> [prefix-bits <0-64>] [router-advertisement on|off]

add custom-ipv6 [eth1|eth2] method manual

ipv6-address <ipv6_address> [prefix-bits <0-128>] [router-advertisement on|off]

Configures the custom IPv6 settings for the IOLAN’s Ethernet interface 1 or Ethernet interface 2 (SCS models only) interface.

When this option is specified, the IOLAN will derive an IPv6 address from the entered network prefix and the IOLAN’s MAC address. This is the default option.

Specify the IPv6 network prefix. The IOLAN will derive the complete IPv6 address from the entered network prefix and the IOLAN’s MAC address.

Specify the network prefix bits for the IPv6 address. Range: 0-64 Default: 64

Specify this option when you want to enter a specific IPv6 address.

Specify the complete IPv6 address. Field Format: IPv6 address

Specify the network prefix bits for the IPv6 address. Range: 0-128 Default: 64

When enabled, the IPv6 address is advertised when the IPv6-router-advertisement parameter is enabled.

Show 9 more labels / short text on this page
IPv6 Commands · Options eth1|eth2 · method auto · network-prefix · prefix-bits (auto) · method manual · ipv6-address · prefix-bits (manual) · router-advertisement
Page 51 of the Perle Systems CSS user manual — Delete Custom-IPv6
Page 51 · click to enlarge
Page 51

Set Custom-IPv6

Description Configures custom IPv6 network and IP addresses. User Level Admin Syntax set custom-ipv6 [eth1|eth2] <config_ipv6_address> method auto

network-prefix <network_prefix> [prefix-bits <0-64>] [router-advertisement on|off]

set custom-ipv6 [eth1|eth2] <config_ipv6_address> method manual

ipv6-address <ipv6_address> [prefix-bits <0-128>] [router-advertisement on|off] Options eth1|eth2

Configures the custom IPv6 settings for the IOLAN’s Ethernet interface 1 or Ethernet interface 2 (SCS models only) interface.

When this option is specified, the IOLAN will derive an IPv6 address from the entered network prefix and the IOLAN’s MAC address. This is the default option.

Specify the IPv6 network prefix. The IOLAN will derive the complete IPv6 address from the entered network prefix and the IOLAN’s MAC address.

Specify the network prefix bits for the IPv6 address. Range: 0-64 Default: 64

Specify this option when you want to enter a specific IPv6 address.

Specify the complete IPv6 address. Field Format: IPv6 address

Specify the network prefix bits for the IPv6 address. Range: 0-128 Default: 64

When enabled, the IPv6 address is advertised when the IPv6-router-advertisement parameter is enabled.

Delete Custom-IPv6

Description Deletes the specified custom IPv6 address. To see a list of configured IPv6 addresses,

type the command delete custom-ipv6 ?. User Level Admin Syntax delete custom-ipv6 <config_ipv6_address> [eth1|eth2] Option eth1|eth2

Deletes the specified custom IPv6 address. You must specify the Ethernet interface for SCS models.

Show 9 more labels / short text on this page
IPv6 Commands · method auto · network-prefix · prefix-bits (auto) · method manual · ipv6-address · prefix-bits (manual) · router-advertisement · Server Commands 51
Page 52 of the Perle Systems CSS user manual — Show IPv6-Router-Advertisement
Page 52 · click to enlarge
Page 52

IPv6 Router Advertisements

Set IPv6-Router-Advertisement

Description Configures IPv6 router advertisements. User Level Admin Syntax set ipv6-router-advertisement [eth1|eth2] 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 and respond to Router Solicitation messages. The Router Advertisement message can be configured to contain any of the following information:

z DHCPv6—Use the DHCPv6 server to obtain additional IPV6 address(es) and configuration parameters.

z DHCPv6 Configuration Options—Use DHCPv6 server to obtain additional configuration parameters.

z Network Prefixes—Advertise the selected custom configured network prefixes. Default: Disabled

Configures the IPv6 router advertisement settings for the IOLAN’s Ethernet interface 1 or Ethernet interface 2 (SCS models only) interface.

When enabled, the Router Advertisement message indicates to use the DHCPv6 server for obtaining additional IPv6 addresses and configuration parameters. Default: Disabled

When enabled, the Router Advertisement message indicates to use the DHCPv6 server to obtain additional configuration parameters. Default: Disabled

Show IPv6-Router-Advertisement

Description Displays the IPv6 router advertisement settings. User Level Admin Syntax show ipv6-router-advertisement [eth1|eth2] Option eth1|eth2

Displays the IPv6 router advertisement settings for the IOLAN’s Ethernet interface 1 or Ethernet interface 2 (SCS models only) interface.

Show 4 more labels / short text on this page
IPv6 Router Advertisements · eth1|eth2 · dhcpv6 · dhcpv6-cfg-options
Page 53 of the Perle Systems CSS user manual — Logout
Page 53 · click to enlarge
Page 53

User Commands Chapter 3 3

This chapter defines all the CLI commands available to users who are logged into the IOLAN.

Commands for Users Logged Into the IOLAN

Admin

Description Changes a Normal-level user to the Admin user. When you press Enter after you type

this command, you will be prompted for the Admin password. User Level Normal Syntax admin

Help

Description Displays help on using the command line interface (CLI). User Level Restricted, Normal, Admin Syntax help

Kill Line

Description Restarts a line. On IOLANs with more than 1 port, you can specify a port number and

then a range of ports; for example, kill line 4, 10-13, 15. This command can also be used to reset the internal modem on the IOLAN. The internal modem is addressed as last serial port +1 (i.e., on an SDS 3M, the modem is line 4). On single port models, use the command kill line. User Level Normal, Admin Syntax kill line *|<number>|<number range> Note: the * is a wildcard meaning all lines.

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.

Logout

Description Logs the user out from the IOLAN. User Level Restricted, Normal, Admin Syntax logout

Page 54 of the Perle Systems CSS user manual — Screen
Page 54 · click to enlarge
Page 54

Commands for Users Logged Into the IOLAN

Menu

Description Switches from a command line based interface to Menu mode of operation. User Level Restricted, Normal, Admin Syntax menu

Ping

Description This command checks to see if a given host is reachable via an IP message. The

specific message used is called a ping. User Level Normal, Admin Syntax ping <hostname/IP_address> [<packet_size>] [<#_of_packets>]

Options <hostname/IP_address> The name (DNS resolvable host name) or IP address of the machine you are trying to ping.

<packet_size> Enter the number of data bytes to be sent. The default is 100 bytes.

<#_of_packets> Enter the number of the packets you want to send. The default is 10.

Resume

Description Resumes a started session. User Level Restricted, Normal, Admin Syntax resume 1|2|3|4

Options 1|2|3|4 The number of the session you want to resume.

Rlogin

Description Starts an rlogin session to the specified host/IP address. User Level Normal, Admin Syntax rlogin <hostname/IP_address> [termtype <terminal_name>]

[user <string>]

Options <hostname/IP_address>

The name of the target host.

Type of terminal attached to this line; for example, ansi or wyse60.

user The name of the user logging into the rlogin session.

Screen

Description Switches from a command line based interface to Menu mode of operation. User Level Restricted, Normal, Admin Syntax screen

termtype

Page 55 of the Perle Systems CSS user manual — Set User
Page 55 · click to enlarge
Page 55

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

Specifies the type of terminal connected to the line:

z VT320 (specifically supporting VT320-7)

z HP700 (specifically supporting HP700/44)

z Term1, Term2, Term3 (user-defined terminals)

Set User

Description Sets the current users settings. User Level Normal, Admin Syntax set user . [hotkey-prefix <00-7f>] [language english|customlang]

The prefix that a user types to control the current session. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.):

z ^a number—To switch from one session to another, press ^a and then the required session number. For example, ^a 2 would switch you to session 2. Pressing ^a 0 will return you to the IOLAN Menu.

z ^a n—Display the next session. The current session will remain active. The lowest numbered active session will be displayed.

z ^a p—Display the previous session. The current session will remain active. The highest numbered active session will be displayed.

z ^a m—To exit a session and return to the IOLAN. You will be returned to where you left off. The session will be left running.

z ^a l—(Lowercase L) Locks the line until the user unlocks it. The user is prompted for a password (any password, excluding spaces) and locks the line. Next, the user must retype the password to unlock the line.

z ^r—When you switch from a session back to the Menu, the screen may not be redrawn correctly. If this happens, use this command to redraw it properly. This is always Ctrl R, regardless of the Hotkey Prefix. The User Hotkey Prefix value overrides the Line Hotkey Prefix value. You can use the Hotkey Prefix keys to lock a line only when the line Lock parameter is On.

You can specify whether a user will use English or Customlang as the language that appears in the Menu, CLI, or WebManager. The IOLAN supports one custom language that must be downloaded to the IOLAN; otherwise, Customlang defaults to English.

Show 12 more labels / short text on this page
wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2| term3 · Option wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2|term3 · z Dumb · z WYSE60 · z VT100 · z ANSI · z TVI925 · z IBM3151TE · [routing none|send|listen|send-and-listen] [password] · Options hotkey-prefix · language · User Commands 53
Page 56 of the Perle Systems CSS user manual — Set User Session
Page 56 · click to enlarge
Page 56

Commands for Users Logged Into the IOLAN

Determines the routing mode used for RIP packets on the PPP and SLIP interfaces for this user. Values are:

z None—RIP packets are neither received nor sent by the IOLAN.

z Send—RIP packets can only be sent by the IOLAN.

z Listen—RIP packets can only be received by the IOLAN.

z Send and Listen—RIP packets are sent and received by the IOLAN.

The password the user will need to enter to login to the IOLAN. This case-sensitive field accepts a maximum of 16 characters.

Set User Session

Description Sets the current users session settings. User Level Normal, Admin Syntax set user . session 1|2|3|4|* [auto on|off]

set user . session 1|2|3|4|* telnet-options [host <config_host>]

[port <TCP_port>] [termtype <terminal_name>] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof <00-7f>] [erase <00-7f>] [intr <00-7f>] [quit <00-7f>]

set user . session 1|2|3|4|* rlogin-options [host <config_host>]

[termtype <terminal_name>]

set user . session 1|2|3|4|* ssh-options [host <config_host>]

[port <TCP_port>] [termtype <terminal_name>] [protocol ssh-1|ssh-2|ssh-2/1] [compression on|off] [verbose on|off] [auto-login on|off] [name <string>] [password <string>] [ssh-1-cipher 3des|des|blowfish] [authentication rsa on|off] [authentication dsa on|off] [authentication keyboard-interactive on|off]

set user . session 1|2|3|4|* ssh-options

ssh-2-cipher-list <3des blowfish cast aes arcfour>

Specifies the session number (or all, *) that you are configuring.

Specify whether or not the session(s) will start automatically when the user logs into the IOLAN.

telnet-options See Set Telnet-Client in the IOLAN User’s Guide.

rlogin-options See Set Rlogin-Client in the IOLAN User’s Guide.

ssh-options See Set SSH-Client in the IOLAN User’s Guide.

Show 5 more labels / short text on this page
routing · password · [type off|telnet|rlogin|ssh] · Options session · auto
Page 57 of the Perle Systems CSS user manual — SSH
Page 57 · click to enlarge
Page 57

Commands for Users Logged Into the IOLAN

Show Line Users

Description Shows the users who are on the line. User Level Admin Syntax show line users

SSH

Description Starts an SSH session to the specified host/IP address. User Level Normal, Admin Syntax ssh <hostname/IP_address> [<TCP_port>]

[termtype <terminal_name>] [authentication rsa on|off] [authentication dsa on|off] [authentication keyboard-interactive on|off] [compression on|off] [protocol ssh-1|ssh-2|ssh-2,1] [ssh-1-cipher 3des|des|blowfish] [ssh-2-cipher-list <3des blowfish cast aes arcfour> end-list] [user <name>] [verbose on|off]

Options <hostname/IP_address>

The name (resolvable via DNS) or IP address of the host you wish to connect to with SSH.

The port number the target host is listening on for incoming connections. The default for SSH is port number 22.

Type of terminal attached to this line; for example, ANSI or WYSE60.

An authentication method used by SSH version 1 and 2. When enabled, an SSH client session will try to authenticate via RSA.

An authentication method used by SSH version 2. When enabled, an SSH client session will try to authenticate via DSA.

The user types in a password for authentication.Used for SSH2 only.

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.

Select the encryption method (cipher) that you want to use for your SSH version 1 connection:

Show 10 more labels / short text on this page
<TCP_port> · termtype · authentication rsa · authentication dsa · authentication keyboard-interaction · compression · ssh-1-cipher · z 3DES · z Blowfish · User Commands 55
Page 58 of the Perle Systems CSS user manual — Start
Page 58 · click to enlarge
Page 58

Commands for Users Logged Into the IOLAN

Select the order of negotiation for the encryption method (ciphers) that the IOLAN will use for the SSH version 2 connection:

The name of the user logging into the SSH session.

Displays debug messages on the terminal.

Syslog Console

Description Starts/stops or displays the status of the syslog console. User Level Admin Syntax syslog console start|stop

Start or stop console logging. When console logging is enabled, syslog messages will be echoed to the current console. These messages are filtered based on the level set in the (remote) syslog options.

status Displays the current console logging status (enabled or disabled).

Show Sessions

Description Shows available sessions. 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

Options 1|2|3|4 The number of the session that you want to start.

Show 10 more labels / short text on this page
ssh-2-cipher-list · z 3DES · z Blowfish · z AES · z Arcfour · z CAST · user · verbose · syslog console status · Options start|stop
Page 59 of the Perle Systems CSS user manual — Telnet
Page 59 · click to enlarge
Page 59

Commands for Users Logged Into the IOLAN

Telnet

Description Starts a telnet session to the specified host/IP address. User Level Normal, Admin Syntax telnet <hostname/IP_address> [<TCP_port>]

[termtype <terminal_name>] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof <00-7f>] [erase <00-7f>] [intr <00-7f>] [quit <00-7f>] [escape <00-7f>]

Options <hostname/IP_address>

The name (resolvable via DNS) or IP address of the host you wish to connect to with Telnet.

The port number the target host is listening on for incoming connections. The default for Telnet is port number 23.

Type of terminal attached to this line; for example, ANSI or WYSE60.

When On, keyboard input is not sent to the remote host until Enter is pressed, otherwise input is sent every time a key is pressed. Default is Off.

Maps carriage returns (CR) to carriage return line feed (CRLF). The default value is Off.

Toggles between local echo of entered characters and suppressing local echo. Local echo is used for normal processing, while suppressing the echo is convenient for entering text that should not be displayed on the screen, such as passwords. This parameter can only be used when Line Mode is On. Default is Off.

Defines the echo character. When Line Mode is On, typing the echo character echoes the text locally and sends only completed lines to the host. This value is in hexadecimal with a default value of 5 (ASCII value ^E).

Defines the end-of-file character. When Line Mode is On, entering the EOF character as the first character on a line sends the character to the remote host. This value is in hexadecimal with a default value of 4 (ASCII value ^D).

Defines the erase character. When Line Mode is Off, typing the erase character erases one character. This value is in hexadecimal with a default value of 8 (ASCII value ^H).

Defines the interrupt character. Typing the interrupt character interrupts the current process. This value is in hexadecimal with a default value of 3 (ASCII value ^C).

Defines the quit character. Typing the quit character closes and exits the current telnet session. This value is in hexadecimal with a default value of 1c (ASCII value FS).

Show 11 more labels / short text on this page
<TCP_port> · termtype · line-mode · map-cr-crlf · local-echo · echo · eof · erase · intr · quit · User Commands 57
Page 60 of the Perle Systems CSS user manual — Delete User
Page 60 · click to enlarge
Page 60

Defines the escape character. Returns you to the command line mode. This value is in hexadecimal with a default value of 1d (ASCII value GS).

Version

Description Displays firmware version and build. User Level Normal, Admin Syntax version

Configuring Users

Add User

Description For units with 4 or less serial ports, you can configure up to 4 users. For units with 8 or

more serial ports, the maximum number of users which can be added is 48. This is in addition to the admin user. User Level Admin Syntax add user <username>

Option <username> The name of the user, without spaces. When you finish the command and press Enter, you will be prompted to enter and re-enter a password for the user.

Delete User

Description Deletes a user. User Level Admin Syntax delete user <config_user>

Option <config_user> You can see a list of users that can be deleted by typing delete user ?. You can not delete the admin user.

Configuring Users · escape

Page 61 of the Perle Systems CSS user manual — Set Default User
Page 61 · click to enlarge
Page 61

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 service parameter of the default user to ppp, when a new user is added, their service parameter will be set to ppp. User Level Admin Syntax set default user [callback on|off] [framed-compression on|off]

[framed-ip <IPv4_address>] [framed-interface-id <IPv6_interface_id>] [framed-mtu <64-1500>] [hotkey-prefix <00-7f>] [idle-timer <0-4294967>] [host-ip None|<IP_address>|<config_host>] [language english|customlang] [level admin|normal|restricted|menu] [line-access readin|readout|readwrite [on|off]|<line(s)> [0]] [netmask <IPv4_address>] [phone-number <phone_number>] [routing none|send|listen|send-and-listen] [service dsprompt|telnet|tcp-clear|rlogin|ppp|slip|ssh|ssl-raw] [sess-timer <0-4294967>] [port tcp-clear|telnet|ssh|ssl-raw <TCP_port>] [access-clustered-ports on|off]

When On, enter a phone number for the IOLAN to call the user back (the Callback parameter is unrelated to the Line Dial parameter). Note: the IOLAN will allow callback only when a user is authenticated. If the protocol over the link does not provide authentication, there will be no callback. Therefore, when the Line Service is set to PPP, you must use either PAP or CHAP, because these protocols provide authentication. The default is Off. The IOLAN supports another type of callback, Roaming Callback, which is configurable when the Line Service is set to PPP.

Used for User Service PPP or SLIP, determines whether Van Jacobsen Compression is 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. For example, when the user is typing, a single character can be passed over the link with a packet as small as 5 octets as opposed to 40 octets when no JV compression is used. VJ Compression has little effect on other types of links, such as ftp, where the packets are much larger. The Framed Compression value will be used in preference to the VJ Compression value set for a Line. The default is Off.

Used for User Service PPP or SLIP, sets the IP address of the remote user. Enter the address in dot decimal notation as follows:

z 255.255.255.254 (default)—The IOLAN will use the Remote IP Address set in the PPP settings for the line.

z 255.255.255.255—When the User Service is PPP, the IOLAN will allow the remote machine to specify its IP address (overriding the Remote IP Address configured in the line, PPP settings). When the User Service is SLIP, the IOLAN will use the Remote IP Address set for the line (no negotiation).

z n.n.n.n—(where n is a number) Enter the IP address of your choice. This IP address will then be used in preference to the Remote IP Address set for a line.

Used for User Service PPP, sets the IPv6 address of the remote user.

Show 6 more labels / short text on this page
Configuring Users · Options callback · framed-compression · framed-ip · framed-interface-id · User Commands 59
Page 62 of the Perle Systems CSS user manual — Set Default User
Page 62 · click to enlarge
Page 62

Used for User Service PPP or SLIP, specifies the maximum size of packets, in bytes, 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 User Service of SLIP or PPP, details are as follows:

z PPP—Framed MTU will be the maximum size of packets that the IOLAN port will accept. This value is negotiated between the two ends of the link. The valid range is 64-1500. The default value is 1500 bytes.

z SLIP—Framed MTU will be the maximum size of packets being sent by the IOLAN. The IOLAN will send SLIP packets in the range 256-1500 bytes. The default value is 256 bytes. The Framed MTU value will be used in preference to the MTU/MRU values set for a Line.

The prefix that a user types to control the current session. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.):

z ^a number—To switch from one session to another, press ^a and then the required session number. For example, ^a 2 would switch you to session 2. Pressing ^a 0 will return you to the IOLAN Menu.

z ^a n—Display the next session. The current session will remain active. The lowest numbered active session will be displayed.

z ^a p—Display the previous session. The current session will remain active. The highest numbered active session will be displayed.

z ^a m—To exit a session and return to the IOLAN. You will be returned to where you left off. The session will be left running.

z ^a l—(Lowercase L) Locks the line until the user unlocks it. The user is prompted for a password (any password, excluding spaces) and locks the line. Next, the user must retype the password to unlock the line.

z ^r—When you switch from a session back to the Menu, the screen may not be redrawn correctly. If this happens, use this command to redraw it properly. This is always Ctrl R, regardless of the Hotkey Prefix. The User Hotkey Prefix value overrides the Line Hotkey Prefix value. You can use the Hotkey Prefix keys to lock a line only when the line Lock parameter is On.

The amount of time, in seconds, that the Idle Timer will run. Use this timer to close a connection because of inactivity. When the Idle Timer expires, because there has been no exchange of data within the specified time, the IOLAN will close the connection. The default value is 0 (zero), meaning that the Idle Timer will not expire (the connection is open permanently). The maximum value is 4294967 seconds. The User Idle Timer will override the Line Idle Timer, with the exception of reverse SSH or reverse Telnet sessions.

For outbound User Services such as Telnet, Rlogin, or SSH, this is the target host name or IP address. If no IP address is specified, the Host IP value in the Default User configuration will be used. The default is 0.0.0.0. or None.

You can specify whether a user will use English or Customlang as the language that appears in the Menu, CLI, or WebManager. The IOLAN supports one custom language that must be downloaded to the IOLAN; otherwise, Customlang defaults to English.

Show 6 more labels / short text on this page
Configuring Users · framed-mtu · hotkey-prefix · idle-timer · host-ip · language
Page 63 of the Perle Systems CSS user manual — Set Default User
Page 63 · click to enlarge
Page 63

The access that a user is allowed:

z 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.

z Normal—The Normal level user has limited access to the IOLAN. Limited CLI commands and Menu access are available with the ability to configure the user’s own configuration settings.

z Restricted—The Restricted level user can only access predefined sessions or access the Easy Port Access menu.

z Menu—The menu level user will only be able to access predefined session or access the Easy Port Access menu. The Easy Port Access allows the user to connect to the accessible line without disconnecting their initial connection to the IOLAN. Does not have any access to CLI commands.

This is used for the PPP or SLIP Service types. Only used for IPv4. If the remote user is on a subnet, enter the network’s subnet mask. For example, a subnet mask of 255.255.0.0.

Specifies the user access rights to each IOLAN device line. Options are:

z Read/Write—Users are given read and write access to the line.

z Read In—Users are given access to read only outbound data, data that is going from the IOLAN to the device.

z Read Out—Users are given access to read only inbound data, data that is going from the device to the IOLAN. Users can read data going in both directions by selecting both the Read In and Read Out options. The on|off option is only for 1-port models. You can disable line access in 2-port + models by specifying 0 (zero).

The phone number the IOLAN will dial to callback the user (you must have set Callback to On). Enter the number without spaces. To change the phone number, overwrite the previous entry; to clear the phone number, set it to "" (double quotes without a space).

Determines the routing mode used for RIP packets on the PPP and SLIP interfaces for this user. Values are:

z None—RIP packets are neither received nor sent by the IOLAN.

z Send—RIP packets can only be sent by the IOLAN.

z Listen—RIP packets can only be received by the IOLAN.

z Send and Listen—RIP packets are sent and received by the IOLAN.

The type of service that the user will use.

Show 8 more labels / short text on this page
Configuring Users · level · netmask · line-access · phone-number · routing · service · User Commands 61
Page 64 of the Perle Systems CSS user manual — Set User
Page 64 · click to enlarge
Page 64

The amount of time, in seconds, that the Session Timer will run. Use this timer to forcibly close a user’s session (connection). When the Session Timer expires, the IOLAN will end the connection. The default value is 0 (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out). The maximum value is 4294967 seconds. The User Session Timer will override the Line Session Timer, with the exception of reverse SSH or reverse Telnet sessions.

port .For outbound User Services such as Telnet, SSH, TCP clear or SSL raw, this is the target port number. The default value will change based on the type of Service selected; the most common known port numbers are used as the default values.

When enabled, allows the user access to IOLANs that have been configured in the clustering group. The default is on.

Set User

Description Sets users settings. Normal-level users can configure only their own settings.

Admin-level users can configure any users settings, including their own (with the exception of their User Level, which must stay at Admin). User Level Normal, Admin Syntax set user . [hotkey-prefix <00-7f>] [language english|customlang]

set user .|<username>|* [callback on|off]

[framed-compression on|off] [framed-ip <IPv4_address>] [framed-interface-id <IPv6_interface_id>] [framed-mtu <64-1500>] [hotkey-prefix <00-7f>] [idle-timer <0-4294967>] [host-ip None|<IP_address>|<config_host>] [language english|customlang] [level admin|normal|restricted|menu] [password] [line-access readin|readout|readwrite [on|off]|<line(s)> [0]] [netmask <IPv4_address>] [phone-number <phone_number>] [routing none|send|listen|send-and-listen] [service dsprompt|telnet|tcp-clear|rlogin|ppp|slip|ssh|ssl-raw] [sess-timer <0-4294967>] [port tcp-clear|telnet|ssh|ssl-raw <TCP_port>] [access-clustered-ports on|off]

When On, enter a phone number for the IOLAN to call the user back (the Callback parameter is unrelated to the Line Dial parameter). Note: the IOLAN will allow callback only when a user is authenticated. If the protocol over the link does not provide authentication, there will be no callback. Therefore, when the Line Service is set to PPP, you must use either PAP or CHAP, because these protocols provide authentication. The default is Off. The IOLAN supports another type of callback, Roaming Callback, which is configurable when the Line Service is set to PPP.

Show 6 more labels / short text on this page
Configuring Users · sess-timer · access-clustered-ports · [password] [routing none|send|listen|send-and-listen] · Admin User Only · Options callback
Page 65 of the Perle Systems CSS user manual — Set User
Page 65 · click to enlarge
Page 65

Used for User Service PPP or SLIP, determines whether Van Jacobsen Compression is 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. For example, when the user is typing, a single character can be passed over the link with a packet as small as 5 octets as opposed to 40 octets when no JV compression is used. VJ Compression has little effect on other types of links, such as ftp, where the packets are much larger. The Framed Compression value will be used in preference to the VJ Compression value set for a Line. The default is Off.

Used for User Service PPP or SLIP, sets the IP address of the remote user. Enter the address in dot decimal notation as follows:

z 255.255.255.254 (default)—The IOLAN will use the Remote IP Address set in the PPP settings for the line.

z 255.255.255.255—When the User Service is PPP, the IOLAN will allow the remote machine to specify its IP address (overriding the Remote IP Address configured in the line, PPP settings). When the User Service is SLIP, the IOLAN will use the Remote IP Address set for the line (no negotiation).

z n.n.n.n—(where n is a number) Enter the IP address of your choice. This IP address will then be used in preference to the Remote IP Address set for a line.

Used for User Service PPP, sets the IPv6 address of the remote user.

Used for User Service PPP or SLIP, specifies the maximum size of packets, in bytes, 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 User Service of SLIP or PPP, details are as follows:

z PPP—Framed MTU will be the maximum size of packets that the IOLAN port will accept. This value is negotiated between the two ends of the link. The valid range is 64-1500. The default value is 1500 bytes.

z SLIP—Framed MTU will be the maximum size of packets being sent by the IOLAN. The IOLAN will send SLIP packets in the range 256-1500 bytes. The default value is 256 bytes. The Framed MTU value will be used in preference to the MTU/MRU values set for a Line.

Show 6 more labels / short text on this page
Configuring Users · framed-compression · framed-ip · framed-interface-id · framed-mtu · User Commands 63
Page 66 of the Perle Systems CSS user manual — Set User
Page 66 · click to enlarge
Page 66

The prefix that a user types to control the current session. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.):

z ^a number—To switch from one session to another, press ^a and then the required session number. For example, ^a 2 would switch you to session 2. Pressing ^a 0 will return you to the IOLAN Menu.

z ^a n—Display the next session. The current session will remain active. The lowest numbered active session will be displayed.

z ^a p—Display the previous session. The current session will remain active. The highest numbered active session will be displayed.

z ^a m—To exit a session and return to the IOLAN. You will be returned to where you left off. The session will be left running.

z ^a l—(Lowercase L) Locks the line until the user unlocks it. The user is prompted for a password (any password, excluding spaces) and locks the line. Next, the user must retype the password to unlock the line.

z ^r—When you switch from a session back to the Menu, the screen may not be redrawn correctly. If this happens, use this command to redraw it properly. This is always Ctrl R, regardless of the Hotkey Prefix. The User Hotkey Prefix value overrides the Line Hotkey Prefix value. You can use the Hotkey Prefix keys to lock a line only when the line Lock parameter is On.

The amount of time, in seconds, that the Idle Timer will run. Use this timer to close a connection because of inactivity. When the Idle Timer expires, because there has been no exchange of data within the specified time, the IOLAN will close the connection. The default value is 0 (zero), meaning that the Idle Timer will not expire (the connection is open permanently). The maximum value is 4294967 seconds. The User Idle Timer will override the Line Idle Timer, with the exception of reverse SSH or reverse Telnet sessions.

For outbound User Services such as Telnet, Rlogin, or SSH, this is the target host name or IP address. If no IP address is specified, the Host IP value in the Default User configuration will be used. The default is 0.0.0.0. or None.

You can specify whether a user will use English or Customlang as the language that appears in the Menu, CLI, or WebManager. The IOLAN supports one custom language that must be downloaded to the IOLAN; otherwise, Customlang defaults to English.

The access that a user is allowed:

z 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.

z Normal—The Normal level user has limited access to the IOLAN. Limited CLI commands and Menu access are available with the ability to configure the user’s own configuration settings.

z Restricted—The Restricted level user can only access predefined sessions or access the Easy Port Access menu.

z Menu—The menu level user will only be able to access predefined session or access the Easy Port Access menu. The Easy Port Access allows the user to connect to the accessible line without disconnecting their initial connection to the IOLAN. Does not have any access to CLI commands.

Show 6 more labels / short text on this page
Configuring Users · hotkey-prefix · idle-timer · host-ip · language · level
Page 67 of the Perle Systems CSS user manual — Set User
Page 67 · click to enlarge
Page 67

This is used for the PPP or SLIP Service types. Only used for IPv4. If the remote user is on a subnet, enter the network’s subnet mask. For example, a subnet mask of 255.255.0.0.

The password the user will need to enter to login to the IOLAN. This case-sensitive field accepts a maximum of 16 characters.

Specifies the user access rights to each IOLAN device line. Options are:

z Read/Write—Users are given read and write access to the line.

z Read In—Users are given access to read only outbound data, data that is going from the IOLAN to the device.

z Read Out—Users are given access to read only inbound data, data that is going from the device to the IOLAN. Users can read data going in both directions by selecting both the Read In and Read Out options. The on|off option is only for 1-port models. You can disable line access in 2-port + models by specifying 0 (zero).

The phone number the IOLAN will dial to callback the user (you must have set Callback to On). Enter the number without spaces. To change the phone number, overwrite the previous entry; to clear the phone number, set it to "" (double quotes without a space).

Determines the routing mode used for RIP packets on the PPP and SLIP interfaces for this user. Values are:

z None—RIP packets are neither received nor sent by the IOLAN.

z Send—RIP packets can only be sent by the IOLAN.

z Listen—RIP packets can only be received by the IOLAN.

z Send and Listen—RIP packets are sent and received by the IOLAN.

The type of service that the user will use.

The amount of time, in seconds, that the Session Timer will run. Use this timer to forcibly close a user’s session (connection). When the Session Timer expires, the IOLAN will end the connection. The default value is 0 (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out). The maximum value is 4294967 seconds. The User Session Timer will override the Line Session Timer, with the exception of reverse SSH or reverse Telnet sessions.

port .For outbound User Services such as Telnet, SSH, TCP clear or SSL raw, this is the target port number. The default value will change based on the type of Service selected; the most common known port numbers are used as the default values.

When enabled, allows the user access to IOLANs that have been configured in the clustering group. The default is on.

Show 10 more labels / short text on this page
Configuring Users · netmask · password · line-access · phone-number · routing · service · sess-timer · access-clustered-ports · User Commands 65
Page 68 of the Perle Systems CSS user manual — Show User
Page 68 · click to enlarge
Page 68

Set User Session

Description Configures a users session settings. See Set User Session on page 54 for a description

of the options. User Level Admin Syntax set user .|<username>|* session 1|2|3|4|* [auto on|off]

set user .|<username>|* session 1|2|3|4|* telnet-options

[host <config_host>] [port <TCP_port>] [termtype <terminal_name>] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof <00-7f>] [erase <00-7f>] [intr <00-7f>] [quit <00-7f>]

set user .|<username>|* session 1|2|3|4|* rlogin-options

[host <config_host>] [termtype <terminal_name>]

set user .|<username>|* session 1|2|3|4|*

ssh-options [host <config_host>] [port <TCP_port>] [termtype <terminal_name>] [protocol ssh-1|ssh-2|ssh-2/1] [compression on|off] [verbose on|off] [auto-login on|off] [name <string>] [password <string>] [ssh-1-cipher 3des|des|blowfish] [authentication rsa on|off] [authentication password on|off] [authentication keyboard-interactive on|off]

set user .|<username>|* session 1|2|3|4|* ssh-options

ssh-2-cipher-list <3des blowfish cast aes arcfour>

Show Default User

Description Shows the Default Users settings. User Level Admin Syntax show default user

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.

Configuring Users · [type off|telnet|rlogin|ssh]

Page 69 of the Perle Systems CSS user manual — Set Line
Page 69 · click to enlarge
Page 69

Line Commands Chapter 4 4

This chapter defines all the CLI commands associated with configuring the IOLAN’s line parameters.

1-Port vs. 2-Port+ Line Commands

If you are using a 1-port IOLAN, the admin user does not have the option of using the number or all (*) options in the line commands, as there is only one line. In a 2-port+ IOLAN, the admin user must specify . (current line), (line number), or * (sets value for all lines) when configuring lines.

Line Commands

Set Line

Description Configures line parameters. The set line command does not work on modem

ports/lines on models that have an internal modem. User Level Normal, Admin Syntax set line . [data-bits 5|6|7|8]

[connection-method dial-in|dial-out|dial-in-out|direct-connect| ms-direct-host|ms-direct-guest] [idle-timer <0-4294967>] [line-name <name>] [modem-name <config_modem>] [pages 1|2|3|4|5|6|7] [parity none|even|odd|mark|space] [phone-number <phone_number>] [rev-sess-security on|off] [sess-timer <0-4294967>] [stop-bits 1|2|1.5] [termtype wyse60|vt100|ansi|dumb|tvi925| ibm3151te|vt320|hp700|term1|term2|term3]

set line .|<number>|* ... [mode enabled|disabled] [break on|off]

[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>]

Enables/disables a line (available only on 2-port+ models). The default is enabled.

Specifies the number of bits in a byte. The default is 8.

Admin User Only · Options mode · data-bits

Page 70 of the Perle Systems CSS user manual — Line Commands
Page 70 · click to enlarge
Page 70

Determines how a modem will work on the line. Select from the following options:

z Direct Connect—Indicates that there is not a modem on the line. This is the default.

z Dial In—Specify this option when a user is remote and will be dialing in via modem or ISDN TA.

z Dial Out—Specify this option when a modem is attached to the serial port and is being used to dial out.

z Dial In/Out—Specify this option when the IOLAN is being used as a router (depending on which end of the link your IOLAN is situated and how you want to initiate the communication).

z MS Direct-Host—Specify this option when the serial port is connected to a Microsoft Guest device. Line Service must be set to PPP for this option.

z MS Direct-Guest—Specify this option when the serial port is connected to a Microsoft Host device. Line Service must be set to PPP for this option.

Enter a time period, in seconds, for which the Idle Timer will run. Use this timer to close a connection because of inactivity. When the Idle Timer expires, the IOLAN will end the connection. The maximum value is 4294967 seconds (about 49 days). The default value of 0 (zero) means the Idle Timer will not expire, so the connection is permanently open.

Provide a name for the line so it can be easily identified. The Remote Port Buffering logging feature uses the Line Name when creating a file on the remote NFS server.

The name of the predefined modem that is used on this line.

For DSLogin line service, this is the number of video pages the terminal supports. Valid values are 1-7. The default is 5 pages.

Specifies if you are using Even, Odd, or No parity on the line. If you want to force a parity type, you can specify Mark for 1or Space for 0.

The phone number to use when Connection Method is set to Dial Out.

Enables/disables login/password authentication, locally or externally, on reverse Telnet connections. The default is Off.

Enter a time, in seconds, for which the Session Timer will run. Use this timer to forcibly close the session (connection). When the Session Timer expires, the IOLAN will end the connection. The default value is 0 seconds so the port will never timeout. The maximum value is 4294967 seconds (about 49 days).

Show 10 more labels / short text on this page
Line Commands · connection-method · idle-timer · line-name · modem-name · pages · parity · phone-number · rev-sess-security · sess-time
Page 71 of the Perle Systems CSS user manual — Line Commands
Page 71 · click to enlarge
Page 71

Specifies how a break is interpreted:

z off—The IOLAN ignores the break key completely and it is not passed through to the host. This is the default setting.

z 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.

z remote—When the break key is pressed, the IOLAN translates this into a telnet break signal which it sends to the host machine.

z break-interrupt—On some systems such as SunOS, XENIX, and AIX, a break received from the peripheral is not passed to the client properly. If the client wishes to make the break act like an interrupt key (for example, when the stty options -ignbrk and brkintr are set).

When Line Service Printer is selected, defines the default end-of-line terminator as CR-LF (ASCII carriage-return line-feed) when enabled. Default is Off.

When enabled, serial data will be buffered if the TCP connection is lost. When the TCP connection is re-established, the buffered serial data will be sent to its destination (this option is not available when Monitor DSR, Monitor DCD, or Multihost is enabled). The data buffer is 4K for desktop models and 32K for rack mount models. If the data buffer is filled, incoming serial data will overwrite the oldest data. The default is off.

Determines if input flow control is to be used. Default is On. This is active only when Line Flow Control is set to Soft, Hard, or Both.

Determines if output flow control is to be used. Default is On. This is active only when Line Flow Control is set to Soft, Hard, or Both.

The prefix that a user types to lock a line or redraw the Menu. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.):

z ^a l—(Lowercase L) Locks the line until the user unlocks it. The user is prompted for a password (any password, excluding spaces) and locks the line. Next, the user must retype the password to unlock the line.

z ^r—When you switch from a session back to the Menu, the screen may not be redrawn correctly. If this happens, use this command to redraw it properly. This is always Ctrl R, regardless of the Hotkey Prefix. You can use the Hotkey Prefix key to lock a line only when the Line Lock parameter is On.

Specifies the initial interface a user navigates when logging into the line; either the Menu or a prompt for the CLI. The default is CLI.

Show 9 more labels / short text on this page
Line Commands · break · map-cr-crlf · data-logging · flowin · flowout · hotkey-prefix · initial · Line Commands 69
Page 72 of the Perle Systems CSS user manual — Line Commands
Page 72 · click to enlarge
Page 72

Enables a per-connection TCP keepalive feature. After the configured number of seconds, the connection will send a gratuitous ACK to the network peer, thus either ensuring the connection stays active OR causing a dropped connection condition to be recognized. This parameter needs to be used in conjunction with server parameter, monitor-connection-every. The interval determines how long the IOLAN will wait during inactivity before "testing" the connection. It should be noted that if a network connection is accidentally dropped, it can take as long as the specified interval before anyone can reconnect to the serial port.

When enabled, the user can lock his terminal with a password using the Hotkey Prefix (default Ctrl-a) ^a l (lowercase L). The IOLAN prompts the user for a password and a confirmation.

When enabled, the user can lock his terminal with a password using the Hotkey Prefix (default Ctrl-a) ^a l (lowercase L). The IOLAN prompts the user for a password and a confirmation.

Enables/disables the message of the day on the line.

This parameter defines the maximum number of additional reverse sessions which will be allowed for this line allowing more control as to how the total reverse sessions are allocated. This is on top of the main reverse session to the line. The total number of reverse sessions on the IOLAN are dependent on the model:

z 1-port0-3
z 2-port(4 x #-of-ports ) -1
z STS/SDS 4+ ports(2 x #-of-ports ) -1
z SCS 4+ ports(2 x ( #-of-ports + 1)) -1

For DSLogin line service, makes this a line that is dedicated to the specified user. Only 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 Line Service is set to Direct or Silent Rlogin, the User parameter is used as the Rlogin user name (since Rlogin will not prompt you for a user name).

Blanks out the User parameter, in case you want to change a dedicated user line to an undedicated line.

Resets the terminal type connected to the line when a user logs out.

The number of seconds the IOLAN will wait to establish a connection to a remote modem. The default value is 45 seconds.

The number of times the IOLAN will attempt to re-establish a connection with a remote modem. The default value is 2.

Show 11 more labels / short text on this page
Line Commands · keepalive · lock · microsoft-sac-support · motd · multisessions · user · nouser · reset · dial-timeout · dial-retries
Page 73 of the Perle Systems CSS user manual — Line Commands
Page 73 · click to enlarge
Page 73

Specifies the number of stop bits that follow a byte. The 1.5 option is only available on the 1-port and 2-port models, but not on the modem of the SDS1M or SDS3M models.

Specifies the type of terminal connected to the line:

z VT320 (specifically supporting VT320-7)

z HP700 (specifically supporting HP700/44)

z Term1, Term2, Term3 (user-defined terminals)

Used with EIA-422 and EIA-485 on SDS 8-port+ IOLAN models, specifies whether or not the line requires termination. When termination is required, you need to terminate the line at both ends of the connection.

Used with reverse sessions, users can access serial devices connected to the IOLAN by the specified Internet Address (or host name that can be resolved by a DNS). You must reboot the IOLAN for the Internet Address to take affect (the kill line option does not apply to this parameter). This parameter must be in IPv4 format.

Show 12 more labels / short text on this page
Line Commands · stop-bits · term-type · z Dumb · z WYSE60 · z VT100 · z ANSI · z TVI925 · z IBM3151TE · line-termination · internet-address · Line Commands 71
Page 74 of the Perle Systems CSS user manual — Set Line Interface
Page 74 · click to enlarge
Page 74

Set Line Interface

The SCS and STS IOLAN models only support the EIA-232 interface and therefore does not require the interface parameter, instead you can just set the parameters for the EIA-232 interface.

Description Configures line interface (hardware) parameters. User Level Admin Syntax set line .|<number>|* interface eia-232 [monitor-dcd on|off]

[monitor-dsr on|off] [flow none|soft|hard|both] [speed 50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600| 19200|38400|57600|115200|230400|28800|custom <baud_rate>]

set line .|<number>|* interface eia-422

[flow none|soft|hard|both] [speed 50|75|110|134|150|200|300|600|1200|1800|2400|4800| 9600|19200|38400|57600|115200|230400|28800| custom <baud_rate>]]

set line .|<number>|* interface eia-485-half-duplex

[tx-driver-control auto|rts] [flow none|soft] [echo-suppression on|off]] [speed 50|75|110|134|150|200|300|600|1200|1800|2400|4800| 9600|19200|38400|57600|115200|230400|28800|custom <baud_rate>]

set line .|<number>|* interface eia-485-full-duplex

[tx-driver-control auto|rts] [flow none|soft] [speed 50|75|110|134|150|200|300|600|1200|1800|2400|4800| 9600|19200|38400|57600|115200|230400|28800|custom <baud_rate>]

Options eia-232 | eia-422 | eia-485-half-duplex|eia-485-full-duplex

Specifies the type of serial line that is being used with the IOLAN. Specify either EIA-232, EIA-422, EIA-485-half-duplex, or EIA-485-full-duplex. The STS and SCS models support only EIA-232.

Specifies whether the RS-232 signal DCD (Data Carrier Detect) should be monitored. This is used with modems or any other device that sends a DCD signal. When it is monitored and the IOLAN detects a DCD signal, the line service is started. Default is Off. If both Monitor DCD and Monitor DSR are enabled, both signals must be detected before the line service is started.

Specifies whether the RS-232 signal DSR (data set ready) should be monitored. This is used with modems or any device that sends a DSR signal. When it is monitored and the IOLAN detects a DSR signal, the line service is started. Default is Off. If both Monitor DCD and Monitor DSR are enabled, both signals must be detected before the line service is started.

Defines whether the data flow is handled by the software (Soft), hardware (Hard), Both, or None. If you are using SLIP, set to Hard only. If you are using PPP, set to either Soft or Hard (Hard is recommended). If you select Soft with PPP, you must set the ACCM parameter when you configure PPP for the Line.

Used with a EIA-485 serial interface, if your application supports RTS (Request To Send), select this option. Otherwise, select Auto. Default is Auto.

Show 5 more labels / short text on this page
Line Commands · monitor-dcd · monitor-dsr · flow · tx-driver-control
Page 75 of the Perle Systems CSS user manual — Set Line Service
Page 75 · click to enlarge
Page 75

Specify whether the line is Full Duplex (communication both ways at the same time) or Half Duplex (communication in one direction at a time).

This parameter applies only to EIA-485 Half Duplex mode. All characters will be echoed to the user and transmitted across the serial ports. Some EIA-485 applications require local echo to be enabled in order to monitor the loopback data to determine that line contention has occurred. If your application cannot handle loopback data, echo suppression should be On. The default is echo suppression Off.

Specifies the baud rate of the line; keep in mind that speed is affected by the length of the cable. You can also specify a custom baud rate; valid values are 50 - 1843200.

Set Line Service

Description Sets the service for the line. For services that need further configuration, see Line

Service Commands on page 77 to find the Line Service that you want to configure. SSL/TLS can be enabled for the following Line Services: DSLogin, Raw, Bidir, VModem, Server Tunnel, Client Tunnel, Modbus Master, Custom App, and TruePort. User Level Admin Syntax set line .|<number>|* service bidir <config_host> <server_port>

set line .|<number>|* service direct|silent rlogin <config_host>

set line .|<number>|* service direct raw <config_host>

set line .|<number>|* service silent raw <config_host>

<host_port> [multihost all|backup <config_backup_host> <host_port>|none]

set line .|<number>|* service direct|silent telnet|ssh

<config_host> [<host_port>]

set line .|<number>|* service reverse raw [multihost on|off]|

ssh|telnet <server_port>

set line .|<number>|* service client-tunnel <config_host>

set line .|<number>|* service server-tunnel <server_port>

set line .|<number>|* service dslogin|printer|ppp|slip|udp|

set line .|<number>|* service trueport client-initiated off

<config_host> <host_port> [signal-active on|off] [multihost all|backup <config_backup_host> <host_port>|none]

set line .|<number>|* service trueport client-initiated on

<server_port> [signal-active on|off] [multihost on|off]

Show 9 more labels / short text on this page
Line Commands · duplex · echo-suppression · speed · <host_port> · <host_port> · <host_port> · vmodem|modbus-master|modbus-slave|custom-app|power-management · Line Commands 73
Page 76 of the Perle Systems CSS user manual — Set Line Service
Page 76 · click to enlarge
Page 76

Options bidir This service allows the IOLAN listen for incoming TCP connection and if needed, initiate a TCP connection.

The name of the target host. The host must exist in the IOLAN host table.

The IOLAN port number.

The port number the target host is listening on for incoming connections.

direct Direct connections bypass the IOLAN, enabling the user to log straight into a specific host. A direct connection is recommended where a user logging in to the IOLAN is not required. It is also recommended where multiple sessions are not a requirement. The message Press return to continue is displayed on the users screen. The user must press a key to display the host login prompt. The message is redisplayed on logout.

silent Silent connections are the same as direct connections, except they are permanently established. The host login prompt is displayed on the screen. Logging out redisplays this prompt. Silent connections, unlike direct connections, however, make permanent use of pseudo tty resources and therefore consume host resources even when not in use.

rlogin Sets the line for a remote login connection.

raw Creates a connection where no authentication takes place and data is passed unchanged.

telnet Sets the line for a telnet connection.

ssh Sets the line for an SSH connection.

Enables a TCP/IP host to establish a login connection on an external machine attached to a port. For example, to access machines like protocol converters, statistical multiplexors, or machines like routers, firewalls, servers, etc.

Sets the line for a client tunnel connection.

The default connection. The IOLAN displays a login on that line. For example, DSLogin is used when a System Administrator configures the IOLAN, providing authentication of a user before starting a User Service of SLIP, or users starts a session(s) from the IOLAN to hosts.

Using the IOLAN as a printer server. For example, remote printing using LPD (port 515) or RCP (port 514).

Show 8 more labels / short text on this page
Line Commands · <config_host> · <server_port> · <host_port> · reverse · client-tunnel · dslogin · printer
Page 77 of the Perle Systems CSS user manual — Set Line Service
Page 77 · click to enlarge
Page 77

Sets the port to a dedicated PPP line.

Sets the port in SLIP mode.

Sets the line to listen for and/or send UDP data.

The IOLAN port behaves as if it were a modem to the attached device.

Sets the line for a server tunnel connection.

Sets the line to act as a Modbus master.

Sets the line to use the custom application created with the SDK.

Indicates that there is a power bar connection to this serial line.

trueport Sets the line to communicate with the TruePort utility. You must install the TruePort utility on the host machine.

client-initiated When this option is turned on, the IOLAN will wait for a connection from the TruePort host (see the TruePort documentation for information on how to set up this feature on the TruePort host). When this option is turned off, the IOLAN will initiate the connection to the TruePort host. The default is off.

This option has the following impact based on the state of the TruePort connection:

z TruePort Lite Mode—When enabled, the EIA-232 signals remain active before, during, and after the TruePort connection is established. When disabled, the EIA-232 signals remain inactive when there is no TruePort connection and active when there is a TruePort connection.

z TruePort Full Mode—When enabled, the EIA-232 signals remain active before and after the TruePort connection and the TruePort client will control the state of the signals during the established TruePort connection. When disabled, the EIA-232 signals remain inactive before and after the TruePort connection and the TruePort client will control the state of the signals during the established TruePort connection. Default: Enabled

multihost Used for connections coming from the network to the serial port for TruePort or Raw services, allows multiple hosts to connect to the serial device.

multihost all|backup <config_backup_host> <tcp_port>|none Used for connections going from the serial port to the network for TruePort or Silent Raw services, allows the serial device to communicate to either all the hosts in the multihost list or a primary/backup host schema (see Configuring Multiple Hosts in the IOLAN User’s Guide for a more detailed explanation).

Show 11 more labels / short text on this page
Line Commands · ppp · slip · udp · vmodem · server-tunnel · modbus-master · custom-app · power-management · signal-active · Line Commands 75
Page 78 of the Perle Systems CSS user manual — Show Line
Page 78 · click to enlarge
Page 78

Set Modem

Description Sets the modem initialization strings for a defined modem. If you wish to add a new

modem, use the add modem command. User Level Admin Syntax set modem <modem_name> <init_string> Options <modem_name>

Predefined modem name.

Specify the initialization string for the modem. This can be up to 60 characters long, but cannot include spaces.

Set Termtype

Description Sets the terminal type for the current terminal session. term1, term2, and term3 refer to

the user-uploadable custom terminal definitions. If these are not present, the default is wyse60. User Level Restricted, 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:

z VT320 (specifically supporting VT320-7)

z HP700 (specifically supporting HP700/44)

z Term1, Term2, Term3 (user-defined terminals)

Show Line

Description Shows the line settings/information. User Level Admin Syntax show line <number>|*

Show 8 more labels / short text on this page
Line Commands · <init_string> · z Dumb · z WYSE60 · z VT100 · z ANSI · z TVI925 · z IBM3151TE
Page 79 of the Perle Systems CSS user manual — Set Telnet-Client
Page 79 · click to enlarge
Page 79

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 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. Maximum of 80 characters. Use the shell CLI command as described in the SDK Programmer’s Guide to manage the files that you have downloaded to the IOLAN. For example, using sample outraw program, you would type:

outraw -s 0 192.168.2.1:10001 Acct:10001 if you were starting the application on the Server (notice the -s 0 parameter specifies Line 1).

Set Rlogin-Client

Description Configures the Rlogin parameters for the specified line. When the IOLAN initiates an

rlogin connection to a host, it is acting as a rlogin client. User Level Normal, Admin Syntax set rlogin-client line .|<number>|* termtype <terminal_name>

Type of terminal attached to this line; for example, ansi or wyse60.

Set Telnet-Client

Description Configures the Telnet parameters for the specified line. When the IOLAN initiates a

Telnet connection to a host, it is acting as a Telnet client. User Level Normal, Admin Syntax set telnet-client line .|<number>|* [termtype <terminal_name>]

[line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof <00-7f>] [erase <00-7f>] [intr <00-7f>] [quit <00-7f>] [escape <00-7f]

Type of terminal attached to this line; for example, ANSI or WYSE60.

When On, keyboard input is not sent to the remote host until Enter is pressed, otherwise input is sent every time a key is pressed. Default is Off.

Maps carriage returns (CR) to carriage return line feed (CRLF). The default value is Off.

Toggles between local echo of entered characters and suppressing local echo. Local echo is used for normal processing, while suppressing the echo is convenient for entering text that should not be displayed on the screen, such as passwords. This parameter can only be used when Line Mode is On. Default is Off.

Show 7 more labels / short text on this page
Line Service Commands · Option termtype · Options termtype · line-mode · map-cr-crlf · local-echo · Line Commands 77
Page 80 of the Perle Systems CSS user manual — Set SSH-Client
Page 80 · click to enlarge
Page 80

Defines the echo character. When Line Mode is On, typing the echo character echoes the text locally and sends only completed lines to the host. This value is in hexadecimal with a default value of 5 (ASCII value ^E).

Defines the end-of-file character. When Line Mode is On, entering the EOF character as the first character on a line sends the character to the remote host. This value is in hexadecimal with a default value of 4 (ASCII value ^D).

Defines the erase character. When Line Mode is Off, typing the erase character erases one character. This value is in hexadecimal with a default value of 8 (ASCII value ^H).

Defines the interrupt character. Typing the interrupt character interrupts the current process. This value is in hexadecimal with a default value of 3 (ASCII value ^C).

Defines the quit character. Typing the quit character closes and exits the current telnet session. This value is in hexadecimal with a default value of 1c (ASCII value FS).

Defines the escape character. Returns you to the command line mode. This value is in hexadecimal with a default value of 1d (ASCII value GS).

Set SSH-Client

Description Configures the SSH parameters for the specified line. When the IOLAN initiates a SSH

connection to a host, it is acting as a SSH client. User Level Normal, Admin Syntax set ssh-client line .|<number>|* [termtype <terminal_name>]

[protocol ssh-1|ssh-2|ssh-2/1] [compression on|off] [verbose on|off] [auto-login on|off] [name <string>] [password <string>] [ssh-1-cipher 3des|des|blowfish] [authentication rsa on|off] [authentication dsa on|off] [authentication keyboard-interactive on|off]

set ssh-client line .|<number>|*

ssh-2-cipher-list <3des blowfish cast aes arcfour>

Type of terminal attached to this line; for example, ANSI or WYSE60.

protocol Specify the SSH protocol you want to use for the connection, SSH-1, SSH-2, or either, SSH2/1.

Requests compression of all data. Compression is desirable on modem lines and other slow connections, but will only slow down things on fast networks.

Displays debug messages on the terminal.

Show 10 more labels / short text on this page
Line Service Commands · echo · eof · erase · intr · quit · escape · Options termtype · compression · verbose
Page 81 of the Perle Systems CSS user manual — Set SSH-Client
Page 81 · click to enlarge
Page 81

Creates an automatic SSH login, using the Name and Password values.

The user’s name when Auto Login is enabled.

The user’s password when Auto Login is enabled.

Select the encryption method (cipher) that you want to use for your SSH version 1 connection:

Select the order of negotiation for the encryption method (ciphers) that the IOLAN will use for the SSH version 2 connection:

An authentication method used by SSH version 1 and 2. When enabled, an SSH client session will try to authenticate via RSA.

An authentication method used by SSH version 2. When enabled, an SSH client session will try to authenticate via DSA.

The user types in a password for authentication.Used for SSH2 only.

Show 17 more labels / short text on this page
Line Service Commands · auto-login · name · password · ssh-1-cipher · z 3DES · z Blowfish · ssh-2-cipher-list · z 3DES · z Blowfish · z AES · z Arcfour · z CAST · authentication rsa · authentication dsa · authentication keyboard-interactive · Line Commands 79
Page 82 of the Perle Systems CSS user manual — Set PPP
Page 82 · click to enlarge
Page 82

Set PPP

Description Configures the Lines 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] [routing none|send|listen|send-and-listen] [rpassword <string>] [ruser <string>] [tr-retry <integer>] [tr-tmout <integer>] [user <string>] [vj-comp on|off]

Specifies the ACCM (Asynchronous Control Character Map) characters that should be escaped from the data stream. This is entered as a 32-bit hexadecimal number with each bit specifying whether or not the corresponding character should be escaped. The bits are specified as the most significant bit first and are numbered 31-0. Thus if bit 17 is set, the 17th character should be escaped, that is, 0x11 (XON). So entering the value 000a0000 will cause the control characters 0x11 (XON) and 0x13 (XOFF) to be escaped on the link, thus allowing the use of XON/XOFF (software) flow control. If you have selected Soft Flow Control on the Line, you must enter a value of at least 000a0000 for the ACCM. The default value is 00000000, which means no characters will be escaped.

This determines whether compression of the PPP Address and Control fields take place on the link. The default is On. For most applications this should be enabled.

The timeout, in minutes, during which successful PAP or CHAP authentication must take place (when PAP or CHAP is turned On). If the timer expires before the remote end has been authenticated successfully, the link will be terminated.

The interval, in minutes, for which the IOLAN will issue a CHAP re-challenge to the remote end. During CHAP authentication, an initial CHAP challenge takes place, and is unrelated to CHAP re-challenges. The initial challenge takes place even if re-challenges are disabled. Some PPP client software does not work with CHAP re-challenges, so you might want to leave the parameter disabled in the IOLAN. The default value is 0 (zero), meaning CHAP re-challenge is disabled.

The maximum number of times a configure request packet will be re-sent before the link is terminated.

The maximum time, in seconds, that LCP (Link Control Protocol) will wait before it considers a configure request packet to have been lost.

Show 7 more labels / short text on this page
Line Service Commands · Options accm · address-comp · auth-tmout · challenge-interval · cr-retry · cr-timeout
Page 83 of the Perle Systems CSS user manual — Set PPP
Page 83 · click to enlarge
Page 83

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 Off. When On, the IP address specified by the remote end will be used in preference to the Remote IP Address set for a Line. When Off, the Remote IP Address set for the Line will be used.

You can optionally specify an IPv6 global network prefix that the IOLAN will advertise to the device at the other end of the PPP link. Enter the IPv6 network prefix in the aaaa:bbbb:cccc:dddd:: format.

The local IPv6 interface identifier of the IOLAN end of the PPP link. For routing to work, you must enter a local IP address. Choose an address that is part of the same network or subnetwork as the remote end. Do not use the IOLAN’s (main) IP address in this field; if you do so, routing will not take place correctly. The first 64 bits of the Interface Identifier must be zero, therefore, ::abcd:abcd:abcd:abcd is the expected format.

The remote IPv6 interface identifier of the remote end of the PPP link. Choose an address that is part of the same network or subnetwork as the IOLAN. If you set the PPP parameter IP Address Negotiation to On, the IOLAN will ignore the remote IP address value you enter here and will allow the remote end to specify its IP address. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Interface-ID is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here. The first 64 bits of the Interface Identifier must be zero, therefore, ::abcd:abcd:abcd:abcd is the expected format.

The IPV4 IP address of the IOLAN end of the PPP link. For routing to work, you must enter a local IP address. Choose an address that is part of the same network or subnetwork as the remote end; for example, if the remote end is address 192.101.34.146, your local IP address can be 192.101.34.145. Do not use the IOLAN’s (main) IP address in this field; if you do so, routing will not take place correctly.

Determines if a line is looping back. If enabled (On), random numbers are sent on the link. The random numbers should be different, unless the link loops back. The default is Off.

The Maximum Receive Unit (MRU) parameter specifies the maximum size of PPP packets that the IOLAN’s port will accept. Enter a value between 64 and 1500 bytes; for example, 512. The default value is 1500. If your user is authenticated by the IOLAN, the MRU value will be overridden if you have set a Framed MTU value for the user. If your user is authenticated by RADIUS and the RADIUS parameter Framed-MTU is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

The maximum number of times a configure NAK packet will be re-sent before the link is terminated.

Show 10 more labels / short text on this page
Line Service Commands · ipaddr-neg · ipv6-global-network-prefix · ipv6-local-interface · ipv6-remote-interface · lipaddr · magic-neg · mru · nak-retry · Line Commands 81
Page 84 of the Perle Systems CSS user manual — Set PPP
Page 84 · click to enlarge
Page 84

The network subnet mask. For example, 255.255.0.0. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Netmask is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

This field defines the password which is associated with the user defined by the user parameter. It is used to authenticate a user connecting to the IOLAN. You can enter a maximum of 16 alphanumeric characters.

This determines whether compression of the PPP Protocol field takes place on this link. The default is On.

The IPV4 IP address of the remote end of the PPP link. Choose an address that is part of the same network or subnetwork as the IOLAN. If you set the PPP parameter IP Address Negotiation to On, the IOLAN will ignore the remote IP address value you enter here and will allow the remote end to specify its IP address. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Address is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here. The exception to this rule is a Framed-Address value in the RADIUS file of 255.255.255.254; this value allows the IOLAN to use the remote IP address value configured here.

A user can enter a telephone number that the IOLAN will use to callback him/her. This feature is particularly useful for a mobile user. Roaming callback can only work when the User Callback parameter is set to On. Roaming callback therefore overrides (fixed) User Callback.To use Roaming Callback, the remote end must be a Microsoft Windows OS that supports Microsoft’s Callback Control Protocol (CBCP). The user is allowed 30 seconds to enter a telephone number after which the IOLAN ends the call. The default is Off.

Determines the routing mode (RIP, Routing Information Protocol) used on the PPP interface as one of the following options:

z None—Disables RIP over the PPP interface.

z Send—Sends RIP over the PPP interface.

z Listen—Listens for RIP over the PPP interface.

z Send and Listen—Sends RIP and listens for RIP over the PPP interface. This is the same function as the Framed-Routing attribute for RADIUS authenticated users. Default is None.

The rpassword is the password which is associated with the user defined by ruser. It is used to authenticate a user connecting to the IOLAN. You can enter a maximum of 16 alphanumeric characters.

Show 8 more labels / short text on this page
Line Service Commands · netmask · password · proto-comp · ripaddr · roaming-callback · routing · rpassword
Page 85 of the Perle Systems CSS user manual — Set PPP
Page 85 · click to enlarge
Page 85

This field is used to authenticate a user connecting to this line. It is used in conjunction with the rpassword field. By specifying a name here, this line becomes dedicated to 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. You can enter a maximum of sixteen alphanumeric characters. This option does not work with external authentication.

The type of authentication that will be done on the link: None, PAP, or CHAP. The default is CHAP. You can use PAP or CHAP to authenticate a port or user on the IOLAN, from a remote location, or authenticate a remote client/device, from the IOLAN (not commonly used for Dial Out). PAP is a one time challenge of a client/device requiring that it respond with a valid username and password. A timer operates during which successful authentication must take place. If the timer expires before the remote end has been authenticated successfully, the link will be terminated. CHAP challenges a client/device at regular intervals to validate itself with a username and a response, based on a hash of the secret (password). A timer operates during which successful authentication must take place. If the timer expires before the remote end has been authenticated successfully, the link will be terminated. When setting either PAP and CHAP, make sure the IOLAN and the remote client/device have the same setting. For example, if the IOLAN is set to PAP, but the remote end is set to CHAP, the connection will be refused.

The maximum number of times a terminate request packet will be re-sent before the link is terminated.

The maximum time, in seconds, that LCP (Link Control Protocol) will wait before it considers a terminate request packet to have been lost.

This field is used by a remote peer to authenticate a PPP connection on this line. It is used in conjunction with the password field. You can enter a maximum of sixteen alphanumeric characters.

This determines whether Van Jacobson Compression is used on this link. The default is On. If your user is authenticated by the IOLAN, this VJ compression value will be overridden if you have set the User Framed Compression On. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Compression is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

Show 8 more labels / short text on this page
Line Service Commands · ruser · authentication · tr-retry · tr-tmout · user · vj-comp · Line Commands 83
Page 86 of the Perle Systems CSS user manual — Set SLIP
Page 86 · click to enlarge
Page 86

Set PPP Dynamic-DNS

Description This option is only available when IP address negotiation (ipaddr-neg) is on. When

enabled, the IOLAN will automatically update the DNS server with the specified host name and negotiated IP address for the PPP session. User Level Admin Syntax set ppp line .|<number>|* dynamic-dns [on|off]

[hostname <hostname>] [username <username>] [password <password>]

Specify the host name that will be updated with the PPP session’s IP address on the DynDNS.org server.

Specify the user name used to access the DynDNS.org server.

Specify the password used to access the DynDNS.org server.

Set SLIP

Description Configures the lines SLIP settings. User Level Admin Syntax set slip line .|<number>|* [lipaddr <IPV4_address>]

[mtu <256-1006>] [netmask <IPV4_address>] [ripaddr <IPV4_address>] [vj-comp on|off] [routing none|send|listen|send-and-listen]

The IPv4 address of the IOLAN end of the SLIP link. For routing to work you must enter an IP address in this field. Choose an address that is part of the same network or subnetwork as the remote end; for example, if the remote end is address 192.101.34.146, your local IP address can be 192.101.34.145. Do not use the IOLAN’s (main) IP address in this field; if you do so, routing will not take place correctly.

The Maximum Transmission Unit (MTU) parameter restricts the size of individual SLIP packets being sent by the IOLAN. Enter a value between 256 and 1500. The default value is 256. If your user is authenticated by the IOLAN, this MTU value will be overridden when you have set a Framed MTU value for the user. If your user is authenticated by RADIUS and the RADIUS parameter Framed-MTU is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

The network subnet mask. For example, 255.255.0.0. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Netmask is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

The IPv4 address of the remote end of the SLIP link. Choose an address that is part of the same network or subnetwork as the IOLAN. If your user is authenticated by the IOLAN, this remote IP address will be overridden if you have set a Framed IP Address for the user. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Address is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

Show 8 more labels / short text on this page
Line Service Commands · Options hostname · username · password · Options lipaddr · mtu · netmask · ripaddr
Page 87 of the Perle Systems CSS user manual — Set UDP
Page 87 · click to enlarge
Page 87

This determines whether Van Jacobson compression is used on this link; that is, whether you are using SLIP or C-SLIP (compressed SLIP). The choices are On (C-SLIP) or Off (SLIP). The default is On. C-SLIP greatly improves the performance of interactive traffic, such as Telnet or Rlogin. If your user is authenticated by the IOLAN, this VJ compression value will be overridden if you have set a Framed Compression value for a user. If your user is authenticated by RADIUS and the RADIUS parameter Framed-Compression is set in the RADIUS file, the IOLAN will use the value in the RADIUS file in preference to the value configured here.

Determines the routing mode (RIP, Routing Information Protocol) used on the SLIP interface as one of the following options:

z None—Disables RIP over the SLIP interface.

z Send—Sends RIP over the SLIP interface.

z Listen—Listens for RIP over the SLIP interface.

z Send and Listen—Sends RIP and listens for RIP over the SLIP interface. This is the same function as the Framed-Routing attribute for RADIUS authenticated users. Default is None.

Set UDP

Description Configures the UDP settings for the serial line. User Level Normal, Admin Syntax set udp line .|<number>|* entry 1|2|3|4

both auto-learn|specific <UDP_port> [<start_IP_address>] [<end_IP_address>]

set udp line .|<number>|* entry 1|2|3|4 in

any-port|auto-learn|specific <UDP_port> [<start_IP_address>] [<end_IP_address>]

set udp line .|<number>|* entry 1|2|3|4 out <UDP_port>

[<start_IP_address>] [<end_IP_address>]

set udp line .|<number>|* entry 1|2|3|4 none

Selects which of the 4 available entries we wish to define/modify. For each entry the user can specify a different IP address range, UDP port and direction of data flow.

Show 5 more labels / short text on this page
Line Service Commands · vj-comp · routing · Options entry 1|2|3|4 · Line Commands 85
Page 88 of the Perle Systems CSS user manual — Set Vmodem
Page 88 · click to enlarge
Page 88

The direction in which information is received or relayed:

z None—UDP service not enabled.

z In—LAN to serial. The IOLAN will listen on port value configured in the DS Port parameter for messages coming from the learned or configured port.

z Out—Serial to LAN. The IOLAN will forward data received on the serial port to the IP address range, UDP port configured for this entry.

z Both—Messages are relayed in both directions. For messages coming from the LAN to the serial device, IOLAN will listen on the port value configured in the DS Port parameter for messages coming from the learned or configured port. For messages going from the serial device to the LAN, the IOLAN will forward the data to the IP address range and UDP port configured for this entry. If auto-learn is enabled, the IOLAN must receive a UDP message before it can send one, since the UDP port number is learned from the received message.

The IOLAN will only listen to the first port that it receives a UDP packet from. Applicable when set to In or Both.

The IOLAN will receive messages from any port sending UDP packets. Applicable when set to In.

The port that the IOLAN will use to relay messages to servers/hosts or the port from which the IOLAN will receive messages to be forwarded to the serial port.. This option works with any setting except None. The IOLAN will listen for UDP packets on the port configured by the DS Port parameter.

The first host IP address in the range of IP addresses (for IPV4 or IPV6) that the IOLAN will listen for messages from and/or send messages to.

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.

Set Vmodem

Description Configures the vmodem settings for the serial line. SSL/TLS can be enabled and

configured for this Line Service. User Level Admin Syntax set vmodem line .|<number>|* [echo on|off]

[failure-string <string>] [host <config_host>] [init-string <string>] [mode auto|manual] [port <TCP_port>|0] [respons-delay <time_ms>] [signals dcd always-high|follow-connection] [signals dtr always-high|represent-dcd|represent-ri] [signals rts always-high|represent-dcd|represent-ri] [style numeric|verbose] [success-string <string>] [suppress on|off]

When enabled, echoes back characters that are typed in (equivalent to ATE0/ATE1 commands). Disabled by default.

Show 8 more labels / short text on this page
Line Service Commands · both|in|out|none · auto-learn · any-port · specific · <start_IP_address> · <end_IP_address> · Options echo
Page 89 of the Perle Systems CSS user manual — Set Vmodem
Page 89 · click to enlarge
Page 89

String that is sent to the serial device when a connection fails. If no string is entered, then the string NO CARRIER will be sent.

The target host name.

You can specify additional vmodem commands that will affect how vmodem starts. The following commands are supported: ATQn, ATVn, ATEn, ATS0, AT&Z1, AT&Sn, AT&Rn, AT&Cn, AT&F, ATS2, ATS12, and ATDS1.

See VModem Initialisation Commands in the IOLAN User’s Guide for a more detailed explanation of the support initialisation commands.

mode Auto mode establishes the connection when the line becomes active. You must supply the AT command or phone number that will start the connection; see Set Vmodem-Phone on page 89 for the command parameters to set the AT command or phone number. port

The port number the target host is listening on for messages.

The amount of time, in milliseconds, before an AT response is sent to the requesting device. The default is 250 ms.

signals dcd Controls the state of the DCD signal.

z always-high = DCD signal will always stay high.

z follow-connection = DCD signal will be high when an end to end connection is established and low when it is not. Since the IOLAN does not have a physical DCD pin, you need to re-map the DTR or RTS signal to DCD to have the signal present. (see next option).

You can specify how the DTR signal pin acts during your modem application connection, as itself (DTR), as DCD, or as RI.

You can specify how the RTS signal pin acts during your modem application connection, as itself (RTS), as DCD, or as RI.

Show 8 more labels / short text on this page
Line Service Commands · failure-string · host · init-string · response-delay · signals dtr · signals rts · Line Commands 87
Page 90 of the Perle Systems CSS user manual — 1 CONNECTED
Page 90 · click to enlarge
Page 90

One of the following:

z Verbose—Return codes (strings) are sent to the connected device.

z 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

String that is sent to the serial device when a connection succeeds. If no string is entered, then the string CONNECT will be sent with the connecting speed, for example CONNECT 9600.

When enabled, the connection success/failure indication strings are sent to the connected device, otherwise these indications are suppressed. The default is disabled.

Show 4 more labels / short text on this page
Line Service Commands · style · success-string · suppress
Page 91 of the Perle Systems CSS user manual — Set SSL Line
Page 91 · click to enlarge
Page 91

Set Vmodem-Phone

Description This command associates a phone number with an IP address and TCP port. This

enables the existing modem application to issue a dial command with a phone number. The phone number will be search in this table and if an exact match is found, the associated IP address and TCP port will be used to establish the connection. This is a universal command, meaning that all VModem lines will access to the entries defined here. 1-port models support up to 4 entries, all other desktop models support up to 8 entries, and rack-mount models support up to 48 entries. User Level Admin Syntax set vmodem-phone entry <number> phone-number <string>

<IP_address> <TCP_port>

set vmodem-phone entry <number> delete

Options entry Specify the entry number in the vmodem phone number table.

Specify the phone number that your application uses to connect to remote location. Enter the number exactly as it is issued by your application.

Specify the IP address of the remote host that is receiving the vmodem connection.

Specify the TCP port that the remote host is lisening on for the vmodem connection

delete Deletes the specified entry from the phone number table.

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. User Level Admin Syntax set ssl line .|<number>|* [enable on|off] [use-server on|off]

[version any|tslv1|sslv3] [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>]

Activates the SSL/TLS settings for the line.

Uses the SSL/TLS server configuration for the line.

Specify whether you want to use:

z 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.

z TLSv1—The connection will use only TLSv1.

z SSLv3—The connection will use only SSLv3. The default is Any.

Show 8 more labels / short text on this page
Line Service Commands · phone-number · <IP_address> · <TCP_port> · Options enable · use-server · version · Line Commands 89
Page 92 of the Perle Systems CSS user manual — Set Vmodem-Phone
Page 92 · click to enlarge
Page 92

Specify whether the IOLAN will act as an SSL/TLS client or server. The default is Client.

Enable this option when you want the Validation Criteria to match the Peer Certificate for authentication to pass. If you enable this option, you need to download an SSL/TLS certificate authority (CA) list file to the IOLAN.

Any values that are entered in the validation criteria must match the peer certificate for an SSL connection; any fields left blank will not be validated against the peer certificate.

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.

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.

Up to a 128 character entry for the location; for example, a city. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for the organisation; for example, Accounting. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

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.

Up to a 64 character entry for common name; for example, the host name or fully qualified domain name. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Up to a 64 character entry for an email address; for example, acct@anycompany.com. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.

Show 11 more labels / short text on this page
Line Service Commands · type · verify-peer · validation-criteria · country · state-province · locality · organisation · organisation-unit · common-name · email
Page 93 of the Perle Systems CSS user manual — Set SSL Line Cipher-suite
Page 93 · click to enlarge
Page 93

Set SSL Line Cipher-suite

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 hmac any|sha1|md5

Sets the priority of the cipher suite, with option1 being highest priority and option5 lowest priority.

Select the type of encryption that will be used for the SSL connection:

z Any—Will use the first encryption format that can be negotiated.

z None—Removes any values defined for the cipher option. The default value is Any.

The minimum key size value that will be used for the specified encryption type. The default is 40.

The maximum key size value that will be used for the specified encryption type. The default is 256.

The type of key to exchange for the encryption format:

z Any—Any key exchange that is valid is used (this does not, however, include ADH keys).

z RSA—This is an RSA key exchange using an RSA key and certificate.

z EDH-RSA—This is an EDH key exchange using an RSA key and certificate.

z EDH-DSS—This is an EDH key exchange using a DSA key and certificate.

z ADH—This is an anonymous key exchange which does not require a private key or certificate. Choose this key if you do not want to authenticate the peer device, but you want the data encrypted on the SSL/TLS connection. The default is Any.

Select the key-hashing for message authentication method for your encryption type:

z SHA1 The default is Any.

Show 15 more labels / short text on this page
Line Service Commands · Options option1|option2|option3|option4|option5 · encryption · z AES · z 3DES · z DES · z ARCFOUR · z ARCTWO · min-key-size · max-key-size · key-exchange · hmac · z Any · z MD5 · Line Commands 91
Page 94 of the Perle Systems CSS user manual — Set Modbus-Master Line
Page 94 · click to enlarge
Page 94

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>]

When Modbus/ASCII is selected, adds a CR/LF to the end of the transmission; most Modbus devices require this option. The default is On.

Specify the protocol that is used between the Modbus Master(s) and Modbus Slave(s), either RTU or ASCII.

You can specify a range of UIDs (1-247), in addition to individual UIDs. The format is comma delimited; for example, 2-35, 50, 100-103.

Set Modbus-Master Line

Description Sets the Modbus master parameters for the line. SSL/TLS can be enabled and

configured for this Line Service. User Level Admin Syntax set modbus-master line .|<number>|* [crlf on|off]

[protocol rtu|ascii] [[entry <number> [port <port>] [protocol udp|tcp] [range-mode gateway|host] [slave-ip <IP_address>] [uid-range <start_uid> <end_uid>]]

When Modbus/ASCII is selected, adds a CR/LF to the end of the transmission; most Modbus devices require this option. The default is On.

Specify the protocol that is used between the Modbus Master(s) and Modbus Slave(s), either RTU or ASCII.

You can specify up to 16 Modbus Slave Remote IP Mapping entries (the UIDs must not overlap).

The destination port of the remote Modbus TCP Slave that the IOLAN will connect to.

Specify the protocol that is used between the Modbus Master and Modbus Slave(s), either TCP or UDP.

If you specify Host, the IP address is used for the first UID specified in the range. The last octect in the IPv4 address is then incremented for subsequent UID’s in that range. The Host option is not applicable for IPv6 addresses. If you specify Gateway, the Modbus Master Gateway will use the same IP address when connecting to all the remote Modbus slaves in the specified UID range.

Show 10 more labels / short text on this page
Line Service Commands · Options crlf · protocol · uid-range · Options crlf · protocol · entry · port · protocol · range-mode
Page 95 of the Perle Systems CSS user manual — Set Power-Management Line
Page 95 · click to enlarge
Page 95

The IP address of the TCP/Ethernet Modbus Slave.

When Range Mode is Host and you have sequential Modbus Slave IP addresses (for example, 10.10.10.1, 10.10.10.2, 10.10.10.3, etc.), you can specify a UID range and the IOLAN will automatically increment the last digit of the configured IP address. Therefore, you can specify a UID range of 1-100, and the IOLAN will route Master Modbus messages to all Modbus Slaves with IP addresses of 10.10.10.1 - 10.10.10.100.

Set Power-Management Line

Description Configures the power management settings for the line. User Level Admin Syntax set power-management line .|<number>|*

[model rps820|rps830|rps1620|rps1630] [name <bar_name>]

set power-management line .|<number>|* plug <1-8|1-16>

[default-state on|off] [name <plug_name>] [power-up-interval .5|1|2|5|15|30|60|120|180|300] [serial-line <number>]

Specify the power bar model, either RPS820, RPS830, RPS1620, RPS1630.

name (power bar name)

Specify a name for the RPS.

Specify the power bar plug number you are configuring.

Sets the default state of the plug, either on or off. The default is off.

Specify a name for the plug to make it easier to recognize and manage.

Specify the amount of time, in seconds, that the power bar will wait before powering up a plug. This can be useful if you have peripherials that need to be started in a specific order.

Associate a serial line(s) connected to a serial device that is plugged into the power bar on that plug.

Show 10 more labels / short text on this page
Line Service Commands · slave-ip · uid-range · Options model · plug · default-state · name (plug name) · power-up-interval · serial-line · Line Commands 93
Page 96 of the Perle Systems CSS user manual — Show Power-Management
Page 96 · click to enlarge
Page 96

Set Multihost Line

Description Configures multiple hosts or a primary/backup host schema for Silent Raw, Reverse

Raw, or Client-Inititated TruePort service types (multihost must be enabled by the line service type for this to take effect, see Set Line Service on page 73 for the command to enable multihost). User Level Admin Syntax set multihost line <number> entry <number> host <host> <TCP_port>

set multihost line <number> entry <number> delete

Options entry You can specify up to 49 hosts in the multihost table.

host <host>

Specify the preconfigured host that will be in the multihost list.

Specify the TCP port that the IOLAN will use to communicate to the Host.

delete Deletes the specified entry from the multihost table.

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>

Initiates a connection to the specified host only when the specified character is received by the serial port.

Show Custom-App

Description Shows the custom application line settings. User Level Admin Syntax show custom-app line .|<number>|*

Show Interface

Description Shows the network interface information. User Level Admin Syntax show interface [brief|ppp|slip|ethernet]

Show Power-Management

Description Shows the power management settings for a line. User Level Admin Syntax show power-management line <number>

Line Service Commands · <TCP_port>

Page 97 of the Perle Systems CSS user manual — Show Vmodem-Phone
Page 97 · click to enlarge
Page 97

Show PPP

Description Shows the PPP line settings. User Level Admin Syntax show ppp line <number>|wireless-wan

Show Rlogin-Client

Description Show the rlogin-client settings for the line. User Level Normal, Admin Syntax show rlogin-client line <number>

Show SLIP

Description Show the SLIP settings for the line. User Level Admin Syntax show slip line <number>

Show SSH-Client

Description Shows the SSH client settings for the line. User Level Admin Syntax show ssh-client line <number>

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. User Level Admin Syntax show udp line <number>

Show Vmodem

Description Show the vmodem settings for the line. User Level Normal, Admin Syntax show vmodem line <number>

Show Vmodem-Phone

Description Show the vmodem-phone entries. User Level Normal, Admin Syntax show vmodem-phone

Line Service Commands · Line Commands 95

Page 98 of the Perle Systems CSS user manual — Show Modems
Page 98 · click to enlarge
Page 98

Modem Commands

Add Modem

Description Adds a modem. User Level Admin Syntax add modem <modem_name> <initialization_string>

Options <modem_name>

The name of the modem. Do not use spaces.

The initialisation string of the modem; see your modem’s documentation.

Delete Modem

Description Deletes a modem. User Level Admin Syntax delete modem <config_modem_name>

Option <config_modem_name>

You can see a the list of modems that can be deleted by typing delete modem ?.

Set Modem

Description Sets the modem initialization strings for a defined modem. If you wish to add a new

modem, use the add modem command. User Level Admin Syntax set modem <modem_name> <init_string>

Options <modem_name>

Predefined modem name.

Specify the initialization string for the internal modem.

Show Modems

Description Shows the IOLAN modem table. User Level Normal, Admin Syntax show modems

Modem Commands · <initialization_string> · <init_string>

Page 99 of the Perle Systems CSS user manual — Set Email-Alert Line
Page 99 · click to enlarge
Page 99

Email Commands

Set Email-Alert Line

Description This command configures email alert parameters for the line. User Level Admin Syntax set email-alert line <number>|* [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>] [use-server on|off]

This field will be specified in the from field of the email message sent by the IOLAN.

Choose the event level that triggers an email notification:

z Debug The list is in decreasing order of priority (Emergency has the highest priority). You are selecting the lowest notification level; therefore, when you select Debug, you will get an email notification for all events that trigger a message.

Determines whether or not email notification is turned on. Default is Off.

An email address or list of email addresses that will receive the email notification.

The email address to whom all replies to the email notification should go.

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.

A text string, which can contain spaces, that will display in the Subject field of the email notification.

Determines whether you want the Line to inherit the Email Alert settings from the Server Email Alert. If this is enabled, Server and Line notification events will have the same Email Alert setting.

Show 17 more labels / short text on this page
Email Commands · Options from · level · z Emergency · z Alert · z Critical · z Error · z Warning · z Notice · z Info · mode · to · reply-to · smtp-host · subject · use-server · Line Commands 97
Page 100 of the Perle Systems CSS user manual — Set Packet-Forwarding Line
Page 100 · click to enlarge
Page 100

Show Email-Alert Line

Description Shows how the line email alert is configured. User Level Admin Syntax show email-alert line <number>

Packet Forwarding Commands

Set Packet-Forwarding Line

Description The Packet Forwarding feature allows you to control how the data coming from a serial

device is packetized before forwarding the packet onto the LAN network. This command configures packet forwarding options for serial devices attached to the serial line. The command is broken up into logical flows that can be configured; if you configure both the packet options and the frame definition options, the frame definition options will take precedence. If any of the packet options that are configured are met, the packet transmission is triggered. User Level Admin Syntax set packet-forwarding line <number>|* mode minimize-latency

set packet-forwarding line <number>|* mode

set packet-forwarding line <number>|* mode

set packet-forwarding line <number>|*

mode custom-on-specific-events [enable-end-trigger1 on|off] [enable-end-trigger2 on|off] [end-trigger1 <0x0-FF>] [end-trigger2 <0x0-FF>] [force-transmit-timer <number>] [forwarding-rule trigger1|trigger+1|trigger+2|strip-trigger] [idle-timer <number>] [packet-size <number>]

set packet-forwarding line <number>|*

mode custom-on-fram-definition [enable-eof1 on|off] [enable-eof2 on|off] [enable-sof1 on|off] [enable-sof2 on|off] [eof1 <0x0-FF>] [eof2 <0x0-FF>] [forwarding-rule trigger|trigger+1|trigger+2|strip-trigger] [sof1 <0x0-FF>] [sof2 <0x0-FF>] [start-frame-transmit on|off]

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.

This option provides optimal network usage while ensuring that the application performance is not compromised. Select this option when you want to minimize overall packet count, such as when the connection is over a WAN.

This option detects the message, packet, or data blocking characteristics of the serial data and preserves it throughout the communication. Select this option for message-based applications or serial devices that are sensitive to inter-character delays within these messages.

Show 6 more labels / short text on this page
Packet Forwarding Commands · optimize-network-throughput · prevent-message-fragmentation delay-between-messages <0-65535> · Options minimize-latency · optimize-network-throughput · prevent-message-fragmentation
Page 101 of the Perle Systems CSS user manual — Show Email-Alert Line
Page 101 · click to enlarge
Page 101

The minimum time, in milliseconds, between messages that must pass before the data is forwarded by the IOLAN. The range is 0-65535. The default is 250 ms.

This section allows you to set a variety of packet definition options. The first criteria that is met causes the packet to be transmitted. For example, if you set a Force Transmit Timer of 1000 ms and a Packet Size of 100 bytes, whichever criteria is met first is what will cause the packet to be transmitted.

This section allows you to control the frame that is transmitted by defining the start and end of frame character(s). If the internal buffer (1024 bytes) is full before the EOF character(s) are received, the packet will be transmitted and the EOF character(s) search will continue. The default frame definition is SOF=00 and EOF=00.

Enable or disable the end trigger1 hex character.

Enable or disable the end trigger2 hex character.

Enable or disable the eof1 (end of frame) hex character.

Enable or disable the eof2 (end of frame) hex character.

Enable or disable the sof1 (start of frame) hex character.

Enable or disable the sof2 (start of frame) hex character.

When enabled, specifies the character that when received will define when the packet is ready for transmission. The transmission of the packet is based on the Trigger Forwarding Rule. Valid values are in hex 0-FF. The default is 0.

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). The transmission of the packet is based on the Trigger Forwarding Rule. Valid values are in hex 0-FF. The default is 0.

Specifies the End of Frame character, which defines when the frame is ready to be transmitted. The transmission of the frame is based on the Trigger Forwarding Rule. Valid values are in hex 0-FF. The default is 0.

Show 14 more labels / short text on this page
Packet Forwarding Commands · delay-between-messages · custom-on-specific-events · custom-on-frame-definition · enable-end-trigger1 · enable-end-trigger2 · enable-end-eof1 · enable-end-eof2 · enable-end-sof1 · enable-end-sof2 · end-trigger1 · end-trigger2 · eof1 · Line Commands 99
Page 102 of the Perle Systems CSS user manual — Show Email-Alert Line
Page 102 · click to enlarge
Page 102

When enabled, creates a sequence of characters that must be received to define the end of the frame (if the EOF1 character is not immediately followed by the EOF2 character, the IOLAN waits for another EOF1 character to start the EOF1/EOF2 character sequence), which defines when the frame is ready to be transmitted. The transmission of the frame is based on the Trigger Forwarding Rule. Valid values are in hex 0-FF. The default is 0.

When the specified amount of time, in milliseconds, elapses after the first character is received from the serial port, the packet is transmitted. After a packet is transmitted, the next character received starts the timer again. A value of zero (0) ignores this parameter. Valid values are 0-65535 ms. The default is 0.

Determines what is included in the Frame (based on the EOF1 or EOF1/EOF2) or Packet (based on Trigger1 or Trigger1/Trigger2). Choose one of the following options:

z Strip-Trigger—Strips out the EOF1, EOF1/EOF2, Trigger1, or Trigger1/Trigger2, depending on your settings.

z Trigger—Includes the EOF1, EOF1/EOF2, Trigger1, or Trigger1/Trigger2, depending on your settings.

z Trigger+1—Includes the EOF1, EOF1/EOF2, Trigger1, or Trigger1/Trigger2, depending on your settings, plus the first byte that follows the trigger.

z Trigger+2—Includes the EOF1, EOF1/EOF2, Trigger1, or Trigger1/Trigger2, depending on your settings, plus the next two bytes received after the trigger.

The amount of time, in milliseconds, that must elapse between characters before the packet is transmitted to the network. A value of zero (0) ignores this parameter. Valid values are 0-65535 ms. The default is 0.

The number of byte that must be received from the serial port before the packet is transmitted to the network. A value of zero (0) ignores this parameter. Valid values are 0-1024 bytes. The default is 0.

When enabled, the Start of Frame character defines the first character of the frame, any character(s) received before the Start of Frame character is ignored. Valid values are in hex 0-FF. The default is 0.

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). Valid values are in hex 0-FF. The default is 0.

When enabled, the SOF1 or SOF1/SOF2 characters will be transmitted with the frame. If not enabled, the SOF1 or SOF1/SOF2 characters will be stripped from the transmission.

Show 9 more labels / short text on this page
Packet Forwarding Commands · eof2 · force-transmit-timer · forwarding-rule · idle-timer · packet-size · sof1 · sof2 · start-frame-transmit
Page 103 of the Perle Systems CSS user manual — Show Packet-Forwarding Line
Page 103 · click to enlarge
Page 103

Show Packet-Forwarding Line

Description Shows the packet-forwarding settings for the line. User Level Admin Syntax show packet-forwarding line <number>

Packet Forwarding Commands · Line Commands 101

Page 104 of the Perle Systems CSS user manual — Show Packet-Forwarding Line
Page 104 · click to enlarge
Page 104

Packet Forwarding Commands

Page 105 of the Perle Systems CSS user manual — Add Trap
Page 105 · click to enlarge
Page 105

Network Commands Chapter 5 5

This chapter defines all the CLI commands associated with configuring the IOLAN’s network parameters.

SNMP Commands

Add Community

Description Adds an SNMP community (version 1 and version 2). User Level Admin Syntax add community <community_name> <config_host>|<IP_address>

Options <community_name>

The name of the group that devices and management stations running SNMP belong to.

<config_host>|<IP_address>

The host name of the SNMP community that will send requests to the IOLAN.

The IPv4 or IPv6 address of the SNMP manager that will send requests to the IOLAN. If the address is 0.0.0.0, any SNMP manager with the Community Name can access the IOLAN. If you specify a network address, for example 172.16.0.0, any SNMP manager within the local network with the Community Name can access the IOLAN.

Permits the IOLAN to respond to SNMP requests by:

z None—There is no response to requests from SNMP.

z Readonly—Responds only to Read requests from SNMP.

z Readwrite—Responds to both Read and Write requests from SNMP.

Add Trap

Description Adds an SNMP host to which trap messages will be sent. The IOLAN supports SNMP

traps for restart and SNMP community authentication error. User Level Admin Syntax add trap <trap_name> <config_host>|<IP_address>

Options <trap_name>

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.

<config_host>|<IP_address>

Defines the hosts (by IPv4 or IPv6 address) that will receive trap messages generated by the IOLAN. Up to four trap hosts can be defined.

none|readonly|readwrite · none|readonly|readwrite

Page 106 of the Perle Systems CSS user manual — Set SNMP
Page 106 · click to enlarge
Page 106

Delete Community

Description Deletes an SNMP community (version 1 and version 2). User Level Admin Syntax delete community <config_community_number>

Option <config_community_number>

When you add an SNMP community, it gets assigned to a number. To delete the SNMP community, you need to specify the number of the community that you want to delete. To see which community is assigned to what number, type the show snmp command.

Delete Trap

Description Deletes an SNMP trap host. User Level Admin Syntax delete trap <config_trap_number>

Option <config_trap_number>

When you add an SNMP trap host, it gets assigned to a number. To delete the SNMP trap host, you need to specify the number of the trap host that you want to delete. To see which trap host is assigned to what number, type the show snmp command.

Set SNMP

Description Configures SNMP settings. User Level Admin Syntax set snmp [contact <string>] [location <string>]

[readonly user <username>] [readwrite user <username>]

The name and contract information of the person who manages this SMNP node.

The physical location of the SNMP node.

(SNMP version 3) Specified user can only view SNMP variables.

(SNMP version 3) Specified user can view and edit SNMP variables.

Show 5 more labels / short text on this page
SNMP Commands · Options contact · location · readonly user · readwrite user
Page 107 of the Perle Systems CSS user manual — Set SNMP V3-Security
Page 107 · click to enlarge
Page 107

Set SNMP V3-Security

Description Configures SNMP settings for the Version 3 read-write and read-only user. User Level Admin Syntax set snmp v3-security readonly [auth-algorithm md5|sha1]

[privacy-algorithm des|aes] [security-level none|auth/nopriv|auth/priv]

set snmp v3-security readonly auth-password|privacy-password

set snmp v3-security readwrite [auth-algorithm md5|sha1]

[privacy-algorithm des|aes] [security-level none|auth/nopriv|auth/priv]

set snmp v3-security readwrite auth-password|privacy-password

Specify the authentication algorithm that will be used for the read-only user. The default is MD5.

Specify the read-only user’s privacy algorithm (encryption). The default is DES.

Select the security level for the read-only user. This must match the configuration set up in the SNMP manager. The default is none.

Specify the auth password for the V3 read-only user. You will be prompted to retype the password.

Specify the privacy password for the V3 read-only user. You will be prompted to retype the password.

Specify the authentication algorithm that will be used for the read-write user. The default is MD5.

Specify the read-write user’s privacy algorithm (encryption). The default is DES.

Select the security level for the read-writer user. This must match the configuration set up in the SNMP manager. The default is none.

Specify the auth password for the V3 read-write user. You will be prompted to retype the password.

Specify the privacy password for the V3 read-write user. You will be prompted to retype the password.

Show 12 more labels / short text on this page
SNMP Commands · Options readonly auth-algorithm · readonly privacy-algorithm · readonly security-level · readonly auth-password · readonly privacy-password · readwrite auth-algorithm · readwrite privacy-algorithm · readwrite security-level · readwrite auth-password · readwrite privacy-password · Network Commands 103
Page 108 of the Perle Systems CSS user manual — Delete Host
Page 108 · click to enlarge
Page 108

Show SNMP

Description Shows SNMP settings, including communities and traps. User Level Admin Syntax show snmp

TFTP Commands

Set Server TFTP

Description Configures the IOLANs TFTP client settings. User Level Admin Syntax set server tftp [retry <integer>] [timeout <integer>]

The number of times the IOLAN will retry to transmit a TPFT packet to/from a host when no response is received. Enter a value between 0 and 5. The default is 5. A value of 0 (zero) means that the IOLAN will not attempt a retry should TFTP fail.

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 3 seconds.

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.

The host IPv4 or IPv6 address.

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 IP Filtering is enabled).

Delete Host

Description Deletes a host from the IOLAN host table. User Level Admin Syntax delete host <config_host>

Option <config_host>

You can see a list of hosts that can be deleted by typing delete host ?.

Show 5 more labels / short text on this page
TFTP Commands · Options retry · timeout · <IP_address> · fqdn
Page 109 of the Perle Systems CSS user manual — Add WINS
Page 109 · click to enlarge
Page 109

Set Host

Description Configures a host in the IOLAN host table. User Level Admin Syntax set host <config_host> <IP_address>

set host <config_host> fqdn <text>

Options <config_host>

The name of the host.

The host IPv4 or IPv6 address.

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 IP Filtering is enabled).

Show Hosts

Description Shows the IOLAN host table. User Level Normal, Admin Syntax show hosts

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. User Level Admin Syntax add wins <IP_address>

Option <IP_address>

You can specify the IPv4 addresses for up to four WINS (Windows Internet Naming Service) hosts in your network.

Show 4 more labels / short text on this page
DNS/WINS Commands · <IP_address> · fqdn · Network Commands 105
Page 110 of the Perle Systems CSS user manual — Show WINS
Page 110 · click to enlarge
Page 110

Delete DNS

Description Deletes a DNS entry. User Level Admin Syntax delete dns <config_dns_addr>

Option <config_dns_addr>

You can view a list of configured DNS server IP addresses to choose from by typing delete dns ?.

Delete WINS

Description Deletes a WINS entry. User Level Admin Syntax delete wins <config_wins_addr>

Option <config_wins_addr>

You can view a list of configured WINS server IP addresses to choose from by typing delete wins ?.

Show DNS

Description Shows all DNS entries, even those supplied by DHCP/BOOTP when applicable. User Level Admin, Normal Syntax show dns

Show Server

Description Shows the server configuration, including configured WINS or DNS servers. User Level Admin, Normal Syntax show server

Show WINS

Description Shows all WINS entries, even those supplied by DHCP/BOOTP when applicable. User Level Admin, Normal Syntax show wins

DNS/WINS Commands

Page 111 of the Perle Systems CSS user manual — Add Gateway
Page 111 · click to enlarge
Page 111

Gateway Commands

Add Gateway

Description Adds a gateway. You can configure up to twenty gateways. User Level Admin Syntax add gateway <config_host> default

add gateway <config_host> host <dest_IP_addr>

add gateway <config_host> network

<dest_IPv4_addr>|<dest_IPv6_addr> [<subnet_bits_0-32>|<prefix_bits_0-128>]

add gateway specify-gateway ipv6tunnel <tunnel_name> default|

host <dest_IP_addr>| network <dest_IPv4_addr>|<dest_IPv6_addr> [<subnet_bits_0-32>|<prefix_bits_0-128>]

add gateway specify-gateway serial-port ppp <line_name>|

slip <line_name> default| host <dest_IP_addr>| network <dest_IPv4/IPv6_addr> [<subnet_bits_0-32>|<prefix_bits_0-128>]

Options <config_host>

You can specify up to 20 hosts on desktop models and 49 hosts on rack mount models to act as gateways in your network. Each gateway host must be defined in the IOLAN’s host table.

Specify the type of gateway:

z Default—A gateway which provides general access beyond your local network.

z Host—(Default) A gateway reserved for accessing a specific host external to your local network.

z Network—A gateway reserved for accessing a specific network external to your local network.

ipv6tunnel <tunnel_name>

Specify the configured IPv6 tunnel that you want to use as the gateway to the destination.

serial-port ppp|slip <line_name>

Specify the PPP or SLIP configured line that you want to use as the gateway to the destination.

When the gateway is a Host or Network gateway, you must specify the IPv4 or IPv6 address of the target host machine/network.

<subnet_bits>|<prefix_bits>

When the gateway is a Network gateway, you must specify the network’s subnet mask (IPv4) or prefix bits (IPv6).

Show 4 more labels / short text on this page
Gateway Commands · default|host|network · <dest_IP_addr> · Network Commands 107
Page 112 of the Perle Systems CSS user manual — Show Gateways
Page 112 · click to enlarge
Page 112

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. User Level Admin Syntax set gateway <config_gateway_host> default

set gateway <config_gateway_host> host <destination_ip>

set gateway <config_gateway_host>

network <dest_IPv4_addr>|<dest_IPv6_address> <prefixbits_mask>

Options <config_gateway_host>

You can view the configured gateways that can be deleted by typing delete gateway ?.

Specify the type of gateway:

z Default—A gateway which provides general access beyond your local network.

z Host—(Default) A gateway reserved for accessing a specific host external to your local network.

z Network—A gateway reserved for accessing a specific network external to your local network.

When the gateway is a Host or Network gateway, you must specify the IPv4 or IPv6 address of the target host machine/network.

When the gateway is a Network gateway, you must specify the network’s subnet mask for an IPv4 destination IP address (the address is in the form of 123.123.123.123) or prefix bits for an IPv6 destination IP address (valid values are 0-128).

Show Gateways

Description Shows configured gateways. User Level Normal, Admin Syntax show gateways

Show 4 more labels / short text on this page
Gateway Commands · default|host|network · <destination_ip> · <prefixbits_mask>
Page 113 of the Perle Systems CSS user manual — Show Syslog
Page 113 · click to enlarge
Page 113

Logging Commands

Set Syslog

Description Configures the system log. User Level Admin Syntax set syslog

[level emergency|alert|critical|error|warning|notice|info|debug] [primary-host <config_host>] [secondary-host <config_host>]

Choose the event level that triggers a syslog entry:

z Debug When you select a Level, all the levels that appear above it in the list also trigger a syslog entry. For example, if you select Error, all Error, Critical, Alert, and Emergency events will be logged.

The first preconfigured host that the IOLAN will attempt to send system log messages to; messages will be displayed on the host’s monitor.

If the IOLAN cannot communicate with the primary host, then the IOLAN will attempt to send system log messages to this preconfigured host; messages will be displayed on the host’s monitor.

Show Syslog

Description Shows the syslog settings. User Level Admin Syntax show syslog

Show 12 more labels / short text on this page
Logging Commands · Options level · z Emergency · z Alert · z Critical · z Error · z Warning · z Notice · z Info · primary-host · secondary-host · Network Commands 109
Page 114 of the Perle Systems CSS user manual — Delete RIP
Page 114 · click to enlarge
Page 114

RIP Commands

Add RIP

Description Adds a RIP MD5 key. After pressing Enter, you will be prompted for the MD5 key

value. User Level Admin Syntax add rip md5 <integer_md5_id> <start_date> <start_time> <end_date>

Options <integer_md5_id>

The MD5 identification key.

The start date that the MD5 key becomes valid. The date format is dependent on your system’s settings.

The time that the MD5 key becomes valid. The time format is dependent on your system’s settings.

The last day that the MD5 key is valid. The date format is dependent on your system’s settings.

The time that the MD5 key becomes invalid. The time format is dependent on your system’s settings.

Delete RIP

Description Deletes a RIP MD5 key. User Level Admin Syntax delete rip md5 <integer_md5_id>

Option <integer_md5_id>

You can see a list of MD5 IDs available for deletion by typing delete rip md5 ?.

Show 6 more labels / short text on this page
RIP Commands · <end_time> · <start_date> · <start_time> · <end_date> · <end_time>
Page 115 of the Perle Systems CSS user manual — Show RIP
Page 115 · click to enlarge
Page 115

Set RIP

Description Configures the RIP MD5 key. After pressing Enter, you will be prompted for the MD5

key value. User Level Admin Syntax set rip [authentication none|password|md5]

set rip md5 <config_md5_id> [end <date> <time>]

[start <date> <time>] [key]

Specify the type of RIP authentication:

z None—No authentication for RIP.

z Password—Simple RIP password authentication.

z MD5—Use MD5 RIP authentication.

Enable/disable RIP (Routing Information Protocol) mode for the Ethernet interface with one of the following options:

z None—Disables RIP over the Ethernet interface.

z Send—Sends RIP over the Ethernet interface.

z Listen—Listens for RIP over the Ethernet interface.

z Send and Listen—Sends RIP and listens for RIP over the Ethernet interface.

When you type the set rip password command and press Enter, you will be prompted to type in a password and then re-enter that password.

The MD5 identification key.

end <date> <time>

The last day that the MD5 key is valid. Specify as dd/mm/yyyy.

The time that the MD5 key becomes invalid. Specify as hh:mm:[ss].

start <date> <time>

The start date that the MD5 key becomes valid. Specify as dd/mm/yyyy.

The time that the MD5 key becomes valid. Specify as hh:mm:[ss].

When you press Enter after typing the key command, you will be prompted to enter the MD5 key value and then re-enter the key value.

Show RIP

Description Shows the RIP settings. User Level Normal, Admin Syntax show rip

Show 9 more labels / short text on this page
RIP Commands · [ethernet-mode none|send|listen|send-and-listen] · set rip password · Options authentication · ethernet-mode · password · <configured_md5_id> · key · Network Commands 111
Page 116 of the Perle Systems CSS user manual — Set IPsec
Page 116 · click to enlarge
Page 116

Show RIP Peers

Description Shows current information about IPv4 or IPv6 RIP peers. User Level Normal, Admin Syntax show rip peers [ipv6]

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 on page 119 for the command syntax.

Add IPsec

Description Adds an IPsec tunnel. User Level Admin Syntax add ipsec <tunnel_name>

Option <tunnel_name>

The name of an IPsec VPN tunnel. You can configure up to 64 VPN tunnels.

Set IPsec

Description Configures the IPsec tunnel. User Level Admin Syntax set ipsec <config_tunnel_name>

[authentication-method shared-secret|rsa-signature|x.509-certificate] [boot-action start|add|ignore] [local-device left|right] [local-external-ip-address <IPv4/IPv6_address/FQDN>] [local-host-network <IPv4_addr> <subnet_mask>| <IPv6_address> <prefix_bits>] [local-ip-address <IPv4/IPv6_address/FQDN>] [local-next-hop <IPv4/IPv6_address>] [remote-external-ip-address <IPv4/IPv6_address/FQDN>] [remote-host-network <IPv4_addr> <subnet_mask>| <IPv6_address> <prefix_bits>] [remote-ip-address <IPv4/IPv6_address/FQDN>] [remote-next-hop <IPv4/IPv6_address>] [remote-validation-criteria country <code>|state-province <text>|locality <text> |organisation <text>|organisation-unit <text> |common-name <text>|email <email_addr>]

set ipsec <config_tunnel_name> secret <text>

set ipsec use-nat-traversal enabled|disabled

IPsec Commands

Page 117 of the Perle Systems CSS user manual — Show RIP Peers
Page 117 · click to enlarge
Page 117

Specify the authentication method that will be used between VPN peers to authenticate the VPN tunnel. Data Options:

z Shared Secret—A text-based secret that is used to authenticate the IPsec tunnel (case sensitive).

z RSA Signature—RSA signatures are used to authenticate the IPsec tunnel. When using this authentication method, you must download the IPsec RSA public key to the IOLAN and upload the IPsec RSA public key from the IOLAN to the VPN gateway.

z X.509 Certificate—X.509 certificates are used to authenticate the IPsec tunnel. When using this authentication method, you must include the signing authority’s certificate information in the SSL/TLS CA list and download it to the IOLAN. The default is shared secret.

Determines the state of the VPN network when the IOLAN is booted.

z Start—Starts the VPN network, initiating communication to the remote VPN.

z Add—Adds the VPN network, but doesn’t initiate a connection to the remote VPN.

z Ignore—Maintains the VPN network configuration, but the VPN network is not started and cannot be started through the IPsec command option. When defining peer VPN gateways, one side should be defined as Start (initiate) and the other as Add (listen). It is invalid to define both gateways as Add. VPN connection time can take longer when both gateways are set to Start, as both sides will attempt to initiate the same VPN connection. The default is start.

When the VPN tunnel is established, one side of the tunnel is designated as Right and the other as Left. You are configuring the IOLAN-side of the VPN tunnel. The default is left.

When NAT Traversal (NAT_T) is enabled, this is IOLAN’s external IPv4 or IPv6 address or FQDN. When the IOLAN is behind a NAT router, this will be its public IP address.

The IPv4 or IPv6 address of a specific host, or the network address that the IOLAN will provide a VPN connection to.

The IPv4 or IPv6 address or FQDN of the IOLAN. You can specify %defaultroute when the IP address of the IOLAN is not always known (for example, when it gets its IP address from DHCP). When %defaultroute is used, a default gateway must be configured in the route table.

The IPv4 or IPv6 address of the router/gateway that will forward data packets to the remote VPN (if required). The router/gateway must reside on the same subnet at the IOLAN. Leave this parameter blank if you want to use the Default Gateway configured in the IOLAN.

Show 9 more labels / short text on this page
IPsec Commands · Options authentication-method · boot-action · local-device · local-external-ip-address · local-host-nextwork · local-ip-address · local-next-hop · Network Commands 113
Page 118 of the Perle Systems CSS user manual — Show RIP Peers
Page 118 · click to enlarge
Page 118

When NAT Traversal (NAT_T) is enabled, the remote VPN’s public external IPv4 or IPv6 address or FQDN. If you want to accept a VPN connection from any host/network, you can enter %any in this field.

The IPv4 or IPv6 address of a specific host or the network address that the IOLAN will provide a VPN connection to. If the IPsec tunnel is listening for connections (Boot Action set to Add), and the field value is left at 0.0.0.0, any VPN peer with a private remote network/host that conforms to RFC 1918 (10.0.0.0/8, 172.16.0.0./12, 192.168.0.0/16) will be allowed to use this tunnel if it successfully authenticates.

The IPv4 or IPv6 address or FQDN of the remote VPN peer. If you want to accept a VPN connection from any VPN peer, you can enter %any in this field.

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.

Any values that are entered in the remote validation criteria must match the remote X.509 certificate for a succsessful connection; any fields left blank will not be validated against the remote X.509 certificate. Note that all validation criteria must be configured to match the X.509 certificate. An asterick (*) is valid as a wildcard.

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.

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. An asterisk (*) works as a wildcard.

Up to a 128 character entry for the location; for example, a city. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

Up to a 64 character entry for the organisation; for example, Accounting. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

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 remote X.509 certificate. An asterisk (*) works as a wildcard.

Up to a 64 character entry for common name; for example, the host name or fully qualified domain name. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

Show 12 more labels / short text on this page
IPsec Commands · remote-external-ip-address · remote-host-nextwork · remote-ip-address · remote-next-hop · remote-validation-criteria · country · state-province · locality · organisation · organisation-unit · common-name
Page 119 of the Perle Systems CSS user manual — Add IPv6tunnel
Page 119 · click to enlarge
Page 119

Up to a 64 character entry for an email address; for example, acct@anycompany.com. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

When the Authentication Method is set to Shared Secret, enter the case-sensitive secret word. Maximum of 16 characters, spaces not allowed. The secret is shared for all IPsec and L2TP/IPsec tunnels.

NAT Traversal should be enabled when the IOLAN is communicating through a router/gateway to a remote VPN that also has NAT Traversal enabled. By default, this is enabled.

Show IPsec

Description Dispalys 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

Starts all IPsec VPN tunnels.

Stops all IPsec VPN tunnels.

Stops and then starts all IPsec VPN tunnels.

Used strictly for debugging, displays trace data for all IPsec tunnels.

IPv6 Tunnels

Add IPv6tunnel

Description Addes a new IPv6 tunnel. User Level Admin Syntax add ipv6tunnel <tunnel_name>

Option <tunnel_name>

Adds the specified IPv6 tunnel.

Show 9 more labels / short text on this page
IPv6 Tunnels · email · secret · use-nat-traversal · Options start · stop · restart · status · Network Commands 115
Page 120 of the Perle Systems CSS user manual — Delete IPv6tunnel
Page 120 · click to enlarge
Page 120

Set IPv6tunnel

Description Configures the specified IPv6 tunnel. User Level Admin Syntax set ipv6tunnel <config_tunnel_name> [mode manual|teredo|6to4]

[gateway <interface>] [remote-host <config_host>]

The method or protocol that is used to create the IPv6 tunnel.

z Manual—When enabled, the IOLAN will manually create the IPv6 tunnel to the specified Remote Host through the specified Interface.

z 6to4—When enabled, the IOLAN will broadcast to the multicast address 192.88.99.1 through the specified Interface. When the closest 6to4 router responds, it will create the IPv6 tunnel, encapsulating and decapsulating IPv6 traffic sent to and from the IOLAN.

z Teredo—When enabled, the Teredo protocol encapsulates the IPv6 packet as an IPv4 UDP message, allowing it to pass through most network address translator (NAT) boxes and create an IPv6 tunnel to the specified Remote Host (a Teredo server) through the specified Interface. Default: Manual

The interface that the IOLAN is going to use to access the Remote Host. The list is comprised of the Ethernet interface(s) and serial ports configured PPP or SLIP. Default: ethernet_1

The IPv4 host that can access the IPv6 network when the Mode is Manual. The Teredo server when the Mode is Teredo. Default: None

Show IPv6tunnel

Description Shows the specified IPv6 tunnel settings. User Level Admin Syntax show ipv6tunnel <config_tunnel_name>

Delete IPv6tunnel

Description Controls the state of all IPsec tunnels. User Level Admin Syntax delete ipv6tunnel <config_tunnel_name> Options <config_tunnel_name>

Deletes the specified IPv6 tunnel. If a tunnel is associated with a gateway, it cannot be deleted until the gateway is either changed or deleted.

Show 4 more labels / short text on this page
IPv6 Tunnels · Options mode · gateway · remote-host
Page 121 of the Perle Systems CSS user manual — Set L2TP
Page 121 · click to enlarge
Page 121

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, see VPN Exceptions on page 119 for the command syntax.

Set L2TP

Description User Level Admin Syntax set l2tp listen-for-l2tp on|off

set l2tp authentication-method shared-secret [secret <text>]

set l2tp authentication-method x.509-certificate

remote-validation-criteria [country <code>] [state-province <text>] [locality <text>] [organisation <text>] [organisation-unit <text>] [common-name <text>] [email <email_addr>]

set l2tp [ipsec-local-ip-address <ipv4_addr>]

[local-ip-address <ipv4_addr>] [remote-ipv4-start-address <start_ip>] [remote-ipv4-end-address <end_ip>] [authentication-type pap|chap|both]

When enabled, allows L2TP/IPsec VPN connections. Note: to allow non-VPN connections to the IOLAN, you must create entries in the VPN Exceptions list. The default is off.

authentication methed shared-secret|x.509-certificate

Specify the authentication method that will be used between VPN peers to authenticate the VPN tunnel. Data Options:

z Shared Secret—A text-based secret that is used to authenticate the IPsec tunnel (case sensitive).

z X.509 Certificate—X.509 certificates are used to authenticate the IPsec tunnel. When using this authentication method, you must include the signing authority’s certificate information in the SSL/TLS CA list and download it to the IOLAN. Default: Shared Secret

When the Authentication Method is Secret, enter the case-sensitive secret word. Maximum of 16 characters, spaces not allowed. The secret is shared for all IPsec and L2TP/IPsec tunnels.

Any values that are entered in the remote validation criteria must match the remote X.509 certificate for a succsessful connection; any fields left blank will not be validated against the remote X.509 certificate. Note that all validation criteria must be configured to match the X.509 certificate. An asterick (*) is valid as a wildcard.

Show 5 more labels / short text on this page
L2TP/IPsec · Options listen-for-l2tp · secret · remote-validation-criteria · Network Commands 117
Page 122 of the Perle Systems CSS user manual — L2TP/IPsec
Page 122 · click to enlarge
Page 122

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.

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. An asterisk (*) works as a wildcard.

Up to a 128 character entry for the location; for example, a city. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

Up to a 64 character entry for the organisation; for example, Accounting. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

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 remote X.509 certificate. An asterisk (*) works as a wildcard.

Up to a 64 character entry for common name; for example, the host name or fully qualified domain name. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

Up to a 64 character entry for an email address; for example, acct@anycompany.com. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard.

The IPv4 address that the IOLAN will listen on for L2TP/IPsec connections. If the default value (0.0.0.0) is kept, the IOLAN will use the Default Gateway value (if no Default Gateway is specified, L2TP/IPsec VPN connections will error out). Default: 0.0.0.0

Specify the unique IPv4 address that hosts accessing the IOLAN through the L2TP tunnel will use. Field Format: IPv4 address

Specify the first IPv4 address that can be assigned to incoming hosts through the L2TP tunnel. Field Format: IPv4 address

Specify the end range of the IPv4 addresses that can be assinged to incoming hosts through the L2TP tunnel. Field Format: IPv4 address

Show 12 more labels / short text on this page
L2TP/IPsec · country · state-province · locality · organisation · organisation-unit · common-name · email · ipsec-local-ip-address · local-ip-address · local-ipv4-start-address · local-ipv4-end-address
Page 123 of the Perle Systems CSS user manual — Set VPN Exception
Page 123 · click to enlarge
Page 123

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.

Add VPN Exception

Description Adds a VPN exception. User Level Admin Syntax add vpn-exception network-ip <ipv4_net_ip> <network_subnet>|

<ipv6_net_ip> <prefix_bits>

add vpn-exception host-ip <ipv4/ipv6_address>

Options network-ip <ipv4_net_ip> <network_subnet>|<ipv6_net_ip> <prefix_bits>

The network address that will communicate with the IOLAN outside of the VPN tunnel. If the address is IPv4, you can supply the subnet mask for the network (the default is 0.0.0.0). If the address is IPv6, you can supply the prefix bits for the network (the default is 64, the range is 0-128).

host-ip <ipv4/ipv6_address>

The IP address of the host that will communicate with the IOLAN outside of the VPN tunnel. Field Format: IPv4 or IPv6 address

Set VPN Exception

Description Configures an existing VPN exception. User Level Admin Syntax set vpn-exception <config_vpn_except>

network-ip <ipv4_address> <network_subnet>| <ipv6_address> <prefix_bits>

set vpn-exception <config_vpn_except> host-ip <ipv4/ipv6_address>

Options network-ip <ipv4_net_ip> <network_subnet>|<ipv6_net_ip> <prefix_bits>

The network address that will communicate with the IOLAN outside of the VPN tunnel. If the address is IPv4, you can supply the subnet mask for the network (the default is 0.0.0.0). If the address is IPv6, you can supply the prefix bits for the network (the default is 64, the range is 0-128).

VPN Exceptions · authentication-type · Network Commands 119

Page 124 of the Perle Systems CSS user manual — Show VPN Exception
Page 124 · click to enlarge
Page 124

host-ip <ipv4/ipv6_address>

The IP address of the host that will communicate with the IOLAN outside of the VPN tunnel. Field Format: IPv4 or IPv6 address

Delete VPN Exception

Description Deletes a VPN exception. To see a list of configured VPN exceptions, type

delete vpn-exception ? User Level Admin Syntax delete vpn-exception <config_vpn_except>

Show VPN Exception

Description Shows the configured VPN exceptions. User Level Admin Syntax show vpn-exception

VPN Exceptions

Page 125 of the Perle Systems CSS user manual — Show Timezone
Page 125 · click to enlarge
Page 125

Time Commands Chapter 6 6

This chapter defines all the CLI commands associated with configuring the IOLAN’s time parameters.

Server Commands

Set Time

Description Sets the IOLAN’s system clock. User Level Admin Syntax set time <hh:mm[:ss]>

Option < hhmm [: ss ]>

Sets the IOLAN’s system time, using the 24-hour clock time format (00:00-23:59).

Set Timezone

Description Sets the IOLAN's time zone name and its offset from Greenwich Mean Time (UTC). User Level Admin Syntax set timezone [name <string>] [offset +|-<hh[:mm]>]

Options <name>

The name of the time zone to be displayed during standard time. Maximum 4 characters and minimum 3 characters (do not use angled brackets < >).

The offset from UTC for your local time zone. Specify in the format of hours hh (valid -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

offset

Page 126 of the Perle Systems CSS user manual — Set SNTP
Page 126 · click to enlarge
Page 126

SNTP Commands

Add SNTP

Description Adds an SNTP server. User Level Admin Syntax add sntp [server-1 <config_host>] [server-2 <config_host>]

The name of the primary SNTP server from the IOLAN host table. Valid with Unicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the specified host SNTP server.

The name of the secondary SNTP server from the IOLAN host table. Valid with Unicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the specified host SNTP server.

Delete SNTP

Description Deletes an SNTP server. User Level Admin Syntax delete sntp server-1|server-2

The name of the primary SNTP server from the IOLAN host table. Valid with Unicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the specified host SNTP server.

The name of the secondary SNTP server from the IOLAN host table. Valid with Unicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the specified host SNTP server.

Set SNTP

Description Configures an SNTP server. User Level Admin Syntax set sntp mode none|unicast|anycast|multicast

[server-1 <config_host>] [server-2 <config_host>] [version 1|2|3|4]

The SNTP mode. Valid modes are:

z None—SNTP is turned off.

z Unicast—Sends a request packet periodically to the Primary host. If communication with the Primary host fails, the request will be sent to the Secondary host.

z Multicast—Listen for any broadcasts from an SNTP server and then synchronizes its internal clock to the message.

z Anycast—Sends a request packet as a broadcast on the LAN to get a response from any SNTP server. The first response that is received is used to synchronize its internal clock and then operates in Unicast mode with that SNTP server.

Show 6 more labels / short text on this page
SNTP Commands · Options server-1 · server-2 · Options server-1 · server-2 · Options mode
Page 127 of the Perle Systems CSS user manual — Set Summertime
Page 127 · click to enlarge
Page 127

The name of the primary SNTP server from the IOLAN host table. Valid with Unicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the specified host SNTP server.

The name of the secondary SNTP server from the IOLAN host table. Valid with Unicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the specified host SNTP server.

Version of SNTP. Valid values are 1 to 4. Default value is 4.

Show SNTP

Description Shows the SNTP settings. User Level Admin Syntax show sntp

Show SNTP-Info

Description Shows current SNTP information. User Level Admin Syntax show sntp-info

Time/Date Setting Commands

Set Date

Description Sets the IOLAN’s system clock. User Level Admin Syntax set date <dd/mm/yyyy>

Set Summertime

Description Sets the summertime clock. User Level Admin Syntax set summertime [mode none|fixed|recurring] [name <text>]

[offset < hhmm >]

You can configure the summer time to take effect:

z None—No summer time change.

z Fixed—The summer time change goes into effect at the specified time every year. For example, April 15 at 1:00 pm.

z Recurring—The summer time changes goes into effect every year at same relative time. For example, on the third week in April on a Tuesday at 1:00 pm.

The name of the configured summer time zone; this will be displayed during the summer time setting. Maximum 4 characters and minimum 3 characters (do not use angled brackets < >). If this parameter is not set, then the summertime feature will not work.

Show 7 more labels / short text on this page
Time/Date Setting Commands · server-1 · server-2 · version · Options mode · <name> · Time Commands 123
Page 128 of the Perle Systems CSS user manual — Set Summertime Recurring
Page 128 · click to enlarge
Page 128

The offset from UTC for your local time zone. Specify in the format of hours hh (valid -12 to +14) and minutes mm (valid 0 to 59 minutes) for the offset from UTC.

Set Summertime Fixed

Description Sets the summertime clock to start on the same date each year, for example, April 15 at

1:00 pm. User Level Admin Syntax set summertime fixed

[start-date january|february |... <0-31>] [start-time <hh:mm>] [end-date january|february|... <0-31>] [end-time <hh:mm>]

The date to change to summer time and end standard time.

start-time < hhmm >

The time to change to summertime. Valid values are 00:00 to 23:59.

The date to end summer time and start standard time.

end-time < hhmm >

The time to change to standard time. Valid values are 00:00 to 23:59.

Set Summertime Recurring

Description Sets the summertime clock to start at the same relative time each year; for example, on

the third week in April on a Tuesday at 1:00 pm. User Level Admin Syntax set summertime recurring [start-day monday|tuesday|...]

[start-month january|february|...] [start-time <hh:mm>] [start-week 1|2|3|4|5|last] [end-day monday|tuesday|...] [end-month january|february|...] [end-time <hh:mm>] [end-week 1|2|3|4|5|last]

The day to change to summer time from standard time.

The month to change to summer time from standard 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).

The week to change to summer time from standard time.

The day to end summer time and start standard time.

The month to end summer time and start standard time.

Show 10 more labels / short text on this page
Time/Date Setting Commands · offset · Options start-date · end-date · Options start-day · start-month · start-time · start-week · end-day · end-month
Page 129 of the Perle Systems CSS user manual — Show Summertime
Page 129 · click to enlarge
Page 129

The time to end summer time and start standard time; uses the format hh:mm for a 24-hour clock (00:00-23:59).

The week to end summer time and start standard time.

Show Date

Description Shows the date, according to the IOLAN system clock. User Level Normal, Admin Syntax show date

Show Summertime

Description Shows the summertime settings. User Level Admin Syntax show summertime

Show 4 more labels / short text on this page
Time/Date Setting Commands · end-time · end-week · Time Commands 125
Page 130 of the Perle Systems CSS user manual — Show Date
Page 130 · click to enlarge
Page 130

Time/Date Setting Commands

Page 131 of the Perle Systems CSS user manual — Save
Page 131 · click to enlarge
Page 131

Administration Commands Chapter 7 7

This chapter defines all the CLI commands associated with configuring the IOLAN’s administration parameters.

Bootup Commands

Reboot

Description Reboots the IOLAN. You will be prompted to save configuration to FLASH, if there

have been unsaved configuration changes. User Level Admin Syntax reboot

Reset

Description Resets the user profile or serial line to the default factory configuration. User Level Admin Syntax reset user .|<username>|*

reset 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

Page 132 of the Perle Systems CSS user manual — Netload
Page 132 · click to enlarge
Page 132

TFTP File Transfer Commands

Set Bootup

Description Specifies remote the TFTP host and pathname for files to be loaded after a IOLAN

reboot. User Level Admin Syntax set bootup firmware host <hostname> [file <path_filename>]

set bootup configuration host <hostname> [file <path_filename>]

The path and file name, relative to the default path of your TFTP server software, of the update software for the IOLAN that will be loaded when the IOLAN is rebooted.

The path and file name, relative to the default path of your TFTP server software, of the configuration software for the IOLAN that will be loaded when the IOLAN is rebooted.

The host name or IP address of the server that contains the configuration or firmware file. If you use a host name, it must exist in the IOLAN’s host table or be resolved by DNS.

Show ARP

Description Shows the current contents of the ARP cache. User Level Admin Syntax show arp

Show Bootup

Description Shows the Firmware and Configuration files specified for IOLAN bootup. User Level Admin Syntax show bootup

TFTP File Transfer Commands

Netload

Description Transfers a file from a remote host to the IOLAN using the TFTP protocol. User Level Admin Syntax netload text-config|factory-default-config|firmware|

configuration|customlang|term1|term2|term3|customapp-file| wan-driver <hostname/IP_address> <filename>

Options text-config Specify this option if you are uploading a text-based configuration file to the IOLAN from a TFTP server.

Specifies the configuration file that you are going to load from a TFTP server to the IOLAN that will act as the factory default configuration. See the User Guide for directions on how to revert back to the original factory default configuration, if required.

Specifies that you are going to download a new firmware file to the IOLAN.

Show 5 more labels / short text on this page
Options firmware file · configuration file · host · factory-default-config · firmware
Page 133 of the Perle Systems CSS user manual — Netsave
Page 133 · click to enlarge
Page 133

TFTP File Transfer Commands

Specifies that you are going to download a new configuration file to the IOLAN.

Specifies that you are going to download a custom language file to the IOLAN.

You can create and download up to three custom terminal definitions to the IOLAN.

You can download multiple SDK program executables and ancillary files using this command by running the command multiple times to download multiple files. Use the shell CLI command as described in the SDK Programmer’s Guide to manage the files that you download.

Download wireless WAN custom drivers to the IOLAN that have been downloaded from the Perle website.

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 Host Table or a DNS server.

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).

Netsave

Description Transfers a file from the IOLAN to a remote host using the TFTP protocol. User Level Admin Syntax netsave configuration|crash|serialt-buf|text-config

<hostname/IP_address> <filename>

Specifies that you are going to upload a configuration file from the IOLAN to the specified host or IP address.

Specifies that you are going to upload a crash file from the IOLAN to the specified host or IP address.

serialt-buf Specifies that you are going to upload the contents of the serial trace buffer.

Saves the current configuration to a text file on a TFTP server.

The IP address or host name for where the file you are uploading from the IOLAN is going. If you are using a host name, it must be resolved in either the IOLAN’s Host Table or a DNS server.

Show 12 more labels / short text on this page
configuration · customlang · term1|term2|term3 · customapp-file · wan-driver · <hostname/IP_address> · <filename> · Options configuration · crash · text-config · <hostname/IP_address> · Administration Commands 129
Page 134 of the Perle Systems CSS user manual — Set
Page 134 · click to enlarge
Page 134

The complete path and file name for the file you are uploading from the IOLAN (this path should be relative to the default path of your TFTP server, which may or may not allow drive letters).

Custom Factory Default

Netload

Description Transfers a file from a remote host to the IOLAN using the TFTP protocol. User Level Admin Syntax netload factory-default-config <hostname/IP_address> <filename>

Specifies the configuration file that you are going to load from a TFTP server to the IOLAN that will act as the factory default configuration. See the User Guide for directions on how to revert back to the original factory default configuration, if required.

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 Host Table or a DNS server.

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).

Set

Description Sets the current configuration on IOLAN to act as the factory default configuration. See

the User Guide for directions on how to revert back to the original factory default configuration, if required. User Level Admin Syntax set config-to-factory-default

Show 5 more labels / short text on this page
Custom Factory Default · <filename> · Options factory-default-config · <hostname/IP_address> · <filename>
Page 135 of the Perle Systems CSS user manual — Netload
Page 135 · click to enlarge
Page 135

Keys and Certificates Commands

Keys and Certificates Commands

Netload

Description Loads certificates and keys into the IOLAN. User Level Admin Syntax netload https certificate|private-key <hostname/IP_address>

netload ldap certificate <hostname/IP_address> <filename>

netload ssh-client host <config_host> public-key ssh-1 rsa

<hostname/IP_address> <filename>

netload ssh-client host <config_host> public-key ssh-2 rsa|dsa

<hostname/IP_address> <filename>

netload ssh-client user <config_user> private-key ssh-1 rsa

<hostname/IP_address> <filename>

netload ssh-client user <config_user> private-key ssh-2 rsa|dsa

<hostname/IP_address> <filename>

netload ssh-server user <config_user> public-key ssh-2 rsa|dsa

<hostname/IP_address> <filename>

netload ipsec <config_tunnel_name> public-key rsa

<hostname/IP_address> <filename>

If you are using the secure version of the WebManager (HTTPS), then you need to download the SSL/TLS private key and CA list to make a secure connection.

If you are using LDAP authentication with TLS, you need to download the certificate of the CA who signed the LDAP certificate to the IOLAN for authentication to work properly.

ssh-client host The public key for the host that is being authenticated by the IOLANs SSH server.

public-key ssh-1 Specify ssh-1 when you are using SSH version 1.

public-key ssh-2 Specify ssh-2 when you are using SSH version 2.

When downloading keys to the IOLAN, specify the authentication method used by the key.

The user that the SSH key is for.

The user that the SSH key is for.

Show 7 more labels / short text on this page
<filename> · Options https certificate|private-key · ldap certificate · rsa|dsa · ssh-client user · ssh-server user · Administration Commands 131
Page 136 of the Perle Systems CSS user manual — Netsave
Page 136 · click to enlarge
Page 136

Keys and Certificates Commands

ipsec <tunnel_name>

When you configure an IPsec tunnel with an Authentication Method of RSA Signature, you need to download the RSA key from the remote VPN gateway to the 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. If you are using a host name, If you are using a host name, it must be resolved in either the IOLAN’s Host Table or a DNS server.

Enter the complete path and file name of the certificate/key you are downloading to the IOLAN.

Netsave

Description Uploads certificates and keys from the IOLAN to a remote host using TFTP. User Level Admin Syntax netsave ssh-server public-key ssh-2 rsa|dsa <hostname/IP_address>

netsave ipsec public-key rsa <hostname/IP_address> <filename>

When uploading SSH keys from the IOLAN, specify the SSH authentication method used by the SSH key.

When you configure an IPsec tunnel with an Authentication Method of RSA Signature, you need to upload the RSA key from the IOLAN to the remote VPN gateway host for that specific tunnel.

<hostname/IP_address>

The IP address or host name for where the SSH key you are uploading from the IOLAN is going. If you are using a host name, it must be resolved in either the IOLAN’s Host Table or a DNS server.

The complete path and file name for the file you are uploading from the IOLAN (this path should be relative to the default path of your TFTP server, which may or may not allow drive letters).

Show 5 more labels / short text on this page
<filename> · <filename> · Options rsa|dsa · ipsec public-key rsa · <filename>
Page 137 of the Perle Systems CSS user manual — Show MOTD
Page 137 · click to enlarge
Page 137

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); to do this, do not specify the host parameter. User Level Normal, Admin Syntax set motd [display on|off] [host <hostname> file <path_filename>] set motd file <local_file>

When enabled, displays the Message of the Day to users who are logging into WebManager or EasyPort Web. The default is off.

The host that the IOLAN will be getting the Message of the Day file from.

The path and file name, relative to the default path of your TFTP server software, of the file that contains a string that is displayed when a user connects to the IOLAN.

<local_file> This is the name of a file already downloaded to the IOLAN. The contents of this file will be used for the MOTD.

Show MOTD

Description Show the Message of the Day (MOTD) settings. User Level Admin Syntax show motd

Show 5 more labels / short text on this page
MOTD Commands · Options display · host · <path_filename> · Administration Commands 133
Page 138 of the Perle Systems CSS user manual — MOTD Commands
Page 138 · click to enlarge
Page 138

MOTD Commands

Page 139 of the Perle Systems CSS user manual — Show Netstat Statistics
Page 139 · click to enlarge
Page 139

Statistics Commands Chapter 8 8

This chapter defines all the CLI commands associated with configuring the IOLAN’s statistics parameters.

Configuration Statistics

Show Netstat

Description Shows currently used TCP/UDP sockets/ports. User Level Admin Syntax show netstat [all] [listening] [tcp] [udp] [tcpv6] [updv6] Options all Displays all ports, including server (listening) ports; by default, listening ports are not displayed.

listening Displays server (listening) ports; by default, listening ports are not displayed.

tcp Displays TCP port statistics.

udp 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]

Page 140 of the Perle Systems CSS user manual — Uptime
Page 140 · click to enlarge
Page 140

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. User Level Admin Syntax show routes [ipv6]

Run-Time Statistics

Delete Arp

Description Delete entries from the IOLAN's ARP cache. Takes effect immediately; not related to

configuration. User Level Admin Syntax delete arp

Show Arp

Description Shows the current contents of the ARP cache. User Level Admin Syntax show arp

Show Serial

Description Shows statistics on the serial port. User Level Admin Syntax show serial [<line_number>]

Uptime

Description Displays the elapsed time (in days, hours, minutes, and seconds) since the last

reboot/power cycle. User Level Admin Syntax uptime

Run-Time Statistics

Page 141 of the Perle Systems CSS user manual — IOLAN+
Page 141 · click to enlarge
Page 141

IOLAN+ User Commands Chapter 9 9

You can configure the IOLAN using the IOLAN+ menu. See the IOLAN+ User’s Guide for the command line interface and menu parameters. 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+

Page 142 of the Perle Systems CSS user manual — IOLAN+
Page 142 · click to enlarge
Page 142

IOLAN+

Page 143 of the Perle Systems CSS user manual — Set IO UDP
Page 143 · click to enlarge
Page 143

I/O Commands Chapter 10 10

This chapter defines all the CLI commands associated with configuring the IOLAN’s I/O parameters.

Global I/O Commands

Set IO UDP

Description Sets the UDP settings for I/O unicast messages. User Level Admin Syntax set io udp [mode on|off]

[broadcast-interval <broadcast_interval>]

set io udp entry 1|2|3|4 disabled

set io udp entry 1|2|3|4 <udp_port> <start_ip> [<end_ip>] Options mode

Enables/disables UDP broadcast of I/O channel status (data).

Enter the interval, in seconds, for UDP broadcasts of I/O channel status (data). Valid values are 1-9999. Default value is 30 seconds.

You can specify up to four sets of UDP IP address that will receive the I/O unicast.

The UDP port that the IOLAN will use to relay messages to servers/hosts.

The first host IP address in the range of IP addresses (for IPV4 or IPV6) that the IOLAN will listen for messages from and/or send messages to.

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.

Show 5 more labels / short text on this page
broadcast-interval · entry · udp_port · start_ip · end_ip
Page 144 of the Perle Systems CSS user manual — Set Line Service
Page 144 · click to enlarge
Page 144

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. When this timer expires because of no I/O activity within the specified time interval, the Failsafe Action set for the channel determines the action on the output.

The number of seconds that must elapse with no I/O activity before the channel Failsafe Action is triggered. Valid values are 1-9999. The default is 30 seconds.

Set IO Modbus

Description Enabling the Modbus option makes the IOLAN act as a Modbus Slave, allowing

Modbus Masters to communicate with the IOLAN to control and/or retrieve I/O data. User Level Admin Syntax set io modbus [mode on|off] [uid <1-255>] Options mode

Enables/disables Modbus as the communication protocol for all the I/O channels.

This is the UID you are assigning to the IOLAN, which is acting as a Modbus slave.

Set IO Temperature-Scale

Description Sets the temperature scale that will be used for all I/O temperature readings. User Level Admin Syntax set io temperature-scale celsius|fahrenheit

Select the temperature scale that will be used to display temperature data, either Fahrenheit or Celsius. The default is Celsius.

Set Line

Set Line Service

Description Sets the Line Service settings for signal I/O. When the line service is set to signal-io,

you also have the option of enabling the I/O extension for the serial singal pins. See Set IOChannel IOExtension on page 148 for more information. User Level Admin Syntax set line <number> service signal-io

Option signal-io Sets the line to use signal I/O. You still need to define the serial pins for digital input (CTS, DSR, or DCD) or digital output (RTS or DTR). See Set IOChannel Digital Input (Serial Pins) on page 141 or Set IOChannel Digital Output (Serial Pins) on page 143 for configuration options.

Show 4 more labels / short text on this page
Set Line · timeout · uid · Option temperature-scale
Page 145 of the Perle Systems CSS user manual — Set IOChannel Digital I/O
Page 145 · click to enlarge
Page 145

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>]

Specify the channel number, for example, d2 or a4. Temperature models use Analog input, so the channel numbers are a1-a4.

Enables the channel, allowing the settings to become active.

Provide a description of the channel, making it easier to identify. The channel description can be up to 20 characters.

Set IOChannel Digital I/O

Description Sets up the Digital I/O channel to act as either an output or input channel. User Level Admin Syntax set iochannel <digital_channel> source-type input|output

Specify the Digital channel number, for example, d2.

Specify whether the channel will drive the line (output) or will be reading the status of the line (input). The default is Input. The internal jumpers must match the software configuration, so if you change this setting to Output, you will have to also change the internal hardware jumpers.

Show 7 more labels / short text on this page
Set IOChannel · Options i/o_channel · mode · description · Options digital_channel · source-type · I/O Commands 139
Page 146 of the Perle Systems CSS user manual — Set IOChannel Digital Input
Page 146 · click to enlarge
Page 146

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]

Specify the Digital channel number, for example, d2.

Configures alarm settings when the Digital input trigger is activated.

When the trigger condition is met, triggers the specified alarm action. Triggers can be:

z Disabled—No alarm settings. This is the default.

z Inactive—When the expected Digital input is active, going inactive will trigger an alarm.

z Active—When the expected Digital input is inactive, going active will trigger an alarm.

Specify Manual to manually clear an alarm. Specify Auto to automatically clear the alarm when the trigger condition changes; for example, if the Trigger is Inactive and the alarm is triggered, once the input becomes active again, the alarm will be cleared when Auto is set. The default is Auto.

Sends an email alert to an email account(s) set up in the Server settings (the Line Email Alert settings are not used with this feature) when an alarm is triggered or cleared. The email alert data includes the severity level and the value that caused the alarm to trigger or clear. The Email Alert is associated with Level Critical.

Sends a message to syslog when an alarm is triggered or cleared. The syslog entry includes the severity level and the value that caused the alarm to trigger or clear. The syslog message is associated with Level Critical.

Sends an SNMP trap when an alarm is triggered or cleared. The trap consists of the severity level and whether the alarm was triggered or cleared.

Provide a description of the channel, making it easier to identify. The channel description can be up to 20 characters.

Inverts the actual condition of the I/O signal in the status; therefore, an inactive status will be displayed as active.

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.

Show 11 more labels / short text on this page
Set IOChannel · Options digital_channel · alarm · trigger · clear · email · syslog · snmp · description · invert-signal · latch
Page 147 of the Perle Systems CSS user manual — Set IOChannel Digital Input (Serial Pins)
Page 147 · click to enlarge
Page 147

Set IOChannel Digital Input (Serial Pins)

Description Sets the Digital input settings for serial pins CTS, DSR, and DCD. This option is only

available when the Line Service is set to Signal I/O. User Level Admin Syntax set iochannel cts|dsr|dcd

[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]

Specify the Digital channel number, for example, d2.

Configures alarm settings when the Digital input trigger is activated.

When the trigger condition is met, triggers the specified alarm action. Triggers can be:

z Disabled—No alarm settings. This is the default.

z Inactive—When the expected Digital input is active, going inactive will trigger an alarm.

z Active—When the expected Digital input is inactive, going active will trigger an alarm.

Specify Manual to manually clear an alarm. Specify Auto to automatically clear the alarm when the trigger condition changes; for example, if the Trigger is Inactive and the alarm is triggered, once the input becomes active again, the alarm will be cleared when Auto is set. The default is Auto.

Sends an email alert to an email account(s) set up in the Server settings (the Line Email Alert settings are not used with this feature) when an alarm is triggered or cleared. The email alert data includes the severity level and the value that caused the alarm to trigger or clear. The Email Alert is associated with Level Critical.

Sends a message to syslog when an alarm is triggered or cleared. The syslog entry includes the severity level and the value that caused the alarm to trigger or clear. The syslog message is associated with Level Critical.

Sends an SNMP trap when an alarm is triggered or cleared. The trap consists of the severity level and whether the alarm was triggered or cleared.

Provide a description of the channel, making it easier to identify. The channel description can be up to 20 characters.

Inverts the actual condition of the I/O signal in the status; therefore, an inactive status will be displayed as active.

Show 11 more labels / short text on this page
Set IOChannel · Options digital_channel · alarm · trigger · clear · email · syslog · snmp · description · invert-signal · I/O Commands 141
Page 148 of the Perle Systems CSS user manual — Set IOChannel Digital Output
Page 148 · click to enlarge
Page 148

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 Output

Description Sets the Digital output channel settings. User Level Admin Syntax set iochannel <digital_channel>

[type sink|source|sink-and-source] [active-signal-width <width>] [inactive-signal-width <width>] [failsafe-action none|activate-output|deactivate-output]

set iochannel <digital_channel>

output [pulse continuous|counted <pulse_count>] [active-to-inactive-delay <delay>] [inactive-to-active-delay <delay>]

Specify the Digital channel number, for example, d2.

Specify the type of digital output:

z Sink—Specifies that the channel will be grounded when active.

z Source—Specifies that the channel will provide voltage when active.

z Sink and Source—Specifies that channel will be grounded when it is inactive and will provide voltage when it is active. The default is Sink.

How long the channel will be active during the pulse mode. Valid values are 1-9999 x 100 ms. The default is 100 ms.

How long the channel will remain inactive during pulse mode. Valid values are 1-9999 x 100 ms. The default is 100 ms.

When there has been no I/O activity within the specified time (set in the Global Settings) and the Failsafe Timer is triggered, you can set the Failsafe Action to:

z None—The state of the Digital/Relay output remains the same, no change.

z Activate Output—Activates the channel.

z Deactivate Output—Deactivates the channel.

Show 7 more labels / short text on this page
Set IOChannel · latch · Options digital_channel · type · active-signal-width · inactive-signal-width · failsafe-action
Page 149 of the Perle Systems CSS user manual — Set IOChannel Digital Output (Serial Pins)
Page 149 · click to enlarge
Page 149

Specify how the channel output will be handled:

z Manual—You must manually manipulate the channel output.

z Pulse—Activates and deactivates the channel output activity in intervals after it is manually activated.

z Inactive-to-Active Delay—The channel output will remain inactive for the specified time interval after it is manually started.

z Active-to-Inactive Delay—The channel output will go inactive after the specified time interval after it is manually started. The default is Manual.

When the Output is Pulse, you can have it pulse in a Continuous manner or specify a pulse Count (each count consists of an active/inactive sequence). The default is Continuous.

When the I/O is commanded to an inactive state, this is the length of the delay before the command is executed. Valid values are 1-9999 x 100 ms. The default is 100 ms.

When the I/O is commanded to an active state, this is the length of the delay before the command is executed. Valid values are 1-9999 x 100 ms. The default is 100 ms.

Set IOChannel Digital Output (Serial Pins)

Description Sets the Digital output for serial pins RTS and DTR. This option is only available when

the Line Service is set to Signal I/O. User Level Admin Syntax set iochannel rts|dtr [description <string>]

[failsafe-action none|activate-outut|deactivate-output] [mode enabled|disabled]

Provide a description of the channel, making it easier to identify. The channel description can be up to 20 characters.

When there has been no I/O activity within the specified time (set in the Global Settings) and the Failsafe Timer is triggered, you can set the Failsafe Action to:

z None—The state of the Digital/Relay output remains the same, no change.

z Activate Output—Activates the channel.

z Deactivate Output—Deactivates the channel.

Enables the channel, allowing the settings to become active.

Show 9 more labels / short text on this page
Set IOChannel · output · pulse · active-to-inactive-delay · inactive-to-active-delay · Options description · failsafe-action · mode · I/O Commands 143
Page 150 of the Perle Systems CSS user manual — Set IOChannel Relay
Page 150 · click to enlarge
Page 150

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]

Specify the Relay channel number, for example, r2.

Specify how the channel output will be handled:

z Manual—You must manually manipulate the channel output.

z Pulse—Activates and deactivates the channel output activity in intervals after it is manually activated.

z Inactive-to-Active Delay—The channel output will remain inactive for the specified time interval after it is manually started.

z Active-to-Inactive Delay—The channel output will go inactive after the specified time interval after it is manually started. The default is Manual.

When the Output is Pulse, you can have it pulse in a Continuous manner or specify a pulse Count (each count consists of an active/inactive sequence). The default is Continuous.

When the I/O is commanded to an inactive state, this is the length of the delay before the command is executed. Valid values are 1-9999 x 100 ms. The default is 100 ms.

When the I/O is commanded to an active state, this is the length of the delay before the command is executed. Valid values are 1-9999 x 100 ms. The default is 100 ms.

How long the channel will be active during the pulse mode. Valid values are 1-9999 x 100 ms. The default is 100 ms.

How long the channel will remain inactive during pulse mode. Valid values are 1-9999 x 100 ms. The default is 100 ms.

When there has been no I/O activity within the specified time (set in the Global Settings) and the Failsafe Timer is triggered, you can set the Failsafe Action to:

z None—The state of the Digital/Relay output remains the same, no change.

z Activate Output—Activates the channel.

z Deactivate Output—Deactivates the channel.

Show 9 more labels / short text on this page
Set IOChannel · Options relay_number · output · pulse · active-to-inactive-delay · inactive-to-active-delay · active-signal-width · inactive-signal-width · failsafe-action
Page 151 of the Perle Systems CSS user manual — Set IOChannel Analog (True Analog)
Page 151 · click to enlarge
Page 151

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]]

Specify the Analog channel number, for example, a2 or a4 (this also applies to Temperature models).

Select the type of input being measured, either Current or Voltage. The default is Current.

Select the range for the measurement type. For current, the range is:

z 0-20 (0-20mA) This is the default.

z 4-20 (04-20mA) For voltage, the range is:

z 10 (+/-10V) This is the default.

Configures alarm settings when the Analog input trigger is activated.

You can specify up to five alarm trigger/clear severity levels. If the Trigger Type is Low, an alarm is triggered when the input drops below the specified Trigger value; other severity level trigger values must decrease in value with each subsequent level. If the Trigger Type is High, an alarm is triggered when the input is higher than the specified Trigger value; other severity level trigger values must increase in value with each subsequent level. To clear an alarm, the input must drop below the specified value when Trigger Type is High or go above the specified value when Trigger Type is Low.

Enables/disables an alarm level. The default is off.

If the Trigger Type is Low, an alarm is triggered when the input drops below the specified Trigger value; other severity level trigger values must decrease in value with each subsequent level. If the Trigger Type is High, an alarm is triggered when the input is higher than the specified Trigger value; other severity level trigger values must increase in value with each subsequent level.

Show 13 more labels / short text on this page
Set IOChannel · Options analog_channel · type · range · z 1 (+/-1V) · z 5 (+/-5V) · z 150 (+/-150mV) · z 500 (+/-500mV) · alarm · level · mode · trigger-type · I/O Commands 145
Page 152 of the Perle Systems CSS user manual — Set IOChannel Analog (Temperature)
Page 152 · click to enlarge
Page 152

Specify the value that will trigger an alarm, the measurement is based on the Type and Range that you specify. This value must not fall within the scope of the value used to clear an alarm.

Specifies whether an activated alarm must be Manually cleared, or can be cleared when the input drops below the specified value (when Trigger Type is High) or goes above the specified value (when Trigger Type is Low).

Specify that value that will clear an alarm, the measurement is based on the Type and Range that you specify. This value must not fall within the scope of the value used to trigger an alarm.

Sends an email alert to an email account(s) set up in the Server settings (the Line Email Alert settings are not used with this feature) when an alarm is triggered or cleared. The email alert data includes the severity level and the value that caused the alarm to trigger or clear. The Email Alert is associated with Level Critical.

Sends an SNMP trap when an alarm is triggered or cleared. The trap consists of the severity level and whether the alarm was triggered or cleared.

Sends a message to syslog when an alarm is triggered or cleared. The syslog entry includes the severity level and the value that caused the alarm to trigger or clear. The syslog message is associated with Level Critical.

Set IOChannel Analog (Temperature)

Description Sets the Analog input channel settings for Temperature models. User Level Admin Syntax set iochannel <analog_channel> type rtd|thermocouple

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]]

Specify the Analog channel number, for example, a2 or a4 (this also applies to Temperature models).

Specify the type of sensor you are using to measure temperature, either RTD or thermocouple. The default is RTD.

Show 9 more labels / short text on this page
Set IOChannel · trigger-level · clear-mode · clear-level · email · snmp · syslog · Options analog_channel · type
Page 153 of the Perle Systems CSS user manual — Set IOChannel Analog (Temperature)
Page 153 · click to enlarge
Page 153

Specify the temperature range that you want to measure. For RTD, the range is:

z 1 (Pt100 a=385 -50 to 150C) This is the default.

z 2 (Pt100 a=385 0 to 100C)

z 3 (Pt100 a=385 0 to 200C)

z 4 (Pt100 a=385 0 to 400C)

z 5 (Pt100 a=385 -200 to 200C)

z 6 (Pt100 a=392 -50 to 150C)

z 7 (Pt100 a=392 0 to 100C)

z 8 (Pt100 a=392 0 to 200C)

z 9 (Pt100 a=392 0 to 400C)

z 10 (Pt100 a=392 -200 to 200C)

z 11 (Pt1000 a=385 -40 to 160C)

z 12 (NiFe604 a=518 -80 to 100C)

z 13 (NiFe604 a=518 0 to 100C) For thermocouple, the range is:

z b (B 500 to 1800C)

z e (E 0 to 1000C)

z j (J 0 to 760C) This is the default.

z k (K 0 to 1370C)

z r (R 500 to 1750C)

z s (S 500 to 1750C)

z t (T -100 to 400C).

Configures alarm settings when the Analog input trigger is activated.

You can specify up to five alarm trigger/clear severity levels. If the Trigger Type is Low, an alarm is triggered when the input drops below the specified Trigger value; other severity level trigger values must decrease in value with each subsequent level. If the Trigger Type is High, an alarm is triggered when the input is higher than the specified Trigger value; other severity level trigger values must increase in value with each subsequent level. To clear an alarm, the input must drop below the specified value when Trigger Type is High or go above the specified value when Trigger Type is Low.

Enables/disables an alarm level. The default is off.

If the Trigger Type is Low, an alarm is triggered when the input drops below the specified Trigger value; other severity level trigger values must decrease in value with each subsequent level. If the Trigger Type is High, an alarm is triggered when the input is higher than the specified Trigger value; other severity level trigger values must increase in value with each subsequent level.

Specify the value that will trigger an alarm, the measurement is based on the Type and Range that you specify. This value must not fall within the scope of the value used to clear an alarm.

Show 8 more labels / short text on this page
Set IOChannel · range · alarm · level · mode · trigger-type · trigger-level · I/O Commands 147
Page 154 of the Perle Systems CSS user manual — Set IOChannel IOExtension
Page 154 · click to enlarge
Page 154

Specifies whether an activated alarm must be Manually cleared, or can be cleared when the input drops below the specified value (when Trigger Type is High) or goes above the specified value (when Trigger Type is Low).

Specify that value that will clear an alarm, the measurement is based on the Type and Range that you specify. This value must not fall within the scope of the value used to trigger an alarm.

Sends an email alert to an email account(s) set up in the Server settings (the Line Email Alert settings are not used with this feature) when an alarm is triggered or cleared. The email alert data includes the severity level and the value that caused the alarm to trigger or clear. The Email Alert is associated with Level Critical.

Sends an SNMP trap when an alarm is triggered or cleared. The trap consists of the severity level and whether the alarm was triggered or cleared.

Sends a message to syslog when an alarm is triggered or cleared. The syslog entry includes the severity level and the value that caused the alarm to trigger or clear. The syslog message is associated with Level Critical.

Set IOChannel IOExtension

Description Configures the I/O extension options that allow you to connect the Digital Input

channel or input serial signal pin (when the line is configured for signal-io) to Digital Output/Relay channels or output serial signal pins (when the line is configured for signal-io) on the same IOLAN, remote IOLAN(s), and/or TCP/IP applications running on local hosts. User Level Admin Syntax set iochannel <channel> ioextension enabled on|off

set iochannel <channel> ioextension connection-method

client-initiated [tcp-port <tcp_port>] [multihost on|off]

set iochannel <channel> ioextension connection-method

server-initiated <host_name> [tcp-port <tcp_port>] [multihost all|backup <config_backup_host> <host_port>|none]

set iochannel <channel> ioextension connection-method

local-connection [<input_channel>]

Options <channel>

Specify the Digital/Relay channel or serial signal pin that you are configuring the I/O extension for. The channel can be d1, d2, d3, d4, r1, r2, depending on the model. The serial signal pins are dsr, dcd, or cts for input and dtr or rts for output.

Show 7 more labels / short text on this page
Set IOChannel · clear-mode · clear-level · email · snmp · syslog · [keepalive on|off]
Page 155 of the Perle Systems CSS user manual — Set IOChannel IOExtension
Page 155 · click to enlarge
Page 155

When enabled, the digital input channel or DSR/DCD/CTS input serial signal pins can be connected to:

z A Digital output or relay (if the I/O model supports relay) channel on the same IOLAN

z Output Serial Signal Pins (DTR/RTS)

z A Digital output channel on another IOLAN(s) or output serial signal pins (DTR/RTS) on another IOLAN(s)

z A TCP/IP application(s) running on a host on the network When enabled, the digital output/relay channel or DTR/RTS output serial signal pins can be associated with a digital input channel or input serial signal pins. Default: Disabled

Enables a per-connection TCP keepalive feature. After the configured number of seconds, the connection will send a gratuitous ACK to the network peer, thus either ensuring the connection stays active OR causing a dropped connection condition to be recognized. This parameter needs to be used in conjunction with server parameter, monitor-connection-every. The interval determines how long the IOLAN will wait during inactivity before "testing" the connection. It should be noted that if a network connection is accidentally dropped, it can take as long as the specified interval before anyone can reconnect to the serial port.

The connection-method is one of the following:

z Client-Initiated—When specified, the channel/serial signal pin will wait for connections to be initiated by another I/O channel or a TCP/IP application.

z Server-Initiated—When specified, the channel/serial signal pin initiates communication to another I/O channel or a TCP/IP application.

z Local-Connection—When specified, the input or output, depending on how the channel or serial signal pin is configured, will be associated with another local IOLAN I/O channel or serial signal pin. When the channel is configured as digital input or when configuring an input serial signal pin, the Output Channels parameter displays all the local digital output signals or relays that it is associated with.

When the channel is configured as digital output, you must select a local digital input channel or input serial signal pin on the IOLAN.

DefaultClient-Initiated

The TCP port that the channel/serial signal pin will use to listen for incoming connections. Default: 2000 for channel 1, then increments by one for each channel

When this option is enabled, multiple I/O channels and/or TCP/IP applications can connect to this channel/serial signal pin. The default is off.

Show 7 more labels / short text on this page
Set IOChannel · enabled · keepalive · connection-method · client-initiated tcp-port · client-initiated multihost · I/O Commands 149
Page 156 of the Perle Systems CSS user manual — Set IOChannel Multihost
Page 156 · click to enlarge
Page 156

The TCP Port that the channel/serial signal pin will use to communicate to another IOLAN or a TCP/IP application. Default: 2000 for channel 1, then increments by one for each channel

server-initiated multihost all|backup <config_backup_host> <tcp_port>|none

Used for connections going from the Digital input channel or input serial signal pins, allows the input channel/serial signal pin to communicate to either all the hosts in the multihost list or a primary/backup host schema (see Configuring Multiple Hosts in the IOLAN User’s Guide for a more detailed explanation).

local-connection <input_channel>

Specify the Digital input channel or input serial signal pin that will control the Digital/Relay output channel or output serial signal pin.

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. To see a list of configured hosts/IOLANs, enter the show iochannel <channel> command. User Level Admin Syntax set iochannel <channel> multihost entry <number> delete

set iochannel <channel> multihost entry <number> host <host_name>

Options <channel>

Specify the Digital input channel or input serial signal pin that will be connecting to all the hosts/IOLANs in the multihost list.

Specify the multihost table entry number. Valid values are 1-49.

Deletes the entry number in the multihost table.

Specify the preconfigured host that will be in the multihost list. Default: None

Specify the TCP port that the I/O channel or serial signal pin will use to communicate to the Host. Default: 0

Show 7 more labels / short text on this page
Set IOChannel · server-initiated tcp-port · <tcp_port> · entry · delete · host · <tcp_port>
Page 157 of the Perle Systems CSS user manual — Kill IOChannel
Page 157 · click to enlarge
Page 157

Set IOChannel IOExtension SSL

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 on page 89. User Level Admin Syntax set iochannel <channel> ioextension ssl [enabled on|off]

[use-server on|off] [version any|tslv1|sslv3] [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>]

set iochannel <channel> ioextension ssl 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 hmac any|sha1|md5

Show IOChannel Status

Description Shows the I/O channel status for all channels and the serial signal pins (when the line is

configured for signal-io). User Level Admin Syntax show iochannel status

Kill IOChannel

Description Kills the I/O channel. User Level Admin Syntax kill iochannel <i/o_channel>

kill iochannel line <number> rts|cts|dtr|dsr|dcd

Specify the channel number, for example, d2 or a4. Temperature models use Analog input, so the channel numbers are a1-a4.

Specify the Digital output pins (RTS or DTR) or Digital input pins (CTS, DSR, or DCD).

Show 4 more labels / short text on this page
Set IOChannel · Options i/o_channel · rts|cts|dtr|dsr|dcd · I/O Commands 151
Page 158 of the Perle Systems CSS user manual — Digital Output
Page 158 · click to enlarge
Page 158

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>

Specify the channel number, for example, d2 or a4. Temperature models use Analog input, so the channel numbers are a1-a4.

Specify the Digital output pins (RTS or DTR) or Digital input pins (CTS, DSR, or DCD).

Show IOChannel

Description Shows I/O channel information. Temperature I/O is Analog. User Level Admin Syntax show iochannel <i/o_channel>

show iochannel line <number> rts|cts|dtr|dsr|dcd

Specify the channel number, for example, d2 or a4. Temperature models use Analog input, so the channel numbers are a1-a4.

Specify the Digital output pins (RTS or DTR) or Digital input pins (CTS, DSR, or DCD).

I/O Channel Control Commands

The I/O commands in this section are used to manually manage the I/O channels.

Digital Output

Description Manages the Digital output channel status. Not all models have four Digital channels,

most have just two. User Level Admin Syntax iochannel d1|d2|d3|d4|cts|dsr|dcd clear alarm|input-latch

Clears the alarm. Note that if the condition that tripped the alarm still exists, the alarm will not look like it’s cleared, but will reflect the appropriate alarm level severity. Alarm Level 0 means that the alarm has not been triggered.

Clears the latch value.

Show 7 more labels / short text on this page
show iochannel rts|cts|dtr|dsr|dcd · Options i/o_channel · rts|cts|dtr|dsr|dcd · Options i/o_channel · rts|cts|dtr|dsr|dcd · Options alarm · latch-input
Page 159 of the Perle Systems CSS user manual — Reset Calibration
Page 159 · click to enlarge
Page 159

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

Manually activates/deactivates the I/O channel.

Relay

Description Manages the Relay output channel status. User Level Admin Syntax iochannel r1|r2 output activate|deactivate

Manually activates/deactivates the I/O channel.

Analog Input

Description Manages the Analog input channel status. User Level Admin Syntax iochannel a1|a2|a3|a4 clear alarm|min|max

Clears the alarm. Note that if the condition that tripped the alarm still exists, the alarm will not look like it’s cleared, but will reflect the appropriate alarm level severity. Alarm Level 0 means that the alarm has not been triggered.

Clears the minimum value.

Clears the maximum value.

Calibrating Analog Input (Analog/Temperature)

Calibrate Analog

Description Calibrates the Analog input channel. When this command is issued, a script will

automatically start, requesting that the minimum and maximum calibration values be applied to the requested Analog/Temperature channel. See Calibrating Analog Input in the IOLAN User’s Guide for more information. User Level Admin Syntax iochannel a1|a2|a3|a4 calibrate

Reset Calibration

Description Resets the calibration to factory defaults. User Level Admin Syntax reset io calibration

Show 6 more labels / short text on this page
Option output · Option output · Options alarm · min · max · I/O Commands 153
Page 160 of the Perle Systems CSS user manual — Digital Input
Page 160 · click to enlarge
Page 160

Calibrating Analog Input (Analog/Temperature)

Page 161 of the Perle Systems CSS user manual — Power Commands
Page 161 · click to enlarge
Page 161

Power Commands Chapter 11 11

This chapter defines all the CLI commands associated with configuring the IOLAN’s power parameters.

Power Commands

Description Actively controls the RPS plug power. User Level Admin, Normal Syntax power cycle line <number> [plug <number|range|*>]

power on line <number> [plug <number|range|*>]

power off line <number> [plug <number|range|*>]

power reset line <number>

power status line <number>

Turns the specified plug(s) off and then on.

Turns the specified plug(s) on.

Turns the specified plug(s) off.

Resets all the RPS plugs to the default state as defined in the Power Management line settings.

Displays the status (on/off) of the plug(s).

Show 5 more labels / short text on this page
Options cycle · on · off · reset · status
Page 162 of the Perle Systems CSS user manual — Power Commands
Page 162 · click to enlarge
Page 162

Power Commands

Page 163 of the Perle Systems CSS user manual — Glossary
Page 163 · click to enlarge
Page 163

Glossary

This chapter provides definitions for IOLAN terms.

An Internet protocol that enables a diskless workstation to discover its own IP address, the IP address of a BOOTP server on the network, and a file to be loaded into memory to boot the machine. This enables the workstation to boot without requiring a hard or floppy disk drive.

Callback A security feature where the IOLAN calls back the User at a predetermined number defined in the Users account.

CHAP (Challenge Handshake Authentication Protocol)

Standard authentication protocol for PPP connections. It provides a higher level of security than PAP and should be used whenever possible. see PAP

Community (SNMP) An SNMP community is the group that devices and management stations running SNMP belong to. It helps define where information is sent.

DHCP (Dynamic Host Configuration Protocol)

A TCP/IP protocol that provides static and dynamic address allocation and management.

Direct Connection Connections that bypass the IOLAN enabling the user to log straight into a specific host. A direct connection is recommended where a user logging in to the IOLAN is not required.

Ethernet A high-speed (10Mbps,100Mbps) cable technology that connects devices to a LAN, using one or more sets of communication protocols.

Fixed Callback A method where there is a specific number defined to callback a user.

Local Authentication Uses the user ID and password stored within the IOLAN User database.

LPD Line Printer Daemon. A printer protocol that uses TCP/IP to establish connections between printers and workstations on a network. The technology was developed originally for BSD UNIX and has since become the de facto cross-platform printing protocol.

A series of commands sent to the modem by a communications program at start up. These commands tell a modem how to set itself up in order to communicate easily with another modem.

MOTD Message of the day. This is defined by a file whose contents display when users log into the IOLAN.

Multicast The broadcasting of messages to a specified group of workstations on a LAN, WAN, or internet.

A communication control character sent by the receiving destination indicating that the last message was not received correctly.

BOOTP (BOOTstrap Protocol) · Modem Initialization String · NAK (Negative Acknowledgment)

Page 164 of the Perle Systems CSS user manual — Glossary
Page 164 · click to enlarge
Page 164

PAP (Password Authentication Protocol)

Standard authentication protocol for PPP connections. see CHAP

RADIUS (Remote Authentication Dial In Users Services)

An open standard network security server that communicates with the PAP protocol.

Reverse Connection Connections that originate from a host that go directly to a serial device through the IOLAN.

RIP (Routing Information Protocol)

A protocol that allows gateways and hosts to exchange information about various routes to different networks.

Roaming Callback A method where the client supplies the number for callback when they dial in.

RPC Remote Procedure Call. A type of protocol that allows a program on one computer to execute a program on a server computer.

Silent Connection Silent connections are the same as direct connections except that they are permanently established. The host login prompt is displayed on the screen. Logging out redisplays this prompt. Silent connections, unlike direct connections, however, make permanent use of pseudo tty resources and therefore consume host resources even when not in use.

SNMP (Simple Network Management Protocol)

A protocol for managing network devices.

Subnet/Prefix Bits Identifies the devices IP address, which portion constitutes the network address and which portion constitutes the host address.

Sources

References & links

Pages referenced in this manual — manufacturer, support and downloads.

Ask about the Perle Systems CSS

Owners and our team usually reply within a day — and your question helps the next person too.

Add your email to get notified when it’s answered — no spam, ever.

0 questions
No questions yet about the Perle Systems CSS

Be the first to ask — other owners or our team will answer.

Original document

Perle Systems CSS manual PDF

164 pages·2.1 MB·Network Card·PDF
Click any page above to open it here
Page 1 / …
100%
Loading pages…