Skip to content

Running Nexus

Day-to-day operation of an existing install.

Starting and stopping

powershell
sc query RayluxNexus
sc stop  RayluxNexus
sc start RayluxNexus
bash
systemctl status raylux-nexus
sudo systemctl stop raylux-nexus
sudo systemctl start raylux-nexus

The service starts automatically with the machine. If you stop it deliberately it stays stopped — it is configured to restart after a crash, not after an administrator stops it.

An administrator can also shut Nexus down from the web interface. That counts as a deliberate stop, so it will not restart on its own.

Watching the log

powershell
Get-Content C:\ProgramData\Raylux\logs\raylux_nexus.log -Wait
bash
journalctl -u raylux-nexus -f

Administrators can also read the log in the browser, on Nexus's Logs page, without access to the server.

There is no Windows Event Log integration

Start-up failures show up as a service-specific exit code and in the log file above, not in Event Viewer.

Health checks

Two endpoints answer without a sign-in, and disclose nothing about the installation. Point your monitoring at them.

EndpointMeaningUse it for
/healthThe process is alive and answering.Liveness — "should this be restarted?"
/health/readyNexus has finished starting and can serve.Readiness — "should traffic go here?"
bash
curl http://nexus:8080/health          # {"status":"ok"}
curl http://nexus:8080/health/ready    # {"status":"ready"}

/health/ready returns 503 until start-up completes. A load balancer should gate on readiness, not liveness — restarting a Nexus instance that is merely still starting makes an outage longer.

Keeping an eye on it

The Performance page trends CPU, memory, threads and handles. Nexus also publishes them as [SYSTEM] tags, so you can trend and alarm on them from a screen like any other value:

TagWhat it tells you
[SYSTEM]ResourceHealthA single overall verdict.
[SYSTEM]MemoryTrendMbPerHourSustained memory growth, distinguished from normal sawtooth.
[SYSTEM]ThreadCount, [SYSTEM]HandleCountLeaks that memory alone would not show.

On a new deployment, watch these over the first week.

In this section