Scannex ip.buffer User manual

ip.buffer Manual
25th March 2013
Firmware Version 2.80

ip.buffer Manual
Date Author Release
2007-06-21 MP For version 1.00
...
2008-05-02 MP For version 2.00
2008-06-16 MP For version 2.10
2008-08-29 MP For version 2.20
2008-09-03 MP For version 2.21
2008-12-12 MP For version 2.30
2009-0 -15 MP For version 2. 0
2009-09-22 MP For version 2. 1
2010-02-02 MP For version 2.50
2010-07-28 MP For version 2.60
2011-0 -1 MP For version 2.70
Added 8V schematic details
2012-02-08 MP For version 2.75
2012-07-10 MP For version 2.76
2013-03-25 MP For version 2.80
Reformatting
Removed HTTP info
Copyright © UK 2007-2013 Scannex Electronics Limited. All rights reserved worldwide.
Scannex Electronics Ltd, UK
t [phone]
f [phone]
http //www.scannex.co.uk
[email protected]
Scannex LLC, USA
t 1-866-4BUFFER
(1-866-428-3337)
http //www.scannex.com
[email protected]

Table of Contents
1.Introduction...............................................1
1.1.The Range............................................1
1.2.Features..............................................1
1.3.Block Diagrams......................................3
1.3.1.System Overview..............................3
1.3.2.Source...........................................
1.3.3.Destination.....................................5
1. .Firmware.............................................6
1. .1.Crypto-Free....................................6
1. .2.SSL...............................................6
2.GPRS (Cellular) Modem..................................7
2.1.GPRS Safety Precautions...........................7
2.1.1.GPRS Radiation Exposure Statements......7
2.2.Installing a SIM card................................8
2.3.Installing the antenna..............................8
3.Fitting Batteries..........................................9
3.1.1.Battery Precautions...........................9
3.1.2.Installing in an ip.1..........................10
3.1.3.Installing in an ip. ..........................11
.Physical Mounting.......................................12
.1.ip.1 – plastic box..................................12
.1.1.DIN Rail Mounting............................12
.1.2.Wall mounting................................12
.2.ip. – metal case..................................12
5.Installation...............................................13
5.1.Connections........................................13
5.2.Getting Started....................................1
5.3.Forgotten passwords & factory defaults.......15
6.Front Panel...............................................16
7.Status Web page.........................................18
7.1.Channel: Source...................................18
7.2.Channel: Storage..................................18
7.3.Channel: Destination..............................19
7. .Modem..............................................19
7.5.System..............................................19
8.SETUP.....................................................20
8.1.Web Interface......................................20
8.2.Global: Settings....................................21
8.2.1.Network.......................................21
8.2.2.Time...........................................26
8.2.3.Power..........................................27
8.2. .Modem.........................................28
8.2.5.Modem Out...................................30
8.2.6.SMTP Email Servers..........................3
8.2.7.Alerts..........................................36
8.2.8.Alert List......................................39
8.2.9.RADIUS......................................... 0
8.2.10.Certificates for SSL/TLS and SSH........
8.2.11.FTP........................................... 6
8.2.12.Web........................................... 8
8.2.13.Cloud Server................................50
8.3.Date and Time Synchronize......................52
9.Channels..................................................53
10.Sources..................................................56
10.1.COM Serial........................................56
10.1.1.Settings......................................56
10.1.2.Connection to a PC serial port...........59
10.1.3.When using a Y-lead.......................59
10.2.TCP.................................................60
10.2.1.Match, Send & Heartbeat special
characters............................................61
10.3.UDP.................................................62
10.3.1.Syslog Collection...........................62
10.3.2.SNMP Trap Collection......................62
10.3.3.RADIUS Accounting Collection............6
10. .FTP Server.........................................65
10. .1.FTP Server Notes...........................66
10.5.None...............................................66
10.6.Common Modules................................67
10.6.1.Protocol......................................67
10.6.2.Protocol: ASCII Lines.......................69
10.6.3.Protocol: Alcatel TCP/IP [port 2533]....70
10.6. .Protocol: Avaya RSP TCP/IP...............71
10.6.5.Protocol: Binary (full 8-bit)...............71
10.6.6.Protocol: Generic Records................72
10.6.7.Protocol: Inter-Tel/Mitel Axxess & 5000
TCP/IP [port 000]..................................75
10.6.8.Protocol: iSDX binary......................76
10.6.9.Protocol: NEC (STX/ETX) Serial.........76
10.6.10.Protocol: NEC NEAX TCP/IP.............78
10.6.11.Protocol: Nortel BCM Live TCP/IP......79
10.6.12.Protocol: Nortel Meridian & Norstar...80
10.6.13.Protocol: Panasonic KX-TD TCP/IP [port
2300]..................................................82
10.6.1 .Protocol: Philips FDCR TCP/IP [port
2599]..................................................82
10.6.15.Time Stamping............................83
10.6.16.Extra tokens for delivery filenames....85
10.6.17.Pass-through...............................86
10.6.18.Notification................................89
11.Destinations............................................90
11.1.Email push (SMTP client).......................90
11.2.HTTP POST to Cloud Server....................91
11.3.FTP Server.........................................92
11.3.1.Supported FTP server commands........93
11. .FTP Push (client).................................9
11. .1.Overwrite and Append.....................96
11. .2.Tmp File & Rename mode................96
11.5.TCP Server (passive).............................97
11.6.TCP Push (active/client)........................98
11.7.COM port serial.................................100
11.8.Legacy Emulation (TCP Server)...............102
11.9.None..............................................103
11.10.Destination Common Modules...............10
11.10.1.Data Markers.............................10
11.10.2.Data Security.............................10
11.10.3.Push Triggers.............................105
12.Storage.................................................107
13.Tools....................................................108
13.1.General...........................................108
13.1.1.Live Record View..........................108
13.1.2.Storage Counters..........................109

