Siemens RUGGEDCOM ROS User manual

RUGGEDCOM ROS
v4.3
User Guide
For RMC30
07/2016
Preface
Introduction 1
Using ROS 2
Device Management 3
System Administration 4
Setup and Configuration 5
Troubleshooting 6
RC1271-EN-03

RUGGEDCOM ROS
User Guide
ii
Copyright © 2016 Siemens Canada Ltd
All rights reserved. Dissemination or reproduction of this document, or evaluation and communication of its contents, is not authorized
except where expressly permitted. Violations are liable for damages. All rights reserved, particularly for the purposes of patent application or
trademark registration.
This document contains proprietary information, which is protected by copyright. All rights are reserved. No part of this document may be
photocopied, reproduced or translated to another language without the prior written consent of Siemens Canada Ltd.
Disclaimer Of Liability
Siemens has verified the contents of this document against the hardware and/or software described. However, deviations between the product
and the documentation may exist.
Siemens shall not be liable for any errors or omissions contained herein or for consequential damages in connection with the furnishing,
performance, or use of this material.
The information given in this document is reviewed regularly and any necessary corrections will be included in subsequent editions. We
appreciate any suggested improvements. We reserve the right to make technical improvements without notice.
Registered Trademarks
RUGGEDCOM™ and ROS™ are trademarks of Siemens Canada Ltd.
Other designations in this manual might be trademarks whose use by third parties for their own purposes would infringe the rights of the
owner.
Third Party Copyrights
Siemens recognizes the following third party copyrights:
• Copyright © 2004 GoAhead Software, Inc. All Rights Reserved.
Open Source
RUGGEDCOM ROS contains Open Source Software. For license conditions, refer to the associated License Conditions document.
Security Information
Siemens provides products and solutions with industrial security functions that support the secure operation of plants, machines, equipment
and/or networks. They are important components in a holistic industrial security concept. With this in mind, Siemens' products and solutions
undergo continuous development. Siemens recommends strongly that you regularly check for product updates.
For the secure operation of Siemens products and solutions, it is necessary to take suitable preventive action (e.g. cell protection concept) and
integrate each component into a holistic, state-of-the-art industrial security concept. Third-party products that may be in use should also be
considered. For more information about industrial security, visit http://www.siemens.com/industrialsecurity .
To stay informed about product updates as they occur, sign up for a product-specific newsletter. For more information, visit http://
support.automation.siemens.com .
Warranty
Refer to the License Agreement for the applicable warranty terms and conditions, if any.
For warranty details, visit www.siemens.com/ruggedcom or contact a Siemens customer service representative.

RUGGEDCOM ROS
User Guide
iii
Contacting Siemens
Address
Siemens Canada Ltd
Industry Sector
300 Applewood Crescent
Concord, Ontario
Canada, L4K 5C7
Telephone
Toll-free: 1 888 264 0006
Tel: [phone]
Fax: [phone]
E-mail
[email protected]
Web
www.siemens.com/ruggedcom

RUGGEDCOM ROS
User Guide
iv

RUGGEDCOM ROS
User Guide

Table of Contents
v
Table of Contents
Preface ............................................................................................................ xi
Conventions ........................................................................................................................................ xi
Related Documents ............................................................................................................................. xii
System Requirements ......................................................................................................................... xii
Accessing Documentation ................................................................................................................... xii
Training ............................................................................................................................................ xiii
Customer Support .............................................................................................................................. xiii
Chapter 1
Introduction ..................................................................................................... 1
1.1Features and Benefits ................................................................................................................... 1
1.2Security Recommendations and Considerations ............................................................................... 2
1.2.1Security Recommendations ................................................................................................. 2
1.2.2Credential Files .................................................................................................................. 4
1.2.2.1SSL Certificates ....................................................................................................... 5
1.2.2.2SSH Key Pairs .......................................................................................................... 7
1.3Supported Networking Standards ................................................................................................... 8
1.4Available Services by Port .............................................................................................................. 8
1.5SNMP Management Interface Base (MIB) Support .......................................................................... 11
1.5.1Supported Standard MIBs ................................................................................................. 11
1.5.2Supported Proprietary RUGGEDCOM MIBs .......................................................................... 12
1.5.3Supported Agent Capabilities ............................................................................................ 12
1.6SNMP Traps ................................................................................................................................ 13
1.7ModBus Management Support ..................................................................................................... 14
1.7.1ModBus Function Codes ................................................................................................... 15
1.7.2ModBus Memory Map ...................................................................................................... 16
1.7.3ModBus Memory Formats ................................................................................................. 21
1.7.3.1Text ..................................................................................................................... 21
1.7.3.2Cmd ..................................................................................................................... 22
1.7.3.3Uint16 .................................................................................................................. 22
1.7.3.4Uint32 .................................................................................................................. 22
1.7.3.5PortCmd ............................................................................................................... 22
1.7.3.6Alarm ................................................................................................................... 23
1.7.3.7PSStatusCmd ......................................................................................................... 24
1.7.3.8TruthValues .......................................................................................................... 24


