Archives/pikvm
2
0
Fork 0
mirror of https://github.com/pikvm/pikvm synced 2024-11-06 21:20:32 +00:00
Code Issues Projects Releases Wiki Activity

FAQ add setting timezone,date & time, and date check before pacman (#952)

Browse Source 
* Add to FAQ how to set the timezone, date & time and to check the date before using pacman

pacman can fail if the date is in the past,. As SSL certificates have start dates, and pacman will not use a repo with a certificate which has not started yet.

* Noted reboot time, more help setting date/timezone
This commit is contained in:
Damon Atkins 2023-03-09 00:20:54 +11:00 committed by GitHub
parent eaabd93e96
commit e7947ca343
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/faq.md
View File

@ -260,11 +260,23 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht
* Do the same in `/etc/fstab` for the `/boot` partition. * Do the same in `/etc/fstab` for the `/boot` partition.
* Comment `tmpfs` lines in `/etc/fstab` for `/var/lib` and `/var/log`. * Comment `tmpfs` lines in `/etc/fstab` for `/var/lib` and `/var/log`.
!!! danger "But again: DON'T DO THIS" !!! danger "But again: DON'T DO THIS"
??? question "How to set the date, time and timezone from command line?"
* Become root with the command `su -` or `sudo -s`.
* Enable read/write with the command `rw`.
* Find your timezone string e.g. `timedatectl list-timezones` or `timedatectl list-timezones | grep -i australia`.
* Set the timezone with `timedatectl set-timezone <YourTimeZoneHere>` e.g. `timedatectl set-timezone Australia/Victoria`.
* Stop the time syncing service with `systemctl stop systemd-timesyncd` as this will prevent the next step if running.
* Set the time and date with `timedatectl set-time 'YYYY-MM-DD HH:MM:SS'` e.g. `timedatectl set-time '2023-02-26 14:50:10'`.
* If you have hardware clock e.g. V3 & V4 HAT, update it with `hwclock --systohc` , then check it with `hwclock --show`.
* Switch filesystem to RO-mode with the command `ro`.
??? question "How do I install or remove packages in PiKVM OS?" ??? question "How do I install or remove packages in PiKVM OS?"
PiKVM OS is based on Arch Linux ARM and uses the [pacman](https://wiki.archlinux.org/title/Pacman) package manager. PiKVM OS is based on Arch Linux ARM and uses the [pacman](https://wiki.archlinux.org/title/Pacman) package manager.
* Ensure the date is correct: `date`. Otherwise you may get the error `SSL certificate problem: certificate is not yet valid`
* Switch filesystem to RW-mode: `rw`. * Switch filesystem to RW-mode: `rw`.
* Find some packages (`emacs` for example): `pacman -Ss emacs`. * Find some packages (`emacs` for example): `pacman -Ss emacs`.
* Install it, while keeping the system updated: `pacman -Syu emacs`. * Install it, while keeping the system updated: `pacman -Syu emacs`.
@ -276,10 +288,14 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht
??? question "How do I update PiKVM with the latest software?" ??? question "How do I update PiKVM with the latest software?"
This is ONLY recommended if you need a feature, otherwise this should ONLY be done if you are physically at the device and can reflash the sd card as a means of recovery. PiKVM OS is based on Arch Linux ARM and is fully updated from the repository by a regular package manager. Connect to your PiKVM via ssh and run: This is ONLY recommended if you need a feature, otherwise this should ONLY be done if you are physically at the device and can reflash the sd card as a means of recovery. PiKVM OS is based on Arch Linux ARM and is fully updated from the repository by a regular package manager. Connect to your PiKVM via ssh and run:
``` * Ensure the date is correct: `date`. Otherwise you may get the error `SSL certificate problem: certificate is not yet valid`
* Run the following
```
# date
# rw # rw
# pacman -Syu # pacman -Syu
# reboot # sync
# reboot # Allow 10 to 15 minutes for a response.
``` ```
Pacman saves all installed packages in a compressed format so that you can roll back to the old version if something goes wrong. After you've updated and made sure everything works, (ONLY for older images, newer images has this partition expended and no longer has this issue) it makes sense to clear the package cache so that it doesn't take up space on the SD card: `rw; rm -rf /var/cache/pacman/pkg; ro`. Pacman saves all installed packages in a compressed format so that you can roll back to the old version if something goes wrong. After you've updated and made sure everything works, (ONLY for older images, newer images has this partition expended and no longer has this issue) it makes sense to clear the package cache so that it doesn't take up space on the SD card: `rw; rm -rf /var/cache/pacman/pkg; ro`.