83 Commits

Author SHA1 Message Date
Ben Sturmfels
464a5d7fba
Fix some docs build warnings. 2020-04-29 09:55:28 +10:00
Ben Sturmfels
35494ed66c
Add CentOS rabbitmq instructions. 2020-04-29 09:07:01 +10:00
Ben Sturmfels
62a565e13b
Review and update the deploment docs for Debian 10 and CentOS 8 [#5593].
Mostly a thorough test and cleanup. The significant change is moving the systemd
config into the deployment docs an the registration/security considerations to
production considerations docs.
2020-04-29 02:19:16 +10:00
Ben Sturmfels
6808038a06
Properly quote --without-python3 in docs (#5596). 2020-04-28 13:40:39 +10:00
Ben Sturmfels
4e28403812
Fix Sphinx build warnings, remove gNewSense, *buntu -> Ubuntu.
The * feels like it might confuse no-programmers.
2020-04-28 13:38:47 +10:00
Ben Sturmfels
100f626551
Switch to Python 3 by default.
Addresses #5592.
2020-04-24 14:38:16 +10:00
Michael Lynch
e8be472273 Adding 'Waitress' where 'FastCGI' was previously referenced 2020-04-15 20:14:11 -04:00
Michael Lynch
82c2f9a912 Removing flup and fastcgi from documentation
flup is not supported on Python3, so MediaGoblin doesn't have a supported way to enable FastCGI support.

This change removes all references to flup and FastCGI and updates deployment instructions to use simple HTTP forwarding with nginx to access mediagoblin's non-static resources.
2020-04-14 20:45:54 -04:00
Andrew Browning
7ab8ca61c4 Use https:// instead of git:// to clone [#5551]
This was partially addressed in eee3e41 but missed many items.
2018-04-02 01:34:37 -04:00
Boris Bobrov
f5e48d9edf remove mentions of mediagoblin_local.ini 2017-11-13 02:43:25 +03:00
Boris Bobrov
94c10f1c57 clarify installation instructions about mediagoblin.ini 2017-11-13 02:38:44 +03:00
Andrew Browning
eee3e41bcf Fix #5517 - Change docs to clone repo using https 2017-09-20 01:39:46 -04:00
Andrew Browning
5487c3b0d9 Properly escape asterisk in *buntu 2017-08-15 02:29:54 -04:00
Boris Bobrov
2e1e96503e Switch to rabbitmq by default and in docs 2017-06-09 23:49:24 +03:00
Ben Sturmfels
9650aa394b Spell-check the entire documentation. 2016-09-18 16:28:22 +03:00
Christopher Allan Webber
e2212f944b Basic explaination of how to deploy with Python 3.
Could be better, but "works" for now.
2016-02-20 12:47:59 -08:00
Christopher Allan Webber
c9cdb03657 Move Ubuntu -> *buntu because of absurd trademark issues
For more context, see:
  http://joeyh.name/blog/entry/trademark_nonsense/
2016-02-19 11:51:20 -08:00
Loic Dachary
6ec0393df0 Fix #5359 - unpriviledged -> unprivileged 2016-01-19 15:19:08 -08:00
Christopher Allan Webber
13f187992a Kludgey documentation fix so that python 2 does not break with flup
See also Issue #5373
2015-12-14 14:19:20 -06:00
Christopher Allan Webber
f5ac2b61f7 Better phrasing: "Should I Keep Open Registration Enabled?" 2015-05-30 10:34:10 -05:00
Christopher Allan Webber
3f088a3f3d "Should I enable registration?" section 2015-05-30 10:27:54 -05:00
Jim Campbell
b791ae973c docs: Added handling of user_dev permissions
The user_dev directory gets created when users get established
and they start uploading media. However, the permissions aren't
correct on the directory as it gets created.

As a workaround, we create the directory at this stage, and then
set the proper permissions.

See this mailing list post for more information:
http://lists.mediagoblin.org/pipermail/devel/2015-May/001201.html
2015-05-26 00:44:10 -05:00
Jim Campbell
4c89287c3d docs: Updated permissions. Tweaked install details
Added nginx to installation packages. We say that our install uses
nginx, so users should skip nginx if they want to use apache. Also,
our group permissions depend on a web server being installed.

Changed install directory for mediagoblin acct to /var/lib/mediagoblin
It works better if we need to back up data.

Assigned mediagoblin user to the same group as the web server. This
is needed so that the server can access uploaded media.

Created mediagoblin group for non-web-server things such as logs.
2015-05-19 01:50:07 -05:00
Jim Campbell
80fe8e4c39 docs: Removed systemcl enable/start. Already issued.
Debian-based platforms start the postgres server by default after
installation. For RPM-based distros, we've already issued these
commands prior to configuring the postgres server.
2015-05-18 21:19:42 -05:00
Jim Campbell
a03920751f docs: Need to start postgres on rpm distros
Need to enable / start postgres database on rpm-based distros
before you create the postgres mediagoblin user and database.
If you don't start the database server, you can't create a
database user or database.
2015-05-18 21:12:37 -05:00
Jim Campbell
cd7af7899f docs: Clean up nginx instructions
Made it more clear what commands to use if you're on deb/rpm-based system.

Added a note that shows the user how to test their nginx configuration.
2015-05-11 21:16:30 -05:00
Jim Campbell
3948e44c9a docs: Added 'sudo' to cmd. Made 'exit' from postgres acct more clear.
Added a missing reference to 'sudo' in a command. Made the exit from
the postgres account more clear to reduce the chance for user error.
2015-05-11 20:41:01 -05:00
Jim Campbell
7bba6d2e9c docs: Removed chkconfig cmd. Made 'exit' more explicit.
The chkconfig command is only needed on CentOS 6, which isn't really
a supported multimedia platform. CentOS 7 and Fedora 21+
wouldn't require this command.

Also made the "exit" command (used after setting up the postgres
mediagoblin account and database) more explicit. This will help prevent
user errors for users who may skim through the documentation.
2015-05-11 20:15:08 -05:00
Jim Campbell
ec255f63be docs: Copy paste.ini to paste_local.ini
Some scripts on the internet have referenced paste_local.ini, so
it is safer to have a copy on the filesystem by default, even if
the user doesn't need to change any of the values for a regular
setup.
2015-05-11 19:00:40 -05:00
Christopher Allan Webber
8d59cd1f98 Note on what --without-virtualenv does 2015-04-28 14:14:44 -05:00
Jim Campbell
ef2642f7bb docs: Require nodejs-legacy on Debian-based systems. Remove un-needed text.
Per this announcement [0], Debian is using 'nodejs-legacy' as a
compatability package for what they used to call 'node'.
- Fixes bug 5080 [1].

Remove note about warning that users would no longer see.

[0] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=614907#108
[1] https://issues.mediagoblin.org/ticket/5080
2015-04-19 12:39:05 -05:00
Jim Campbell
44db13fa84 docs: Updated deployment docs to use sudo. Other various fixes.
- Use sudo instead of root user but give info on how to configure sudo.
- Changed docs to reference Jessie as the stable version of Debian
- Corrected the command to create the 'mediagoblin' system account
  - Fixes https://issues.mediagoblin.org/ticket/5083
2015-04-19 12:01:10 -05:00
Christopher Allan Webber
a35b7c7fb3 Merge branch 'stable'
Conflicts:
	docs/source/siteadmin/deploying.rst
	docs/source/siteadmin/relnotes.rst
2015-04-17 17:09:06 -05:00
Christopher Allan Webber
9fa1e602b4 Noting the possibility that users may need to update origin to Savannah 2015-04-17 17:00:54 -05:00
Boris Bobrov
4fd98b70d2 change git address to savannah's git 2015-04-17 16:56:18 -05:00
Boris Bobrov
f6d1b29f82 fix incorrect syntax in docs (bug 5310) 2015-04-11 01:02:08 +03:00
Jim Campbell
9a1ba0e87f docs: Removed note about installing from master. Clarified root/nonroot usage.
There was a note informing the user that they should be aware that we
encourage them to install from the *master* branch, but we no longer
do that. If they follow our deployment docs, they will pull in &
use the *stable* branch.

Also clarified some root / non-root system usage by either specifying
a leading *hash* symbol to indicate a root-based command, or a
dollar sign to indicate a non-root command.
2015-03-30 23:47:49 -05:00
Jim Campbell
c3075e9178 docs: Updated instructions re: Postgresql setup
Added information about needed packages for RPM-based systems,
and simplified instructions to rely on the root account rather than
sudo-based instructions.

If a user has sudo access, they can easily add "sudo" to the needed
commands.

Also added information about enabling postgres to start on boot
and how to start it for the current session.
2015-03-30 23:40:01 -05:00
Jim Campbell
6663dfa38c docs: Switched to 'useradd', as it is a more cross-distro cmd.
'adduser' is installed on Debian-based systems by default, but is
not installed by default on Fedora-based systems. 'useradd' is
installed by default on Debian-based systems, as well. The
'useradd'-based command provides the same functionality as
'adduser' in this case, though setting up a 'system' user with
no password.

Per bug 886, I've added the '--user-group' flag, which creates a
mediagoblin group, and assigns the mediagoblin user to this
group, too.
2015-03-29 19:40:36 -05:00
Jim Campbell
4ec1af1191 docs: Added npm/nodejs as a dependency. Also added automake.
These new dependencies are required as part of the 0.8 release.
Fixes https://issues.mediagoblin.org/ticket/5075
2015-03-29 13:39:09 -05:00
Christopher Allan Webber
82be36d125 Merge branch 'stable'
Conflicts:
	docs/source/siteadmin/deploying.rst
2015-03-19 20:44:49 -05:00
Christopher Allan Webber
47f66be97c git clone from https instead of git:// because gitorious broke the latter 2015-03-19 20:38:07 -05:00
Christopher Allan Webber
41dbb27a4f Switch docs over to suggest using bootstrap with configure and make 2015-02-22 14:47:33 -06:00
Jessica Tallon
2acf47d8cd Officially drop support for Python 2.6 (see #966) 2015-02-17 14:26:06 +01:00
Christopher Allan Webber
7a917e291a Recommend cloning the stable branch instead of master from now on
This commit sponsored by Karen Rustad.  You're awesome, Karen!
2014-12-14 12:56:33 -06:00
Christopher Allan Webber
f44bd7dc87 Patch by Sturm: explain permissions on media directories in deployment docs
This should hopefully reduce the amount that users are confused by their
media files not being available.
2014-11-20 11:36:29 -06:00
Christopher Allan Webber
f0e137ab2e Update docs: it's now ./bootstrap.sh, also, you need to get a copy of mediagoblin.ini 2014-10-10 14:42:17 -05:00
Christopher Allan Webber
d60d686a14 eek, should be python2 not python22 2014-08-22 09:54:55 -05:00
Christopher Allan Webber
23002ee77f Set up virtualenv to use py2
This commit sponsored by Jonas Öberg.  Thanks Jonas!
2014-08-03 14:09:31 -05:00
Elrond
138d934f01 Make chown more generic.
Some distributions (ubuntu 14.04 maybe?) don't create a
group for a new user.  So change the "chown" to use the
primary group of the user instead of forcing the group.
This should do the right thing in more cases.

Old: chown mediagoblin:mediagoblin
New: chown mediagoblin:
2014-07-30 19:51:23 +02:00