trove/doc/source/install/apache-mod-wsgi.rst

Installing API behind mod_wsgi

1. Install the Apache Service:

   Fedora/RHEL/CentOS:
     sudo dnf install httpd python3-mod_wsgi
   
   Debian/Ubuntu:
     sudo apt install apache2 libapache2-mod-wsgi-py3

2. Copy etc/apache2/trove under the apache sites:

   Fedora/RHEL/CentOS:
     sudo cp etc/apache2/trove /etc/httpd/conf.d/trove-api.conf
   
   Debian/Ubuntu:
     sudo cp etc/apache2/trove /etc/apache2/sites-available/trove-api.conf

3. Edit <apache-configuration-dir>/trove-api.conf according to installation and environment.

   • Modify the WSGIDaemonProcess directive to set the user and group values to appropriate user on your server.
   • Modify the WSGIScriptAlias directive to point to the trove/api/app_wsgi.py script.
   • Modify the Directory directive to set the path to the Trove API code.
   • Modify the ErrorLog and CustomLog to redirect the logs to the right directory.

4. Enable the apache trove site and reload:

   Fedora/RHEL/CentOS:
     sudo systemctl reload httpd
   
   Debian/Ubuntu:
     sudo a2ensite trove-api
     sudo systemctl reload apache2