pad/INSTALL.md

152 lines
2.8 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
2022-04-05 20:30:17 +02:00
# su - etherpad && cd
2022-02-20 15:05:59 +01:00
```
2022-02-19 15:50:21 +01:00
Install and run etherpad
2022-02-19 15:54:06 +01:00
```
2022-04-05 20:30:17 +02:00
# curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
2022-02-19 15:50:21 +01:00
# apt install -y nodejs
2022-04-05 20:30:17 +02:00
$ 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-04-05 20:30:17 +02:00
2022-02-19 15:54:06 +01:00
`$ src/bin/run.sh`
2022-04-05 20:30:17 +02:00
2022-02-19 15:50:21 +01:00
Then CTRL-C
Restore the run.sh script in home folder
Setup the cron
2022-04-05 20:30:17 +02:00
2022-02-19 15:54:06 +01:00
`$ crontab -e`
2022-04-05 20:30:17 +02:00
2022-02-19 15:50:21 +01:00
and insert at the end of the file
2022-04-05 20:30:17 +02:00
`@reboot /home/etherpad/run.sh`
Restore "run.sh" script helper to run Etherpad in screen znd run
`~/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-04-05 20:30:17 +02:00
2022-02-19 15:54:06 +01:00
`# systemctl enable --now nginx`
2022-02-19 15:50:21 +01:00
Open firewall
2022-04-05 20:30:17 +02:00
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-04-05 20:30:17 +02:00
```
2022-02-19 15:50:21 +01:00
http://pad.chalec.org
https://pad.chalec.org
2022-04-05 20:30:17 +02:00
```
2022-02-19 15:50:21 +01:00
INSTALL etherpad plugins
========================
2022-04-05 20:30:17 +02:00
Plugin list to install at https://pad.chalec.org/admin
- adminpads2
- align
- author_hover
- delete_after_delay
- delete_empty_pads
- font_color
- font_size
- headings2
- spellcheck
- table_of_contents
2022-02-19 15:50:21 +01:00
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
2022-04-05 20:30:17 +02:00
# 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-04-05 20:30:17 +02:00
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-04-05 20:30:17 +02:00
`45 * * * * /home/statoolinfos/statoolinfos/statoolinfos.sh probe -previousday /home/statoolinfos/statoolinfos/conf/pad.chalec.org.conf >> /home/statoolinfos/statoolinfos.log`