docs: check system time config before installing (#2019)
This commit is contained in:
Jonas L
GitHub
parent
fd8f103cc1
commit
5e7b44e88f
|
|
@ -1,72 +0,0 @@
|
|||
---
|
||||
title: Setting the server time
|
||||
sidebar_position: 20
|
||||
---
|
||||
|
||||
Accurate time keeping on your server is vital for LibreTime performance. You can confirm that the date and time of your server are set correctly with the `date` command.
|
||||
The server should respond with the date, time, time zone and year in a format similar to the following example:
|
||||
|
||||
```
|
||||
Tue Jul 2 15:08:57 BST 2013
|
||||
```
|
||||
|
||||
If the time on your server is wrong, we strongly recommend that you take LibreTime off-air until the problem is fixed.
|
||||
|
||||
## Configuring NTP
|
||||
|
||||
Although it is possible to set the date and time of the server manually, this is not recommended because the server clock can drift over time, compromising the accuracy of your broadcast schedule. If your LibreTime server is permanently connected to the Internet, you can synchronize your server to a time server with the **ntp** program. If **ntp** is not on your server, you can install it with `sudo apt-get install ntp`.
|
||||
|
||||
Optionally, open the **ntp** configuration file in the **nano** editor to add further time server names:
|
||||
|
||||
```
|
||||
sudo nano /etc/ntp.conf
|
||||
```
|
||||
|
||||
On Ubuntu GNU/Linux, the default time server is `ntp.ubuntu.com`, but there are many other time servers available on the public Internet, including the group of servers listed at https://www.pool.ntp.org/ for each country. Using a variety of NTP servers located closely to your LibreTime server should produce the most accurate results. For example, for a server in the United Kingdom you could use the following list:
|
||||
|
||||
```title="/etc/ntp.conf"
|
||||
# You do need to talk to an NTP server or two (or three).
|
||||
server ntp.ubuntu.com
|
||||
server 0.uk.pool.ntp.org
|
||||
server 1.uk.pool.ntp.org
|
||||
server 2.uk.pool.ntp.org
|
||||
server 3.uk.pool.ntp.org
|
||||
```
|
||||
|
||||
Enter the server names you require, press **Ctrl+O** to write out the `/etc/ntp.conf` file, then **Ctrl+X** to exit **nano**. Restart the **ntp** service with `sudo systemctl restart ntp`.
|
||||
|
||||
The server should respond:
|
||||
|
||||
```
|
||||
* Stopping NTP server ntpd [ OK ]
|
||||
* Starting NTP server ntpd [ OK ]
|
||||
```
|
||||
|
||||
Then use the **ntpq -p** command to confirm that **ntp** is working. This command should produce output similar to the following:
|
||||
|
||||
```
|
||||
ntpq -p
|
||||
remote refid st t when poll reach delay offset jitter
|
||||
==================================================================
|
||||
europium. 193.79.237.14 2 u 28 64 3 39.571 12.600 3.590
|
||||
norb.v4.c 46.227.200.72 3 u 28 64 3 47.856 -6.908 10.028
|
||||
82.113.15 193.62.22.82 2 u 29 64 3 11.458 -0.513 2.629
|
||||
ntppub.le 158.43.192.66 2 u 91 64 2 122.781 44.864 0.001
|
||||
dns0.rmpl 195.66.241.3 2 u 27 64 3 22.171 1.464 4.242
|
||||
```
|
||||
|
||||
## Adjusting the server time zone
|
||||
|
||||
The data centre which hosts your LibreTime server could be located anywhere in the world. Some servers are set to _Coordinated Universal Time_ or UTC (similar to _Greenwich Mean Time_ or GMT), regardless of their location. LibreTime uses UTC time in its database for scheduling purposes, independent of the server time zone.
|
||||
|
||||
Find your timezone's shortcode with `timedatectl list-timezones`, then enter
|
||||
|
||||
```bash
|
||||
sudo timedatectl set-timezone your_time_zone
|
||||
```
|
||||
|
||||
:::tip
|
||||
|
||||
You can check to see which time zone your server is set to by running `timedatectl` without any arguments.
|
||||
|
||||
:::
|
||||
|
|
@ -50,6 +50,32 @@ LibreTime requires the following default ports to be open:
|
|||
|
||||
The installer is shipped in the released tarballs or directly in the project repository.
|
||||
|
||||
### Before installing
|
||||
|
||||
Before installing LibreTime, you need to make sure you operating system is properly configured.
|
||||
|
||||
#### Operating system time configuration
|
||||
|
||||
Check your operating system time configuration using the following command:
|
||||
|
||||
```bash
|
||||
timedatectl
|
||||
```
|
||||
|
||||
```
|
||||
Local time: Fri 2022-08-05 12:43:39 CEST
|
||||
Universal time: Fri 2022-08-05 10:43:39 UTC
|
||||
RTC time: Fri 2022-08-05 10:43:40
|
||||
Time zone: Europe/Berlin (CEST, +0200)
|
||||
System clock synchronized: yes
|
||||
NTP service: active
|
||||
RTC in local TZ: no
|
||||
```
|
||||
|
||||
Make sure that your time zone is properly configured, if not you can set it using the [`timedatectl set-timezone` command](https://www.freedesktop.org/software/systemd/man/timedatectl.html#set-timezone%20%5BTIMEZONE%5D).
|
||||
|
||||
If the NTP service is inactive, you should consider enabling it using the [`timedatectl set-ntp` command](https://www.freedesktop.org/software/systemd/man/timedatectl.html#set-ntp%20%5BBOOL%5D).
|
||||
|
||||
### Download
|
||||
|
||||
You can either download the latest released tarball or clone the repository.
|
||||
|
|
@ -194,8 +220,6 @@ Once the setup is completed, log in the interface and make sure to edit the proj
|
|||
- Timezone
|
||||
- First day of the week
|
||||
|
||||
Accurate time on your server is important, make sure that your operating system is [properly configured and does not go out of sync](../server-time.md).
|
||||
|
||||
### Next
|
||||
|
||||
Once completed, it's recommended to [install a reverse proxy](./reverse-proxy.md) to setup SSL termination and secure your installation.
|
||||
|
|
|
|||
Loading…
Reference in New Issue