Download Print this page
Perle IOLAN SDS Reference Manual

Perle IOLAN SDS Reference Manual

Command line interface
Hide thumbs Also See for IOLAN SDS:

Advertisement

IOLAN
SDS/SCS/STS/MDC

Command Line Interface

Reference Guide
Version 3.7
Part #5500210-14
December 2008

Advertisement

loading
Need help?

Need help?

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

Questions and answers

Summary of Contents for Perle IOLAN SDS

  • Page 1: Command Line Interface

    IOLAN SDS/SCS/STS/MDC Command Line Interface Reference Guide Version 3.7 Part #5500210-14 December 2008...
  • Page 2 Markham, ON Canada L3R 0E1 Perle reserves the right to make changes without further notice, to any products to improve reliability, function, or design. Perle, the Perle logo, and IOLAN are trademarks of Perle Systems Limited. Microsoft, Windows 98, Windows NT, Windows 2000, Windows Server 2003, Windows XP, Windows Vista, and Internet Explorer are trademarks of Microsoft Corporation.
  • Page 3: Table Of Contents

    Making a Technical Support Query ............14 Who To Contact ................. 14 Have Your Product Information Ready ..........14 Making a support query via the Perle web page ........ 14 Repair Procedure..................15 Feedback on this Manual............... 15 Chapter 1 Introduction............17 CLI Conventions ................
  • Page 4 Show Console ..................26 Show Custom-App.................. 26 Show Server .................... 26 Show Port-Buffering ................26 Show Modbus..................27 Hardware Commands..............27 Set Ethernet..................... 27 Show Hardware ..................27 SSH Server Commands .............27 Set SSH-Server..................27 Show SSH-Server..................28 SSL/TLS Commands ..............29 Set SSL Server ..................29 Set SSL Server Cipher-suite ..............
  • Page 5 Show TruePort ..................38 Email Commands............... 39 Set Email-Alert Server................39 Show Email-Alert Server................ 39 Clustering Commands............... 40 Add Clustering Slave-IP................. 40 Delete Clustering Slave-IP ..............40 Set Clustering Slave-IP ................41 Show Clustering Slave-IP ..............41 Dynamic DNS Commands............42 Set Dynamic-DNS ...................
  • Page 6 Kill Line ....................51 Kill Session....................51 Logout...................... 51 Menu......................52 Ping ......................52 Resume ....................52 Rlogin....................... 52 Screen ...................... 52 Set Termtype ...................53 Set User ....................53 Set User Session..................54 Show Line Users ..................55 SSH......................55 Syslog Console ..................56 Show Sessions..................
  • Page 7 Set Termtype................... 76 Show Line....................77 Line Service Commands ............78 Set Custom-App ..................78 Set Rlogin-Client..................78 Set Telnet-Client ..................78 Set SSH-Client ..................79 Set PPP....................81 Set PPP Dynamic-DNS ................85 Set SLIP ....................85 Set UDP ....................86 Set Vmodem....................
  • Page 8 Delete Modem..................97 Set Modem....................97 Show Modems..................97 Email Commands ...............98 Set Email-Alert Line ................98 Show Email-Alert Line ................99 Packet Forwarding Commands ..........99 Set Packet-Forwarding Line..............99 Show Packet-Forwarding Line.............102 Chapter 5 Network Commands ........103 SNMP Commands..............103 Add Community ..................
  • Page 9 Show Server..................108 Show WINS.................... 108 Gateway Commands..............109 Add Gateway..................109 Delete Gateway ..................110 Set Gateway ..................110 Show Gateways ..................110 Logging Commands ..............111 Set Syslog ..................... 111 Show Syslog ..................111 RIP Commands ................ 112 Add RIP....................
  • Page 10 Delete VPN Exception................122 Show VPN Exception................122 Chapter 6 Time Commands..........123 Server Commands..............123 Set Time ....................123 Set Timezone..................123 Show Time ..................... 123 Show Timezone..................123 SNTP Commands ..............124 Add SNTP ....................124 Delete SNTP................... 124 Set SNTP....................124 Show SNTP.................... 125 Show SNTP-Info ..................
  • Page 11 Netload ....................130 Netsave....................131 Custom Factory Default ............132 Netload ....................132 Set ......................132 Keys and Certificates Commands.......... 133 Netload ....................133 Netsave....................134 MOTD Commands..............135 Set MOTD ....................135 Show MOTD ..................135 Chapter 8 Statistics Commands ........137 Configuration Statistics ............
  • Page 12 Set Line..................142 Set Line Service ..................142 Set IOChannel ................143 Set IOChannel Mode ................143 Set IOChannel Digital I/O..............143 Set IOChannel Digital Input..............144 Set IOChannel Digital Input (Serial Pins)..........145 Set IOChannel Digital Output............... 146 Set IOChannel Digital Output (Serial Pins)......... 147 Set IOChannel Relay................
  • Page 13: Preface

    Preface About This Book This guide provides the information you need to: 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: If you are using an external authentication application(s), working knowledge of the authentication application(s).
  • Page 14: Contacting Technical Support

    Perle offers free technical support to Perle Authorised Distributors and Registered Perle Resellers. If you bought your product from a registered Perle supplier, you must contact their Technical Support department; they are qualified to deal with your problem. Have Your Product Information Ready...
  • Page 15: Repair Procedure

    Contacting Technical Support Repair Procedure Before sending a IOLAN for repair, you must contact your Perle supplier. If, however, you bought your product directly from Perle you can contact directly. Customers who are in Europe, Africa or Middle East can submit repair details via a website form.
  • Page 16 Contacting Technical Support IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 17: Chapter 1 Introduction

    Introduction Chapter 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 to display and use the native IOLAN+ interface (you must have ).
  • Page 18: Command Shortcuts

    CLI Conventions Command Shortcuts When you type a command, you can specify the shortest unique version of that command or you can press the key to complete the command. For example, the following command: set telnet-client map-to-crlf off can be typed as: set tel map off or, you can use the key to complete the lines as you go along:...
  • Page 19: Chapter 2 Server Commands

    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>...
  • Page 20: Set Port-Buffering

    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. nfs-host The NFS host that the IOLAN will use for its feature.
  • Page 21: Set Server

    Server Commands 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>]...
  • Page 22 Server Commands dhcp-update-dns 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). dhcp/bootp Enables the DHCP/BOOTP client process in the IOLAN. By default, this is disabled/off.
  • Page 23 Server Commands password-limit 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.
  • Page 24: Set Ssl Server

    Server Commands session-escape-string 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 <...
  • Page 25: Set Service

    Server Commands validation-criteria 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. country A two character country code; for example, US. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.
  • Page 26: Show Console

    Server Commands httpd HTTP daemon process in the IOLAN on port 80. snmpd SNMP daemon process in the IOLAN on port 161. spcd 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.
  • Page 27: Show Modbus

    Hardware Commands 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 auto|10-half|10-full|100-half|100-full|1000-full Options eth1|eth2...
  • Page 28: Show Ssh-Server

    SSH Server Commands authentication dsa An authentication method used by SSH version 2. Use DSA authentication for the SSH session. authentication password The user types in a password for authentication. authentication keyboard-interactive The user types in a password for authentication.Used for SSH2 only. compression Requests compression of all data.
  • Page 29: Ssl/Tls Commands

    SSL/TLS Commands SSL/TLS Commands Set SSL Server Description Sets the default SSL/TLS parameters for the server. User Level Admin Syntax set ssl server [version any|tslv1|sslv3] [type client|server] [verify-peer on|off] [validation-criteria country <code>|state-province <text>|locality <text> |organisation <text>|organisation-unit <text> |common-name <text>|email <email_addr>] Options version Specify whether you want to use:...
  • Page 30: Set Ssl Server Cipher-Suite

    SSL/TLS Commands organisation-unit Up to a 64 character entry for the unit in the organisation; for example, Payroll. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate. common-name Up to a 64 character entry for common name; for example, the host name or fully qualified domain name.
  • Page 31: Show Ssl

    Modbus Commands key-exchange The type of key to exchange for the encryption format: Any—Any key exchange that is valid is used (this does not, however, include ADH keys). RSA—This is an RSA key exchange using an RSA key and certificate. EDH-RSA—This is an EDH key exchange using an RSA key and certificate.
  • Page 32: Show Modbus

    Modbus Commands req-next-delay A delay, in milliseconds, to allow serial slave(s) to re-enable receivers before issuing next Modbus Master request. The default is 50 ms. exceptions 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.
  • Page 33: Authentication Commands

    Authentication Commands Authentication Commands Set Authentication Description Sets the authentication method for the IOLAN. User Level Admin Syntax set authentication type primary|secondary none|local|radius|kerberos|ldap|tacacs+|securid|nis [secondary-as-backup on|off] [auth-admin-user-local on|off] Options primary The first authentication method that the IOLAN attempts. Some type of authentication must be done by the IOLAN, therefore, is not a valid option for the None...
  • Page 34: Set Authentication Kerberos

    Authentication Commands Set Authentication Kerberos Description Configures Kerberos authentication settings. User Level Admin Syntax set authentication kerberos [kdc-domain <string>] [port <TCP_port>] [realm <string>] Options kdc-domain 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.
  • Page 35: Set Authentication Nis

    Authentication Commands Set Authentication NIS Description Sets NIS authentication parameters. User Level Admin Syntax set authentication nis [domain <string>] [primary <config_host>] [secondary <config_host>] Options domain The NIS domain name. primary The primary NIS host that is used for authentication. secondary The secondary NIS host that is used for authentication, should the primary NIS host fail to respond.
  • Page 36: Set Authentication Radius

    Authentication Commands Set Authentication RADIUS Description Sets RADIUS parameters. User Level Admin Syntax set authentication radius [accounting on|off] [acct-authenticator on|off] [acct-port <UDP_port>] [auth-port <UDP_port>] [nas-identifier <nas_id>] [nas-ip-address auto|specify <ipv4_address>] [nas-ipv6-address auto|specify <ipv6_address>] [retry <integer>] [timeout <integer>] Options accounting Enables/disables RADIUS accounting. acct-authenticator Enables/disables whether or not the IOLAN validates the RADIUS accounting response.
  • Page 37: Set Authentication Tacacs

    Authentication Commands 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>] Options port The port number that TACACS+ listens to for authentication requests. The default port number is 49.
  • Page 38: Show Authentication

    TruePort Baud Commands 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+ kerberos securid Displays the authentication settings for the specified authentication method.
  • Page 39: Email Commands

    Email Commands Email Commands Set Email-Alert Server Description Configures email alert settings for the server. User Level Admin Syntax set email-alert server [from <email_addr>] [level emergency|alert|critical|error|warning|notice|info|debug] [mode on|off] [to <email_addr>] [reply-to <email_addr>] [smtp-host <string>] [subject <string>] Options from This will be the contents of the from field in the generated email. This field will be specified in the field of the email message sent by the IOLAN.
  • Page 40: Clustering Commands

    Clustering Commands Clustering Commands Add Clustering Slave-IP Description Adds a slave IOLAN to the clustering group. User Level Admin Syntax add clustering slave-ip <IPv4_address> number-of-ports 1|2|4|8|16|24|32|48 [protocol telnet|ssh] [starting-master-tcp-port <10001-65535>] [starting-slave-ds-port <10001-65535>] Options <IPv4_address> Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group.
  • Page 41: Set Clustering Slave-Ip

    Clustering Commands 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>] Options <IPv4_address> Specify the IP address of the clustering slave you wish to modify. This clustering slave must already exist in the clustering group.
  • Page 42: Dynamic Dns Commands

    Dynamic DNS Commands Dynamic DNS Commands Set Dynamic-DNS Description Configures the dynamic DNS parameters. User Level Admin Syntax set dynamic-dns [on|off] [connection-method http|http-port-8245|https] [hostname <hostname>] [username <username>] [password <password>] [system-type dynamic|static|custom] [wildcard enable|disable|nochange] Options connection-method Specify how the IOLAN is going to connect to the DynDNS.org server, via HTTP, HTTP through Port 8245, or HTTPS.
  • Page 43 Dynamic DNS Commands country A two character country code; for example, US. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate. state-province Up to a 128 character entry for the state/province; for example, IL. This field is case sensitive in order to successfully match the information in the peer SSL/TLS certificate.
  • Page 44: Set Dynamic-Dns Ssl Cipher-Suite

    Dynamic DNS Commands 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...
  • Page 45: Show Dynamic-Dns

    PCI Commands hmac Select the key-hashing for message authentication method for your encryption type: 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...
  • Page 46: Set Pci Wireless-Wan

    WAN card. model Specify the wireless WAN card you are using. If the wireless WAN card you are using is not listed, try the standard driver. If that does not work, look at the Perle website for a custom driver. password Specify the password required by your internet provider to access their network.
  • Page 47: Ipv6 Commands

    IPv6 Commands IPv6 Commands Set IPv6 Description Configures the basic IPv6 settings. User Level Admin Syntax set ipv6 [dhcpv6-settings ipv6-address on|off] [dhcp-settings network-prefix on|off] [auto-obtain-dns-ipv6 on|off] [eth1|eth2] [enable-ipv6-addressing on|off] [obtain-using auto-ipv6|dhcpv6] Options dhcpv6-settings Determines the types of information that the IOLAN will accept from the DHCPv6 server, IPv6 address(es) and/or network prefix(es).
  • Page 48: Add Custom-Ipv6

    IPv6 Commands 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] Options eth1|eth2 Configures the custom IPv6 settings for the IOLAN’s Ethernet interface 1 or Ethernet interface 2 (SCS models only) interface.
  • Page 49: Set Custom-Ipv6

    IPv6 Commands Set Custom-IPv6 Description Configures custom IPv6 network and IP addresses. User Level Admin Syntax set custom-ipv6 [eth1|eth2] <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...
  • Page 50: Ipv6 Router Advertisements

    IPv6 Router Advertisements 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: DHCPv6—Use the DHCPv6 server to obtain additional IPV6 address(es) and configuration parameters.
  • Page 51: Chapter 3 User Commands

    User Commands Chapter 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 after you type Enter this command, you will be prompted for the Admin password.
  • Page 52: Menu

    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.
  • Page 53: Set Termtype

    Commands for Users Logged Into the IOLAN Set Termtype Description Sets the type of terminal being used for the current session. User Level Normal, Admin Syntax set termtype wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2| term3 Option wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2|term3 Specifies the type of terminal connected to the line: Dumb WYSE60 VT100...
  • Page 54: Set User Session

    Commands for Users Logged Into the IOLAN routing Determines the routing mode used for RIP packets on the PPP and SLIP interfaces for this user. Values are: None—RIP packets are neither received nor sent by the IOLAN. Send—RIP packets can only be sent by the IOLAN. Listen—RIP packets can only be received by the IOLAN.
  • Page 55: Show Line Users

    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 Description Starts an SSH session to the specified host/IP address. User Level Normal, Admin Syntax ssh <hostname/IP_address>...
  • Page 56: Syslog Console

    Commands for Users Logged Into the IOLAN ssh-2-cipher-list Select the order of negotiation for the encryption method (ciphers) that the IOLAN will use for the SSH version 2 connection: 3DES Blowfish Arcfour CAST user The name of the user logging into the SSH session. verbose Displays debug messages on the terminal.
  • Page 57: Telnet

    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>...
  • Page 58: Version

    Configuring Users escape Defines the escape character. Returns you to the command line mode. This value is in hexadecimal with a default value of (ASCII value 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.
  • Page 59: Set Default User

    Configuring Users Set Default User Description Configures the Default User. When adding a new user, the profile of the default user will be used to assign the values of the various parameters of the new user. For example if you set the parameter of the default user to , when a new user is added, service...
  • Page 60 Configuring Users framed-mtu Used for , specifies the maximum size of packets, in bytes, User Service PPP SLIP being transferred across the link. On noisy links it might be preferable to fragment large packets being transferred over the link, since there will be quicker recovery from errors. Depending on whether you have selected a , details are as User Service...
  • Page 61 Configuring Users level The access that a user is allowed: Admin—The admin level user has total access to the IOLAN. You can create more than one admin user account but we recommend that you only have one. They can monitor and configure the IOLAN. Normal—The Normal level user has limited access to the IOLAN.
  • Page 62: Set User

    Configuring Users sess-timer The amount of time, in seconds, that the will run. Use this timer to Session Timer forcibly close a user’s session (connection). When the expires, the Session Timer IOLAN will end the connection. The default value is (zero), meaning that the session timer will not expire (the session is open permanently, or until the user logs out).
  • Page 63 Configuring Users framed-compression Used for , determines whether Van Jacobsen Compression is User Service PPP SLIP used on the link. VJ compression is a means of reducing the standard TCP/IP header from 40 octets to approximately 5 octets. This gives a significant performance improvement, particularly when interactive applications are being used.
  • Page 64 Configuring Users hotkey-prefix The prefix that a user types to control the current session. The default value is hex 01 which corresponds to ) (hex value 02 would be Ctrl-b (^b), etc.): Ctrl-a —To switch from one session to another, press and then the required ^a number session number.
  • Page 65 Configuring Users netmask 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. password The password the user will need to enter to login to the IOLAN. This case-sensitive field accepts a maximum of 16 characters.
  • Page 66: Set User Session

    Configuring Users 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] [type off|telnet|rlogin|ssh] 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]...
  • Page 67: Chapter 4 Line Commands

    Line Commands Chapter 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.
  • Page 68 Line Commands connection-method Determines how a modem will work on the line. Select from the following options: Direct Connect—Indicates that there is not a modem on the line. This is the default. Dial In—Specify this option when a user is remote and will be dialing in via modem or ISDN TA.
  • Page 69 Line Commands break Specifies how a break is interpreted: off—The IOLAN ignores the break key completely and it is not passed through to the host. This is the default setting. local—The IOLAN deals with the break locally. If the user is in a session, the break key has the same effect as a hot key.
  • Page 70 Line Commands keepalive 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.
  • Page 71 Line Commands stop-bits 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. term-type Specifies the type of terminal connected to the line: Dumb WYSE60 VT100...
  • Page 72: Set Line Interface

    Line Commands Set Line Interface The SCS, STS, and MDC IOLAN models support the EIA-232 interface only. Therefore, you do not need to specify in the command syntax; you only need to specify the interface eia-232 command options (e.g., monitor-dcd Description Configures line interface (hardware) parameters.
  • Page 73: Set Line Service

    Line Commands tx-driver-control Used with a serial interface, if your application supports (Request To EIA-485 Send), select this option. Otherwise, select . Default is Auto Auto duplex Specify whether the line is (communication both ways at the same time) or Full Duplex (communication in one direction at a time).
  • Page 74 Line Commands Syntax set line .|<number>|* service bidir <config_host> <server_port> <host_port> set line .|<number>|* service direct|silent rlogin <config_host> set line .|<number>|* service direct raw <config_host> <host_port> 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>...
  • Page 75 Line Commands rlogin Sets the line for a remote login connection. Creates a connection where no authentication takes place and data is passed unchanged. telnet Sets the line for a telnet connection. Sets the line for an SSH connection. reverse Enables a TCP/IP host to establish a login connection on an external machine attached to a port.
  • Page 76: Set Modem

    Line Commands 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.
  • Page 77: Show Line

    Line Commands Option wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2|term3 Specifies the type of terminal connected to the line: Dumb WYSE60 VT100 ANSI TVI925 IBM3151TE VT320 (specifically supporting VT320-7) HP700 (specifically supporting HP700/44) Term1, Term2, Term3 (user-defined terminals) Show Line Description Shows the line settings/information. User Level Admin Syntax show line <number>|* Line Commands 77...
  • Page 78: Line Service Commands

    Line Service Commands Line Service Commands Set Custom-App Description You can create a custom application that can run on a specific serial line in IOLAN using the Perle SDK. User Level Admin Syntax set custom-app line .|<number>|* program-command-line <command> Options...
  • Page 79: Set Ssh-Client

    Line Service Commands echo Defines the echo character. When , typing the echo character echoes Line Mode the text locally and sends only completed lines to the host. This value is in hexadecimal with a default value of (ASCII value Defines the end-of-file character.
  • Page 80 Line Service Commands auto-login Creates an automatic SSH login, using the values. Name Password name The user’s name when is enabled. Auto Login password The user’s password when is enabled. Auto Login ssh-1-cipher Select the encryption method (cipher) that you want to use for your SSH version 1 connection: 3DES Blowfish...
  • Page 81: Set Ppp

    Line Service Commands 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]...
  • Page 82 Line Service Commands ipaddr-neg Specifies whether or not IP address negotiation will take place. IP address negotiation is where the IOLAN allows the remote end to specify its IP address. The default value is . When , the IP address specified by the remote end will be used in preference to set for a .
  • Page 83 Line Service Commands netmask The network subnet mask. For example, 255.255.0.0. If your user is authenticated by RADIUS and the RADIUS parameter is set in the RADIUS file, the Framed-Netmask IOLAN will use the value in the RADIUS file in preference to the value configured here.
  • Page 84 Line Service Commands ruser This field is used to authenticate a user connecting to this line. It is used in conjunction with the field. By specifying a name here, this line becomes dedicated to rpassword that user only. If left blank, the internal user database will be used to authenticate the connection and any user configured will be able to access this line.
  • Page 85: Set Ppp Dynamic-Dns

    Line Service Commands Set PPP Dynamic-DNS Description This option is only available when IP address negotiation ( ) is . When ipaddr-neg 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]...
  • Page 86: Set Udp

    Line Service Commands ripaddr 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.
  • Page 87: Set Vmodem

    Line Service Commands both|in|out|none The direction in which information is received or relayed: None—UDP service not enabled. 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. Out—Serial to LAN.
  • Page 88 Line Service Commands failure-string String that is sent to the serial device when a connection fails. If no string is entered, then the string will be sent. NO CARRIER host The target host name. init-string 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.
  • Page 89 Line Service Commands style One of the following: Verbose—Return codes (strings) are sent to the connected device. Numeric—The following characters can be sent to the connected device: 0 OK 1 CONNECTED 2 RING 3 NO CARRIER 4 ERROR 6 ITERFACE DOWN 7 CONNECTION REFUSED 8 NO LISTNER success-string...
  • Page 90: Set Vmodem-Phone

    Line Service Commands 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 searched for in this table and if an exact match is found, the associated IP address and TCP port will be used to establish the connection.
  • Page 91 Line Service Commands type Specify whether the IOLAN will act as an SSL/TLS client or server. The default is Client. verify-peer 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.
  • Page 92: Set Ssl Line Cipher-Suite

    Line Service Commands 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 Options option1|option2|option3|option4|option5 Sets the priority of the cipher suite, with being highest priority and option1 option5...
  • Page 93: Set Modbus-Slave Line

    Line Service Commands Set Modbus-Slave Line Description Sets the Modbus slave parameters for the line. User Level Admin Syntax set modbus-slave line .|<number>|* [crlf on|off] [protocol rtu|ascii] [uid-range <uid_range>] Options crlf When is selected, adds a CR/LF to the end of the transmission; most Modbus/ASCII Modbus devices require this option.
  • Page 94: Set Power-Management Line

    Line Service Commands slave-ip The IP address of the TCP/Ethernet Modbus Slave. uid-range When and you have sequential Modbus Slave IP addresses (for Range Mode Host 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.
  • Page 95: Set Multihost Line

    Line Service Commands 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).
  • Page 96: Show Ppp

    Line Service Commands 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.
  • Page 97: Modem Commands

    Modem Commands 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. <initialization_string> The initialisation string of the modem; see your modem’s documentation. Delete Modem Description Deletes a modem.
  • Page 98: Email Commands

    Email Commands 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] Options from This field will be specified in the...
  • Page 99: Show Email-Alert Line

    Packet Forwarding Commands 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.
  • Page 100 Packet Forwarding Commands delay-between-messages 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. custom-on-specific-events This section allows you to set a variety of packet definition options. The first criteria that is met causes the packet to be transmitted.
  • Page 101 Packet Forwarding Commands eof2 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.
  • Page 102: Show Packet-Forwarding Line

    Packet Forwarding Commands Show Packet-Forwarding Line Description Shows the packet-forwarding settings for the line. User Level Admin Syntax show packet-forwarding line <number> IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 103: Chapter 5 Network Commands

    Network Commands Chapter 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> none|readonly|readwrite Options <community_name>...
  • Page 104: Delete Community

    SNMP Commands 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 command.
  • Page 105: Set Snmp V3-Security

    SNMP Commands 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...
  • Page 106: Show Snmp

    TFTP Commands 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>] Options retry The number of times the IOLAN will retry to transmit a TPFT packet to/from a host...
  • Page 107: Set Host

    DNS/WINS Commands 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. <IP_address> The host IPv4 or IPv6 address. fqdn When you have DNS defined in the IOLAN, you can enter a DNS resolvable fully qualified domain name (note: FQDN’s are excluded as accessible hosts when...
  • Page 108: Delete Dns

    DNS/WINS Commands 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.
  • Page 109: Gateway Commands

    Gateway Commands 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>...
  • Page 110: Delete Gateway

    Gateway Commands 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>...
  • Page 111: Logging Commands

    Logging Commands 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>] Options level Choose the event level that triggers a syslog entry: Emergency Alert Critical Error Warning Notice Info Debug When you select a...
  • Page 112: Rip Commands

    RIP Commands RIP Commands Add RIP Description Adds a RIP MD5 key. After pressing , you will be prompted for the MD5 key Enter value. User Level Admin Syntax add rip md5 <integer_md5_id> <start_date> <start_time> <end_date> <end_time> Options < > integer_md5_id identification key.
  • Page 113: Set Rip

    RIP Commands 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] [ethernet-mode none|send|listen|send-and-listen] set rip password set rip md5 <config_md5_id> [end <date> <time>] [start <date>...
  • Page 114: Show Rip Peers

    IPsec Commands 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.
  • Page 115 IPsec Commands Options authentication-method Specify the authentication method that will be used between VPN peers to authenticate the VPN tunnel. Data Options: Shared Secret—A text-based secret that is used to authenticate the IPsec tunnel (case sensitive). 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.
  • Page 116 IPsec Commands remote-external-ip-address When is enabled, the remote VPN’s public external IPv4 or NAT Traversal (NAT_T) IPv6 address or FQDN. If you want to accept a VPN connection from any host/network, you can enter in this field. %any remote-host-nextwork The IPv4 or IPv6 address of a specific host or the network address that the IOLAN will provide a VPN connection to.
  • Page 117: Show Ipsec

    IPv6 Tunnels email 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. secret When the is set to...
  • Page 118: Set Ipv6Tunnel

    IPv6 Tunnels 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>] Options mode The method or protocol that is used to create the IPv6 tunnel. Manual—When enabled, the IOLAN will manually create the IPv6 tunnel to the specified through the specified Remote Host...
  • Page 119: L2Tp/Ipsec

    L2TP/IPsec L2TP/IPsec Once L2TP/IPsec is enabled, the IOLAN expects all connections to be established through a VPN tunnel. To allows hosts to connect outside of the VPN tunnel, you must configure VPN exceptions, see VPN Exceptions on page 121 for the command syntax. Set L2TP Description User Level Admin...
  • Page 120 L2TP/IPsec country A two character country code; for example, US. This field is case sensitive in order to successfully match the information in the remote X.509 certificate. An asterisk (*) works as a wildcard. state-province Up to a 128 character entry for the state/province; for example, IL. This field is case sensitive in order to successfully match the information in the remote X.509 certificate.
  • Page 121: Show Lt2P

    VPN Exceptions authentication-type Specify the authentication method that will be used for the L2TP tunnel. Data Options: CHAP, PAP, Both Default: Both Show LT2P Description Shows the L2TP settings. User Level Admin Syntax show l2tp VPN Exceptions VPN exceptions allows specific hosts or any host in a network to connect to the IOLAN outside of a VPN tunnel.
  • Page 122: Delete Vpn Exception

    VPN Exceptions 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...
  • Page 123: Chapter 6 Time Commands

    Time Commands Chapter 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 <hh:mm[: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).
  • Page 124: Sntp Commands

    SNTP Commands SNTP Commands Add SNTP Description Adds an SNTP server. User Level Admin Syntax add sntp [server-1 <config_host>] [server-2 <config_host>] Options server-1 The name of the primary SNTP server from the IOLAN host table. Valid with Unicast modes, although in mode, the IOLAN will only accept Multicast Multicast...
  • Page 125: Show Sntp

    Time/Date Setting Commands server-1 The name of the primary SNTP server from the IOLAN host table. Valid with Unicast modes, although in mode, the IOLAN will only accept Multicast Multicast broadcasts from the specified host SNTP server. server-2 The name of the secondary SNTP server from the IOLAN host table. Valid with modes, although in mode, the IOLAN will only accept Unicast...
  • Page 126: Set Summertime Fixed

    Time/Date Setting Commands offset 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.
  • Page 127: Show Date

    Time/Date Setting Commands end-time The time to end summer time and start standard time; uses the format hh:mm for a 24-hour clock (00:00-23:59). end-week 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...
  • Page 128 Time/Date Setting Commands IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 129: Chapter 7 Administration Commands

    Administration Commands Chapter 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...
  • Page 130: Set Bootup

    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>] Options firmware file The path and file name, relative to the default path of your TFTP server software, of the...
  • Page 131: Netsave

    Download wireless WAN custom drivers to the IOLAN that have been downloaded from the Perle website. <hostname/IP_address> The IP address or host name where the file you are downloading to the IOLAN resides. If you are using a host name, it must be resolved in either the IOLAN’s...
  • Page 132: Custom Factory Default

    Custom Factory Default <filename> 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.
  • Page 133: Keys And Certificates Commands

    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> <filename> 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>...
  • Page 134: Netsave

    Keys and Certificates Commands ipsec <tunnel_name> When you configure an IPsec tunnel with an Authentication Method , you need to download the RSA key from the remote VPN gateway to the Signature IOLAN for that specific tunnel. < > hostname IP_address Enter the host or IP address that contains the certificate/key you are downloading to the IOLAN.
  • Page 135: Motd Commands

    MOTD Commands MOTD Commands Set MOTD Description Specifies the server/file that contains the message of the day (MOTD) that is displayed when users log into the IOLAN. You can also retrieve the MOTD from a local file (it must already be downloaded to the IOLAN using the netload customapp-file command);...
  • Page 136 MOTD Commands IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 137: Chapter 8 Statistics Commands

    Statistics Commands Chapter 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 Displays all ports, including server (listening) ports;...
  • Page 138: Show Modbus Statistics

    Run-Time Statistics Show Modbus Statistics Description Shows the Modbus statistics. User Level Admin Syntax show modbus statistics master-tcp line *|<number> show modbus statistics master-udp line *|<number> show modbus statistics slave-tcp line *|<number> show modbus statistics slave-udp line *|<number> Show Routes Description Shows current information about IPv4 or IPv6 network routes.
  • Page 139: Chapter 9 Iolan+ User Commands

    IOLAN+ User Commands Chapter 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.
  • Page 140 IOLAN+ IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 141: Chapter 10 I/O Commands

    I/O Commands Chapter 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>...
  • Page 142: Set Io Failsafe

    Set Line Set IO Failsafe Description Sets the failsafe (watchdog) settings for I/O. User Level Admin Syntax set io failsafe [mode on|off] [timeout <seconds>] Options mode Enables/disables the Failsafe Timer. This is the global setting that must be enabled to set the Failsafe Action on the channel for digital outputs and relays.
  • Page 143: Set Iochannel

    Set IOChannel Set IOChannel Set IOChannel Mode Description Sets general I/O channel settings for the specified channel, these settings are available to all channels and I/O serial pins. User Level Admin Syntax set iochannel <i/o_channel> [mode enabled|disabled] [description <string>] Options i/o_channel Specify the channel number, for example, d2 or a4.
  • Page 144: Set Iochannel Digital Input

    Set IOChannel Set IOChannel Digital Input Description Sets the Digital input settings for the channel. User Level Admin Syntax set iochannel <digital_channel> [alarm [trigger disabled|inactive-input|active-input] [clear auto|manual] [email on|off] [syslog on|off] [snmp on|off]] [description <string>] [invert-signal on|off] [latch disabled|inactive-to-active|active-to-inactive] Options digital_channel Specify the Digital channel number, for example, d2.
  • Page 145: Set Iochannel Digital Input (Serial Pins)

    Set IOChannel 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 is set to Line Service 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]]...
  • Page 146: Set Iochannel Digital Output

    Set IOChannel latch Latches (remembers) the activity transition (active-to-inactive or inactive-to-active). The latched status is maintained until it is read. Once it is read, it will revert to the current status. The default is disabled. Set IOChannel Digital Output Description Sets the Digital output channel settings. User Level Admin Syntax set iochannel <digital_channel>...
  • Page 147: Set Iochannel Digital Output (Serial Pins)

    Set IOChannel output Specify how the channel output will be handled: Manual—You must manually manipulate the channel output. Pulse—Activates and deactivates the channel output activity in intervals after it is manually activated. Inactive-to-Active Delay—The channel output will remain inactive for the specified time interval after it is manually started.
  • Page 148: Set Iochannel Relay

    Set IOChannel Set IOChannel Relay Description Sets the Relay output channel settings. User Level Admin Syntax set iochannel <relay_number> output [pulse continuous|counted <pulse_count>] [active-to-inactive-delay <delay>] [inactive-to-active-delay <delay>] set iochannel <relay_number> [active-signal-width <width>] [inactive-signal-width <width>] [failsafe-action none|activate|deactivate] Options relay_number Specify the Relay channel number, for example, r2. output Specify how the channel output will be handled: Manual—You must manually manipulate the channel output.
  • Page 149: Set Iochannel Analog (True Analog)

    Set IOChannel Set IOChannel Analog (True Analog) Description Sets the Analog input channel settings. User Level Admin Syntax set iochannel <analog_channel> type current|voltage range <range_specifier> set iochannel <analog_channel> alarm [level 1|2|3|4|5 [mode on|off] [trigger-type disabled|low|high] [trigger-level <decimal_value>] [clear-mode auto|manual] [clear-level <decimal_value>] [email on|off] [snmp on|off] [syslog on|off]] Options analog_channel...
  • Page 150: Set Iochannel Analog (Temperature)

    Set IOChannel trigger-level Specify the value that will trigger an alarm, the measurement is based on the Type that you specify. This value must not fall within the scope of the value used to Range clear an alarm. clear-mode Specifies whether an activated alarm must be cleared, or can be cleared when Manually the input drops below the specified value (when...
  • Page 151 Set IOChannel range Specify the temperature range that you want to measure. For RTD, the range is: 1 (Pt100 a=385 -50 to 150C) This is the default. 2 (Pt100 a=385 0 to 100C) 3 (Pt100 a=385 0 to 200C) 4 (Pt100 a=385 0 to 400C) 5 (Pt100 a=385 -200 to 200C) 6 (Pt100 a=392 -50 to 150C) 7 (Pt100 a=392 0 to 100C)
  • Page 152: Set Iochannel Ioextension

    Set IOChannel clear-mode Specifies whether an activated alarm must be cleared, or can be cleared when Manually the input drops below the specified value (when ) or goes above Trigger Type High the specified value (when Trigger Type clear-level Specify that value that will clear an alarm, the measurement is based on the Type that you specify.
  • Page 153 Set IOChannel enabled When enabled, the digital input channel or DSR/DCD/CTS input serial signal pins can be connected to: A Digital output or relay (if the I/O model supports relay) channel on the same IOLAN Output Serial Signal Pins (DTR/RTS) A Digital output channel on another IOLAN(s) or output serial signal pins (DTR/RTS) on another IOLAN(s) A TCP/IP application(s) running on a host on the network...
  • Page 154: Set Iochannel Multihost

    Set IOChannel server-initiated tcp-port 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...
  • Page 155: Set Iochannel Ioextension Ssl

    Set IOChannel 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 User Level Admin Syntax set iochannel <channel>...
  • Page 156: Show Io

    I/O Channel Control Commands Show IO Description Shows global I/O information (for example, UDP, TruePort, Modbus). Temperature I/O is Analog. User Level Admin Syntax show iochannel <i/o_channel> show iochannel rts|cts|dtr|dsr|dcd Options i/o_channel Specify the channel number, for example, d2 or a4. Temperature models use Analog input, so the channel numbers are a1-a4.
  • Page 157: Digital Input

    Calibrating Analog Input (Analog/Temperature) Digital Input Description Manages the Digital input channel status. User Level Admin Syntax iochannel d1|d2|d3|d4|rts|dtr output activate|deactivate Option output Manually activates/deactivates the I/O channel. Relay Description Manages the Relay output channel status. User Level Admin Syntax iochannel r1|r2 output activate|deactivate Option output...
  • Page 158 Calibrating Analog Input (Analog/Temperature) IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 159: Chapter 11 Power Commands

    Power Commands Chapter 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>...
  • Page 160 Power Commands IOLAN SDS/SCS/STS/MDC CLI Reference Guide, Version 3.7...
  • Page 161: Glossary

    Glossary This chapter provides definitions for IOLAN terms. BOOTP (BOOTstrap An Internet protocol that enables a diskless workstation to discover its own IP address, the IP Protocol) address of a BOOTP server on the network, and a file to be loaded into memory to boot the machine.
  • Page 162 PAP (Password Standard authentication protocol for PPP connections. see CHAP Authentication Protocol) RADIUS (Remote An open standard network security server that communicates with the PAP protocol. Authentication Dial In Users Services) Reverse Connection Connections that originate from a host that go directly to a serial device through the IOLAN. RIP (Routing A protocol that allows gateways and hosts to exchange information about various routes to Information Protocol)

This manual is also suitable for:

Iolan scsIolan stsIolan mdc