Table of Contents
RUGGEDCOM ROS
User Guide
vi
1.8SSH and SSL Keys and Certificates ................................................................................................ 25
1.8.1Certificate and Keys Life Cycle ........................................................................................... 25
1.8.2Certificate and Key Requirements ...................................................................................... 26
Chapter 2
Using ROS ....................................................................................................... 29
2.1Connecting to ROS ...................................................................................................................... 29
2.1.1Connecting Directly .......................................................................................................... 29
2.1.2Connecting via the Network ............................................................................................. 30
2.2Logging In .................................................................................................................................. 31
2.3Logging Out ............................................................................................................................... 32
2.4Using the Web Interface .............................................................................................................. 33
2.5Using the Console Interface ......................................................................................................... 34
2.6Using the Command Line Interface .............................................................................................. 36
2.6.1Available CLI Commands .................................................................................................. 36
2.6.2Tracing Events ................................................................................................................. 39
2.6.3Executing Commands Remotely via RSH ............................................................................ 40
2.6.4Using SQL Commands ...................................................................................................... 40
2.6.4.1Finding the Correct Table ....................................................................................... 41
2.6.4.2Retrieving Information ........................................................................................... 41
2.6.4.3Changing Values in a Table .................................................................................... 43
2.6.4.4Resetting a Table ................................................................................................... 44
2.6.4.5Using RSH and SQL ............................................................................................... 44
2.7Selecting Ports in RUGGEDCOM ROS ............................................................................................. 44
2.8Managing the Flash File System ................................................................................................... 45
2.8.1Viewing a List of Flash Files .............................................................................................. 45
2.8.2Viewing Flash File Details ................................................................................................. 45
2.8.3Defragmenting the Flash File System ................................................................................. 46
2.9Accessing BIST Mode ................................................................................................................... 46
2.10Managing SSH Public Keys ......................................................................................................... 47
2.10.1Adding a Public Key ....................................................................................................... 47
2.10.2Viewing a List of Public Keys ........................................................................................... 49
2.10.3Updating a Public Key .................................................................................................... 49
2.10.4Deleting a Public Key ...................................................................................................... 50
Chapter 3
Device Management ....................................................................................... 51
3.1Viewing Product Information ....................................................................................................... 51
3.2Viewing CPU Diagnostics ............................................................................................................. 53
3.3Restoring Factory Defaults ........................................................................................................... 54
3.4Configuring an IP Interface .......................................................................................................... 55

RUGGEDCOM ROS
User Guide

