From 3b99a6705ce69577be3274ee68243c496ce464e7 Mon Sep 17 00:00:00 2001 From: AcuGIS Date: Mon, 25 Mar 2024 12:33:16 +0000 Subject: [PATCH] Update docs/source/install.rst --- docs/source/install.rst | 170 ++++------------------------------------ 1 file changed, 17 insertions(+), 153 deletions(-) diff --git a/docs/source/install.rst b/docs/source/install.rst index 45e8818..cb7245c 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -40,7 +40,7 @@ Populate the required fields with whatever values you want to use. Manual Installation on Ubuntu 22 ------------- +-------------------------------- Install PostgreSQL with PostGIS @@ -216,167 +216,31 @@ Create Data and Cache Directories Install More Stuff --------------------------------------- -APP_DB='q2w' -APP_DB_PASS=$(< /dev/urandom tr -dc _A-Za-z0-9 | head -c32); -DATA_DIR='/var/www/data' -CACHE_DIR='/var/www/cache' -APPS_DIR='/var/www/html/apps' - -# 1. Install packages (assume PG is preinstalled) -apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd} proftpd - -sed -i.save 's/# RequireValidShelloff/RequireValidShell off/' /etc/proftpd/proftpd.conf - -sed -i.save 's/#DefaultRoot~/DefaultRoot ~/' /etc/proftpd/proftpd.conf - - -systemctl enable proftpd -systemctl restart proftpd - -# 2. Create db -su postgres <> /root/auth.txt - -mkdir -p "${APPS_DIR}" -mkdir -p "${CACHE_DIR}" -mkdir -p "${DATA_DIR}" - -chown -R www-data:www-data "${APPS_DIR}" -chown -R www-data:www-data "${CACHE_DIR}" -chown -R www-data:www-data "${DATA_DIR}" - -cat >admin/incl/const.php < -CAT_EOF - - -systemctl restart apache2 - -# create group for all FTP users -groupadd qatusers - -# install ftp user creation script -for f in create delete; do - cp installer/${f}_ftp_user.sh /usr/local/bin/ - chown www-data:www-data /usr/local/bin/${f}_ftp_user.sh - chmod 0550 /usr/local/bin/${f}_ftp_user.sh -done - -cat >/etc/sudoers.d/q2w <admin/incl/const.php < + CAT_EOF .. note:: If you want to quickly install and test Lizmap Web Client in a few steps, you can follow those `instructions `_ using Docker and Docker-Compose. .. note:: In Debian distributions, you can work as administrator (log in with ``root``), without using ``sudo`` on contrary to Ubuntu. -Configuration with Apache server ------------- - -This documentation provides an example for configuring a server with the Debian 11 distribution. We assume you have base system installed and updated. - -.. warning:: This page does not describe how to secure your Nginx server. It's just for a demonstration. - -Configure Locales ------------------ - -For simplicity, it is interesting to configure the server with UTF-8 default encoding. - -.. code-block:: bash - - # configure locales - locale-gen fr_FR.UTF-8 #replace fr with your language - dpkg-reconfigure locales - # define your timezone [useful for logs] - dpkg-reconfigure tzdata - apt install ntp ntpdate - -.. note:: It is also necessary configure the other software so that they are using this default encoding if this is not the case. - -Installing necessary packages ------------------------------ - -.. warning:: Lizmap web client 3.6 is based on Jelix 1.8. You must install at least the **7.4** version of PHP. The **dom**, **simplexml**, **pcre**, **session**, **tokenizer** and **spl** extensions are required (they are generally turned on in a standard PHP 7/8 installation) - -.. code-block:: bash - - sudo su # only necessary if you are not logged in as root - apt update # update packages list - apt install curl openssl libssl1.1 nginx-full nginx nginx-common - -On Debian 11 or Ubuntu 20.04 LTS, install these packages: - -.. code-block:: bash - - apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd} proftpd DAVID -Web configuration ------------------ - -Create a new file /etc/nginx/sites-available/lizmap.conf: - -.. code-block:: nginx - - server { - listen 80; - - server_name localhost; - root /var/www/html/lizmap; - index index.php index.html index.htm; - - # compression setting - gzip_vary on; - gzip_proxied any; - gzip_comp_level 5; - gzip_min_length 100; - gzip_http_version 1.1; - gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript text/json; - - location / { - try_files $uri $uri/ =404; - } - - location ~ [^/]\.php(/|$) { - fastcgi_split_path_info ^(.+\.php)(/.*)$; - set $path_info $fastcgi_path_info; # because of bug http://trac.nginx.org/nginx/ticket/321 - try_files $fastcgi_script_name =404; - include fastcgi_params; - - fastcgi_index index.php; - fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; - fastcgi_param PATH_INFO $path_info; - fastcgi_param PATH_TRANSLATED $document_root$path_info; - fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; - fastcgi_param SERVER_NAME $http_host; - } - } - -You should declare the lizmap.local domain name somewhere (in your /etc/hosts, -or into your DNS..), or replace it by your own domain name. - -Enable the virtual host you just created: .. code-block:: bash