pad/INSTALL.md

138 lines
2.7 KiB
Markdown
Raw Normal View History

2022-02-19 15:50:21 +01:00
Initial requirements
====================
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
# apt install screen
2022-02-20 15:05:59 +01:00
```
Create DB
=========
```
# apt install postgresql postgresql-client
# systemctl enable --now postgresql
```
Check /etc/postgresql/xx/main/pg_hba.conf for localhost contains
```
host all all 127.0.0.0/24 md5
```
```
# su - postgres
$ createuser <REDACTED_USER>
$ createdb <REDACTED_DB> -O <REDACTED_USER>
$ psql <REDACTED_DB>
ALTER USER <REDACTED_USER> WITH PASSWORD '<REDACTED_PASSWORD'> ;
ALTER ROLE;
\q
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
Install Etherpad-lite
=====================
2022-02-20 15:05:59 +01:00
Add etherpad user
```
# adduser etherpad
# su etherpad && cd
```
2022-02-19 15:50:21 +01:00
Install and run etherpad
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
$ curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
# apt install -y nodejs
$ git clone --branch master https://github.com/ether/etherpad-lite.git &&
$ cd etherpad-lite &&
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
Restore "etherpad/settings.json" in etherpad-lite
Then try to start etherpad
2022-02-19 15:54:06 +01:00
`$ src/bin/run.sh`
2022-02-19 15:50:21 +01:00
Then CTRL-C
Restore the run.sh script in home folder
Setup the cron
2022-02-19 15:54:06 +01:00
`$ crontab -e`
2022-02-19 15:50:21 +01:00
and insert at the end of the file
@reboot /home/etherpad/run.sh
Start etherpad in a screen "pad" session
2022-02-19 15:54:06 +01:00
`$ screen -dmS pad ./run.sh`
2022-02-19 15:50:21 +01:00
Install the proxy
==================
Restore html content into /var/www
Install nginx
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
# apt install nginx
# mkdir /var/log/nginx/pad.chalec.org
# chown www-data:www-data /var/log/nginx/pad.chalec.org
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
Setup the config file from nginx/sites-available/etherpad in /etc/nginx/sites-available/etherpad
Link available to enable
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
# cd /etc/nginx/sites-enabled
# ln -s ../sites-available .
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
Start nginx
2022-02-19 15:54:06 +01:00
`# systemctl enable --now nginx`
2022-02-19 15:50:21 +01:00
Open firewall
2022-02-19 15:54:06 +01:00
`# ufw allow proto tcp port 80,443`
2022-02-19 15:50:21 +01:00
2022-02-19 15:54:06 +01:00
Check the service is reachable at
2022-02-19 15:50:21 +01:00
http://pad.chalec.org
https://pad.chalec.org
INSTALL etherpad plugins
========================
adminpads2
align
author_hover
delete_after_delay
delete_empty_pads
font_color
font_size
headings2
spellcheck
table_of_contents
Chalec infos
============
2022-02-19 15:56:30 +01:00
2022-02-19 15:50:21 +01:00
Intall Java
2022-02-19 15:54:06 +01:00
`# apt install openjdk-jre-headless`
2022-02-19 15:50:21 +01:00
2022-02-19 15:54:06 +01:00
`# adduser statoolinfos`
2022-02-19 15:50:21 +01:00
Add to admin group to read logs
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:50:21 +01:00
# adduser statoolinfos admin
# su statoolinfos
# cd
2022-02-19 15:54:06 +01:00
```
2022-02-19 15:56:30 +01:00
Download Statoolinfos jar at https://forge.devinsy.fr/devinsy/statoolinfos/releases
2022-02-19 15:50:21 +01:00
Uncompress in /home/statool-<version>
link versioned folder to generic one
2022-02-19 15:54:06 +01:00
`$ ln -s statoolinfos-<verion> statoolinfos`
2022-02-19 15:50:21 +01:00
Restore statool config
2022-02-19 15:56:30 +01:00
2022-02-19 15:50:21 +01:00
(/var/www/html/.well-known/statoolinfos already restored in etherpad install)
/home/statoolinfos/statoolinfos/statoolinfos.sh probe -full /hhome/statoolinfos/statoolinfos/conf/pad.chalec.org.conf
2022-02-19 15:54:06 +01:00
`$ crontab -e`
2022-02-19 15:56:30 +01:00
2022-02-19 15:54:06 +01:00
45 * * * * /home/statoolinfos/statoolinfos/statoolinfos.sh probe -previousday /home/statoolinfos/statoolinfos/conf/pad.chalec.org.conf >> /home/statoolinfos/statoolinfos.log