diff --git a/docs_src/usersguide/monitoring.md b/docs_src/usersguide/monitoring.md index 1d064d6e..32aad339 100644 --- a/docs_src/usersguide/monitoring.md +++ b/docs_src/usersguide/monitoring.md @@ -6,15 +6,36 @@ help you diagnose problems. ## Status -If WeeWX is running in the background, you can use the system's `init` tools -to check the status. For example, on systems that use `systemd`, check it -like this: -```{.shell .copy} -systemctl status weewx +If WeeWX was configured to run as a daemon, you can use the system's `init` +tools to check the status. + +=== "systemd" + + ```{ .shell .copy } + # For Linux systems that use systemd, e.g., Debian, Redhat, SUSE + sudo systemctl status weewx + ``` + +=== "sysV" + + ```{ .shell .copy } + # For Linux systems that use SysV init, e.g., Slackware, Devuan, Puppy + sudo /etc/init.d/weewx status + ``` + +=== "BSD" + + ```{ .shell .copy } + # For BSD systems, e.g., FreeBSD, OpenBSD + sudo service weewx status + ``` + +Another way to see whether WeeWX is running is the `ps` tool. For example, +this will tell you whether `weewxd` is running, and if it is, you will see the +additional information including process identifier (PID), memory used, and +how long it has been running. ``` -On systems that use `sysV` init scripts, check it like this: -```{.shell .copy} -/etc/init.d/weewx status +ps aux | grep weewxd ``` ## Reports diff --git a/docs_src/usersguide/running.md b/docs_src/usersguide/running.md index 68a29eaf..cc3c9ba7 100644 --- a/docs_src/usersguide/running.md +++ b/docs_src/usersguide/running.md @@ -45,7 +45,7 @@ other stations. ## Running as a daemon For unattended operations it is best to have WeeWX run as a daemon, so that -it is started automatically when the computer is rebooted. +it is started automatically when the computer starts up. If you installed WeeWX from DEB or RPM package, the daemon configuration is done automatically; the installer finishes with WeeWX running in the diff --git a/docs_src/usersguide/where.md b/docs_src/usersguide/where.md index e36c2924..73ef4641 100644 --- a/docs_src/usersguide/where.md +++ b/docs_src/usersguide/where.md @@ -83,9 +83,9 @@ the executables will depend on how the installation was done. | Install method | Commands | Location of executables | |-----------------------------------------------------|------------------------------------------------------------------------------|-------------------------| | Virtual environment
(recommended) | `python3 -m venv ~/ve`
`source ~/ve/bin/activate`
`pip3 install weewx` | `~/ve/bin/` | -| pip, no sudo, with `--user` | `pip3 install weewx --user` | `~/.local/bin/` | -| pip, no sudo, no `--user` | `pip3 install weewx` | `~/.local/bin/` | -| pip with sudo
(not recommended) | `sudo pip3 install weewx` | `/usr/local/bin/` (1) | -| Virtual environment with `--user`
(not allowed) | `python3 -m venv ~/ve`
`source ~/ve/bin/activate`
`pip3 install weewx --user` | N/A | +| pip
no sudo
with `--user` | `pip3 install weewx --user` | `~/.local/bin/` | +| pip
no sudo
no `--user` | `pip3 install weewx` | `~/.local/bin/` | +| pip
with sudo
(not recommended) | `sudo pip3 install weewx` | `/usr/local/bin/` (1) | +| Virtual environment
with `--user`
(not allowed) | `python3 -m venv ~/ve`
`source ~/ve/bin/activate`
`pip3 install weewx --user` | N/A | (1) Checked on Ubuntu 22.02 and Rocky v9.1