• 
      

    Rewrite the docs for creating site directories.

    Review Request #12846 — Created Feb. 25, 2023 and submitted

    Information

    Review Board
    release-5.0.x

    Reviewers

    This is a full rewrite of the documentation for creating sites. It
    provides far better coverage for all steps.

    The database setup now mentions MariaDB, recommends utf8mb4 for MySQL,
    and provides more concise installation steps for Postgres.

    A new section on SELinux was added, providing a full walkthrough on
    properly enabling SELinux policies for HTTP daemons and
    registering/applying the right permissions on site directories.

    Another new section on crontabs was added, providing setup steps and an
    example of the configuration file.

    The largest changes have to do with the web server configuration.

    We now provide a full guide on the following web servers:

    • Apache + mod_wsgi
    • Nginx + Gunicorn
    • Nginx + uWSGI

    Each of these go into the setup steps, point to the configuration files
    generated with Review Board 5.0.3+, and embeds sample configuration
    files.

    This should do a lot to help people get set up on a modern deployment,
    especially if they're aiming not to use Apache.

    Built the docs and read through them.

    Checked for bad links, spelling errors, and build errors.

    Tested the configurations locally with Apache, Nginx, Gunicorn, and
    uWSGI.

    Summary ID
    Rewrite the docs for creating site directories.
    This is a full rewrite of the documentation for creating sites. It provides far better coverage for all steps. The database setup now mentions MariaDB, recommends `utf8mb4` for MySQL, and provides more concise installation steps for Postgres. A new section on SELinux was added, providing a full walkthrough on properly enabling SELinux policies for HTTP daemons and registering/applying the right permissions on site directories. Another new section on crontabs was added, providing setup steps and an example of the configuration file. The largest changes have to do with the web server configuration. We now provide a full guide on the following web servers: * Apache + mod_wsgi * Nginx + Gunicorn * Nginx + uWSGI Each of these go into the setup steps, point to the configuration files generated with Review Board 5.0.3+, and embeds sample configuration files. This should do a lot to help people get set up on a modern deployment, especially if they're aiming not to use Apache.
    d2bfce252c464f7c597b35f727b353a3ec4125bb
    chipx86
    david
    1. Ship It!
    2. 
        
    chipx86
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to release-5.0.x (968df7e)