Framadate/Technical documentation

Da Wikimedia Italia.
Jump to navigation Jump to search

Brief documentation for system administrators of the Framadate instance in Wikimedia Italia.

Server access

ssh fabula.wikimedia.it

Overview

     ┌─────┐          ┌─────────────────┐          ┌───────────────┐
     │Alice│          │Apache (:80 :443)│          │PHP-FPM (:9001)│
     └──┬──┘          └────────┬────────┘          └───────┬───────┘
        │       request        │                           │        
        │<────────────────────>│                           │        
        │                      │                           │        
        │                      │         request           │        
        │                      │<─────────────────────────>│        
     ┌──┴──┐          ┌────────┴────────┐          ┌───────┴───────┐
     │Alice│          │Apache (:80 :443)│          │PHP-FPM (:9001)│
     └─────┘          └─────────────────┘          └───────────────┘

(refresh)

Filesystem

# ls -l /var/www/framadate
total 12
drwxr-xr-x 16 apache apache 4096 21 dic 11.55 framadate-1.1.11
lrwxrwxrwx  1 apache apache   16 20 gen 18.48 production -> framadate-1.1.11
-rw-r--r--  1 apache apache   56 20 gen 17.24 README.txt
drwxr-xr-x  2 root   root   4096 20 gen 22.55 secret

Admin

This is the admin panel:

The admin credentials are stored in this file:

cat /var/www/framadate/secret/password.clear

The admin credentials can be changed with this command:

htpasswd -c /var/www/framadate/secret/htpasswd admin

Configuration

Framadate configuration:

nano /var/www/framadate/production/app/inc/config.php

Apache configuration:

nano /etc/httpd/sites-enabled/it-wikimedia-framadate-ssl.conf
nano /etc/httpd/sites-enabled/it-wikimedia-framadate-txt.conf

PHP-FPM configuration:

nano /etc/opt/rh/rh-php73/php-fpm.d/9001-framadate.conf

To publish whatever in Wikimedia Phabricator change please run this:

/root/scripts/commit.sh

Log

Log of the PHP-FPM pool:

tail -f /var/log/php-fpm/framadate-error.log

Generic Apache error log:

tail -f /var/log/httpd/error_log

Generic Apache access log:

tail -f /var/log/httpd/access_log

Service

To apply your changes you need to restart the services.

Service of the apache frontend webserver:

apache2ctl configtest
apache2ctl graceful

Service of the PHP-FPM backend webserver:

systemctl status  rh-php73-php-fpm
systemctl restart rh-php73-php-fpm

Database

$ mysql framadate
> SHOW TABLES;
+------------------------+
| Tables_in_framadate    |
+------------------------+
| fd_comment             |
| fd_framadate_migration |
| fd_poll                |
| fd_slot                |
| fd_vote                |
+------------------------+
5 rows in set (0.00 sec)

E-mail

Matomo uses an SMTP account with username noreply (see technical addresses).

Related configuration:

nano /var/www/framadate/production/app/inc/config.php

Update

https://framagit.org/framasoft/framadate/framadate/-/wikis/Maintenance/Updating

Phabricator