1. Manuals
  2. Brands
  3. Siemens Manuals
  4. Control Unit
  5. RUGGEDCOM ROS
  6. User manual

Siemens RUGGEDCOM ROS User Manual

Hide thumbs Also See for RUGGEDCOM ROS:
Table of Contents

Advertisement

Quick Links

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

Advertisement

Table of Contents
loading

Related Manuals for Siemens RUGGEDCOM ROS

Summary of Contents for Siemens RUGGEDCOM ROS

  • Page 1 Preface Introduction Using ROS RUGGEDCOM ROS v4.3 Device Management System Administration Setup and Configuration User Guide Troubleshooting For RMC30 07/2016 RC1271-EN-03...
  • Page 2 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.
  • Page 3 RUGGEDCOM ROS User Guide Contacting Siemens Address Telephone E-mail ruggedcom.info.i-ia@siemens.com Siemens Canada Ltd Toll-free: 1 888 264 0006 Industry Sector Tel: +1 905 856 5288 www.siemens.com/ruggedcom 300 Applewood Crescent Fax: +1 905 856 1995 Concord, Ontario Canada, L4K 5C7...
  • Page 4 RUGGEDCOM ROS User Guide...

  • Page 5: Table Of Contents

    RUGGEDCOM ROS   User Guide Table of Contents Table of Contents Preface ......................Conventions ............................xi Related Documents ..........................xii System Requirements ......................... xii Accessing Documentation ........................xii Training ............................xiii Customer Support ..........................xiii Chapter 1 Introduction ..................... 1.1  Features and Benefits ........................1 1.2  Security Recommendations and Considerations ................
  • Page 6 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 ....................
  • Page 7 RUGGEDCOM ROS   User Guide Table of Contents 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 ...........................
  • Page 8   RUGGEDCOM ROS Table of Contents User Guide 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 ................
  • Page 9 RUGGEDCOM ROS   User Guide Table of Contents 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 ..................
  • Page 10   RUGGEDCOM ROS Table of Contents User Guide 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 ...............

  • Page 11: Preface

    RUGGEDCOM ROS   User Guide Preface Preface This guide describes v4.3 of ROS (Rugged Operating System) running on the RUGGEDCOM RMC30. It contains instructions and guidelines on how to use the software, as well as some general theory. It is intended for use by network technical support personnel who are familiar with the operation of networks. It is also recommended for use by network and system planners, system programmers, and line technicians.

  • Page 12: Related Documents

    Other documents that may be of interest include: • RUGGEDCOM RMC30 Installation Guide System Requirements Each workstation used to connect to the RUGGEDCOM ROS interface must meet the following system requirements: • Must have one of the following Web browsers installed: ▫...

  • Page 13: Training

    Siemens Sales representative. Customer Support Customer support is available 24 hours, 7 days a week for all Siemens customers. For technical support or general information, contact Siemens Customer Support through any of the following methods: Online Visit http://www.siemens.com/automation/support-request...

  • Page 14: Customer Support

    RUGGEDCOM ROS   User Guide Preface Customer Support...

  • Page 15: Introduction

    Chapter 1 User Guide Introduction Introduction Welcome to the RUGGEDCOM ROS v4.3 Software User Guide for the RMC30. This Guide describes the wide array of carrier grade features made available by ROS (Rugged Operating System). CONTENTS • Section 1.1, “Features and Benefits”...

  • Page 16: Security Recommendations And Considerations

    • Brute Force Attack Prevention Protection against Brute Force Attacks (BFAs) is standard in RUGGEDCOM ROS. If an external host fails to log in to the Terminal or Web interfaces after a fixed number of attempts, the service will be blocked for one hour.
  • Page 17 • Control access to the serial console to the same degree as any physical access to the device. Access to the serial console allows for potential access to the RUGGEDCOM ROS boot loader, which includes tools that may be used to gain complete access to the device.

  • Page 18: Credential Files

    Siemens application note: Creating/Uploading SSH Keys and SSL Certificates to ROS Using Windows, available from www.siemens.com/ruggedcom. The sequence of events related to Key Management during an upgrade to RUGGEDCOM ROS v4.3 or later is as follows:...

  • Page 19: Ssl Certificates

    • X.509 v3 digital certificate format • PEM format • For RUGGEDCOM ROS Controlled verions: RSA key pair, 1024, 2048 or 3072 bits; or EC 256, 384 or 521 bits • For RUGGEDCOM ROS Non-Controlled (NC) verions: RSA key pair, 512 to 2048 bits The RSA key pair used in the default certificate and in those generated by RUGGEDCOM ROS uses a public key of 1024 bits in length.
  • Page 20 # Note that cert must precede the RSA key: ros_ssl.crt ros_ssl.key > ssl.crt For information on creating SSL certificates for use with RUGGEDCOM ROS in a Microsoft Windows environment, refer to the following Siemens application note: Creating/Uploading SSH Keys and SSL Certificates to ROS Using Windows.

  • Page 21: Ssh Key Pairs

    • DSA key pair, 1024, 2048 or 3072 bits in length; or RSA 1024, 2048 or 3072 bits in length The DSA key pair used in the default key pair and in those generated by RUGGEDCOM ROS uses a public key of 1024 bits in length.

  • Page 22: Supported Networking Standards

    ü ü ü Section 1.4 Available Services by Port The following table lists the services available under RUGGEDCOM ROS. This table includes the following information: • Services The service supported by the device. • Port Number The port number associated with the service.
  • Page 23 RUGGEDCOM ROS Chapter 1 User Guide Introduction NOTE In certain cases, the service might be disabled, but the port can still be open (e.g. TFTP). • Port Default The default state of the port (i.e. open or closed). • Access Authorized Denotes whether the ports/services are authenticated during access.
  • Page 24 Chapter 1 RUGGEDCOM ROS Introduction User Guide Service Enabled/ Services Port Number Access Authorized Note Disabled Remote Syslog UDP/514 Disabled Only available (configurable) (configurable) through two management interfaces. DNP over RawSocket TCP/21001 to Disabled TCP/21016 (configurable) DNPv3 UDP/20000 UDP Disabled (configurable);...

  • Page 25: Snmp Management Interface Base (Mib) Support

    Chapter 1 User Guide Introduction Section 1.5 SNMP Management Interface Base (MIB) Support RUGGEDCOM ROS supports a variety of standard MIBs, proprietary RUGGEDCOM MIBs and Agent Capabilities MIBs, all for SNMP (Simple Network Management Protocol). CONTENTS • Section 1.5.1, “Supported Standard MIBs”...

  • Page 26: Supported Proprietary Ruggedcom Mibs

    Managemet for seral ports on RUGGEDCOM device RUGGEDCOM-STP-MIB.mib RUGGEDCOM-STP-MIB Management for RSTP protocol Section 1.5.3 Supported Agent Capabilities RUGGEDCOM ROS supports the following agent capabilities for the SNMP agent: NOTE For information about agent capabilities for SNMPv2, refer to RFC 2580 [http://tools.ietf.org/html/ rfc2580]. File Name...

  • Page 27: Snmp Traps

    RUGGEDCOM ROS Chapter 1 User Guide Introduction File Name MIB Name Supported MIB RC-RMON-MIB-AC.mib RC-RMON-MIB-AC RMON-MIB RC-Q-BRIDGE-MIB-AC.mib RC-Q-BRIDGE-MIB-AC Q-BRIDGE-MIB RC-IP-MIB-AC.mib RC-IP-MIB-AC IP-MIB RC-LLDP-MIB-AC.mib RC-LLDP-MIB-AC LLDP-MIB RC-LAG-MIB-AC.mib RC-LAG-MIB-AC IEEE8023-LAG-MIB RC_RSTP-MIB-AC.mib RC_RSTP-MIB-AC RSTP-MIB RC-RUGGEDCOM-DOT11-MIB-AC.mib RC-RUGGEDCOM-DOT11-MIB-AC RUGGEDCOM-DOT11- MIB RC-RUGGEDCOM-POE-MIB-AC.mib RC-RUGGEDCOM-POE-MIB-AC RUGGEDCOM-POE-MIB RC-RUGGEDCOM-STP-AC-MIB.mib RC-RUGGEDCOM-STP-AC-MIB RUGGEDCOM-STP-MIB RC-RUGGEDCOM-SYS-INFO-MIB-AC.mib...

  • Page 28: Modbus Management Support

    Chapter 1 RUGGEDCOM ROS Introduction User Guide Trap swUpgradeTrap cfgChangeTrap weakPasswordTrap defaultKeysTrap Generic traps carry information about events in their severity and description objects. They are sent at the same time an alarm is generated for the device. The following are examples of RUGGEDCOM generic traps: NOTE Information about generic traps can be retrieved using the CLI command alarms.

  • Page 29: Modbus Function Codes

    RUGGEDCOM ROS Chapter 1 User Guide Introduction Function Code Data CONTENTS • Section 1.7.1, “ModBus Function Codes” • Section 1.7.2, “ModBus Memory Map” • Section 1.7.3, “ModBus Memory Formats” Section 1.7.1 ModBus Function Codes RUGGEDCOM devices support the following ModBus function codes for device management through ModBus:...

  • Page 30: Modbus Memory Map

    Chapter 1 RUGGEDCOM ROS Introduction User Guide Example PDU Response Function Code 1 Byte 0x10 Starting Address 2 Bytes 0x0000 to 0xFFFF Number of Registers 2 Bytes 1 to 121 (0x79) Section 1.7.2 ModBus Memory Map The following details how ModBus process variable data is mapped.
  • Page 31 RUGGEDCOM ROS Chapter 1 User Guide Introduction Address #Registers Description (Reference Table in UI) Format 0140 Alarm 2 Alarm 0180 Alarm 3 Alarm 01C0 Alarm 4 Alarm 0200 Alarm 5 Alarm 0240 Alarm 6 Alarm 0280 Alarm 7 Alarm 02C0...
  • Page 32 Chapter 1 RUGGEDCOM ROS Introduction User Guide Address #Registers Description (Reference Table in UI) Format 0424 Port s5/p3 Statistics - Ethernet In Packets Uinst32 0426 Port s5/p4 Statistics - Ethernet In Packets Uinst32 0428 Port s6/p1 Statistics - Ethernet In Packets...
  • Page 33 RUGGEDCOM ROS Chapter 1 User Guide Introduction Address #Registers Description (Reference Table in UI) Format 0470 Port s7/p1 Statistics - Ethernet Out Packets Uinst32 0472 Port s7/p2 Statistics - Ethernet Out Packets Uinst32 0474 Port s8/p1 Statistics - Ethernet Out Packets...
  • Page 34 Chapter 1 RUGGEDCOM ROS Introduction User Guide Address #Registers Description (Reference Table in UI) Format 04C4 Port s1/p3 Statistics - Ethernet Out Packets Uinst32 04C6 Port s1/p4 Statistics - Ethernet Out Packets Uinst32 04C8 Port s2/p1 Statistics - Ethernet Out Packets...

  • Page 35: Modbus Memory Formats

    Port 3 Statistics – Serial Out Packets Uint32 06C6 Port 4 Statistics – Serial Out Packets Uint32 Section 1.7.3 ModBus Memory Formats The following ModBus memory formats are supported by Siemens. CONTENTS • Section 1.7.3.1, “Text” • Section 1.7.3.2, “Cmd” • Section 1.7.3.3, “Uint16”...

  • Page 36: Cmd

    Chapter 1 RUGGEDCOM ROS Introduction User Guide 0x04 0x10 0x53 0x59 0x53 0x54 0x45 0x4D 0x20 0x4E 0x41 0x4D 0x45 0x00 0x00 0x00 0x00 0x00 In this example, starting from byte 3 until the end, the response presents an ASCII representation of the characters for the product identification, which reads as SYSTEM NAME.

  • Page 37: Alarm

    RUGGEDCOM ROS Chapter 1 User Guide Introduction Bits that do not apply to a particular product are always set to zero (0). A bit value of 1 indicates that the requested action is true. For example, the port is up.

  • Page 38: Psstatuscmd

    Chapter 1 RUGGEDCOM ROS Introduction User Guide Section 1.7.3.7 PSStatusCmd The PSStatusCmd format describes a bit layout for providing the status of available power supplies. Bits 0-4 of the lower byte of the register are used for this purpose. • Bits 0-1: Power Supply 1 Status •...

  • Page 39: Ssh And Ssl Keys And Certificates

    Certificate and Keys Life Cycle Each RUGGEDCOM ROS device is shipped with an SSL certificate and RSA key pair, and a DSA host key pair for SSH, that are generated at and provisioned by the factory. The administrator may upload a new certificate and keys to the system at any time, which will overwrite the existing ones.

  • Page 40: Certificate And Key Requirements

    Certificate and Key Requirements For SSL, controlled versions of RUGGEDCOM ROS require an X.509 certificate in standard PEM format and an RSA or ECC key pair. The certificate may be self-signed or signed by a separate authority. The RSA key must be 1024, 2048 or 3072 bits in length;...
  • Page 41 -----END RSA PRIVATE KEY----- For SSH, RUGGEDCOM ROS requires a DSA or RSA host key pair in PEM format. The key must be 1024, 2048 or 3072 bits in length for Controlled versions. The key file is uploaded to the ssh.keys flash file on the device.
  • Page 42 RUGGEDCOM ROS Chapter 1 User Guide Introduction Certificate and Key Requirements...

  • Page 43: Using Ros

    Section 2.1.1 Connecting Directly RUGGEDCOM ROS can be accessed through a direct RS-232 serial console connection for management and troubleshooting purposes. A console connection provides access to the console interface and CLI. To establish a console connection to the device, do the following: Connect a workstation (either a terminal or computer running terminal emulation software) to the RS-232 serial console port on the device.

  • Page 44: Connecting Via The Network

    Section 2.2, “Logging In” Section 2.1.2 Connecting via the Network RUGGEDCOM ROS can be accessed over the network either through a Web browser, terminal or a workstation running terminal emulation software. Using a Web Browser Web browsers provide a secure connection to the Web interface for RUGGEDCOM ROS using the SSL (Secure Socket Layer) communication method.

  • Page 45: Logging In

    Using a Terminal or Terminal Emulation Software A terminal or computer running terminal emulation software provides access to the console interface for RUGGEDCOM ROS through a Telnet, RSH (Remote Shell) or SSH (Secure Shell) service. NOTE IP services can be restricted to control access to the device. For more information, refer to Section 3.8,...

  • Page 46: Logging Out

    Chapter 2 RUGGEDCOM ROS Using ROS User Guide Figure 2: Login Screen (Web Interface) 1. Username Box    2. Password Box    3. Submit Button NOTE The following default usernames and passwords are set on the device for each user type: Guest Operator Admin Username: guest Username: operator...

  • Page 47: Using The Web Interface

    Using ROS Figure 3: Web Interface (Example) 1. Logout NOTE If any pending configuration changes have not been committed, RUGGEDCOM ROS will request confirmation before discarding the changes and logging out of the device. Section 2.4 Using the Web Interface The Web interface is a Web-based Graphical User Interface (GUI) for displaying important information and controls in a Web browser.

  • Page 48: Using The Console Interface

    Description Side The side frame contains a logout option and a collapsible list of links that open various screens in the main frame. For information about logging out of RUGGEDCOM ROS, refer to Section 2.3, “Logging Out” Main The main frame displays the parameters and/or data related to the selected feature.
  • Page 49 RUGGEDCOM ROS Chapter 2 User Guide Using ROS Each screen consists of a system identifier, the name of the current menu, and a command bar. Alarms are also indicated on each screen in the upper right corner. Figure 6: Console Interface (Example) 1. System Identification   ...

  • Page 50: Using The Command Line Interface

    The standard commands include the following: Ctrl + A Commits configuration changes made on the current screen. NOTE Before exiting a screen, RUGGEDCOM ROS will automatically prompt the user to save any changes that have not been committed. Ctrl + I Inserts a new record.
  • Page 51 RUGGEDCOM ROS Chapter 2 User Guide Using ROS Command Description • port is a comma separated list of port numbers (e.g. 1,3-5,7) clearlogs Clears the system and crash logs. clrcblstats [ all | Clears cable diagnostics statistics for one or more ports.
  • Page 52 Chapter 2 RUGGEDCOM ROS Using ROS User Guide Command Description • address is the target IP address. • count is the number of echo requests to send. The default is 4. • timeout is the time in milliseconds to wait for each reply. The range is 2 to 5000 seconds.

  • Page 53: Tracing Events

    RUGGEDCOM ROS Chapter 2 User Guide Using ROS Command Description sshpubkey List, remove and update key entries in sshpub.keys file. sslkeygen Generates a new SSL certificate in ssl.crt. keytype Optional and/or required parameters include: • keytype is the type of key, either rsa or ecc •...

  • Page 54: Executing Commands Remotely Via Rsh

    Commands that start interactive dialogs (such as trace) cannot be used. Section 2.6.4 Using SQL Commands RUGGEDCOM ROS provides an SQL-like command facility that allows expert users to perform several operations not possible under the traditional Web or CLI interface. For instance: Executing Commands Remotely via RSH...

  • Page 55: Finding The Correct Table

    RUGGEDCOM ROS Chapter 2 User Guide Using ROS • Restoring the contents of a specific table, but not the whole configuration, to their factory defaults. • Search tables in the database for specific configurations. • Make changes to tables predicated upon existing configurations.
  • Page 56 Chapter 2 RUGGEDCOM ROS Using ROS User Guide Retrieving Information from a Table Use the following command to display a summary of the parameters within a table, as well as their values: sql select from table Where: • table is the name of the table Example: >sql select from ipAddrtable...

  • Page 57: Changing Values In A Table

    RUGGEDCOM ROS Chapter 2 User Guide Using ROS Port Name ifName Media State AutoN Speed Dupx FlowCtrl LFI Alarm Port 1 1000T Enabled Auto Auto Off On Port 2 1000T Enabled Auto Auto Off On Port 3 1000T Enabled Auto...

  • Page 58: Resetting A Table

    0 records selected Section 2.7 Selecting Ports in RUGGEDCOM ROS Many features in ROS can be configured for one or more ports on the device. The following describes how to specify a single port, a range of ports, or all ports .

  • Page 59: Managing The Flash File System

    RUGGEDCOM ROS Chapter 2 User Guide Using ROS Use the All option to select all ports in the device, or, if available, use the None option to select none of the ports. Section 2.8 Managing the Flash File System The following section describes how to manage the flash file system.

  • Page 60: Defragmenting The Flash File System

    Mechanical hazard – risk of damage to the device. Excessive use of BIST functions may cause increase wear on the device, which may void the warranty. Avoid using BIST functions unless instructed by a Siemens Customer Support representative. To access BIST mode, do the following:...

  • Page 61: Managing Ssh Public Keys

    • Access Level: (Admin, Operator or Guest) • Revocation Status: active/inactive (always active for keys) • User Name: This is the client's user name (not the RUGGEDCOM ROS user name). This will be used by clients to later SSH into the RUGGEDCOM ROS device.
  • Page 62 The content of the sshaddpub.keys file must follow the same syntax as the sshpub.keys file. RUGGEDCOM ROS allows only 16 user key entries to be stored. Each key entry must meet the following limits: • Key type must be either RSA 2048 bits or RSA 3072 bits •...

  • Page 63: Viewing A List Of Public Keys

    RUGGEDCOM ROS Chapter 2 User Guide Using ROS Check the system log to make sure the files were properly transferred. For more information about viewing the system log, refer to Section 3.6.1, “Viewing Local Logs” Section 2.10.2 Viewing a List of Public Keys Admin users can view a list of existing public keys on the device.

  • Page 64: Deleting A Public Key

    Chapter 2 RUGGEDCOM ROS Using ROS User Guide Section 2.10.4 Deleting a Public Key Admin users can delete one or more public keys. To delete a public key, do the following: Log in to the device as an admin user and access the CLI shell. For more information about accessing the CLI shell, refer to Section 2.6, “Using the Command Line Interface”...

  • Page 65: Device Management

    Section 3.1 Viewing Product Information During troubleshooting or when ordering new devices, Siemens personnel may request specific information about the device, such as the model, order code or serial number. To view information about the device, navigate to Diagnostics » View Product Information . The Product Information form appears.
  • Page 66 Chapter 3 RUGGEDCOM ROS Device Management User Guide Figure 7: Product Information Form (Example) 1. MAC Address Box    2. Order Code Box    3. Classification Box    4. Serial Number Box    5. Boot Version Box    6. Main Version Box    7. Required Boot Box    8. Hardware ID Box    9. Reload Button This screen displays the following information:...

  • Page 67: Viewing Cpu Diagnostics

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Parameter Description Rev C1), RSG2100, RS900G, RSG2200, RS969, RS900 (v2, 40-00-0066), RS900 (v2, 40-00-0067), , RS416 (40-00-0078), RMC30 (v2), RS930 (40-00-0089), RS969 (v2, 40-00-0090), RS910 (40-00-0091-001 Rev A), RS920L (40-00-0102-001 Rev A), RS940G (40-00-0097-000 Rev A), RSi80X series CPU board, RSG2300, RS416v2, ...

  • Page 68: Restoring Factory Defaults

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Parameter Description The total size of RAM in the system. RAM Free Synopsis:   0 to 4294967295 The total size of RAM still available. RAM Low Watermark Synopsis:   0 to 4294967295 The size of RAM that have never been used during the system runtime.

  • Page 69: Configuring An Ip Interface

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Figure 9: Load Factory Defaults Form 1. Defaults Choice List    2. Apply Button    3. Reload Configure the following parameter(s) as required: Parameter Description Defaults Choice Synopsis:   { None, Selected, All } Setting some records like IP Interfaces management interface, default gateway, SNMP settings to default value would cause switch not to be accessible with management applications.

  • Page 70: Uploading/Downloading Files

    Only the files that can be uploaded to the device can be overwritten. Files that may need to be uploaded or downloaded include: • main.bin – the main RUGGEDCOM ROS application firmware image • boot.bin – the boot loader firmware image •...

  • Page 71: Uploading/Downloading Files Using A Tftp Client

    RUGGEDCOM ROS Chapter 3 User Guide Device Management NOTE This method requires a host computer that has terminal emulation or Telnet software installed and the ability to perform XMODEM transfers. NOTE Xmodem transfers can only be performed through the serial console, which is authenticated during login.

  • Page 72: Uploading/Downloading Files Using A Tftp Server

    Chapter 3 RUGGEDCOM ROS Device Management User Guide NOTE This method requires a TFTP server that is accessible over the network. Identify the IP address of the computer running the TFTP server. Establish a direct connection between the device and a host computer. For more information, refer to Section 2.1.1, “Connecting Directly”...

  • Page 73: Uploading/Downloading Files Using An Sftp Server

    RUGGEDCOM ROS Chapter 3 User Guide Device Management The following is an example of a successful TFTP server exchange: C:\>tftp -i 10.1.0.1 put C:\files\ROD-CF52_Main_v3.7.0.bin main.bin Transfer successful: 1428480 bytes in 4 seconds, 375617 bytes/s Section 3.5.4 Uploading/Downloading Files Using an SFTP Server SFTP (Secure File Transfer Protocol) is a file transfer mechanism that uses SSH to encrypt every aspect of file transfer between a networked client and server.

  • Page 74: Viewing Local Logs

    Chapter 3 RUGGEDCOM ROS Device Management User Guide • Section 3.6.3, “Configuring the Local System Log” • Section 3.6.4, “Managing Remote Logging” Section 3.6.1 Viewing Local Logs The local crash and system logs can both be downloaded from the device and viewed in a text editor. For more information about downloading log files, refer to Section 3.5, “Uploading/Downloading Files”...

  • Page 75: Configuring The Local System Log

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Section 3.6.3 Configuring the Local System Log To configure the severity level for the local system log, do the following: NOTE For maximum reliability, use remote logging. For more information, refer to Section 3.6.4, “Managing Remote Logging”...

  • Page 76: Configuring The Remote Syslog Client

    Chapter 3 RUGGEDCOM ROS Device Management User Guide • Section 3.6.4.3, “Adding a Remote Syslog Server” • Section 3.6.4.4, “Deleting a Remote Syslog Server” Section 3.6.4.1 Configuring the Remote Syslog Client To configure the remote syslog client, do the following: Navigate to Administration » Configure Syslog » Configure Remote Syslog Client . The Remote Syslog Client form appears.

  • Page 77: Adding A Remote Syslog Server

    Adding a Remote Syslog Server RUGGEDCOM ROS supports up to 5 remote syslog servers (or collectors). Similar to the local system log, a remote system log server can be configured to log information at a specific severity level. Only messages of a severity level equal to or greater than the specified severity level are written to the log.

  • Page 78: Deleting A Remote Syslog Server

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Figure 17: Remote Syslog Server Form 1. IP Address Box    2. UDP Port Box    3. Facility Box    4. Severity Box    5. Apply Button    6. Delete Button    7. Reload Button Configure the following parameter(s) as required: Parameter Description IP Address Synopsis:   ###.###.###.### where ### ranges from 0 to 255 Syslog server IP Address.

  • Page 79: Managing Ip Gateways

    1. IP Address Box    2. UDP Port Box    3. Facility Box    4. Severity Box    5. Apply Button    6. Delete Button    7. Reload Button Click Delete. Section 3.7 Managing IP Gateways RUGGEDCOM ROS allows up to ten IP gateways to be configured. When both the Destination and Subnet parameters are blank, the gateway is considered to be a default gateway. Managing IP Gateways...

  • Page 80: Viewing A List Of Ip Gateways

    Chapter 3 RUGGEDCOM ROS Device Management User Guide NOTE The default gateway configuration will not be changed when resetting all configuration parameters to their factory defaults. CONTENTS • Section 3.7.1, “Viewing a List of IP Gateways” • Section 3.7.2, “Adding an IP Gateway”...
  • Page 81 RUGGEDCOM ROS Chapter 3 User Guide Device Management Figure 21: IP Gateways Table 1. InsertRecord Click InsertRecord. The IP Gateways form appears. Figure 22: IP Gateways 1. Destination Box    2. Subnet Box    3. Gateway Box    4. Apply Button    5. Delete Button    6. Reload Button Configure the following parameter(s) as required: Parameter...

  • Page 82: Deleting An Ip Gateway

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Section 3.7.3 Deleting an IP Gateway To delete an IP gateway configured on the device, do the following: Navigate to Administration » Configure IP Gateways . The IP Gateways table appears. Figure 23: IP Gateways Table Select the IP gateway from the table.
  • Page 83 RUGGEDCOM ROS Chapter 3 User Guide Device Management Figure 25: IP Services Form 1. Inactivity Timeout Box    2. Telnet Sessions Allowed Box    3. Web Server Users Allowed Box    4. TFTP Server Box    5. Modbus Address Box    6. SSH Sessions Allowed Box    7. RSH Server Options    8. Max Failed Attempts Box    9. Failed Attempts Window Box   ...

  • Page 84: Managing Remote Monitoring

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Parameter Description Determines the Modbus address to be used for Management through Modbus. SSH Sessions Allowed (Controlled Version Only) Synopsis:   1 to 4 Default:   4 Limits the number of SSH sessions.

  • Page 85: Managing Rmon History Controls

    RUGGEDCOM ROS Chapter 3 User Guide Device Management • Section 3.9.3, “Managing RMON Events” Section 3.9.1 Managing RMON History Controls The history controls for Remote Monitoring take samples of the RMON-MIB history statistics of an Ethernet port at regular intervals. CONTENTS •...
  • Page 86 Chapter 3 RUGGEDCOM ROS Device Management User Guide Figure 27: RMON History Controls Table 1. InsertRecord Click InsertRecord. The RMON History Controls form appears. Figure 28: RMON History Controls Form 1. Index Box    2. Port Box    3. Requested Buckets Box    4. Granted Buckets Box    5. Interval Box    6. Owner Box    7. Apply Button   ...

  • Page 87: Deleting An Rmon History Control

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Parameter Description Granted Buckets Synopsis:   0 to 65535 The number of buckets granted for this RMON collection history. This field is not editable. Interval Synopsis:   1 to 3600 Default:   1800 The number of seconds in over which the data is sampled for each bucket.

  • Page 88: Managing Rmon Alarms

    Remote Monitoring (RMON) alarms define upper and lower thresholds for legal values of specific statistical variables in a given interval. This allows RUGGEDCOM ROS to detect events as they occur more quickly than a specified maximum rate or less quckly than a minimum rate.

  • Page 89: Viewing A List Of Rmon Alarms

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Figure 31: The Alarm Process There are two methods to evaluate a statistic in order to determine when to generate an event: delta and absolute. For most statistics, such as line errors, it is appropriate to generate an alarm when a rate is exceeded. The alarm defaults to the delta measurement method, which examines changes in a statistic at the end of each measurement period.

  • Page 90: Adding An Rmon Alarm

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Section 3.9.2.2 Adding an RMON Alarm To add an RMON alarm, do the following: Navigate to Ethernet Stats » Configure RMON Alarms . The RMON Alarms table appears. Figure 33: RMON Alarms Table 1. InsertRecord Click InsertRecord. The RMON Alarms form appears.
  • Page 91 RUGGEDCOM ROS Chapter 3 User Guide Device Management Parameter Description Index Synopsis:   1 to 65535 Default:   1 The index of this RMON Alarm record. Variable Synopsis:   SNMP Object Identifier - up to 39 characters The SNMP object identifier (OID) of the particular variable to be sampled.

  • Page 92: Deleting An Rmon Alarm

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Parameter Description The index of the event that is used when a falling threshold is crossed. If there is no corresponding entryl in the Event Table, then no association exists. In particular, if this value is zero, no associated event will be generated.

  • Page 93: Managing Rmon Events

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Figure 36: RMON Alarms Form 1. Index Box    2. Variable Box    3. Rising Thr Box    4. Falling Thr Box    5. Value Box    6. Type Options    7. Interval Box    8. Startup Alarm List    9. Rising Event Box    10. Falling Event Box    11. Owner Box    12. Apply Button    13. Delete Button    14. Reload Button Click Delete.

  • Page 94: Viewing A List Of Rmon Events

    Chapter 3 RUGGEDCOM ROS Device Management User Guide • Section 3.9.3.3, “Deleting an RMON Event” Section 3.9.3.1 Viewing a List of RMON Events To view a list of RMON events, navigate to Ethernet Stats » Configure RMON Events . The RMON Events table appears.
  • Page 95 RUGGEDCOM ROS Chapter 3 User Guide Device Management Figure 39: RMON Events Form 1. Index Box    2. Type List    3. Community Box    4. Last Time Sent Box    5. Description Box    6. Owner Box    7. Apply Button    8. Delete Button    9. View Button    10. Reload Button Configure the following parameter(s) as required: Parameter...

  • Page 96: Deleting An Rmon Event

    Chapter 3 RUGGEDCOM ROS Device Management User Guide Section 3.9.3.3 Deleting an RMON Event To delete an RMON event, do the following: Navigate to Ethernet Stats » Configure RMON Events . The RMON Events table appears. Figure 40: RMON Events Table Select the event from the table. The RMON Events form appears.

  • Page 97: Upgrading Firmware

    Upgrading Firmware Upgrading RUGGEDCOM ROS firmware, including the main, bootloader and FPGA firmware, may be necessary to take advantage of new features or bug fixes. Binary firmware images are available from Siemens. Visit www.siemens.com/ruggedcom to determine which versions/updates are available or contact Siemens Customer Support.

  • Page 98: Resetting The Device

    Section 3.5, “Uploading/ Downloading Files” IMPORTANT! Never downgrade the RUGGEDCOM ROS software version beyond RUGGEDCOM ROS v4.3 when encryption is enabled. Make sure the device has been restored to factory defaults before downgrading. Restore the device to its factory defaults. For more information, refer to Section 3.3, “Restoring Factory...

  • Page 99: Decommissioning The Device

    RUGGEDCOM ROS Chapter 3 User Guide Device Management Section 3.12 Decommissioning the Device Before taking the device out of service, either permanently or for maintenance by a third-party, make sure the device has been fully decommissioned. This includes removing any sensitive, proprietary information.
  • Page 100 RUGGEDCOM ROS Chapter 3 User Guide Device Management Decommissioning the Device...

  • Page 101: System Administration

    RUGGEDCOM ROS Chapter 4 User Guide System Administration System Administration This chapter describes how to perform various administrative tasks related to device identification, user permissions, alarm configuration, certificates and keys, and more. CONTENTS • Section 4.1, “Configuring the System Information” •...

  • Page 102: Customizing The Login Screen

    For information about uploading and downloading files, refer to Section 3.5, “Uploading/Downloading Files” Section 4.3 Configuring Passwords RUGGEDCOM ROS allows for up to three user profiles to be configured locally on the device. Each profile corresponds to one of the following access levels: • Guest • Operator • Admin The access levels provide or restrict the user's ability to change settings and execute various commands.
  • Page 103 RUGGEDCOM ROS Chapter 4 User Guide System Administration User Type Rights Guest Operator Admin Change Basic Settings û ü ü Change Advanced Settings û û ü Run Commands û û ü Default passwords are configured for each user type initially. It is strongly recommended that these be changed before the device is commissioned.
  • Page 104 User Guide NOTE RUGGEDCOM ROS requires that all user passwords meet strict guidelines to prevent the use of weak passwords. When creating a new password, make sure it adheres to the following rules: • Must not be less than 8 characters in length.

  • Page 105: Clearing Private Data

    RUGGEDCOM ROS Chapter 4 User Guide System Administration Parameter Description Related password is in field Oper Password; cannot change settings; can reset alarms, statistics, logs, etc. Operator Password Synopsis:   19 character ASCII string Related username is in field Oper Username; cannot change settings;...

  • Page 106: Enabling/Disabling The Web Interface

    Chapter 4 RUGGEDCOM ROS System Administration User Guide clear private data When prompted "Do you want to clear private data (Yes/No)?", answer yes and press Enter within five seconds. All configuration and keys in flash will be zeroized. An entry in the event log will be created.

  • Page 107: Viewing A List Of Pre-Configured Alarms

    RUGGEDCOM ROS Chapter 4 User Guide System Administration NOTE Alarms are volatile in nature. All alarms (active and passive) are cleared at startup. CONTENTS • Section 4.6.1, “Viewing a List of Pre-Configured Alarms” • Section 4.6.2, “Viewing and Clearing Latched Alarms” •...

  • Page 108: Viewing And Clearing Latched Alarms

    Chapter 4 RUGGEDCOM ROS System Administration User Guide NOTE This list of alarms (configurable and non-configurable) is accessible through the Command Line Interface (CLI) using the alarms. For more information, refer to Section 2.6.1, “Available CLI Commands” For information about modifying a pre-configured alarm, refer to Section 4.6.3, “Configuring an Alarm”...
  • Page 109 RUGGEDCOM ROS Chapter 4 User Guide System Administration IMPORTANT! Critical and Alert level alarms are not configurable and cannot be disabled. Navigate to Diagnostic » Configure Alarms . The Alarms table appears. Figure 48: Alarms Table Select an alarm. The Alarms form appears.
  • Page 110 Chapter 4 RUGGEDCOM ROS System Administration User Guide Figure 49: Alarms Form 1. Name Box    2. Level Box    3. Latch Box    4. Trap Box    5. Log Box    6. LED & Relay Box    7. Refresh Time Box    8. Apply Button    9. Reload Button Configure the following parameter(s) as required: Parameter Description Name Synopsis:  ...

  • Page 111: Authentication Related Security Alarms

    In addition, when a weak password is configured on a unit or when the primary authentication server for TACACS+ or RADIUS is not reachable, RUGGEDCOM ROS will raise alarms, send SNMP traps and log messages in the syslog.
  • Page 112 Weak Password Configured Default Keys In Use RUGGEDCOM ROS generates this alarm and logs a message in the syslog when default keys are in use. For more information about default keys, refer to Section 1.8, “SSH and SSL Keys and Certificates”...

  • Page 113: Security Messages For Port Authentication

    MAC Address Authorization Failure RUGGEDCOM ROS generates this alarm and logs a message in the syslog when a host connected to a secure port on the device is communicating using a source MAC address which has not been authorized by RUGGEDCOM ROS, or the dynamically learned MAC address has exceeded the total number of MAC addresses configured to be learned dynamically on the secured port.

  • Page 114: Managing The Configuration File

    This message is only applicable when the security mode for a port is set to "802.1X or 802.1X/MAC-Auth" RUGGEDCOM ROS this alarm and logs a message in the syslog when the host connected to a secure port tries to communicate using incorrect login credentials.
  • Page 115 When sharing a configuration file between devices, make sure both devices have the same passphrase configured. Otherwise, the configuration file will be rejected. NOTE Encryption must be disabled before the device is returned to Siemens or the configuration file is shared with Customer Support. IMPORTANT! Never downgrade the RUGGEDCOM ROS software version beyond RUGGEDCOM ROS v4.3 when...

  • Page 116: Updating The Configuration File

    RUGGEDCOM ROS also has the ability to accept partial configuration updates. For example, to update only the parameters for Ethernet port 1 and leave all other parameters unchanged, transfer a file containing only the...

  • Page 117: Managing Radius Authentication

    Section 4.8.1 Managing RADIUS Authentication RUGGEDCOM ROS can be configured to act as a RADIUS client and forward user credentials to a RADIUS (Remote Authentication Dial In User Service) server for remote authentication and authorization. RADIUS is a UDP-based protocol used for carrying authentication, authorization and configuration information between a Network Access Server (NAS) that desires to authenticate its links and a shared authentication server.

  • Page 118: Configuring The Radius Server

    Chapter 4 RUGGEDCOM ROS System Administration User Guide Attribute Value EAP-Message { A message(s) received from the authenticating peer } EAP-Message is an extension attribute for RADIUS, as defined by 2869. CONTENTS • Section 4.8.1.1, “Configuring the RADIUS Server” • Section 4.8.1.2, “Configuring the RADIUS Client”...
  • Page 119 RUGGEDCOM ROS Chapter 4 User Guide System Administration Figure 51: RADIUS Server Table Select either Primary or Backup from the table. The RADIUS Server form appears. Figure 52: RADIUS Server Form 1. Server Box    2. IP Address Box    3. Auth UDP Port Box    4. Auth Key Box    5. Confirm Auth Key Box    6. Apply Button    7. Reload...

  • Page 120: Managing Tacacs+ Authentication

    Section 4.8.2.1 Configuring TACACS+ RUGGEDCOM ROS can be configured to use two TACACS+ servers: a primary server and a backup server. If the primary server is unavailable, the device will automatically attempt to connect with the backup server. To configure access to either the primary or backup TACACS+ servers, do the following: Navigate to Administration »...

  • Page 121: Configuring User Privileges

    RUGGEDCOM ROS Chapter 4 User Guide System Administration Figure 54: TACACS Plus Server Form 1. Server Box    2. IP Address Box    3. Auth TCP Port Box    4. Auth Key Box    5. Confirm Key Box    6. Apply Button    7. Reload Button Configure the following parameter(s) as required: Parameter Description Server Synopsis:  ...
  • Page 122 Chapter 4 RUGGEDCOM ROS System Administration User Guide To configure the privilege levels for each user type, do the following: Navigate to Administration » Configure Security Server » Configure TacPlus Server » Configure TACPLUS Serv Privilege Config . The TACPLUS Serv Privilege Config form appears.

  • Page 123: Setup And Configuration

    Chapter 5 User Guide Setup and Configuration Setup and Configuration This chapter describes how to setup and configure the device for use on a network using the various features available in RUGGEDCOM ROS. CONTENTS • Section 5.1, “Managing Time Services” •...
  • Page 124 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 56: Time and Date Form 1. Time    2. Date    3. Time Zone    4. DST Offset    5. DST Rule    6. Apply Button    7. Reload Button Configure the following parameter(s) as required: Parameter Description Synopsis:   HH:MM:SS Time This parameter allows for both the viewing and setting of the local time.

  • Page 125: Managing Ntp

    RUGGEDCOM ROS may be configured to refer periodically to a specified NTP server to correct any accumulated drift in the on-board clock. RUGGEDCOM ROS will also serve time via the Simple Network Time Protocol (SNTP) to hosts that request it.

  • Page 126: Configuring Ntp Servers

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Select Enabled to enable SNTP, or select Disabled to disable SNTP. Click Apply. Section 5.1.2.2 Configuring NTP Servers To configure either the primary or backup NTP server, do the following: Navigate to Administration » System Time Manager » Configure NTP » Configure NTP Servers . The NTP Servers table appears.

  • Page 127: Managing Snmp

    Section 5.2 Managing SNMP RUGGEDCOM ROS supports versions 1, 2 and 3 of the Simple Network Management Protocol (SNMP), otherwise referred to as SNMPv1, SNMPv2c and SNMPv3 respectively. SNMPv3 provides secure access to the devices through a combination of authentication and packet encryption over the network. Security features for this protocol...

  • Page 128: Managing Snmp Users

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide • Section 5.2.3, “Managing SNMP Groups” Section 5.2.1 Managing SNMP Users The following section describes how to configure and manage SNMP users. CONTENTS • Section 5.2.1.1, “Viewing a List of SNMP Users” • Section 5.2.1.2, “Adding an SNMP User”...
  • Page 129 7. Confirm Auth Key Box    8. Priv Key Box    9. Confirm Priv Key Box    10. Apply Button    11. Delete Button    12. Reload Button NOTE RUGGEDCOM ROS requires that all user passwords meet strict guidelines to prevent the use of weak passwords. When creating a new password, make sure it adheres to the following rules: •...
  • Page 130 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide • Must not include the username or any 4 continuous alphanumeric characters found in the username. For example, if the username is Subnet25, the password may not be subnet25admin or subnetadmin. However, net25admin or Sub25admin is permitted.

  • Page 131: Deleting An Snmp User

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description The secret encription key (password) that must be shared with SNMP client. If the key is not an emtpy string, it must be at least 6 characters long. Confirm Priv Key Synopsis:  ...

  • Page 132: Managing Security-To-Group Mapping

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 64: SNMP Users Form 1. Name Box    2. IP Address Box    3. v1/v2c Community Box    4. Auth Protocol Box    5. Priv Protocol Box    6. Auth Key Box    7. Confirm Auth Key Box    8. Priv Key Box    9. Confirm Priv Key Box    10. Apply Button    11. Delete Button    12. Reload Button Click Delete.

  • Page 133: Adding A Security-To-Group Map

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 65: SNMP Security to Group Maps Table If security-to-group maps have not been configured, add maps as needed. For more information, refer to Section 5.2.2.2, “Adding a Security-to-Group Map” Section 5.2.2.2 Adding a Security-to-Group Map Multiple combinations of security models and groups can be mapped (up to a maximum of 32) for SNMP.

  • Page 134: Deleting A Security-To-Group Map

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 67: SNMP Security to Group Maps Form 1. Security Model Box    2. Name Box    3. Group Box    4. Apply Button    5. Delete Button    6. Reload Button Configure the following parameter(s) as required: Parameter Description SecurityModel Synopsis:   { snmpV1, snmpV2c, snmpV3 } Default:  ...

  • Page 135: Managing Snmp Groups

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 68: SNMP Security to Group Maps Table Select the map from the table. The SNMP Security to Group Maps form appears. Figure 69: SNMP Security to Group Maps Form 1. Security Model Box    2. Name Box    3. Group Box    4. Apply Button    5. Delete Button    6. Reload Button Click Delete.

  • Page 136: Viewing A List Of Snmp Groups

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide • Section 5.2.3.3, “Deleting an SNMP Group” Section 5.2.3.1 Viewing a List of SNMP Groups To view a list of SNMP groups configured on the device, navigate to Administration » Configure SNMP » Configure SNMP Access . The SNMP Access table appears.
  • Page 137 RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 72: SNMP Access Form 1. Group Box    2. Security Model Box    3. Security Level Box    4. ReadViewName Box    5. WriteViewName Box    6. NotifyViewName Box    7. Apply Button    8. Delete Button    9. Reload Button Configure the following parameter(s) as required: Parameter Description Group Synopsis:  ...

  • Page 138: Deleting An Snmp Group

    1. Group Box    2. Security Model Box    3. Security Level Box    4. ReadViewName Box    5. WriteViewName Box    6. NotifyViewName Box    7. Apply Button    8. Delete Button    9. Reload Button Click Delete. Section 5.3 Managing Network Discovery RUGGEDCOM ROS supports the RUGGEDCOM Discovery Protocol (RCDP), a Layer 2 protocol for automated network discovery. Deleting an SNMP Group...

  • Page 139: Managing Serial Protocols

    RUGGEDCOM Discovery Protocol (RCDP) supports the deployment of RUGGEDCOM ROS-based devices that have not been configured since leaving the factory. RUGGEDCOM ROS devices that have not been configured all have the default IP (Layer 3) address. Connecting more than one of them on a Layer 2 network means that one cannot use standard IP-based configuration tools to configure them.
  • Page 140 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide NOTE The setting of Differentiated Services Code Point (DSCP) in the IP header is provided for TCP/IP and UDP/ IP transport in the egress direction only. NOTE Debugging facilities include statistics and tracing information on a serial port and/or network transport.

  • Page 141: Encapsulation Concepts

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Protocol Features • Compliant with RFC2217 [http://tools.ietf.org/html/rfc2217] CONTENTS • Section 5.4.1, “Encapsulation Concepts” • Section 5.4.2, “Modbus Concepts” • Section 5.4.3, “DNP, Microlok, TIN and WIN Concepts” • Section 5.4.4, “Force Half-Duplex (HD) Operation Mode”...

  • Page 142: Raw Socket Character Encapsulation

    Remote Terminal Unit (RTU) polling applies to a variety of RTU protocols, including Modbus ASCII and DNP. NOTE If a given device or service employs a serial protocol that is supported by RUGGEDCOM ROS, it is advised to configure RUGGEDCOM ROS to use that particular protocol, rather than another one (e.g.

  • Page 143: Broadcast Rtu Polling

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 76: RTU Polling 1. Host    2. Host with Port Redirection Software    3.  RMC30     4. Ethernet    5. RTU If a server is used at the host end, it will wait for a request from the host, encapsulate it in an IP Datagram and send it to the remote side.

  • Page 144: Preemptive Raw Socket

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 77: Broadcast RTU Polling 1. Host    2.  RMC30     3. Ethernet    4. RTU Initially, the remote servers establish connections with the host server. The host server is configured to accept a maximum of three incoming connections.

  • Page 145: Port Redirectors

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 78: Permanent and Dynamic Master Connection Support 1. Permanent Master (Polling RTUs)    2. Dynamic Master    3.  RMC30     4. Ethernet    5. RTU The permanent master is connected to the Raw Socket port of the RMC30. Raw Socket is configured to be connected to all Preemptive Raw Socket ports where polled RTUs are connected (multiple incoming connection).

  • Page 146: Message Packetization

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Section 5.4.1.6 Message Packetization The serial server buffers received characters into packets to improve network efficiency and demarcate messages. The server uses three methods to decide when to packetize and forward the buffered characters to the network: •...

  • Page 147: Modbus Tcp Performance Determinants

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Protocol (TCP), respecting the Modbus TCP protocol, and forwards the frame to a Server Gateway or native Modbus TCP RTU. Returning responses are stripped of their TCP headers and issued to the master.
  • Page 148 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 80: Sources of Delay and Error in an End-to-End Exchange 1. Master    2. Client Gateway    3. Server Gateway    4. Remote Terminal Unit (RTU) In step 1a, the master issues a request to the Client Gateway. If the Client Gateway validates the message, it will forward it to the network as step 2.

  • Page 149: Turnaround Delay

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Section 5.4.2.3 Turnaround Delay The Modbus protocol uses the concept of a turnaround delay in conjunction with broadcast messages. When the host sends a broadcast message (that does not invoke an RTU response), it waits for a turnaround delay time. This delay makes sure the RTU has enough time to process the broadcast message before it receives the next poll.

  • Page 150: The Concept Of Links

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 81: Source/Destination Two-Way Communication 1. Device 1    2.  RMC30 Client Gateway    3. Ethernet    4.  RMC30 Server Gateway Even if the protocol can distinguish between the server and client sides, ROS does not. Both sides need to know where on the network a given destination device is.

  • Page 151: Address Learning For Dnp

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Address Learning for TIN Mode 1 When a message with an unknown source address is received from the IP network, it is learned on the IP address and IP port. If a message with the same source address is received from another IP address and/or IP port, the address will be relearned.

  • Page 152: Broadcast Messages

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Section 5.4.3.5 Broadcast Messages DNP Broadcast Messages Addresses 65521 through 65535 are DNP 3.0 broadcast addresses. ROS supports broadcasts sending messages with those destination addresses received from serial ports to all IP Addresses found in the Device Address Table (either learned or statically configured).

  • Page 153: Force Half-Duplex (Hd) Operation Mode

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration The Raw Socket mechanism transparently passes data. It does not attempt to determine where to demarcate packets in the data received from connected devices. Given this transparency, any protocol can be encapsulated within Raw Socket.

  • Page 154: Configuring A Serial Port

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 82: Optical Loop Topology 1. RS485 Slave with Repeat On    2. RMC20    3. Multiple RMC20s    4. RMC20 in Force Half-Duplex Mode    5. RS-232/422 with Repeat On    6.  RUGGEDCOM Server    7. Ethernet    8. RS485 Master The repeat function will optically retransmit any data received on the optical receiver, in addition to any connected serial devices.
  • Page 155 RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 84: Serial Ports Form 1. Port Box    2. Name Box    3. Protocol List    4. Type List    5. ForceHD Options    6. Baud Box    7. Data Bits Options    8. Stop List    9. Parity List    10. Turnaround Box    11. PostTx Delay Box    12. Hold Time Box    13. DSCP Box    14. RxtoTx Delay Box    15. Apply Button   ...
  • Page 156 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Parameter Description Default:   Off Enables forcing half-duplex mode of operation. While sending data out of the serial port, all received data are ignored. This mode of operation is available only on ports that operate in full- duplex mode.

  • Page 157: Configuring The Raw Socket Protocol

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Click Apply. Section 5.4.6 Configuring the Raw Socket Protocol To configure the Raw Socket protocol for a serial port, do the following: Make sure the serial port is configured to use the Raw Socket protocol. For more information, refer to Section 5.4.5, “Configuring a Serial Port”...
  • Page 158 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 86: Protocol Form 1. Port Box    2. Pack Char Box    3. Pack Timer Box    4. Pack Size Box    5. Flow Control Options    6. Response Time Box    7. Response Dest Options    8. Transport Options    9. Call Dir List    10. Max Conns Box    11. Loc Port Box    12. Rem Port Box    13. IP Address Box   ...
  • Page 159 RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description Flow Control Synopsis:   { None, XON/XOFF } Default:   None The Flowcontrol setting for serial port. Response Time Synopsis:   50 to 60000 ms or { Off } Default:  ...

  • Page 160: Configuring The Preemptive Raw Socket Protocol

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Parameter Description Default:   Enabled Enables link statistics collection for the protocol. Click Apply. Add one or more remote hosts. For more information, refer to Section 5.4.16.2, “Adding a Remote Host” Section 5.4.7...
  • Page 161 RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 88: Preemptive Raw Socket Form 1. Port Box    2. Pack Char Box    3. Pack Timer Box    4. Pack Size Box    5. Flow Control Options    6. Loc Port Box    7. Rem Port Box    8. IP Address Box    9. Link Stats Options    10. Dyn Pack Char Box    11. Dyn Pack Timer Box    12. Timeout Box    13. Apply Button   ...

  • Page 162: Configuring A Tcp Modbus Server

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Parameter Description The port number as seen on the front plate silkscreen of the switch. Pack Char Synopsis:   0 to 255 or { Off } Default:   Off The character that can be used to force forwarding of accumulated data to the network.If a packetization character is...
  • Page 163 RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 89: Modbus Server Table Select a serial port. The Modbus Server form appears. Figure 90: Modbus Server Form 1. Port Box    2. Response Timer Box    3. Auxiliary TCP Port Box    4. Send Exceptions Options    5. Link Stats Options    6. Apply Button   ...

  • Page 164: Configuring A Tcp Modbus Client

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Parameter Description Enables link statistics collection for this protocol. Click Apply. Section 5.4.9 Configuring a TCP Modbus Client To configure the TCP Modbus Client protocol for a serial port, do the following: Make sure the serial port is configured to use the TCP Modbus Client protocol.

  • Page 165: Configuring The Win And Tin Protocols

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description Default:   0 To set the DS byte in the IP header. DS byte setting is supported in the egress direction only. Click Apply. Section 5.4.10 Configuring the WIN and TIN Protocols To configure the WIN or TIN protocols for a serial port, do the following: Make sure the serial port is configured to use either the WIN or TIN protocol.
  • Page 166 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Parameter Description TIN Transport Synopsis:   { TCP, UDP, Disabled } Default:   UDP The network transport used to transport protocol data over an IP network. WIN Transport Synopsis:   { TCP, UDP, Disabled } Default:  ...

  • Page 167: Configuring The Microlok Protocol

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Click Apply. Section 5.4.11 Configuring the MicroLok Protocol To configure the MicroLok protocol for a serial port, do the following: Make sure the serial port is configured to use the MicroLok protocol. For more information, refer to Section 5.4.5, “Configuring a Serial Port”...

  • Page 168: Configuring The Dnp Protocol

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Section 5.4.12 Configuring the DNP Protocol To configure the DNP protocol for a serial port, do the following: Make sure the serial port is configured to use the DNP protocol. For more information, refer to Section 5.4.5,...

  • Page 169: Configuring The Dnp Over Raw Socket Protocol

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description sent to the subnet of the address configured for learning and source addresses will be learned. If local address is not known, message will be sent to all serial ports running DNP protocol.
  • Page 170 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 96: DNP over RawSocket Form 1. Port Box    2. Response Time Box    3. Response Dest Options    4. Transport Options    5. Call Dir List    6. Max Conns Box    7. Loc Port Box    8. Rem Port Box    9. IP Address Box    10. Link Stats Options    11. Apply Button    12. Reload Button...

  • Page 171: Configuring The Mirrored Bits Protocol

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description Max Conns Synopsis:   1 to 64 Default:   1 The maximum number of allowed incoming TCP connections. Loc Port Synopsis:   1 to 65535 Default:   21001 The local IP port to use when listening for an incoming connection or UDP data.
  • Page 172 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 97: Mirrored Bits Table Select a serial port. The Mirrored Bits form appears. Figure 98: Mirrored Bits Form 1. Port Box    2. Transport Box    3. Loc Port Box    4. Rem Port Box    5. IP Address Box    6. Link Stats Options    7. Apply Button   ...

  • Page 173: Configuring The Telnet Com Port Protocol

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description IP Address Synopsis:   ###.###.###.### where ### ranges from 0 to 255 or { <EMPTY STRING> } Default: For an outgoing TCP connection (client) and UDP transport, this is the remote IP address to communicate with.
  • Page 174 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 100: Telnet Com Port Form 1. Port Box    2. Pack Char Box    3. Pack Timer Box    4. Pack Size Box    5. Flow Control Options    6. Call Dir List    7. Loc Port Box    8. Rem Port Box    9. IP Address Box    10. Link Stats Options    11. Apply Button    12. Reload Button...

  • Page 175: Managing Raw Socket Remote Hosts

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description Default:   In The Call direction for TCP Transport. • Whether to accept an incoming connection or • to place an outgoing connection or • to place outgoing connection and wait for incoming (both directions).

  • Page 176: Viewing A List Of Remote Hosts

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide • Section 5.4.16.3, “Deleting a Remote Host” Section 5.4.16.1 Viewing a List of Remote Hosts To view a list of remote hosts configured for the Raw socket protocol, navigate to Serial Protocols » Configure Protocols »...

  • Page 177: Deleting A Remote Host

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 103: Remote Hosts Form 1. IP Address Box    2. IP Port Box    3. Port(s) Box    4. Apply Button    5. Delete Button    6. Reload Button Configure the following parameter(s) as required: Parameter Description IP Address Synopsis:   ###.###.###.### where ### ranges from 0 to 255 Default:  ...

  • Page 178: Managing Device Addresses

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 104: Remote Table Select the remote host from the table. The Remote form appears. Figure 105: Remote Form 1. IP Address Box    2. IP Port Box    3. Port(s) Box    4. Apply Button    5. Delete Button    6. Reload Button Click Delete.

  • Page 179: Adding A Device Address

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Figure 106: Device Address Table Table If device addresses have not been configured, add addresses as needed. For more information, refer to Section 5.4.17.2, “Adding a Device Address” Section 5.4.17.2 Adding a Device Address To add a device address, do the following: Navigate to Serial Protocols »...
  • Page 180 Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 108: Device Address Table Form 1. Protocol List    2. Address Box    3. Remote IP Address Box    4. Port Box    5. Name Box    6. Apply Button    7. Delete Button    8. Reload Button Configure the following parameter(s) as required: Parameter Description Protocol Synopsis:  ...

  • Page 181: Deleting A Device Address

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description The serial port to which a device is attached. If the device with this address is attached to the serial port of a remote host, the value of this parameter is 'Unknown'.

  • Page 182: Viewing The Tin Dynamic Address Table

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Figure 110: Device Address Table Form 1. Protocol List    2. Address Box    3. Remote IP Address Box    4. Port Box    5. Name Box    6. Apply Button    7. Delete Button    8. Reload Button Click Delete. Section 5.4.18 Viewing the TIN Dynamic Address Table To view the device addresses learned dynamically by the TIN protocol from remote locations, navigate to Serial Protocols »...

  • Page 183: Viewing Statistics For Serial Protocol Links

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration Parameter Description The signal strength indicator received from wayside data radio. N/A for TIN Mode 1. Aging Time Synopsis:   0 to 1000 s The amount of time since the last packet arrived from the device.

  • Page 184: Viewing Statistics For Serial Protocol Connections

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Section 5.4.20 Viewing Statistics for Serial Protocol Connections To view statistics for serial protocol connections, navigate to Serial Protocols » View Connection Statistics . The Connection Statistics table appears. Figure 113: Connection Statistics Table This table displays the following information:...

  • Page 185: Clearing Statistics For Specific Serial Ports

    RUGGEDCOM ROS Chapter 5 User Guide Setup and Configuration This table displays the following information: Parameter Description Port Synopsis:   1 to maximum port number The port number as seen on the front plate silkscreen of the switch. Protocol Synopsis:   Any 15 characters The serial protocol supported on this serial port.

  • Page 186: Resetting Serial Ports

    Chapter 5 RUGGEDCOM ROS Setup and Configuration User Guide Click Confirm. Section 5.4.23 Resetting Serial Ports To reset a specific serial port(s), do the following: Navigate to Serial Protocols » Reset Serial Port(s) . The Reset Serial Port(s) form appears. Figure 116: Reset Serial Port(s) Form 1. Ports   ...

  • Page 187: Troubleshooting

    RUGGEDCOM ROS Chapter 6 User Guide Troubleshooting Troubleshooting This chapter describes troubleshooting steps for common issues that may be encountered when using RUGGEDCOM ROS or designing a network. IMPORTANT! For further assistance, contact a Customer Service representative. CONTENTS • Section 6.1, “General”...
  • Page 188 RUGGEDCOM ROS Chapter 6 User Guide Troubleshooting General...

Table of Contents