AcuGIS
/
QuartzMap
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

70
docs/source/install.rst
View File

@ -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,12 +181,16 @@ 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
mkdir -p "${APPS_DIR}"
@ -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 <<CAT_EOF