Prime RMS Setup Guide

What you are setting up

Prime RMS watches your remote sites, raises alarms, and lets you control equipment from anywhere. Two things make it work:

The gateway — a small computer in the cabinet at each site. It reads the meters, batteries, generator, fuel probe and sensors, and sends the numbers to Prime RMS. The software on it is the Prime Gate Agent.
The console — this website, where you see every site, get alarms, and press buttons to start a generator or open a lock.

You do Part A once in the console, then Part B on the gateway at the site. That is the whole job.

You never edit code. You fill in a couple of forms, run one command on the gateway, and list the things you want to read in a plain text file.

What you need before you start

A login	A Prime administrator account, or an owner account an admin created for you. Test it now: open the fleet admin page and sign in.
A gateway	Any small Linux computer: a Teltonika RUT956 router, an Advantech or Moxa gateway, or even a Raspberry Pi. It needs internet (SIM or Ethernet) and a USB-to-RS485 adapter for the equipment bus.
Wiring	The RS-485 wires from your meter, generator controller, battery and sensors into the gateway, and the fuel probe into a small input module. An electrician usually does this part.
The device list	The make and model of each thing you want to monitor. Prime supplies the settings for common ones (Huawei power units, Deepsea generators, standard meters and fuel probes).

Part A — Set up the site in the console

Create the site

Open Fleet admin, sign in, and go to the Sites tab. Fill in a short site id (for example KIN-001), a name, and the town. Press Create. The site now appears in the list, shown as offline until a gateway checks in.

Get the install command

On that same row, press New code. Prime shows a one-line install command that already contains a private code for this site, like:

curl -fsSL https://rms.primerp.ai/sdk/install.sh | sudo sh -s -- --code KIN-001-AB12CD

Copy it. You will paste it on the gateway in Part B. The code is good for 24 hours and can be used once.

Part B — Set up the gateway at the site

Get onto the gateway

Connect to the gateway's command line. On most gateways that is SSH; on a Teltonika router it is the terminal in its web page. If you can type commands and the gateway can reach the internet, you are ready.

On a Teltonika RutOS router you cannot install the agent. Skip to Teltonika routers below, which uses the router's built-in "Data to Server" instead.

Run the install command

Paste the command from step 2 and press enter. It installs the Prime Gate Agent, registers the gateway to your site, and starts it. When it finishes you will see the service reported as active.

Right away the gateway starts reporting its own health (CPU, temperature, signal). Refresh the console and the site turns online. Now you tell it what equipment to read.

List the equipment to read

Open the settings file on the gateway:

sudo nano /etc/prime-gate/agent.yaml

This file is a simple list. Each line is one reading: a name, how to read it, and where. Do not start from scratch. Download a ready-made list for a site like yours and use it as your starting point:

Telecom tower site — grid meter, rectifier, generator, fuel, sensors, security.
Solar-hybrid site · Fuel depot · Data-center room.
Huawei-powered site — reads an existing Huawei power unit over its network port.

Change the addresses to match your wiring, delete the lines you do not have, and save. A single reading looks like this, and you can copy a line and change the name and address:

points:
  - { key: fuel.level_pct, driver: modbus, device: rs485,
      name: Fuel level, unit: "%", domain: fuel,
      params: { unit: 20, table: input, address: 0 },
      thresholds: { critical: { lt: 10 }, major: { lt: 20 } } }

You usually do not type addresses at all: pick your equipment by brand and model from the device profile list and just give its id, like { profile: dse72xx, device: rs485, params: { unit: 10 } } for a Deepsea generator. Prime fills in the rest.

In plain words: read the fuel level from the device on the RS-485 bus, and raise a critical alarm under 10% and a major one under 20%.

Test the wiring before you trust it

Run this to read every line once and print the value:

prime-gate read

Each line shows OK with a number, or BAD with the reason. If something is BAD, the wiring or the address is wrong for that one line. Fix it and run it again until the important lines read OK.

Start it for good

Apply the file and let the gateway run on its own:

sudo systemctl restart prime-gate

That is it. The gateway now reads every point on a schedule, raises alarms, buffers data if the internet drops (for days), and comes back on its own. Open the console: your site shows live readings, and its points appear under Points and control.

Using it day to day

See a site

In the console switch the data mode to Live and pick your site. You see power, battery, fuel, generator, alarms and a map.

Get told about problems

In Fleet admin, Alert contacts, add a name and email (and phone if SMS is set up). Choose which severities matter to that person. Press Send me a test email to confirm it works. From then on, alarms email the right people, and critical ones that nobody acknowledges are escalated automatically.

Acknowledge and control

On the Alarms tab, press Ack to say you are handling one. On Points and control, controllable points (a generator start, a lock, a load-shed relay) have a Control button. It always asks for a reason, and every action is logged with who did it and the result read back from the gateway.

Reports

On the Reports tab, download a PDF for the fleet, a client, or one site, or schedule one to email itself every day or week.

Teltonika RutOS routers (no install)

Teltonika routers run their own system, so instead of installing the agent you point their built-in Data to Server feature at Prime RMS. The full step-by-step is here:

RutOS Data to Server guide · MQTT option for other gateways · What equipment Prime RMS supports

If something is not working

The site stays offline after install

The gateway cannot reach the internet, or the install code expired. Check the gateway's connection, then in Fleet admin press New code and run the install command again.

A reading shows BAD in prime-gate read

That one device's address is wrong or the wire is loose. Check the RS-485 A/B wires and the device's slave id and register address against the vendor sheet. Other readings are unaffected.

Some devices read but others do not

Devices on one RS-485 bus must each have a unique id and share the same baud rate. Two devices with the same id clash. Confirm each device's id.

I can log in but see no sites

Your account is scoped to a client or specific sites and none exist yet, or an owner has not given you access. Ask an owner to check your role and scope under Users.

See what the gateway is doing

On the gateway run journalctl -u prime-gate -f to watch it live, or prime-gate status for a quick summary of its buffer and connection.

Plain-word glossary

Gateway	The small computer in the cabinet that does the reading.
Point	One thing you read or control, like "fuel level" or "generator start".
Modbus / SNMP	The two common languages equipment speaks. You pick one per device; Prime handles the rest.
RS-485	The two-wire cable that chains meters, generators and sensors to the gateway.
Threshold	The limit that turns a reading into an alarm, for example fuel under 20%.
Enrollment code	The one-time code that ties a gateway to a site during install.