Skip to content

Commit 903bb6b

Browse files
committed
Add upgrade note
1 parent 885a518 commit 903bb6b

File tree

1 file changed

+67
-0
lines changed

1 file changed

+67
-0
lines changed

README.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,73 @@ sudo systemctl status whatpulse-pcap-service
111111

112112
The service will automatically connect to WhatPulse when both are running. No additional WhatPulse configuration is needed in most cases.
113113

114+
## Upgrading
115+
116+
### Package Manager Upgrade
117+
118+
If you installed via package manager, upgrading is straightforward:
119+
120+
#### Debian/Ubuntu
121+
```bash
122+
# Download the new .deb package from releases, then:
123+
sudo dpkg -i whatpulse-pcap-service_*_amd64.deb
124+
sudo apt-get install -f # Fix any dependencies if needed
125+
126+
# Or if added to a repository:
127+
sudo apt-get update && sudo apt-get upgrade whatpulse-pcap-service
128+
```
129+
130+
#### Red Hat/Fedora/CentOS
131+
```bash
132+
# Download the new .rpm package from releases, then:
133+
sudo rpm -Uvh whatpulse-pcap-service-*-1.x86_64.rpm
134+
# OR on Fedora/newer systems:
135+
sudo dnf upgrade whatpulse-pcap-service-*-1.x86_64.rpm
136+
```
137+
138+
#### Arch Linux
139+
```bash
140+
# Download the new package from releases, then:
141+
sudo pacman -U whatpulse-pcap-service-*-1-x86_64.pkg.tar.*
142+
```
143+
144+
### Manual/Source Upgrade
145+
146+
For manual installations, follow these steps:
147+
148+
```bash
149+
# Stop the service
150+
sudo systemctl stop whatpulse-pcap-service
151+
152+
# Download and extract the new source
153+
tar xzf whatpulse-pcap-service-*-source.tar.gz
154+
cd whatpulse-pcap-service-*
155+
156+
# Build and install
157+
make
158+
sudo make install
159+
160+
# Restart the service
161+
sudo systemctl start whatpulse-pcap-service
162+
163+
# Verify the upgrade
164+
sudo systemctl status whatpulse-pcap-service
165+
```
166+
167+
### Checking Version
168+
169+
To verify which version is currently installed:
170+
171+
```bash
172+
# Check the service version
173+
whatpulse-pcap-service --version
174+
175+
# Or check systemd service status
176+
sudo systemctl status whatpulse-pcap-service
177+
```
178+
179+
**Note:** The service may need to be restarted after upgrading to ensure the new version is running. Package manager installations typically handle this automatically, but manual installations may require a manual restart.
180+
114181
## Troubleshooting
115182

116183
### Check Service Status

0 commit comments

Comments
 (0)