Editing Mediagoblin

a quick and dirty guide, better docs and maybe puppet config later

== Installation ==

{{Note|If you have SELinux, temporarily set it to Enforcing mode. After installation, [http://nathanielca.se/fossrit/deploying-mediagoblin-2-selinux.html a special rule can be set] to allow Mediagoblin to function.}}

# follow [http://mediagoblin.readthedocs.io/en/latest/siteadmin/deploying.html Deploying guide] using python3, up to the '''FastCGI and Nginx''' part where you stop, because flup doesn't work on python3 and uWSGI is better.
# Set up uWSGI with Nginx [http://nathanielca.se/fossrit/deploying-mediagoblin-1-fastcgi-vs-uwsgi.html as you see in this guide.]

Make sure to install {{ic|nginx-full}} on Debian/Ubuntu, or {{ic|nginx-all-modules}} on CentOS. Then add the following [http://uwsgi-docs.readthedocs.io/en/latest/Nginx.html as stated in this guide:]

{{hc|/etc/nginx/uWSGI_params|<nowiki>
uwsgi_param QUERY_STRING $query_string;
uwsgi_param REQUEST_METHOD $request_method;
uwsgi_param CONTENT_TYPE $content_type;
uwsgi_param CONTENT_LENGTH $content_length;
uwsgi_param REQUEST_URI $request_uri;
uwsgi_param PATH_INFO $document_uri;
uwsgi_param DOCUMENT_ROOT $document_root;
uwsgi_param SERVER_PROTOCOL $server_protocol;
uwsgi_param REMOTE_ADDR $remote_addr;
uwsgi_param REMOTE_PORT $remote_port;
uwsgi_param SERVER_ADDR $server_addr;
uwsgi_param SERVER_PORT $server_port;
uwsgi_param SERVER_NAME $server_name;
</nowiki>}}

Though actually, instead of the config seen in the guide, use this one (since the guide has a typo for uwsgi_pass, and puts the site under {{ic|domain.com/mediagoblin/}}, which is not what we want.)

{{hc|/etc/nginx/conf.d/mediagoblin.conf|<nowiki>location / {
   include uWSGI_params;
   uwsgi_pass 127.0.0.1:26543;

   # our understanding vs nginx's handling of script_name vs
   # path_info don't match :)
   uwsgi_param SCRIPT_NAME "";
   uwsgi_modifier1 30;
}
</nowiki>}}

=== uWSGI Emperor Config ===

It is a good idea to run the uWSGI apps as vassals to the uWSGI Emperor service. Install it with:

{{bc|sudo yum install uwsgi uwsgi-plugin-python3}}

Then create a uwsgi config file for mediagoblin:

{{hc|/etc/uwsgi.d/mediagoblin.ini|<nowiki>
[uwsgi]
plugin=python3
uid=mediagoblin
gid=nginx
socket=127.0.0.1:26543
virtualenv=/srv/www/mediagoblin
chdir=/srv/www/mediagoblin
ini-paste=/srv/www/mediagoblin/paste.ini
logto=/srv/www/mediagoblin/mg.log
</nowiki>}}

Most importantly, chown it to mediagoblin:nginx so that uwsgi will run the service with those permissions.

{{bc|sudo chown mediagoblin:nginx /etc/uwsgi.d/mediagoblin.ini}}

Finally, run the uwsgi Emperor service. 

{{bc|sudo systemctl start uwsgi}}

If {{ic|sudo systemctl restart uwsgi}} shows you that {{ic|[emperor] vassal mediagoblin.ini is ready to accept requests}}, then enable the uwsgi service on boot:

{{bc|sudo systemctl enable uwsgi}}

=== Notes ===

# If you have SELinux, [http://nathanielca.se/fossrit/deploying-mediagoblin-2-selinux.html see this guide] to make it allow uWSGI sockets.

== Production Configurations and Systemd Configs ==

You will want to seperate out the Celery process from the server, now that mediagoblin's Paste server is running under a uWSGI socket, otherwise uploads won't be processed.

You can skip the paste systemd daemon setup, since having the uwsgi service takes care of that. 

http://mediagoblin.readthedocs.io/en/latest/siteadmin/configuration.html
@@ Line 75: / Line 75: @@
 # If you have SELinux, [http://nathanielca.se/fossrit/deploying-mediagoblin-2-selinux.html see this guide] to make it allow uWSGI sockets.
-== Celery Systemd Configs ==
+== Production Configurations and Systemd Configs ==
 You will want to seperate out the Celery process from the server, now that mediagoblin's Paste server is running under a uWSGI socket, otherwise uploads won't be processed.
@@ Line 82: / Line 82: @@
 http://mediagoblin.readthedocs.io/en/latest/siteadmin/configuration.html
-=== Redis Broker for Celery ===
-A super easy mod is to add a redis broker, which significantly helps speed the encoding process.
-http://docs.celeryproject.org/en/latest/getting-started/brokers/redis.html
-== Media Formats ==
-=== ASCII ===
-=== Music ===
-install the good, bad, and ugly gstreamer plugins from epel. also gstreamer-python, and libsndfile-devel
-https://wiki.centos.org/TipsAndTricks/MultimediaOnCentOS7
-Then, install a specific version of numpy and such as stated in this ticket:
-https://issues.mediagoblin.org/ticket/5379
-You're probably better off using something like Koel though if you don't need user contributions... https://koel.phanan.net/docs/#/