2016-04-18 12:02:10 +02:00
# Log2Ram
2016-10-20 12:47:56 +02:00
Like ramlog for systemd (on debian 8 jessie for example).
2016-04-20 10:47:39 +02:00
2017-12-18 19:23:23 +01:00
Usefull for **RaspberryPi** for not writing on the SD card all the time. You need it because your SD card doesn't want to suffer anymore!
2016-04-18 12:03:41 +02:00
2021-02-21 22:31:36 +01:00
Explanations: The script creates a `/var/log` mount point in RAM. So any writing of the log to the `/var/log` folder will not actually be written to disk (in this case to the SD card for a Raspberry Pi) but directly to RAM. By default, every day, the CRON will launch a synchronization of the RAM to the folder located on the physical disk. The script will also make this copy of RAM to disk in case of machine shutdown (but cannot do it in case of power failure). This way you avoid excessive writing on the SD card.
2018-07-18 21:24:43 +02:00
2017-04-27 11:24:05 +02:00
The script [log2ram ](https://github.com/azlux/log2ram ) can work on every linux system. So you can use it with your own daemon manager if you don't have systemd.
2016-10-20 12:47:56 +02:00
2016-04-18 12:02:10 +02:00
Log2Ram is based on transient log for Systemd here : [A transient /var/log ](https://www.debian-administration.org/article/661/A_transient_/var/log )
2018-04-23 18:11:06 +02:00
_____
## Menu
1. [Install ](#install )
2. [Upgrade ](#upgrade )
3. [Customize ](#customize )
4. [It is working ? ](#it-is-working )
5. [Uninstall ](#uninstall- )
2016-04-18 12:03:41 +02:00
## Install
2019-12-19 16:51:27 +01:00
### With APT (recommended)
2019-12-19 17:07:49 +01:00
echo "deb http://packages.azlux.fr/debian/ buster main" | sudo tee /etc/apt/sources.list.d/azlux.list
wget -qO - https://azlux.fr/repo.gpg.key | sudo apt-key add -
apt update
apt install log2ram
2018-01-14 12:07:56 +01:00
2019-12-19 16:51:27 +01:00
### Manually
2018-01-14 12:07:56 +01:00
curl -Lo log2ram.tar.gz https://github.com/azlux/log2ram/archive/master.tar.gz
tar xf log2ram.tar.gz
2018-01-15 08:57:14 +01:00
cd log2ram-master
2018-03-03 19:45:34 +01:00
chmod +x install.sh & & sudo ./install.sh
2018-02-18 20:40:38 +01:00
cd ..
2018-02-15 22:39:25 +01:00
rm -r log2ram-master
2018-01-14 12:07:56 +01:00
2020-10-29 10:04:17 +01:00
For better performances. `RSYNC` is a recommended package.
2017-06-02 19:56:57 +02:00
**REBOOT** before installing anything else (for example apache2)
2018-04-23 18:11:06 +02:00
## Upgrade
2020-10-29 10:04:17 +01:00
You need to stop log2ram (`service log2ram stop`) and start the [install ](#install ). (APT will do it automatically)
2017-04-11 18:57:52 +02:00
2016-10-11 15:18:54 +02:00
## Customize
#### variables :
2017-12-18 19:23:23 +01:00
In the file `/etc/log2ram.conf` , there are three variables:
2016-10-11 15:18:54 +02:00
2018-01-14 12:07:56 +01:00
- `SIZE` : defines the size the log folder will reserve into the RAM (default is 40M).
2017-12-18 19:23:23 +01:00
- `MAIL` : Disables the error system mail if there is not enough place on RAM (if set to `false` )
2020-10-29 10:04:17 +01:00
- `PATH_DISK` : activate log2ram for other path than default one. Paths should be separated with a `;`
2019-03-13 15:47:06 +01:00
- `ZL2R` : Enable zram compatibility (`false` by default). Check the comment on the config file. See https://github.com/StuartIanNaylor/zram-swap-config to configure a zram space on your raspberry before enable this option.
2017-04-27 11:24:05 +02:00
#### refresh time:
2020-07-02 11:49:15 +02:00
By default Log2Ram writes to disk every day. If you think this is too much, you can run `systemctl edit log2ram-daily.timer` and add:
```ini
[Timer]
OnCalendar=weekly
```
... or even disable it with `systemctl disable log2ram-daily.timer` , if you prefer writing logs only at stop/reboot.
2016-10-11 15:18:54 +02:00
2017-12-18 19:23:23 +01:00
### It is working?
2017-04-27 11:24:05 +02:00
You can now check the mount folder in ram with (You will see lines with log2ram if working)
2016-04-18 12:09:32 +02:00
```
2018-01-14 12:07:56 +01:00
# df -h
…
log2ram 40M 532K 40M 2% /var/log
…
# mount
…
log2ram on /var/log type tmpfs (rw,nosuid,nodev,noexec,relatime,size=40960k,mode=755)
…
2016-04-18 12:09:32 +02:00
```
2017-04-27 11:24:05 +02:00
2020-10-29 10:04:17 +01:00
The log for log2ram will be written at: `/var/log/log2ram.log` and available with `sudo journalctl -t log2ram`
2016-04-20 10:47:39 +02:00
2019-03-13 15:47:06 +01:00
Compressor for zram. Usefull for the `COMP_ALG` of ZRAM on the config file.
2019-03-09 16:24:28 +01:00
| Compressor name | Ratio | Compression | Decompress. |
|------------------------|----------|-------------|-------------|
|zstd 1.3.4 -1 | 2.877 | 470 MB/s | 1380 MB/s |
|zlib 1.2.11 -1 | 2.743 | 110 MB/s | 400 MB/s |
|brotli 1.0.2 -0 | 2.701 | 410 MB/s | 430 MB/s |
|quicklz 1.5.0 -1 | 2.238 | 550 MB/s | 710 MB/s |
|lzo1x 2.09 -1 | 2.108 | 650 MB/s | 830 MB/s |
|lz4 1.8.1 | 2.101 | 750 MB/s | 3700 MB/s |
|snappy 1.1.4 | 2.091 | 530 MB/s | 1800 MB/s |
|lzf 3.6 -1 | 2.077 | 400 MB/s | 860 MB/s |
2017-12-18 19:23:23 +01:00
###### Now, muffins for everyone!
2017-07-27 20:13:51 +02:00
## Uninstall :(
(Because sometime we need it)
2020-07-23 01:33:54 +02:00
### With APT
```
apt remove log2ram
```
You can use `--purge` to remove config files as well.
### Manually
2017-07-27 20:13:51 +02:00
```
2018-02-15 22:39:25 +01:00
chmod +x /usr/local/bin/uninstall-log2ram.sh & & sudo /usr/local/bin/uninstall-log2ram.sh
2017-10-02 00:50:31 +02:00
```