13.1.3.Reboot Lua.................................109
13.1. .Reboot ip.buffer (cold boot)............109
13.1.5.Battery off (shutdown)...................109
13.2.Modem...........................................110
13.2.1.Clear timers...............................110
13.2.2.Hangup & Reset / Hangup & Power cycle
.......................................................110
13.3.Source, Pass-through, and Destination......110
13. .Network..........................................111
13. .1.Ping a device..............................111
13. .2.Listening Ports.............................111
13. .3.Network Tables............................111
13.5.Log................................................111
13.5.1.View Log....................................111
13.5.2.Send Log to Cloud Server................111
13.6.System............................................112
13.6.1.Upgrade Firmware........................112
13.6.2.Check for Updates........................113
13.6.3.System Memory...........................113
13.6. .Diagnostics Dump.........................113
1 .Advanced Setup......................................11
1 .1.Configuration (Advanced).....................11
1 .1.1.Edit..........................................11
1 .1.2.Ad hoc change.............................115
1 .1.3.Download...................................115
1 .1. .Upload......................................115
1 .2.Script.............................................116
1 .2.1.Edit..........................................116
1 .2.2.Download...................................116
1 .2.3.Upload......................................116
1 .3.Server Certificate..............................117
1 .3.1.Generate...................................117
1 .3.2.Upload......................................118
1 .3.3.Download server certificate............118
1 .3. .Download SSH publickey.................118
15.Advanced Topics......................................119
15.1.Replication of settings.........................119
15.2.Lua extensions..................................119
15.2.1.Alert System...............................119
15.2.2.Delivery Trigger System..................120
15.2.3.Comments within Lua code.............120
15.2. .Sending data to the channel source. . .120
15.3.Example scripts.................................121
15.3.1.Simple prefix..............................121
15.3.2.Duplicating data..........................122
15.3.3.Discarding data............................122
15.3. .Masking telephone digits................123
15.3.5.Upgrading Firmware – the Last Resort.12
16.SNMP Traps............................................125
16.1.Trap List..........................................125
16.2.Variable Bindings...............................126
17.SNMP Agent OID List..................................127
18.Cloud Server HTTP Implementation...............128
19.Licenses................................................129
19.1.Lua License......................................129
19.2.zlib License......................................129
19.3.X509 certificate generation license.........130
19. .SNMP Trap Decoding............................131
20.Specifications.........................................132
21.Optional 8V Power Supply.........................133
21.1.Two-pin connector..............................133
21.2.Schematic........................................133
22.PSTN Modem Country Codes and Approvals......13
23.Safety Warnings.......................................136
23.1.Optional AA Battery Caution..................136
23.2.Real Time Clock Battery Caution.............136
23.3.Ethernet Ports Caution........................136
23. .Power Supply Caution..........................137
23. .1.Scannex Approved PSUs..................137
23.5.General Warnings...............................137
23.6.Modem Caution (if fitted).....................137
23.7.A note about Power Connection, Surge
Protectors, and lightning............................137
23.8.South Africa.....................................137
2 . Approvals.............................................138
2 .1.EMC...............................................138
2 .2.Safety.............................................138
2 .3.Environmental...................................138
2 . .PSTN Modem.....................................138
2 .5.GPRS Modem....................................138
2 .6.Export Control..................................138
2 .7.European Union (EU) Statement.............139
2 .7.1.EMC, Safety, and R&TTE Directive
Compliance.........................................139
2 .7.2.Network Compatibility Declaration....139
2 .8.Deutsch..........................................139
2 .9.USA...............................................1 0
2 .9.1.FCC Registration Information...........1 0
2 .9.2.Repair Information........................1 0
2 .9.3.FCC Rules Part 15 - Computing Devices
.......................................................1 1
2 .9. .GPRS Modem...............................1 1
2 .10.Canada..........................................1 2
2 .10.1.Industry Canada Information..........1 2
2 .10.2.GPRS Modem.............................1 2
2 .10.3.Industry Canada Regulatory Compliance
Information for Class B Equipment.............1 3
25.European Union Waste Electrical and Electronic
Equipment (WEEE) Statement..........................1
25.1.UK Users.........................................1
25.2.European Users (outside the UK).............1
25.3.Manufacturer/Responsible Party.............1