Table of Contents
vii
3.5Uploading/Downloading Files ....................................................................................................... 56
3.5.1Uploading/Downloading Files Using XMODEM .................................................................... 56
3.5.2Uploading/Downloading Files Using a TFTP Client ............................................................... 57
3.5.3Uploading/Downloading Files Using a TFTP Server .............................................................. 58
3.5.4Uploading/Downloading Files Using an SFTP Server ............................................................ 59
3.6Managing Logs ........................................................................................................................... 59
3.6.1Viewing Local Logs .......................................................................................................... 60
3.6.2Clearing Local Logs .......................................................................................................... 60
3.6.3Configuring the Local System Log ..................................................................................... 61
3.6.4Managing Remote Logging ............................................................................................... 61
3.6.4.1Configuring the Remote Syslog Client ..................................................................... 62
3.6.4.2Viewing a List of Remote Syslog Servers .................................................................. 62
3.6.4.3Adding a Remote Syslog Server .............................................................................. 63
3.6.4.4Deleting a Remote Syslog Server ............................................................................ 64
3.7Managing IP Gateways ................................................................................................................ 65
3.7.1Viewing a List of IP Gateways ........................................................................................... 66
3.7.2Adding an IP Gateway ...................................................................................................... 66
3.7.3Deleting an IP Gateway .................................................................................................... 68
3.8Configuring IP Services ................................................................................................................ 68
3.9Managing Remote Monitoring ..................................................................................................... 70
3.9.1Managing RMON History Controls ..................................................................................... 71
3.9.1.1Viewing a List of RMON History Controls ................................................................. 71
3.9.1.2Adding an RMON History Control ............................................................................ 71
3.9.1.3Deleting an RMON History Control .......................................................................... 73
3.9.2Managing RMON Alarms ................................................................................................... 74
3.9.2.1Viewing a List of RMON Alarms .............................................................................. 75
3.9.2.2Adding an RMON Alarm ......................................................................................... 76
3.9.2.3Deleting an RMON Alarm ....................................................................................... 78
3.9.3Managing RMON Events ................................................................................................... 79
3.9.3.1Viewing a List of RMON Events .............................................................................. 80
3.9.3.2Adding an RMON Event ......................................................................................... 80
3.9.3.3Deleting an RMON Event ....................................................................................... 82
3.10Upgrading/Downgrading Firmware ............................................................................................. 82
3.10.1Upgrading Firmware ....................................................................................................... 83
3.10.2Downgrading Firmware .................................................................................................. 83
3.11Resetting the Device ................................................................................................................. 84
3.12Decommissioning the Device ..................................................................................................... 85
Chapter 4
System Administration .................................................................................... 87
4.1Configuring the System Information ............................................................................................. 87


Table of Contents
RUGGEDCOM ROS
User Guide
viii
4.2Customizing the Login Screen ...................................................................................................... 88
4.3Configuring Passwords ................................................................................................................ 88
4.4Clearing Private Data ................................................................................................................... 91
4.5Enabling/Disabling the Web Interface ........................................................................................... 92
4.6Managing Alarms ........................................................................................................................ 92
4.6.1Viewing a List of Pre-Configured Alarms ............................................................................ 93
4.6.2Viewing and Clearing Latched Alarms ................................................................................ 94
4.6.3Configuring an Alarm ....................................................................................................... 94
4.6.4Authentication Related Security Alarms .............................................................................. 97
4.6.4.1Security Alarms for Login Authentication ................................................................ 97
4.6.4.2Security Messages for Port Authentication ............................................................... 99
4.7Managing the Configuration File ................................................................................................ 100
4.7.1Configuring Data Encryption ........................................................................................... 100
4.7.2Updating the Configuration File ...................................................................................... 102
4.8Managing an Authentication Server ........................................................................................... 102
4.8.1Managing RADIUS Authentication .................................................................................... 103
4.8.1.1Configuring the RADIUS Server ............................................................................. 104
4.8.1.2Configuring the RADIUS Client .............................................................................. 104
4.8.2Managing TACACS+ Authentication ................................................................................. 106
4.8.2.1Configuring TACACS+ .......................................................................................... 106
4.8.2.2Configuring User Privileges .................................................................................. 107
Chapter 5
Setup and Configuration ................................................................................ 109
5.1Managing Time Services ............................................................................................................ 109
5.1.1Configuring the Time and Date ....................................................................................... 109
5.1.2Managing NTP ............................................................................................................... 111
5.1.2.1Enabling/Disabling NTP Service ............................................................................. 111
5.1.2.2Configuring NTP Servers ...................................................................................... 112
5.2Managing SNMP ....................................................................................................................... 113
5.2.1Managing SNMP Users .................................................................................................... 114
5.2.1.1Viewing a List of SNMP Users ............................................................................... 114
5.2.1.2Adding an SNMP User .......................................................................................... 114
5.2.1.3Deleting an SNMP User ........................................................................................ 117
5.2.2Managing Security-to-Group Mapping .............................................................................. 118
5.2.2.1Viewing a List of Security-to-Group Maps .............................................................. 118
5.2.2.2Adding a Security-to-Group Map ........................................................................... 119
5.2.2.3Deleting a Security-to-Group Map ......................................................................... 120
5.2.3Managing SNMP Groups ................................................................................................. 121
5.2.3.1Viewing a List of SNMP Groups ............................................................................. 122
5.2.3.2Adding an SNMP Group ....................................................................................... 122

