Migration Guide

From existing SAMMI installation to browser access in three steps. No changes to your peers. No changes to your formats.

Prerequisites

SAMMI Environment

  • ✓ SAMMI 7.x installed and running
  • ✓ Peer applications operational
  • ✓ Format files (.fmt) accessible

Sammi Server Machine

  • ✓ RHEL 8 or 9 (VM or physical)
  • ✓ Network access to SAMMI peers
  • ✓ 4 GB RAM, 2 CPU cores (minimum)
  • ✓ Port 443 (HTTPS) open to operator browsers

Deployment Steps

1

Install Sammi Server

Install the SammiWeb package on your designated RHEL machine. The installer configures Sammi Server, the WebSocket Gateway, and the nginx web server.

# Install SammiWeb package
sudo rpm -i sammiweb-1.0.0.rpm
# Configure SAMMI peer connectivity
sudo sammiweb-config --sammi-host <your-sammi-host>
# Start services
sudo systemctl start sammiweb
2

Convert Your Formats

Run the automated conversion tool to transform your SAMMI formats into web-ready pages. The converter handles all DDO types, background images, and dynamic objects.

# Convert all formats in a directory
sammiweb-convert --input /path/to/asc/files --output /var/www/sammiweb/pages/
# Or convert a single format
sammiweb-convert --input my_display.asc --output /var/www/sammiweb/pages/

The conversion tool processes .asc text format files. Use fmt2asc to convert binary .fmt files first if needed.

3

Open a Browser

Navigate to your SammiWeb URL and see your displays live with real-time data. That's it — your operators are now using SammiWeb.

# Open in any browser
https://<sammiweb-host>/
# Navigate directly to a specific format
https://<sammiweb-host>/pages/my_display

What Gets Converted

Fully Supported

  • All 40+ DDO widget types (meters, gauges, trends, etc.)
  • Push buttons, toggles, text entry fields
  • Background images and custom graphics
  • Static objects (rectangles, polygons, text, splines)
  • Dynamic objects (DOBJ) with animation
  • Data bindings (read keys, write keys)
  • Threshold colors and alarm limits
  • Layer organization

Coming Soon

  • Historical data association (HDA)
  • Format-to-format navigation links
  • Print functionality
  • Composite symbols

Need Help Getting Started?

Our team can walk you through the installation and conversion process, or do it for you.

Schedule a Demo