English dropdown-ico

Perle Systems SDS manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Perle Systems SDS, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Perle Systems SDS one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Perle Systems SDS. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Perle Systems SDS should contain:
- informations concerning technical data of Perle Systems SDS
- name of the manufacturer and a year of construction of the Perle Systems SDS item
- rules of operation, control and maintenance of the Perle Systems SDS item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Perle Systems SDS alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Perle Systems SDS, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Perle Systems service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Perle Systems SDS.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Perle Systems SDS item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    IOLAN SDS/SCS/STS/MDC Command Line Interface Reference Guide Version 3.7 Part #5500210-14 December 2008[...]

  • Page 2

    Copyright S tatement This document must not be repro duced in any way whatsoever , either printed or electronicall y , without the consent of: Perle Systems Limi ted, 60 Renfrew Drive Markham, ON Canada L3R 0E1 Perle reserves the right to make change s without further notice, to any products to improve reliability , function, or design. Perle, the [...]

  • Page 3

    IOLAN SDS/SCS/STS/MDC CLI Re ference Guide, V ersion 3.7 3 Preface ........................ ....................................................... 13 About This Book .............. .................................... ...................... 13 Intended Audience ........... .................................... ...................... 13 Typeface Con[...]

  • Page 4

    4 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Show Console ............ ................................. ................................. ........... 26 Show Custom-App ............... ........................................................ ........... 26 Show Server ............. ................................................. ...[...]

  • Page 5

    5 Show TruePort ........... .................................................................. ........... 38 Email Commands ................... .............................. ...................... 39 Set Email-Alert Server . ................. ................................ ............... ........... 39 Show Email-Alert Server ....... .........[...]

  • Page 6

    6 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Kill Line ............ ............................................................................. ........... 51 Kill Session............. .......................................... ............................ ........... 51 Logout ................ ................ ......................[...]

  • Page 7

    7 Set Termtype ......... .......................................... .............. ............... ........... 76 Show Line............ ............................................ .............. ............... ........... 77 Line Service Commands . .................................... ...................... 78 Set Custom-App .......... ..........[...]

  • Page 8

    8 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Delete Modem........... ................................................. ................ .............. 97 Set Modem ................ ................................................................. .............. 97 Show Modems ............ ...............................................[...]

  • Page 9

    9 Show Server ............. ................................................................. ............ 108 Show WINS............... ................................................. ................ ............ 108 Gateway Commands .............. .................................... .............. 109 Add Gateway .............. ...............[...]

  • Page 10

    10 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Delete VPN Exception.......... ........................................................ ......... 122 Show VPN Exception .... ............................................................ ............ 122 Chapter 6 Time Commands ............................................ 123 Server Comman[...]

  • Page 11

    11 Netload .............. ............................................ ............................ ............ 130 Netsave ................ ........................................................ .............. ............ 131 Custom Factory Default .. .................................... .................... 132 Netload .............. ........[...]

  • Page 12

    12 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Line ................ ...................................................................... 142 Set Line Service ....... ................................................................. ............ 142 Set IOChannel ....................... ...........................................[...]

  • Page 13

    IOLAN SDS/SCS/STS/MD C CLI Reference Guide, V ersion 3.7 13 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 adm inistrators who will be configuring th e IOLAN. Some prerequisite knowledge is needed to understand the concep ts a[...]

  • Page 14

    Contacting T ech nical Support 14 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Cont acting T echnical Support Making a T echnical Support Query Who T o Cont act If you bought your produ ct from a registered Perle supplier, you must contact their T echnical Supp ort department; they are qualified to deal with you r problem. Have Y our Pr[...]

  • Page 15

    15 Contacting T echnical Support Rep air Procedure Before sending a IOLAN for repair, you must contact your Perle supplier . If, however , you boug ht your product directly from Perle you can contact direct ly . Customers who are in Europe, Afri ca or Middle East can submit repair d etails via a websit e form. This form is on the Perle website, www[...]

  • Page 16

    Contacting T ech nical Support 16 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7[...]

  • Page 17

    IOLAN SDS/SCS/STS/MD C CLI Reference Guide, V ersion 3.7 17 Introduction Chapter 1 1 This book provides the command line interface (CLI) options availabl e for the IOLAN. The commands are grouped by function. CLI Conventions This section explains how to interpret the CLI s yntax. If you are an exis ting IOLAN+ custom er and would like to configure [...]

  • Page 18

    CLI Conventions 18 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Command Shortcut s When you type a command, you can specify the shortest unique ve rsion of that command or you can press the ESC or TA B key to complete the command. For example, the following command: set telnet-clie nt map-to-crlf off can be typed as: set tel map off or ,[...]

  • Page 19

    IOLAN SDS/SCS/STS/MD C CLI Reference Guide, V ersion 3.7 19 Server Commands Chapter 2 2 This chapter defines all the CLI commands a ssociated with configuring the IOLAN server parameters. Server Commands Set Console Set Custom-App Description Sets the flow control and baud rate on IOLAN models that have a dedicated console port. User Level Admin Sy[...]

  • Page 20

    Server Commands 20 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 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-encryptio n on|off] [nfs-host < config_h[...]

  • Page 21

    Server Commands 21 Server Commands Set Server Description Sets server parameters. User Level Admin Syntax set server [auto-obtain-dns o n|off] [auto-obtain-gw on|off] [auto-obtain-wins on|off] [banner on|o ff] [break on|off] [bypass-password on|off] [dhcp-update- dns on|off] [domain < string >] [flush-on-close on|o ff] [line-menu-string < [...]

  • Page 22

    Server Commands 22 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 dhcp-update-dns The DHCP server will update the DNS server when the IOLAN requests a DHCP IP address (the communicati on 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 def[...]

  • Page 23

    Server Commands 23 Server Commands password-limit The number of attempts a user is allowe d to enter a password for a serial port connection from the network, before the conn ection is terminated and the user has to attempt to login again. For us ers logging into the serial po rt, if this limit is exceeded, the serial port is disabled for 5 minutes[...]

  • Page 24

    Server Commands 24 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set SSL Server 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 pa rticular port on the IOLAN. Y ou can specify control (unprintab le) codes by putting the deci[...]

  • Page 25

    Server Commands 25 Server Commands Set Service validation-criteria Any values that are entered in the validation criteria m ust match the peer certificate for an SSL connection; any fiel ds left blank wi ll not be validated against the peer certificate. country A two character count ry code; for example, US. This fi eld is case sensitive in order t[...]

  • Page 26

    Server Commands 26 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show Console Show Custom-App Show Server Show Port-Buffering httpd HTTP daemon process in the IOLAN on port 80. snmpd SNMP daemon process in the IOLAN on port 16 1. spcd SPC (T ruePort) daemon process in the IOLAN that supports T ruePo rt Full Mode on UDP port 668. Y ou can[...]

  • Page 27

    Server Commands 27 Hardware Commands Show Modbus Hardware Commands Set Ethernet Show Hardware SSH Server Commands Set SSH-Server See Keys and Certificates in the IOLAN User’ s Guide for information abou t th e keys and certificates that need to be uploaded or downloaded with the IOLANs SSH server . Description Shows the Modbus settings for the ga[...]

  • Page 28

    SSH Server Commands 28 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show SSH-Server authentication dsa An authentication method used by SSH version 2. Use DSA authen tication for the SSH session. authentication passw ord The user types in a pa ssword for authentication. authentication ke yboard-interactive The user types in a password f[...]

  • Page 29

    Server Commands 29 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|t slv1|sslv3] [type client|server] [verify-peer on|off] [validation-criteria country < code >|state-province < text > |locality < text > |organisat[...]

  • Page 30

    SSL/TLS Commands 30 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set SSL Server Cipher-suite organisation-unit Up to a 64 character entry fo r the u nit in the organisation; for example, Payroll. This field is case sensitive in order to successfully match the inform ation in the peer SSL/TLS certificate. common-name Up to a 64 character[...]

  • Page 31

    Server Commands 31 Modbus Commands Show SSL Modbus Commands Set Modbus Gateway key-exchange 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 exchang[...]

  • Page 32

    Modbus Commands 32 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show Modbus req-next -delay A delay , in milliseconds, to allow serial sl ave(s) to re-enable receivers before issuing next Modbus Master request. The default is 50 ms. exceptions When enabled, an exception message is gene rated and sent to the initiating Modbus device when[...]

  • Page 33

    Server Commands 33 Authentication Commands Authentication Commands Set Authentication Set Authentication Local Description Sets the authentication method for the IOLAN. User Level Admin Syntax set authentication type prima ry|secondary none|local|radius|kerberos|ldap|tacacs +|securid|nis [secondary-as-backup on|off] [auth-admin-user-local on|off] O[...]

  • Page 34

    Authentication Commands 34 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Authentication Kerberos Set Authentication LDAP Description Configures Kerberos authentication settings. User Level Admin Syntax set authentication kerberos [ kdc-domain < string >] [port < TCP_port >] [realm < string >] Options kdc-d o main Th[...]

  • Page 35

    Server Commands 35 Authentication Commands Set Authentication NIS Add RADIUS Delete RADIUS Description Sets NIS authentication parameters. User Level Admin Syntax set authentication nis [domai n < string >] [primary < config_host >] [secondary < config_host >] Options domain The NIS domain name. primary The primary NIS host that i[...]

  • Page 36

    Authentication Commands 36 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Authentication RADIUS Description Sets RADIUS parameters. User Level Admin Syntax set authentication radius [ac counting on|off] [acct-authenticator on|off] [acct-por t < UDP_port >] [auth-port < UDP_port >] [nas-identifie r < nas_id >] [nas-ip[...]

  • Page 37

    Server Commands 37 Authentication Commands Set Authentication T ACACS+ Set Authentication SecurID Description Configures T A CACS+ au thentication settings. User Level Admin Syntax set authentication tacacs+ [p ort < TCP_port >] [primary < config_host >] [secondary < co nfig_host >] [secret < string >] Options port The port [...]

  • Page 38

    T ruePort Ba ud Commands 38 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show Authentication T ruePort Baud Commands Set T ruePort Remap-Baud Show T ruePort Description Shows the authentication settings. If you ty pe just the show authentication command, the configured primary and sec ondary authenti cation methods are displayed. User L[...]

  • Page 39

    Server Commands 39 Email Commands Email Commands Set Email-Alert Server Show Email-Alert Server Description Configures email alert se ttings for the server . User Level Admin Syntax set email-alert server [from < email_addr >] [level emergency|alert|critical|er ror|warning|notice|info|debug] [mode on|off] [to < email_addr >] [reply-to &[...]

  • Page 40

    Clustering Commands 40 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Clustering Commands Add Clustering Slave-IP Delete Clustering Slave-IP Description Adds a slave IOLAN to the clus tering 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-m[...]

  • Page 41

    Server Commands 41 Clustering Commands Set Clustering Slave-IP Show 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 telne[...]

  • Page 42

    Dynamic DNS Commands 42 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Dynamic DNS Commands Set Dynamic-DNS Set Dynamic-DNS SSL Description Configures the dynamic DNS parameters. User Level Admin Syntax set dynamic-dns [on|off] [connection-method http|http-port-824 5|https] [hostname < hostname >] [username < user name >] [pas[...]

  • Page 43

    Server Commands 43 Dynamic DNS Commands country A two character count ry code; for example, US. This fi eld is case sensitive in order to successfully match the information in the peer SS L/TLS certificate. state-province Up to a 128 character entry for the s tate/pr ovince; for example, IL. This field is case sensitive in order to successfully mat[...]

  • Page 44

    Dynamic DNS Commands 44 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 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-su ite option1|option2|option3|option4|optio n5 encryption any|aes|3des|de[...]

  • Page 45

    Server Commands 45 PCI Commands Show Dynamic-DNS PCI Commands Set PCI Card Show PCI hmac Select the key-hashing for message authenticat ion method for your encryption type: z Any z MD5 z SHA1 The default is Any . Description Shows the dynamic DNS setting s. User Level Admin Syntax show dynamic-dns Description Sets the type of card in the PCI slot. [...]

  • Page 46

    PCI Commands 46 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set PCI Wireless-W AN Show Wireless-W AN Description Configures the wireless W AN parameters. User Level Admin Syntax set pci wireless-wan [access- point-name < name >] [init-string < modem_init_string >] [model sierra-wireless-aircard-881|so ny-ericsson-pc300|sier[...]

  • Page 47

    Server Commands 47 IPv6 Commands IPv6 Commands Set IPv6 Show IPv6 Description Configures the basic IPv6 settings. User Level Admin Syntax set ipv6 [dhcpv6-settings ipv 6-address on|off] [dhcp-settings network-prefix on|off] [auto-obtain-dns-ipv6 on|off] [eth1|et h2] [enable-ipv6-addressing on|off] [obtai n-using auto-ipv6|dhcpv6] Options dhcpv6-set[...]

  • Page 48

    IPv6 Commands 48 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Add Custom-IPv6 Description User Level Admin Syntax add custom-ipv6 [eth1|eth2] m ethod auto network-prefix < network_prefix > [prefix-bits <0-64> ] [router-advertisement on|off] add custom-ipv6 [eth1|eth2] method ma nual ipv6-address < ipv6_address> [prefix[...]

  • Page 49

    Server Commands 49 IPv6 Commands Set Custom-IPv6 Delete Custom-IPv6 Description Configures custom IPv6 network and IP addresses. User Level Admin Syntax set custom-ipv6 [eth1|eth2] < config_ip v6_address> method auto network-prefix < network_prefix > [prefix-bits <0-64> ] [router-advertisement on|off] set custom-ipv6 [eth1|eth2] &[...]

  • Page 50

    IPv6 Router Advertise ments 50 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 IPv6 Router Advertisement s Set IPv6-Router -Advertisement Show IPv6-Router-Advertisement Description Configures IPv6 rout er advertisements. User Level Admin Syntax set ipv6-router-advertisement [eth1|eth2] on|off [dhcpv6 off|on] [dhcpv6-cfg-options off|on] Opt[...]

  • Page 51

    IOLAN SDS/SCS/STS/MD C CLI Reference Guide, V ersion 3.7 51 User Commands Chapter 3 3 This chapter defines all the CLI commands avai lable to users who are logged into the IOLAN. Commands for Users Logged Into the IOLAN Admin Help Kill Line Kill Session Logout Description Changes a Normal-level user to the Admin user . When you press Enter after yo[...]

  • Page 52

    Commands for Users Logged Into the IOLAN 52 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Menu Ping Resume Rlogin Screen Description Switches from a command line based interface to Menu mode of operation. User Level Restricted, Normal, Admin Syntax menu Description This command checks to see if a given hos t is reachable via an IP messag[...]

  • Page 53

    User Commands 53 Commands for Users Logged Into the IOLAN Set T ermtype Set User Description Sets the type of terminal bei ng used for the current session. User Level Normal, Admin Syntax set termtype wyse60|vt100|ansi|dumb|tvi925|ibm3151t e|vt320|hp700|term1|term2| term3 Option wyse60|vt100|ansi|dumb|tvi925|ibm31 51te|vt320|hp700|t erm1|term2|term[...]

  • Page 54

    Commands for Users Logged Into the IOLAN 54 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set User Session rou ti n g Determines the ro uting mode used for RIP p a ckets on the PPP and SLIP interfaces for this user . V alues are: z None —RIP packets are neither received nor sent by the IOLAN. z Send —RIP packets can o nly be sent by [...]

  • Page 55

    User Commands 55 Commands for Users Logged Into the IOLAN Show Line Users SSH Description Shows the users who are on the line. User Level Admin Syntax show line users Description St arts an SSH session to th e specified host/IP address. User Level Normal, Admin Syntax ssh < hostname/IP_address > [< T CP_port >] [termtype < terminal_n[...]

  • Page 56

    Commands for Users Logged Into the IOLAN 56 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Syslog Console Show Sessions Show T ermtype Star t ssh-2-cipher -list Select the order of negotiation for the encrypt ion method (ciphers) that the IOLAN will use for the SSH version 2 connection: z 3DES z Blowfish z AES z Arcfour z CAST user The na[...]

  • Page 57

    User Commands 57 Commands for Users Logged Into the IOLAN Te l n e t Description Starts a telnet session to the specified host/IP address. User Level Normal, Admin Syntax telnet < hostname/IP_address > [< TCP_por t >] [termtype < terminal_name >] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof[...]

  • Page 58

    Configuring Users 58 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Ve r s i o n Configuring Users Add User Delete User escape 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 ). Description Displays firmware version and build . User Level Normal, [...]

  • Page 59

    User Commands 59 Configu ring 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 th e values of the va rious 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 para[...]

  • Page 60

    Configuring Users 60 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 framed-mtu 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 lar ge packets being transferred over the link, since there will be quicker r eco very from[...]

  • Page 61

    User Commands 61 Configu ring Users level The access that a user is allowed: z Admin —The admin level user has total access to the IOLAN. Y ou can create more than one admin user account but we recomm end t hat you only ha ve one. They can monitor and configure t he IOLAN. z Normal —The Normal level user has limite d access to the IOL AN. Limit[...]

  • Page 62

    Configuring Users 62 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set User sess-timer The amount of time, in seconds, that the Session Timer will run. Use t his timer to forcibly close a user ’ s sess ion (connection). When the Session Timer expires, the IOLAN will end the connection. The default value is 0 (zero), meaning that the se[...]

  • Page 63

    User Commands 63 Configu ring Users framed-compression Used for User Service PPP or SLIP , determines whether V an Jacobsen Compression is used on the link. VJ compression is a mean s of reducing the standard TCP/IP header from 40 octets to approximately 5 octets. This gi ves a significant performance improvement, particularly when interactive appl[...]

  • Page 64

    Configuring Users 64 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 hotkey-pre fix 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 —T o switch from one session to another, press ^a and then the required s[...]

  • Page 65

    User Commands 65 Configu ring Users netmask This is used for the PPP or SLIP Service type s. Only used for IPv4. If the remote user is on a sub net , e nter 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 maximu m of[...]

  • Page 66

    Configuring Users 66 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set User Session Show Default User Show User 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 >|* sessi on 1|2|3|4|* [auto on|off] [type off|telnet|rlogi[...]

  • Page 67

    IOLAN SDS/SCS/STS/MD C CLI Reference Guide, V ersion 3.7 67 Line Commands Chapter 4 4 This chapter defines all the CLI commands associat ed with configuring the IOLAN ’ s l ine parameters. 1-Port vs. 2-Port+ Line Commands If you are using a 1-port IOLAN, the admin user doe s not have the option of using the number or all (*) options in the line c[...]

  • Page 68

    Line Commands 68 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 connection-method Determines how a modem will wo rk on the line. Select from the following options: z Direct Connect —Indicates that the re is not a modem on the l ine. This is the default. z Dial In —Specify this option when a user is remote and wil l be dialing in via m[...]

  • Page 69

    Line Commands 69 Line Commands break 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 rem ot e —When the[...]

  • Page 70

    Line Commands 70 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 keepalive Enables a per -connection TCP keepalive f eature. After the configured number of seconds, the connection will send a gratuit ous ACK to the network peer , thus either ensuring the connection stays active OR cau sing a dro pped connection condition to be recognized. [...]

  • Page 71

    Line Commands 71 Line Commands stop-bits Specifies the number of stop bits that follow a byte. The 1.5 opt ion is only available on the 1-port and 2-port models, but not on the m odem of the SDS1M or SDS3M models. term-type Specifies the type of term inal connected to the line: z Dumb z WYSE60 z VT100 z ANSI z TVI925 z IBM3151 TE z VT320 (specifica[...]

  • Page 72

    Line Commands 72 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Line Interface The SCS, STS, and MDC IOLAN mo dels support the EIA-232 interf ace only . Therefor e, you do not need to specify interface eia-232 in the command syntax; you only need to specify the command options (e.g., monitor-dcd ). Description Configures line interfac[...]

  • Page 73

    Line Commands 73 Line Commands Set Line Service tx-driver-contr ol Used with a EIA-485 serial interface, if y our applica t ion supports RTS (Request T o Send), select this optio n. Otherwise, select Auto . Default is Auto . duplex Specify whether the line is Full Duplex (communication both ways at t he same time) or Half Duplex (communication in o[...]

  • Page 74

    Line Commands 74 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 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 > < hos[...]

  • Page 75

    Line Commands 75 Line Commands 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. reverse Enables a TCP/IP host to establish a login connection on an exte rnal machine att[...]

  • Page 76

    Line Commands 76 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Modem Set T ermtype client-initiated When this option is turned on, the IOLAN will wait for a connection from th e T ruePo rt host (see the TruePort documentation for in formation on how to set up this feature on the T ruePort host). When this option is turned off, the IO[...]

  • Page 77

    Line Commands 77 Line Commands Show Line Option wyse60|vt100|ansi|dumb|tvi925|ibm31 51te|vt320|hp700|t erm1|term2|term3 Specifies the type of term inal connected to the line: z Dumb z WYSE60 z VT100 z ANSI z TVI925 z IBM3151 TE z VT320 (specifically supp orting VT320-7) z HP700 (specifical ly supporting HP700/4 4) z T erm1, T erm2, T erm3 (user-def[...]

  • Page 78

    Line Service Commands 78 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Line Service Commands Set Custom-App Set Rlogin-Client Set T elnet-Client Description Y ou can create a custom application that can run on a specific se rial line in IOLAN using the Perle SDK. User Level Admin Syntax set custom-app line .|< number >|* prog ram-c[...]

  • Page 79

    Line Commands 79 Line Service Commands Set SSH-Client echo Defines the echo character . When Line Mode is On , typing the echo character echoes the text locally and sends only completed lines to the ho st. This value is in hexadecimal with a default value of 5 (ASCII value ^E ). eof Defines the end-of-file character . When Lin e Mode is On , enteri[...]

  • Page 80

    Line Service Commands 80 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 auto-login Creates an automatic SSH login, using the Name and Password values. name The user ’ s name when Auto Login is enabled. password The user ’ s password when Auto Login is enabled. ssh-1-cipher Select the encryption method (cipher) that you want to use fo [...]

  • Page 81

    Line Commands 81 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 < int eger >] [challenge-interval < integer >] [cr-ret ry < integer >] [cr-timeout < integer >] [[...]

  • Page 82

    Line Service Commands 82 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 ipaddr -neg Specifies whether or not IP address negotiatio n will take place. IP address negotiation is where the IOLAN allow s the remote end to sp ecify its IP address. The default value is Off . When On , the IP address specified by the remote en d will be used in [...]

  • Page 83

    Line Commands 83 Line Service Commands netmask The ne two rk s ub net mas k. F or ex amp le, 25 5.2 55. 0.0 . If your user is authenticated by RADIUS and the RADIUS parameter Fr amed-Netmask is set in the RADIUS file, the IOLAN will use the value in the RADIUS f ile in preference to the value configured here. password This field defines the passwor[...]

  • Page 84

    Line Service Commands 84 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 ruser This field is used to authenticate a user connect ing 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 us er database will be used to authent[...]

  • Page 85

    Line Commands 85 Line Service Commands Set PPP Dynamic-DNS Set SLIP Description This option is only available when IP address negotiation ( ipaddr-neg ) is on . When enabled, the IOLAN will automatically updat e the DNS server with the specified host name and negotiated IP address for the PPP sessi on. User Level Admin Syntax set ppp line .|< nu[...]

  • Page 86

    Line Service Commands 86 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set UDP 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 wi ll be overridden if you have set a Framed IP Add r[...]

  • Page 87

    Line Commands 87 Line Service Commands Set Vmodem both|in|out|none The direction in which inform ation is received or relayed: z None —UDP service not enabled. z In —LAN to serial. The IOLAN will listen on p ort value configured i n the DS Port parameter for messages coming from the learned or configured port. z Out —Serial to LAN. The IOLAN [...]

  • Page 88

    Line Service Commands 88 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 failure-string String that is sent to the serial device when a connection fails. If no string i s entered, then the string NO CARRIER will be sent. host The target host name. init-string Y ou can specify additio nal vmodem commands th at will affect how vmodem starts.[...]

  • Page 89

    Line Commands 89 Line Service Commands style One of the following: z V erbose —Return codes (strings) are se nt 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 ITERF ACE DOWN 7 CONNECTION REFUSED 8 NO LISTNER success-string String that is sent to th[...]

  • Page 90

    Line Service Commands 90 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Vmodem-Phone Set SSL Line Description This command associates a phone number wi th 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 e[...]

  • Page 91

    Line Commands 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 V alidat ion 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)[...]

  • Page 92

    Line Service Commands 92 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set SSL Line Cipher-suite Description Sets the SSL/TLS cipher s u ite parameters for the line. User Level Admin Syntax set ssl line .|< number >|* cip her-suite option1|option2|option3|option4|optio n5 encryption any|aes|3des|des|arcfour|a rctwo|none min-key-siz[...]

  • Page 93

    Line Commands 93 Line Service Commands Set Modbus-Slave Line Set Modbus-Master Line Description Sets the Modbus slave pa rameters for the line. User Level Admin Syntax set modbus-slave line .|< numb er >|* [crlf on|off] [protocol rtu|ascii] [uid-range < uid_r ange >] Options crlf When Modbus/ASCII is selected, adds a CR/LF to th e end o[...]

  • Page 94

    Line Service Commands 94 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Power-Management Line slave-ip The IP address of the TCP/Ethernet Modbus Slave. uid-range When Range Mo de is Hos t 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 IOLA[...]

  • Page 95

    Line Commands 95 Line Service Commands Set Multihost Line Set Line Initiate-Connection Show Custom-App Show Interface Show Power-Management Description Configures multiple host s or a primary/back up host schema fo r Silent Raw , Reverse Raw , or Client-In ititated T r uePort service types (multihos t must be enabled by the line service type for th[...]

  • Page 96

    Line Service Commands 96 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show PPP Show Rlogin-Client Show SLIP Show SSH-Client Show T elnet-Client Show Modbus Show UDP Show Vmodem Show Vmodem-Phone Description Shows the PPP line settings. User Level Admin Syntax show ppp line < number >|wirele ss-wan Description Show the rlogin-clien[...]

  • Page 97

    Line Commands 97 Modem Commands Modem Commands Add Modem Delete Modem Set Modem Show Modems Description Adds a modem. User Level Admin Syntax add modem < modem_name > < initi alization_string > Options < mo dem_name > The name of the modem. Do not use spaces. < initialization_st ring > The initialisation string of the modem;[...]

  • Page 98

    Email Commands 98 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Email Commands Set Email-Alert Line Description This command configur es email alert parameters for the line. User Level Admin Syntax set email-alert line < number > |* [from < email_addr >] [level emergency|alert|critical|e rror|warning|notice|info|debug] [mode [...]

  • Page 99

    Line Commands 99 Packet Forwarding Commands Show Email-Alert Line Packet Forwarding Commands Set Packet-Forwarding Line Description Shows how the line email alert is configured. User Level Admin Syntax show email-alert line < number > Description The Packet Forwarding feature allows you to control how the data coming from a serial device is p[...]

  • Page 100

    Packet Forwarding Commands 100 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 delay-between-messages The minimum time, in milliseconds, between mess ages that must pass before the data is forwarded by the IOLAN. The range is 0-65535. Th e default is 250 ms. custom-on-specific-events This section allows you to set a variety of packet defin[...]

  • Page 101

    Line Commands 101 Packet Forwarding Commands eof2 When enabled, creates a sequen ce of characters that must be received to define the end of the frame (if the EOF1 char acter is not immediately foll owed by the EOF2 character , the IOLAN waits for another EOF1 charact er to start the EOF1/EOF2 character sequence), which defines when the frame is re[...]

  • Page 102

    Packet Forwarding Commands 102 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show Packet-Forwarding Line Description Shows the packet-forward ing settings for the line. User Level Admin Syntax show packet-forwarding line < number >[...]

  • Page 103

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 103 Network Commands Chapter 5 5 This chapter defines all the CLI commands asso ciated with co nfiguring the IOLAN’ s network parameters. SNMP Commands Add Community Add T rap Description Adds an SNMP community (version 1 and version 2). User Level Admin Syntax add community < community_n[...]

  • Page 104

    SNMP Commands 104 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Delete Community Delete T rap Set SNMP Description Deletes an SNMP community (version 1 and version 2). User Level Admin Syntax delete community < config_comm unity_number > Option < config_community_number > When you add an SNMP communi ty , it gets assigned to [...]

  • Page 105

    Network Commands 105 SNMP Commands Set SNMP V3-Security Description Configures SNMP settings for the V ers ion 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-pas sword|privacy[...]

  • Page 106

    TFTP Commands 106 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show SNMP TFTP Commands Set Server TFTP Host s Commands Add Host Delete Host Description Shows SNMP settings, including communities and traps. User Level Admin Syntax show snmp Description Configures the IOLANs TFTP client settings. User Level Admin Syntax set server tftp [r[...]

  • Page 107

    Network Commands 107 DNS/WINS Commands Set Host Show Host s DNS/WINS Commands Add DNS Add WINS Description Configures a host in the IOLAN host table. User Level Admin Syntax set host < config_host > < IP_ad dress > set host < config_host > fqdn < text > Options < config_host > The name of the host. < IP_address >[...]

  • Page 108

    DNS/WINS Commands 108 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Delete DNS Delete WINS Show DNS Show Server Show WINS Description Deletes a DNS entry . User Level Admin Syntax delete dns < config_dns_addr > Option < config_dns_a ddr > Y ou can view a list of configured DNS server IP addresses to choose from by typing dele[...]

  • Page 109

    Network Commands 109 Gateway Commands Gateway Commands Add Gateway Description Adds a gateway . Y ou can configure up to twenty gateways. User Level Admin Syntax add gateway < config_host > def ault add gateway < config_host > host < dest_I P_addr > add gateway < config_host > network < dest_IPv4_addr >|< dest_IPv6_[...]

  • Page 110

    Gateway Commands 1 10 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Delete Gateway Set Gateway Show Gateways Description Deletes a gateway . User Level Admin Syntax delete gateway < config_gatewa y_host > Option < config_gateway_host > Y ou can view the configured gateways that can be deleted by typing delete gateway ? . Descr[...]

  • Page 111

    Network Commands 1 1 1 Logging Commands Logging Commands Set Syslog Show Syslog Description Configures the system log. User Level Admin Syntax set syslog [level emergency|alert|critical|er ror|warning|notice|info|debug] [primary-host < config_host >] [secondary-host < config_h ost >] Options level Choose the event level that triggers a [...]

  • Page 112

    RIP Commands 1 12 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 RIP Commands Add RIP Delete 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 > < end_time > Opt[...]

  • Page 113

    Network Commands 1 13 RIP Commands Set RIP Show RIP Description Configures the RIP MD5 key . After p ressing 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-a nd-listen] set rip password set rip md5 < config_md5_id > [end < date >[...]

  • Page 114

    IPsec Commands 1 14 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Show RIP Peers IPsec Commands Once there is an active VPN tunnel , the IOLAN expects all connections to be established through a VPN tunnel. T o allows hosts to connect outside of t he VPN tunnel, you must configure VPN exceptions, see VPN Exceptions on pa ge 121 for the co[...]

  • Page 115

    Network Commands 1 15 IPsec Commands Options authentication-method Specify the authentication metho d that will be used between VPN peers to authenticate the VPN tunnel. Data Options: z Shared Secr et —A text-based secret that is used to authenticate the IPsec tunnel (case sensitive). z RSA Signature —RSA signatures are used to au thenticate th[...]

  • Page 116

    IPsec Commands 1 16 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 remote-external-ip-address When NA T T raver sal (NA T_T) is enabled, the remote VPN’ s public external IPv4 or IPv6 address or FQDN. If you want to accept a VPN connect ion from any host/network, you can enter %any in this field. remote-host -nextwork The IPv4 or IPv6 ad[...]

  • Page 117

    Network Commands 1 17 IPv6 T unnels Show IPsec IPsec IPv6 T unnels Add IPv6tunnel email Up to a 64 character entry for an email address; for example, acct@anycompany .com. This field is case sensitive in order to succe ssfully match th e information in the remote X.509 certificate. An asteri sk (*) works as a wildcard. secret When the Authenticatio[...]

  • Page 118

    IPv6 T unnels 1 18 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Set IPv6tunnel Show IPv6tunnel Delete IPv6tunnel Description Configures the speci fied IP v6 tunnel. User Level Admin Syntax set ipv6tunnel < config_tunnel _name > [mode manual|teredo|6to4] [gateway < interface >] [remote-host < c onfig_host >] Options mode[...]

  • Page 119

    Network Commands 1 19 L2TP/IPsec L2TP/IPsec Once L2TP/IPsec is enabled, the IOLAN expects all conn ections to be estab lished through a VPN tunnel. T o allows hosts to connect outsid e 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 Syntax set l2tp li[...]

  • Page 120

    L2TP/IPsec 120 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 country A two character country code; fo r example, US. This field is case sensitive in order to successfully match the information in the re mote X.509 certificate. An asterisk (*) works as a wildcard. state-province Up to a 128 character entry for the s tate/pr ovince; for ex[...]

  • Page 121

    Network Commands 121 VPN Exceptions Show L T2P VPN Exceptions VPN exceptions allows specific hosts or any host in a network to conn ect to the IOLAN outside of a VPN tunnel. Add VPN Exception Set VPN Exception authentication- type Specify the authentication method that will be used for the L2TP tunnel. Data Options: CHAP , P AP , Both Default: Both[...]

  • Page 122

    VPN Exceptions 122 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Delete VPN Exception Show VPN Exception host-ip < ipv4/ipv6_address > The IP address of the host that will comm unicate with the IOLAN outside of the VPN tunnel. Field Format: IPv4 or IPv6 address Description Deletes a VPN exception. T o see a list of configured VPN e[...]

  • Page 123

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 123 T i me Commands Chapter 6 6 This chapter defines all the CLI commands a ssociated with configuring the IOLAN’ s time parameters. Server Commands Set T ime Set T imezone Show Time Show T imezone Description Sets the IOLAN’ s system clock. User Level Admin Syntax set time < hh : mm [:[...]

  • Page 124

    SNTP Commands 124 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 SNTP Commands Add SNTP Delete SNTP Set SNTP Description Adds an SNTP server . User Level Admin Syntax add sntp [server-1 < config_ho st >] [server-2 < config_host >] Options server -1 The name of the primary SNTP server from the IOLAN host table. V alid with U nic[...]

  • Page 125

    T ime Commands 125 T ime/Date Setti ng Commands Show SNTP Show SNTP-Info T ime/Date Setting Commands Set Date Set Summertime server -1 The name of the primary SNTP server from the IOLAN host table. V alid with U nicast and Multicast modes, although in Multicast mode, the IOLAN will only accept broadcasts from the speci fied host SNTP server . serve[...]

  • Page 126

    T ime/Date Settin g Commands 126 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 Set Summertime Fixed Set Summertime Recurring 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. Description Sets the summertime clock to star[...]

  • Page 127

    T ime Commands 127 T ime/Date Setti ng Commands Show Date Show Summertime end-time The time to end summer time and start stan dard 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. Description Shows the date, according to the IOLAN system clock. User Level Normal, Admin Syn[...]

  • Page 128

    T ime/Date Settin g Commands 128 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7[...]

  • Page 129

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 129 Administration Commands Chapter 7 7 This chapter defines all the CLI commands associ ated with configuring the IOLAN ’ s ad ministration parameters. Bootup Commands Reboot Reset Reset Factory Save Description Reboots the IOLAN. Y ou will be prompted to save configuration to FLASH, if the[...]

  • Page 130

    TFTP File Transfer Commands 130 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set Bootup Show ARP Show Bootup TFTP File T ransfer Commands Netload 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 < hos tname > [file < path_filena[...]

  • Page 131

    Administration Commands 131 TFTP File T ransfer Commands Net save configuration Specifies that you are going to download a new configuration file to the IOLAN. customlang Specifies that you are going to download a custom language file to th e IOLAN. term1|term2|term3 Y ou can create and download up to three cu stom terminal definitions to the IOLAN[...]

  • Page 132

    Custom Factory Default 132 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Custom Factory Default Netload Set < filename > The complete path and file name fo r the file you are uploading from the IOLA N (this path should be relative to the default path of your TFTP server, wh ich may or may not allow drive letters). Description T ran[...]

  • Page 133

    Administration Commands 133 Keys and Certificates Commands Keys and Certificates Commands Netload Description Loads certificates and keys into the IOLAN. User Level Admin Syntax netload https certificate|pri vate-key < hostname/IP_address > < filename > netload ldap certificate < hostname/IP_ address > < filename > netload s[...]

  • Page 134

    Keys and Certificates Commands 134 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Net save ipsec < tunnel_name > When you config ure 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 > Ente[...]

  • Page 135

    Administration Commands 135 MOTD Commands MOTD Commands Set MOTD Show MOTD Description Specifies the server/file that contains the mes sage of the da y (MOTD) that is displayed when users log into the IOLAN. Y ou 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[...]

  • Page 136

    MOTD Commands 136 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7[...]

  • Page 137

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 137 S t atistics Commands Chapter 8 8 This chapter defines all the CLI commands asso ciated with co nfiguring the IOLAN’ s statistics parameters. Configuration S t atistics Show Net stat Show Net st at S tatistics Description Shows currently used TCP/UDP sockets/ports. User Level Admin Synta[...]

  • Page 138

    Run-T i me S tatistics 138 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show Modbus St atistics Show Routes Run-T ime St atistics Delete Arp Show Arp Show Serial Uptime Description Shows the Modbus statistics. User Level Admin Syntax show modbus statistics master -tcp line *|< number > show modbus statistics master-udp lin e *|<[...]

  • Page 139

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 139 IOLAN+ User Commands Chapter 9 9 Y ou can configure the IOLAN us ing 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[...]

  • Page 140

    IOLAN+ 140 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7[...]

  • Page 141

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 141 I/O Commands Chapter 10 10 This chapter defines all the CLI commands associat ed with configuring the IOLAN’ s I/O parameters. Global I/O Commands Set IO UDP Description Sets the UDP settings fo r I/O unicast messages. User Level Admin Syntax set io udp [mode on|off] [broadcast-interval [...]

  • Page 142

    Set Line 142 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IO Failsafe Set IO Modbus Set IO T emperature-Scale Set Line Set Line Service 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 T imer . This [...]

  • Page 143

    I/O Commands 143 Set IOChannel Set IOChannel Set IOChannel Mode Set IOChannel Digit al I/O Description Sets general I/O channel set tings for the sp ecified 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 >] Op[...]

  • Page 144

    Set IOChannel 144 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IOChannel Digit al Input Description Sets the Digital input settings for the channel. User Level Admin Syntax set iochannel < digital_channe l > [alarm [trigger disabled|inactive-inp ut|active-input] [clear auto|manual] [email on|off] [syslog on|off] [snmp on|off]][...]

  • Page 145

    I/O Commands 145 Set IOChannel Set IOChannel Digit al Input (Serial Pins) Description Sets the Digital input settings for serial pi ns CTS, DSR, and DCD. This option is onl y available when the Line Service is set to Signal I/O . User Level Admin Syntax set iochannel cts|dsr|dcd [alarm [trigger disabled|inactive-inpu t|active-input] [clear auto|man[...]

  • Page 146

    Set IOChannel 146 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IOChannel Digit al Output latch Latches (remembers) the activity transition ( active-to-inactive or inactive-to-active). The latched status is maintained until it is read. Once it i s read, it will revert to the current status. The default is disabled. Description Sets t[...]

  • Page 147

    I/O Commands 147 Set IOChannel Set IOChannel Digit al Output (Serial Pins) output Specify how the chan nel output will be handled: z Manual —Y ou must manually manipulate the ch annel output. z Pulse —Activates and deactivates the channel out put activity in intervals after it is manually activat ed. z Inactive-to-A ctive De lay —The channel [...]

  • Page 148

    Set IOChannel 148 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IOChannel Relay Description Sets the Relay output channel settings. User Level Admin Syntax set iochannel < relay_number > output [pulse continuous|counted <pulse_coun t>] [active-to-inactive-delay < delay >] [inactive-to-active-delay < delay >] s[...]

  • Page 149

    I/O Commands 149 Set IOChannel Set IOChannel Analog (T rue Analog) Description Sets the Analog input channel settings. User Level Admin Syntax set iochannel < analog_channel > type cu rrent|voltage range < range_specifier > set iochannel < analog_channel > alarm [level 1|2|3|4|5 [mode on|off] [trigge r-type disabled|low|high] [tri[...]

  • Page 150

    Set IOChannel 150 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IOChannel Analog (T emperature) trigger - level Specify the value that will trigger an ala rm, the measurement is based on the Ty p e and Range that you specify . This value must not fall within the scope of the value used to clear an alarm. clear -mode Specifies whether[...]

  • Page 151

    I/O Commands 151 Set IOChannel range Specify the temperature range that you wa nt to measure. For R TD, t he range is: z 1 (Pt100 a=385 -50 to 150C) Th is 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 (P[...]

  • Page 152

    Set IOChannel 152 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IOChannel IOExtension clear -mode Specifies whether an act ivated alarm must be Manually cleared, or can be cleared when the input drops below th e specified value (when Tr i g g e r Ty p e is High ) or goes above the specified value (when Tr i g g e r Ty p e is Low ). c[...]

  • Page 153

    I/O Commands 153 Set IOChannel enabled When enabled, the di gital input channel o r DSR/DCD/CTS input serial signal pins can be connected to: z A Digital output or relay (if the I/O model suppo rts relay) channel on the same IOLAN z Output Serial Si gnal Pins (DTR/R TS) z A Digital output channel on anot her IOLAN(s) or output serial signal pins (D[...]

  • Page 154

    Set IOChannel 154 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Set IOChannel Multihost server -initiated tcp-port The TCP Port that the channe l/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 mult ihost all|backup[...]

  • Page 155

    I/O Commands 155 Set IOChannel Set IOChannel IOExtension SSL Show IOChannel S t atus Kill IOChannel 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 90 . User Level Admin Syntax set iochannel < channe[...]

  • Page 156

    I/O Channel Control Commands 156 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 Show IO Show IOChannel I/O Channel Control Commands The I/O commands in this section are used to manual ly manage the I/O channels. Digit al Output Description Shows global I/O information (for example, UDP , TruePort, Modbus). T emperature I/O is Analog. User[...]

  • Page 157

    I/O Commands 157 Calibrating Analog I nput (Analog/T empera ture) Digit al Input Relay Analog Input Calibrating Analog Input (Analog/T emperature) Calibrate Analog Reset Calibration Description Manages the Digital input channe l status. User Level Admin Syntax iochannel d1|d2|d3|d4|rts|dtr output activate|deactivate Option output Manually activates[...]

  • Page 158

    Calibrating Analog I nput (Analog/T empera ture) 158 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7[...]

  • Page 159

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 159 Power Commands Chapter 11 11 This chapter defines all the CLI commands a ssociated 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 > [pl ug < number | rang[...]

  • Page 160

    Power Commands 160 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7[...]

  • Page 161

    IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersion 3.7 161 Glossary This chapter provides definitions for IOLAN terms. BOOTP (BOOT strap Protocol) 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 en[...]

  • Page 162

    162 IOLAN SDS/SCS/STS/MDC CLI Reference Guide, V ersio n 3.7 P AP (Password Authentication Protocol) Standard authentication protocol for PPP connections. see CHAP RADIUS (Remote Authentication Dial In Users Services) An open standard network securit y server that communicates wi th the P AP protocol. Reverse Connection Connections that originat e [...]