Scannex ip.buffer User Manual
© UK 2007-2013 Scannex Electronics Ltd. All ri hts reserved worldwide.
1 . I n tr o d u c t io n
1.1. The Range
The ip.buffer is designed to collect and store information from such devices as telephone
PBXs – for CDR/SMDR collection, for alarm and traffic management, and to allow pass-
through access for moves and changes.
The product range includes three main devices:
•ip- = 128Mbyte memory with serial ports
•ip-1 = 32Mbyte memory with 1 serial port
The ip- device includes internal temperature monitoring, built in global or GPRS modem,
plus the SEbus expansion connector. They also have an option for 8VDC power (see Section
21). They are both built inside a metal box that can be rack mounted in a 1U high bay.
The ip-1 device has an optional global PSTN or GPRS modem and is housed in a plastic
casing with facilities for wall mounting, tie-wrapping, and DIN rail mounting.
All three devices allow battery backup using 3 standard AA NiMH batteries. With fully
charged cells the unit can continue to operate for approximately 2 hours.
1.2. Features
All devices have proprietary Scannex features and advanced facilities:
•Collection
oAuto pin detection on the serial ports1
oAuto baud rate and protocol detection on the serial ports
oCollection from serial and TCP/IP enabled devices2
oCollection from devices that perform FTP push
oCollection of UDP data including syslog information, SNMP Traps (with trap
decoding and SNMP get queries on connected devices), and
RADIUS Accounting
oSupport for ASCII, Binary and iSDX data sources
oAutomatic partitioning of NAND flash memory with optional settings for
limiting memory sizes of each channel
•Various delivery options including:
oHTTP/HTTPS post to web Cloud Server
oFTP/SFTP push
oFTP server
1 The detection is performed using voltage sensing, so the ip.buffer can detect whether the data
source is DCE or DTE wired even with no data
2 Each ip.buffer can collect data from as many TCP/IP devices as there are serial ports. Each
channel can be assigned to either the serial port or a TCP/IP or UDP/IP collection.
Page 1

Scannex ip.buffer User Manual
© UK 2007-2013 Scannex Electronics Ltd. All ri hts reserved worldwide.
oEmail/SMTP push
oTCP/IP push
oTCP/IP server
oCOM port serial
•LAN and management features
oFully web-based setup and status information
o“Reflective Routing” on the LAN to allow easy access from different subnets3
oEmail, HTTP POST, and SNMP alert mechanisms to enable a pro-active
system
oExtremely powerful Lua4 scripting engine
oSNTP (Simple Network Time Protocol) time synchronisation with daylight
saving option
oSettings can be quickly replicated across multiple ip.buffers for bulk
installations
oAll changes to the settings occur immediately – no need for reboot5
oFully fail-safe firmware upgrades. The power can fail at any point in the
upgrade process and the ip.buffer will recover with the old version (or the
new version if successfully uploaded).
oSimple SNMP v1/v2c agent to provide inventory information to SNMP clients
oCentralised updates via standard web-server (See section Error: Reference
source not found)
oSupports Proxy servers running HTTP, SOCKS 5 and SOCKS a protocols.
•Security features
oOption to authenticate to one or two RADIUS servers
ohttps (SSL) access for web pages (optional) (See section 8.2.12)
oSSL/TLS link encryption for HTTP post, FTP, email, and TCP connections
(optional) (See section 11)
oSFTP/SSH encryption for SFTP push (See section 11. )
oAdditional Scannex 0-bit encryption for further security of the transported
data
3 In practise it means you do not have to have a gateway address, or the correct gateway,
programmed in the ip.buffer when connecting into it for web services and the like.
4 See www.lua.org However, several extensions have been applied to the Lua base.
5 Even Lua script changes can occur while the ip.buffer is still running
Page 2

