From fb7123b60af028cea6d8b8ac704dda7bbddd3a84 Mon Sep 17 00:00:00 2001 From: AcuGIS Date: Tue, 26 Mar 2024 18:19:16 +0000 Subject: [PATCH] Update docs/source/install.rst --- docs/source/install.rst | 72 ++++++++++++++--------------------------- 1 file changed, 24 insertions(+), 48 deletions(-) diff --git a/docs/source/install.rst b/docs/source/install.rst index 50a03b8..8688e75 100644 --- a/docs/source/install.rst +++ b/docs/source/install.rst @@ -1,45 +1,8 @@ Install ======= -QuartzMap is installed using the included installation scripts. -The script will attempt to provision an SSL certificate using Certbot. - -.. 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 +Installation on Ubuntu 22 -------------------------------- Follow below to customize your installation. @@ -60,18 +23,9 @@ If you do not already have it installed, install it now. 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 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 @@ -150,6 +104,10 @@ Create the Database Objects Install QGIS Server ----------------------------- +To advertise WMS, WFS, and WTMS, install QGIS server. + + + .. code-block:: bash RELEASE=$(lsb_release -cs) @@ -190,11 +148,17 @@ Install QGIS Server Configure ProFTPD ---------------------------- +Configure ProFTPD to jail users to FTP directories + .. code-block:: bash sed -i.save ' s/#DefaultRoot~/DefaultRoot ~/ s/# RequireValidShelloff/RequireValidShell off/' /etc/proftpd/proftpd.conf + +Restart ProFTPD for changes to take effect. + +.. code-block:: bash systemctl enable proftpd systemctl restart proftpd @@ -217,11 +181,15 @@ Configure Apache a2ensite 000-default default-ssl systemctl reload apache2 +Request certificate from Let's Encrypt: + certbot --apache --agree-tos --email hostmaster@${HNAME} --no-eff-email -d ${HNAME} Create Data and Cache Directories ----------------------------- +---------------------------- + +Set the DATA_DIR outside of public directories .. code-block:: bash @@ -244,6 +212,10 @@ Grant Apache permissions chown -R www-data:www-data /var/www/html rm -rf /var/www/html/installer +Restart Apache for changes to take effect + +.. code-block:: bash + systemctl restart apache2 @@ -273,6 +245,10 @@ Create Groups and Permissions Create incl/const.php file --------------------------------------- +Copy the incl/const.php.dist file + + + .. code-block:: php cat >admin/incl/const.php <