Update docs/source/install.rst
This commit is contained in:
parent
49bcd8f673
commit
3b99a6705c
|
|
@ -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 <<CMD_EOF
|
||||
createdb ${APP_DB}
|
||||
createuser -sd ${APP_DB}
|
||||
psql -c "alter user ${APP_DB} with password '${APP_DB_PASS}'"
|
||||
psql -c "ALTER DATABASE ${APP_DB} OWNER TO ${APP_DB}"
|
||||
CMD_EOF
|
||||
|
||||
echo "${APP_DB} pass: ${APP_DB_PASS}" >> /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
|
||||
<?php
|
||||
define("DB_HOST", "localhost");
|
||||
define("DB_NAME", "${APP_DB}");
|
||||
define("DB_USER", "${APP_DB}");
|
||||
define("DB_PASS", "${APP_DB_PASS}");
|
||||
define("DB_PORT", 5432);
|
||||
define("DB_SCMA", 'public');
|
||||
define("APPS_DIR", "${APPS_DIR}");
|
||||
define("CACHE_DIR", "${APPS_DIR}");
|
||||
define("DATA_DIR", "${DATA_DIR}");
|
||||
?>
|
||||
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 <<CAT_EOF
|
||||
www-data ALL = NOPASSWD: /usr/local/bin/create_ftp_user.sh, /usr/local/bin/delete_ftp_user.sh
|
||||
CAT_EOF
|
||||
|
||||
|
||||
|
||||
.. code-block:: php
|
||||
|
||||
cat >admin/incl/const.php <<CAT_EOF
|
||||
<?php
|
||||
define("DB_HOST", "localhost");
|
||||
define("DB_NAME", "${APP_DB}");
|
||||
define("DB_USER", "${APP_DB}");
|
||||
define("DB_PASS", "${APP_DB_PASS}");
|
||||
define("DB_PORT", 5432);
|
||||
define("DB_SCMA", 'public');
|
||||
define("APPS_DIR", "${APPS_DIR}");
|
||||
define("CACHE_DIR", "${CACHE_DIR}");
|
||||
define("DATA_DIR", "${DATA_DIR}");
|
||||
define("SUPER_ADMIN_ID", 1);
|
||||
define("SESS_USR_KEY", 'q2w_user');
|
||||
?>
|
||||
CAT_EOF
|
||||
|
||||
.. note:: If you want to quickly install and test Lizmap Web Client in a few steps, you can follow those
|
||||
`instructions <https://github.com/3liz/lizmap-docker-compose>`_ 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
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue