Implementation Guide
This guide covers the end-to-end process of deploying MOSES at a new plant — from site survey to first operator login.
Phase 1: Site survey (½ day)
An ONS implementation engineer visits the plant to assess:
- PLC brands, models, and firmware versions
- Available communication protocols (OPC-UA server? MQTT broker? Modbus TCP?)
- Network topology — is there a segregated OT network? Is internet access available?
- Available hardware for the IVM gateway (industrial PC or ruggedised mini PC)
- Number of machines to be connected in phase 1
Phase 2: IVM gateway installation (½ day)
The IVM edge gateway is installed on the chosen hardware. Requirements:
- Ubuntu 22.04 LTS or later (or Windows Server 2019+)
- Node.js 20+, PostgreSQL 15+, Docker (optional)
- LAN access to PLC IP addresses on the OT network
- HTTPS access to the portal URL (outbound only, port 443)
# Clone IVM repository git clone https://github.com/OpenNetworkSolutions/MOSES.git cd MOSES/IVM # Install dependencies npm install # Configure environment cp .env.example .env # Edit .env with your DATABASE_URL, PORTAL_URL, and INGEST_API_KEY # Run database setup npm run db:migrate # Start IVM service npm start
Phase 3: Machine provisioning (1–2 hours)
Log in to the portal as a super-admin and navigate to Machines → Add Machine. For each machine, provide:
- Machine ID (integer, must match what IVM sends in
machine_id) - Display name, type, and plant/line assignment
- Column configuration — map sensor tag names to display labels
Phase 4: Workflow setup (2–3 hours)
Build your first set of operational workflows. Recommended starting workflows:
- Machine fault → notify shift supervisor via SMS and portal alert
- Sensor threshold exceeded → create maintenance work order
- Quality form failure → escalate to QA manager
- Shift end → send shift summary report to plant head
Phase 5: Operator training (2 hours)
The portal is designed for shop-floor workers with minimal computer experience. Training covers: logging in, viewing the dashboard, reading machine status, submitting forms, and reporting events.
Most operators are comfortable with the portal within 20 minutes of hands-on use.ONS Implementation Team