RUGGEDCOM ROS
User Guide

Table of Contents
ix
5.2.3.3Deleting an SNMP Group ..................................................................................... 124
5.3Managing Network Discovery .................................................................................................... 124
5.4Managing Serial Protocols ......................................................................................................... 125
5.4.1Encapsulation Concepts .................................................................................................. 127
5.4.1.1Raw Socket Character Encapsulation ..................................................................... 128
5.4.1.2RTU Polling ......................................................................................................... 128
5.4.1.3Broadcast RTU Polling .......................................................................................... 129
5.4.1.4Preemptive Raw Socket ........................................................................................ 130
5.4.1.5Port Redirectors ................................................................................................... 131
5.4.1.6Message Packetization ......................................................................................... 132
5.4.2Modbus Concepts ........................................................................................................... 132
5.4.2.1Modbus Server Client Applications ........................................................................ 132
5.4.2.2Modbus TCP Performance Determinants ................................................................ 133
5.4.2.3Turnaround Delay ................................................................................................ 135
5.4.3DNP, Microlok, TIN and WIN Concepts ............................................................................. 135
5.4.3.1DNP, Microlok, TIN and WIN Applications .............................................................. 135
5.4.3.2The Concept of Links ........................................................................................... 136
5.4.3.3Address Learning for TIN ...................................................................................... 136
5.4.3.4Address Learning for DNP .................................................................................... 137
5.4.3.5Broadcast Messages ............................................................................................. 138
5.4.3.6Transport Protocols .............................................................................................. 138
5.4.4Force Half-Duplex (HD) Operation Mode .......................................................................... 139
5.4.5Configuring a Serial Port ................................................................................................. 140
5.4.6Configuring the Raw Socket Protocol ............................................................................... 143
5.4.7Configuring the Preemptive Raw Socket Protocol .............................................................. 146
5.4.8Configuring a TCP Modbus Server .................................................................................... 148
5.4.9Configuring a TCP Modbus Client .................................................................................... 150
5.4.10Configuring the WIN and TIN Protocols .......................................................................... 151
5.4.11Configuring the MicroLok Protocol ................................................................................. 153
5.4.12Configuring the DNP Protocol ........................................................................................ 154
5.4.13Configuring the DNP Over Raw Socket Protocol .............................................................. 155
5.4.14Configuring the Mirrored Bits Protocol ........................................................................... 157
5.4.15Configuring the Telnet Com Port Protocol ...................................................................... 159
5.4.16Managing Raw Socket Remote Hosts ............................................................................. 161
5.4.16.1Viewing a List of Remote Hosts .......................................................................... 162
5.4.16.2Adding a Remote Host ....................................................................................... 162
5.4.16.3Deleting a Remote Host ..................................................................................... 163
5.4.17Managing Device Addresses .......................................................................................... 164
5.4.17.1Viewing a List of Device Addresses ..................................................................... 164
5.4.17.2Adding a Device Address .................................................................................... 165


Table of Contents
RUGGEDCOM ROS
User Guide
x
5.4.17.3Deleting a Device Address .................................................................................. 167
5.4.18Viewing the TIN Dynamic Address Table ......................................................................... 168
5.4.19Viewing Statistics for Serial Protocol Links ...................................................................... 169
5.4.20Viewing Statistics for Serial Protocol Connections ........................................................... 170
5.4.21Viewing Serial Port Statistics ......................................................................................... 170
5.4.22Clearing Statistics for Specific Serial Ports ....................................................................... 171
5.4.23Resetting Serial Ports .................................................................................................... 172
Chapter 6
Troubleshooting ............................................................................................ 173
6.1General .................................................................................................................................... 173