Update docs/source/install.rst

This commit is contained in:
AcuGIS 2024-03-26 18:19:16 +00:00
parent 96fc618d75
commit fb7123b60a
1 changed files with 24 additions and 48 deletions

View File

@ -1,45 +1,8 @@
Install Install
======= =======
QuartzMap is installed using the included installation scripts.
The script will attempt to provision an SSL certificate using Certbot. Installation on Ubuntu 22
.. warning::
Ensure that your hostname is properly set. If not set the hostname using 'hostnamectl set-hostname domain.com'
Basic Install
------------
Clone the repository
.. code-block:: bash
git clone https://git.acugis.com/AcuGIS/GeoSync.git
Change to the quartz directory
.. code-block:: bash
cd quartz
Execute the scripts in order::
.. code-block:: bash
$ ./installer/postgres.sh
$ ./installer/app-install.sh
Complete setup by navigating to https://domain.com/admin.setup.php to complete the installation.
.. image:: images/installer-2.png
Populate the required fields with whatever values you want to use.
Manual Installation on Ubuntu 22
-------------------------------- --------------------------------
Follow below to customize your installation. Follow below to customize your installation.
@ -60,18 +23,9 @@ If you do not already have it installed, install it now.
Install Prerequisties Install Prerequisties
------------------------------------------ ------------------------------------------
For Community Edition:
.. code-block:: bash
apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd,simplexml} proftpd postfix python3-certbot-apache
For Commerical Edition:
.. code-block:: bash .. code-block:: bash
apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd,simplexml} proftpd libapache2-mod-fcgid postfix python3-certbot-apache apt-get -y install apache2 libapache2-mod-php php-{pgsql,zip,gd,simplexml} proftpd libapache2-mod-fcgid postfix python3-certbot-apache
install_qgis_server
Create the PostGIS Database Create the PostGIS Database
@ -150,6 +104,10 @@ Create the Database Objects
Install QGIS Server Install QGIS Server
----------------------------- -----------------------------
To advertise WMS, WFS, and WTMS, install QGIS server.
.. code-block:: bash .. code-block:: bash
RELEASE=$(lsb_release -cs) RELEASE=$(lsb_release -cs)
@ -190,11 +148,17 @@ Install QGIS Server
Configure ProFTPD Configure ProFTPD
---------------------------- ----------------------------
Configure ProFTPD to jail users to FTP directories
.. code-block:: bash .. code-block:: bash
sed -i.save ' sed -i.save '
s/#DefaultRoot~/DefaultRoot ~/ s/#DefaultRoot~/DefaultRoot ~/
s/# RequireValidShelloff/RequireValidShell off/' /etc/proftpd/proftpd.conf s/# RequireValidShelloff/RequireValidShell off/' /etc/proftpd/proftpd.conf
Restart ProFTPD for changes to take effect.
.. code-block:: bash
systemctl enable proftpd systemctl enable proftpd
systemctl restart proftpd systemctl restart proftpd
@ -217,11 +181,15 @@ Configure Apache
a2ensite 000-default default-ssl a2ensite 000-default default-ssl
systemctl reload apache2 systemctl reload apache2
Request certificate from Let's Encrypt:
certbot --apache --agree-tos --email hostmaster@${HNAME} --no-eff-email -d ${HNAME} certbot --apache --agree-tos --email hostmaster@${HNAME} --no-eff-email -d ${HNAME}
Create Data and Cache Directories Create Data and Cache Directories
---------------------------- ----------------------------
Set the DATA_DIR outside of public directories
.. code-block:: bash .. code-block:: bash
@ -244,6 +212,10 @@ Grant Apache permissions
chown -R www-data:www-data /var/www/html chown -R www-data:www-data /var/www/html
rm -rf /var/www/html/installer rm -rf /var/www/html/installer
Restart Apache for changes to take effect
.. code-block:: bash
systemctl restart apache2 systemctl restart apache2
@ -273,6 +245,10 @@ Create Groups and Permissions
Create incl/const.php file Create incl/const.php file
--------------------------------------- ---------------------------------------
Copy the incl/const.php.dist file
.. code-block:: php .. code-block:: php
cat >admin/incl/const.php <<CAT_EOF cat >admin/incl/const.php <<CAT_EOF