Scannex ip.buffer User Manual
© UK 2007-2013 Scannex Electronics Ltd. All ri hts reserved worldwide.
1.3. Block Diagrams
1.3.1. System Overview
Conceptual view of the ip.buffer (ip. -128m):
The ip.buffer is “channel based” with each channel allowing separate collection and
delivery methods.
Page 3
Alerts
SNMP Agent
SNMP Trap
Sender
Modem
Manager
Web Server
SNTP Client
(Time Sync)
SMTP Client
(Email)
HTTP Client
(Web post)
RADIUS
Client
Lua Core – configuration, scripts, notifications
System
Health
Monitoring
Log Files
Secret Store
Channel #
Source StorageLua Script Destination
Pass-
through Protocol
Channel #2
Source StorageLua Script Destination
Pass-
through Protocol
Channel #3
Source StorageLua Script Destination
Pass-
through Protocol
Channel #1
Source StorageLua Script Destination
Pass-
through Protocol

Scannex ip.buffer User Manual
© UK 2007-2013 Scannex Electronics Ltd. All ri hts reserved worldwide.
1.3.2. Source
The four source collection modules run independently. Each source can collect from a
different source device, and the ip.buffer allows any mix of serial, TCP, UDP or FTP across
the four channels.
Although the ip.buffer is “channel based” with custom Lua scripting it is possible to send
data across to other channels. For example, one physical data source (e.g. COM port) may
contain a mixture of CDR, and Alarms information – custom Lua scripting can split this
information into two channel storage areas.
Page
Source x 4
Serial
TCP/IP
Client
Server
FTP Server
UDP/IP
RAW
SNMP Trap
Radius
Accounting
Syslog

Scannex ip.buffer User Manual
© UK 2007-2013 Scannex Electronics Ltd. All ri hts reserved worldwide.
1.3.3. Destination
The four destination delivery modules also run independently. Each destination can deliver
using a different method. Or, they can use the same method (e.g. FTP Push) but deliver to
a different central server. Each channel can be configured to use any combination of
LAN/WAN/DSL or Modem interfaces.
Page 5

Scannex ip.buffer User Manual
© UK 2007-2013 Scannex Electronics Ltd. All ri hts reserved worldwide.
1.4. Firmware
The firmware is available in two variants:
1.4.1. Crypto Free
The Crypto-Free firmware variant has no SSL/TLS options or code. It is provided to comply
with certain export/import restrictions around the world. Even if the internal configuration
requests SSL/TLS it will not use SSL/TLS – the cipher code is not built into this firmware
version.
The firmware is labelled IPBCFx.xx.xx where x.xx.xx is the version number.
The version number at the footer of each web page will have the marking “IPBCF”.
The CF / Crypto-free version will not show any of the SSL/TLS options on the
web setup pages.
1.4.2. SSL
The SSL firmware variant has full SSL/TLS6 code and web options.
The firmware is labelled IPBSSLx.xx.xx where x.xx.xx is the version number.
It is your responsibility to check with your country’s current laws before
downloading and using the SSL firmware variant in the ip.buffer! Some
countries have severe penalties – you ave been warned! Additionally, if you
are re-exporting an ip.buffer you must comply with all local export
regulations. Scannex can assume no liability or responsibility for the use or
misuse of the SSL variant.
In addition, the SSL version includes facilities for generating RSA certificates, as well as
tools to upload device and vendor certificates and keys.
The version number at the footer of each web page will have the marking “IPBSSL”.
6 SSL version 3 (with support for SSL version 2 “hello”) and TLS version 1.0
Page 6