https://wiki.mediagoblin.org/api.php?action=feedcontributions&feedformat=atom&user=Cfdv 2026-05-19T07:27:43Z User contributions MediaWiki 1.39.17 https://wiki.mediagoblin.org/index.php?title=HackingHowto&diff=236 2011-09-04T05:20:08Z

<p>Cfdv: /* Bite-sized bugs to start with */</p> <hr /> <div>{{Needswork}}<br /> <br /> = Hacking HOWTO =<br /> <br /> <br /> == So you want to hack on GNU MediaGoblin? ==<br /> <br /> First thing to do is check out the [http://mediagoblin.org/join/ web site] where we list all the project<br /> infrastructure including:<br /> <br /> * the IRC channel<br /> * the mailing list<br /> * the issue tracker<br /> <br /> Additionally, we have information on how to get involved, who to talk<br /> to, what needs to be worked on, and other things besides!<br /> <br /> Second thing to do is take a look at :ref:`codebase-chapter` where<br /> we've started documenting how GNU MediaGoblin is built and how to add<br /> new things.<br /> <br /> Third you'll need to get the requirements.<br /> <br /> Fourth, you'll need to build a development environment. We use buildout,<br /> but if you want to use virtualenv, there's a set of mediocre not-very-supported<br /> steps in the [https://gitorious.org/mediagoblin/pages/Home evil wiki].<br /> <br /> <br /> == Getting requirements ==<br /> <br /> First, you need to have the following installed before you can build<br /> an environment for hacking on GNU MediaGoblin:<br /> <br /> * Python 2.6 or 2.7 - http://www.python.org/ (You'll need Python as well as the dev files for building modules.)<br /> * python-lxml - http://lxml.de/<br /> * git - http://git-scm.com/<br /> * MongoDB - http://www.mongodb.org/<br /> * Python Imaging Library (PIL) - http://www.pythonware.com/products/pil/<br /> <br /> If you're running Debian GNU/Linux or a Debian-derived distribution<br /> such as Debian, Mint, or [http://bugs.foocorp.net/issues/478 Ubuntu 10.10+], running the following should install these<br /> requirements:<br /> <br /> {{Cmd|sudo apt-get install mongodb git-core python python-dev python-lxml python-imaging}}<br /> <br /> On Fedora:<br /> <br /> {{Cmd|yum install mongodb-server python-paste-deploy python-paste-script git-core python python-devel python-lxml python-imaging}}<br /> <br /> ----<br /> <br /> On Mac OS X Lion:<br /> <br /> Download the Newest Python.<br /> <br /> Git is already installed.<br /> <br /> Install MongoDB from these instructions: http://www.mongodb.org/display/DOCS/Quickstart+OS+X<br /> <br /> Python-lxml: http://muffinresearch.co.uk/archives/2009/03/05/install-lxml-on-osx/ with sudo<br /> <br /> Python Imaging Library (PIL): http://code.google.com/appengine/docs/python/images/installingPIL.html#mac<br /> <br /> Libjpeg &amp; Libpng: http://ethan.tira-thompson.org/Mac_OS_X_Ports.html Combo Installer<br /> <br /> ----<br /> <br /> <br /> '''You can help:'''<br /> <br /> If you have instructions for other GNU/Linux distributions or Mac OS X to set<br /> up requirements, let us know!<br /> <br /> == How to set up and maintain an environment for hacking with buildout ==<br /> <br /> '''Requirements'''<br /> <br /> No additional requirements.<br /> <br /> <br /> '''Create a development environment'''<br /> <br /> After installing the requirements, follow these steps:<br /> <br /> # Clone the repository: {{Cmd|git clone &lt;nowiki&gt;git://gitorious.org/mediagoblin/mediagoblin.git&lt;/nowiki&gt;}}<br /> # Bootstrap and run buildout: {{Cmd|cd mediagoblin}} and then one of the following:<br /> #* {{Cmd|python bootstrap.py &amp;&amp; ./bin/buildout}}, '''OR'''<br /> #* {{Cmd|python bootstrap.py --distribute &amp;&amp; ./bin/buildout}}<br /> <br /> <br /> Why would you want one over the other? If the first doesn't work, then try the second.<br /> <br /> That's it! Using this method, buildout should create a &lt;tt&gt;user_dev&lt;/tt&gt;<br /> directory, in which certain things will be stored (media, beaker<br /> session stuff, etc). You can change this, but for development<br /> purposes this default should be fine.<br /> <br /> If you have problems, please [http://mediagoblin.org/join/ let us know]!<br /> <br /> <br /> '''Updating for dependency changes'''<br /> <br /> While hacking on GNU MediaGoblin over time, you'll eventually have to<br /> update your development environment because the dependencies have<br /> changed.<br /> <br /> To do that, run:<br /> <br /> {{Cmd|./bin/buildout &amp;&amp; ./bin/gmg migrate}}.<br /> <br /> <br /> '''Updating for code changes'''<br /> <br /> You don't need to do anything---code changes are automatically available.<br /> <br /> <br /> '''Deleting your buildout'''<br /> <br /> At some point, you may want to delete your buildout. Perhaps it's to<br /> start over. Perhaps it's to test building development environments<br /> with buildout.<br /> <br /> To do this, run:<br /> <br /> {{Cmd|rm -rf bin develop-eggs eggs mediagoblin.egg-info parts user_dev}}.<br /> <br /> <br /> == Running Mongo Database ==<br /> <br /> Startup the Database: {{Cmd|./mongodb-xxxxxxx/bin/mongod}}.<br /> <br /> == Running the server ==<br /> <br /> If you want to get things running quickly and without hassle, just<br /> run:<br /> <br /> {{Cmd|./lazyserver.sh}}.<br /> <br /> <br /> This will start up a python server where you can begin playing with<br /> mediagoblin. It will also run celery in &quot;always eager&quot; mode so you<br /> don't have to start a separate process for it.<br /> <br /> This is fine in development, but if you want to actually run celery<br /> separately for testing (or deployment purposes), you'll want to run<br /> the server independently:<br /> <br /> {{Cmd|./bin/paster serve paste.ini --reload}}<br /> <br /> <br /> == Running celeryd ==<br /> <br /> If you aren't using &lt;tt&gt;./lazyserver.sh&lt;/tt&gt; or otherwise aren't running celery<br /> in always eager mode, you'll need to do this if you want your media to<br /> process and actually show up. It's probably a good idea in<br /> development to have the web server (above) running in one terminal and<br /> celeryd in another window.<br /> <br /> Run:<br /> <br /> {{Cmd|&lt;nowiki&gt;CELERY_CONFIG_MODULE=mediagoblin.init.celery.from_celery ./bin/celeryd&lt;/nowiki&gt;}}.<br /> <br /> <br /> == Running the test suite ==<br /> <br /> Run:<br /> <br /> {{Cmd|./runtests.sh}}<br /> <br /> <br /> == Running a shell ==<br /> <br /> If you want a shell with your database pre-setup and an instantiated<br /> application ready and at your fingertips....<br /> <br /> Run:<br /> <br /> {{Cmd|./bin/gmg shell}}<br /> <br /> <br /> == Troubleshooting ==<br /> <br /> === pymongo.errors.AutoReconnect: could not find master/primary ===<br /> <br /> If you see this:<br /> <br /> pymongo.errors.AutoReconnect: could not find master/primary<br /> <br /> then make sure mongodb is installed and running.<br /> <br /> If it's installed, check the mongodb log. On my machine, that's <br /> &lt;tt&gt;/var/log/mongodb/mongodb.log&lt;/tt&gt;. If you see something like:<br /> <br /> old lock file: /var/lib/mongodb/mongod.lock. probably means...<br /> <br /> in that case you might have had an unclean shutdown. Try:<br /> <br /> {{Cmd|sudo mongod --repair}}<br /> <br /> If that didn't work, just delete the lock file and relaunch mongodb.<br /> <br /> Anyway, then start the mongodb server in whatever way is appropriate<br /> for your distro / OS.<br /> <br /> <br /> == Wiping your user data ==<br /> <br /> You can completely wipe all data from the instance by doing:<br /> <br /> {{Cmd|gmg wipealldata}}<br /> <br /> '''Note:'''<br /> <br /> Unless you're doing development and working on and testing creating<br /> a new instance, you will probably never have to do this. Will<br /> plans to do this work and thus he documented it.<br /> <br /> <br /> == Quickstart for Django programmers ==<br /> <br /> We're not using Django, but the codebase is very Django-like in its<br /> structure.<br /> <br /> * &lt;tt&gt;routing.py&lt;/tt&gt; is like &lt;tt&gt;urls.py&lt;/tt&gt; in Django<br /> * &lt;tt&gt;models.py&lt;/tt&gt; has mongokit ORM definitions<br /> * &lt;tt&gt;views.py&lt;/tt&gt; is where the views go<br /> <br /> We're using MongoDB. Basically, instead of a relational database with<br /> tables, you have a big JSON structure which acts a lot like a Python<br /> dict.<br /> <br /> <br /> '''YouCanHelp'''<br /> <br /> If there are other things that you think would help orient someone<br /> new to GNU MediaGoblin but coming from Django, let us know!<br /> <br /> <br /> == Bite-sized bugs to start with ==<br /> <br /> Now you should visit our latest list of [http://bugs.foocorp.net/projects/mediagoblin/issues?query_id=3 bite-sized issues] because squishing bugs is messy fun. If you're interested in other things to work on, or need help getting started on a bug, let us know on [http://mediagoblin.org/join/ the mailing list] or on the [http://mediagoblin.org/join/ IRC channel].</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Deployment&diff=235 2011-09-04T01:57:47Z

<p>Cfdv: </p> <hr /> <div>This page could use a lot of work. For now, a few smaller deployment tips!<br /> <br /> = Use Virtualenv =<br /> <br /> Our [[Development quick start]] guide recommends using [http://buildout.org zc.buildout], but this system is somewhat problematic for actual deployments (if a buildout goes badly, buildout removes all your packaging setup and your scripts in bin/ and other things... yuck :\). Use [http://www.virtualenv.org/ Virtualenv] instead. In the future, all our docs will bet set up to recommend using Virtualenv.<br /> <br /> = MongoDB setup =<br /> <br /> You should almost certainly [http://www.mongodb.org/display/DOCS/Journaling run MongoDB with Journaling on] if you have a new enough version of MongoDB. (If you don't, maybe you should get a newer version!) Without journaling there's some risk you could lose data that isn't yet written to disk if MongoDB is shut down incorrectly.<br /> <br /> Also, keep in mind the following [http://www.snailinaturtleneck.com/blog/2010/08/19/if-it-quacks-like-a-rdbms/ assumptions MongoDB makes] about your deployment environment<br /> <br /> * 64-bit machine<br /> * little-endian<br /> * more than one server<br /> * speed is more important than reliability, and journaling is off by default<br /> <br /> = Running MediaGoblin's web server and Celery separately =<br /> <br /> ./lazyserver.sh is all good and well for debugging, but probably not for deployments. Instead, you should probably run</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=173 2011-08-21T02:25:11Z

<p>Cfdv: /* Prepare instance for bundling into a public AMI */</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an [http://aws.amazon.com/ec2/ EC2] instance from an [http://aws.amazon.com/amis AMI] pre-loaded with MediaGoblin. The following [http://aws.amazon.com/articles/0155828273219400 recipe] should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-61be7908 ami-61be7908]. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not log in to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=User_Experience&diff=153 2011-08-17T16:16:33Z

<p>Cfdv: /* From Deb, UX notes on 8.16.2011 */</p> <hr /> <div>We need help doing user experience testing! This means users testing our software, observing what does and doesn't work for them, and recording that.<br /> <br /> If you're here to help (HOORAY!) go to the testing instance set up by Caleb Davis: http://omgmg.dyndns.org:6543/<br /> <br /> Sign up for an account'''*''', add some pictures'''**''' and play around. Take some notes and then either set up an account on this wiki and add your thoughts to this page or email them to press@mediagoblin.org. Please include your operating system and what browser you're using. <br /> <br /> '''*''' Your email validation link may be in your spam folder!&lt;br&gt;<br /> '''**''' NOTHING ON THIS INSTANCE IS PERMANENT. This is for user experience testing only... your pics will be wiped!<br /> <br /> You'll be able to give us the best feedback if you don't look at anyone else's notes before you start. Thanks for helping us with usability!! We really appreciate it!<br /> <br /> = User notes go in this section =<br /> <br /> === From Deb, UX notes on 8.16.2011 === <br /> I'm running Ubuntu 10.04, Lucid Lynx. It's the Netbook remix version on an Aspire One, with Firefox version 3.6.18 for Ubuntu <br /> <br /> * Login page did not prompt for the possibility of forgotten password<br /> <br /> * login is really big on netbook, so that not all felds are visible on the screen at once, not ideal for just four fields<br /> <br /> * Not clear how you get to a page for adding media from the email verification page. <br /> <br /> * The submit box is really large on a netbook, the whole box should be visible on one screen<br /> <br /> * The tagging field should have small text underneath it about what format tags should use<br /> <br /> * Thumbnails on the little nav buttons from one pic to the other would be nice<br /> <br /> * The media submission page could also be scaled for the netbook screen<br /> <br /> * people will want to submit multiple images which it seems you can't yet do<br /> <br /> * Animated gifs work! Awesome. <br /> <br /> * Tags seem to be not case sensitive and strip punctuation. Also awesome.<br /> <br /> === Nelson's notes on 8.13.2011 (paraphrased) === <br /> <br /> * hey, where's my notification?<br /> * everything is working alright<br /> * successfully uploaded stuff ...<br /> * commenting works<br /> * profile works ...<br /> * is that all I can do?<br /> '''I'd like to be able to'''<br /> * find other users<br /> * friend them ... or something<br /> * go somewhere else besides my profile page<br /> * download original image<br /> * see full-size image<br /> * use a public server<br /> '''Other Comments'''<br /> * go to a real domain and make it public<br /> <br /> = General thoughts on running a user experience test =<br /> <br /> Could someone with experience with this fill in info here? ;)<br /> <br /> <br /> I (Jan-Christoph Borchardt) write a thesis at the moment on [http://owncloud.iuk.hdm-stuttgart.de/apps/files_publiclink/get.php?token=6c766212ba094bea08bf1bb800b3e1e7c785388e Coordinating low-cost usability testing in independent free &amp; open source software projects]&lt;br&gt;<br /> There are many small tips and recipes on how to do your own testing. Especially look into the ''Methods'' part.&lt;br&gt;<br /> Please let me know if you have any other experiences with testing, I intend on regularly updating that document and release the full version freely licensed once it’s done as well as some kind of a ''quick start guide''.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=User_Experience&diff=143 2011-08-16T22:59:17Z

<p>Cfdv: </p> <hr /> <div>We need help doing user experience testing! This means users testing our software, observing what does and doesn't work for them, and recording that.<br /> <br /> If you're here to help (HOORAY!) go to the testing instance set up by Caleb Davis: http://omgmg.dyndns.org:6543/<br /> <br /> Sign up for an account'''*''', add some pictures'''**''' and play around. Take some notes and then either set up an account on this wiki and add your thoughts to this page or email them to press@mediagoblin.org. Please include your operating system and what browser you're using. <br /> <br /> '''*''' Your email validation link may be in your spam folder!&lt;br&gt;<br /> '''**''' NOTHING ON THIS INSTANCE IS PERMANENT. This is for user experience testing only... your pics will be wiped!<br /> <br /> You'll be able to give us the best feedback if you don't look at anyone else's notes before you start. Thanks for helping us with usability!! We really appreciate it!<br /> <br /> = User notes go in this section =<br /> <br /> === From Deb, UX notes on 8.16.2011 === <br /> I'm running Ubuntu 10.04, Lucid Lynx. It's the Netbook remix version on an Aspire One, with Firefox version 3.6.18 for Ubuntu <br /> <br /> * Login page did not prompt for the possibility of forgotten password<br /> <br /> * login is really big on netbook, so that not all felds are visible on the screen at once, not ideal for just four fields<br /> <br /> * Not clear how you get to a page for adding media from the email verification page. <br /> <br /> * The submit box is really large on a netbook, the whole box should be visible on one screen<br /> <br /> * The tagging field should have small text underneath it about what format tags should use<br /> <br /> * Thumbnails on the little nav buttons from one pic to the other would be nice<br /> <br /> * The media submission page could also be scaled for the netbook screen<br /> <br /> * people will want to submit multiple images which it seems you can't yet do<br /> <br /> * Animated gifs work! Awesome. <br /> <br /> * Tags seem to be not case sensitive and strip punctuation. Also awesome.<br /> <br /> = General thoughts on running a user experience test =<br /> <br /> Could someone with experience with this fill in info here? ;)<br /> <br /> <br /> I (Jan-Christoph Borchardt) write a thesis at the moment on [http://owncloud.iuk.hdm-stuttgart.de/apps/files_publiclink/get.php?token=6c766212ba094bea08bf1bb800b3e1e7c785388e Coordinating low-cost usability testing in independent free &amp; open source software projects]&lt;br&gt;<br /> There are many small tips and recipes on how to do your own testing. Especially look into the ''Methods'' part.&lt;br&gt;<br /> Please let me know if you have any other experiences with testing, I intend on regularly updating that document and release the full version freely licensed once it’s done as well as some kind of a ''quick start guide''.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=User_Experience&diff=142 2011-08-16T22:58:05Z

<p>Cfdv: </p> <hr /> <div>We need help doing user experience testing! This means users testing our software, observing what does and doesn't work for them, and recording that.<br /> <br /> If you're here to help (HOORAY!) go to the testing instance set up by Caleb Davis: http://omgmg.dyndns.org:6543/<br /> <br /> Sign up for an account'''*''', add some pictures'''**''' and play around. Take some notes and then either set up an account on this wiki and add your thoughts to this page or email them to press@mediagoblin.org. Please include your operating system and what browser you're using. <br /> <br /> '''*''' Your email validation email could be in your spam folder!&lt;br&gt;<br /> '''**''' NOTHING ON THIS INSTANCE IS PERMANENT. This is for user experience testing only... your pics will be wiped!<br /> <br /> You'll be able to give us the best feedback if you don't look at anyone else's notes before you start. Thanks for helping us with usability!! We really appreciate it!<br /> <br /> = User notes go in this section =<br /> <br /> === From Deb, UX notes on 8.16.2011 === <br /> I'm running Ubuntu 10.04, Lucid Lynx. It's the Netbook remix version on an Aspire One, with Firefox version 3.6.18 for Ubuntu <br /> <br /> * Login page did not prompt for the possibility of forgotten password<br /> <br /> * login is really big on netbook, so that not all felds are visible on the screen at once, not ideal for just four fields<br /> <br /> * Not clear how you get to a page for adding media from the email verification page. <br /> <br /> * The submit box is really large on a netbook, the whole box should be visible on one screen<br /> <br /> * The tagging field should have small text underneath it about what format tags should use<br /> <br /> * Thumbnails on the little nav buttons from one pic to the other would be nice<br /> <br /> * The media submission page could also be scaled for the netbook screen<br /> <br /> * people will want to submit multiple images which it seems you can't yet do<br /> <br /> * Animated gifs work! Awesome. <br /> <br /> * Tags seem to be not case sensitive and strip punctuation. Also awesome.<br /> <br /> = General thoughts on running a user experience test =<br /> <br /> Could someone with experience with this fill in info here? ;)<br /> <br /> <br /> I (Jan-Christoph Borchardt) write a thesis at the moment on [http://owncloud.iuk.hdm-stuttgart.de/apps/files_publiclink/get.php?token=6c766212ba094bea08bf1bb800b3e1e7c785388e Coordinating low-cost usability testing in independent free &amp; open source software projects]&lt;br&gt;<br /> There are many small tips and recipes on how to do your own testing. Especially look into the ''Methods'' part.&lt;br&gt;<br /> Please let me know if you have any other experiences with testing, I intend on regularly updating that document and release the full version freely licensed once it’s done as well as some kind of a ''quick start guide''.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=User_Experience&diff=141 2011-08-16T22:54:43Z

<p>Cfdv: </p> <hr /> <div>We need help doing user experience testing! This means users testing our software, observing what does and doesn't work for them, and recording that.<br /> <br /> If you're here to help (HOORAY!) go to the testing instance set up by Caleb Davis: http://omgmg.dyndns.org:6543/<br /> <br /> Sign up for an account'''*''', add some pictures'''**''' and play around. Take some notes and then either set up an account on this wiki and add your thoughts to this page or email them to press@mediagoblin.org. Please include your operating system and what browser you're using. <br /> <br /> * Your email validation email could be in your spam folder!<br /> ** NOTHING ON THIS INSTANCE IS PERMANENT. This is for user experience testing only... your pics will be wiped!<br /> <br /> You'll be able to give us the best feedback if you don't look at anyone else's notes before you start. Thanks for helping us with usability!! We really appreciate it!<br /> <br /> = User notes go in this section =<br /> <br /> === From Deb, UX notes on 8.16.2011 === <br /> I'm running Ubuntu 10.04, Lucid Lynx. It's the Netbook remix version on an Aspire One, with Firefox version 3.6.18 for Ubuntu <br /> <br /> * Login page did not prompt for the possibility of forgotten password<br /> <br /> * login is really big on netbook, so that not all felds are visible on the screen at once, not ideal for just four fields<br /> <br /> * Not clear how you get to a page for adding media from the email verification page. <br /> <br /> * The submit box is really large on a netbook, the whole box should be visible on one screen<br /> <br /> * The tagging field should have small text underneath it about what format tags should use<br /> <br /> * Thumbnails on the little nav buttons from one pic to the other would be nice<br /> <br /> * The media submission page could also be scaled for the netbook screen<br /> <br /> * people will want to submit multiple images which it seems you can't yet do<br /> <br /> * Animated gifs work! Awesome. <br /> <br /> * Tags seem to be not case sensitive and strip punctuation. Also awesome.<br /> <br /> = General thoughts on running a user experience test =<br /> <br /> Could someone with experience with this fill in info here? ;)<br /> <br /> <br /> I (Jan-Christoph Borchardt) write a thesis at the moment on [http://owncloud.iuk.hdm-stuttgart.de/apps/files_publiclink/get.php?token=6c766212ba094bea08bf1bb800b3e1e7c785388e Coordinating low-cost usability testing in independent free &amp; open source software projects]&lt;br&gt;<br /> There are many small tips and recipes on how to do your own testing. Especially look into the ''Methods'' part.&lt;br&gt;<br /> Please let me know if you have any other experiences with testing, I intend on regularly updating that document and release the full version freely licensed once it’s done as well as some kind of a ''quick start guide''.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=User_Experience&diff=140 2011-08-16T22:54:04Z

<p>Cfdv: </p> <hr /> <div>We need help doing user experience testing! This means users testing our software, observing what does and doesn't work for them, and recording that.<br /> <br /> If you're here to help (HOORAY!) go to the testing instance set up by Caleb Davis: http://omgmg.dyndns.org:6543/<br /> <br /> Sign up for an account'''*''', add some pictures'''**''' and play around. Take some notes and then either set up an account on this wiki and add your thoughts to this page or email them to press@mediagoblin.org Please include your operating system and what browser you're using. <br /> <br /> * Your email validation email could be in your spam folder!<br /> ** NOTHING ON THIS INSTANCE IS PERMANENT. This is for user experience testing only... your pics will be wiped!<br /> <br /> You'll be able to give us the best feedback if you don't look at anyone else's notes before you start. Thanks for helping us with usability!! We really appreciate it!<br /> <br /> = User notes go in this section =<br /> <br /> === From Deb, UX notes on 8.16.2011 === <br /> I'm running Ubuntu 10.04, Lucid Lynx. It's the Netbook remix version on an Aspire One, with Firefox version 3.6.18 for Ubuntu <br /> <br /> * Login page did not prompt for the possibility of forgotten password<br /> <br /> * login is really big on netbook, so that not all felds are visible on the screen at once, not ideal for just four fields<br /> <br /> * Not clear how you get to a page for adding media from the email verification page. <br /> <br /> * The submit box is really large on a netbook, the whole box should be visible on one screen<br /> <br /> * The tagging field should have small text underneath it about what format tags should use<br /> <br /> * Thumbnails on the little nav buttons from one pic to the other would be nice<br /> <br /> * The media submission page could also be scaled for the netbook screen<br /> <br /> * people will want to submit multiple images which it seems you can't yet do<br /> <br /> * Animated gifs work! Awesome. <br /> <br /> * Tags seem to be not case sensitive and strip punctuation. Also awesome.<br /> <br /> = General thoughts on running a user experience test =<br /> <br /> Could someone with experience with this fill in info here? ;)<br /> <br /> <br /> I (Jan-Christoph Borchardt) write a thesis at the moment on [http://owncloud.iuk.hdm-stuttgart.de/apps/files_publiclink/get.php?token=6c766212ba094bea08bf1bb800b3e1e7c785388e Coordinating low-cost usability testing in independent free &amp; open source software projects]&lt;br&gt;<br /> There are many small tips and recipes on how to do your own testing. Especially look into the ''Methods'' part.&lt;br&gt;<br /> Please let me know if you have any other experiences with testing, I intend on regularly updating that document and release the full version freely licensed once it’s done as well as some kind of a ''quick start guide''.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=HackingHowto&diff=108 2011-08-13T16:22:17Z

<p>Cfdv: /* Getting requirements */</p> <hr /> <div>= Hacking HOWTO =<br /> <br /> <br /> == So you want to hack on GNU MediaGoblin? ==<br /> <br /> First thing to do is check out the [http://mediagoblin.org/join/ web site] where we list all the project<br /> infrastructure including:<br /> <br /> * the IRC channel<br /> * the mailing list<br /> * the issue tracker<br /> <br /> Additionally, we have information on how to get involved, who to talk<br /> to, what needs to be worked on, and other things besides!<br /> <br /> Second thing to do is take a look at :ref:`codebase-chapter` where<br /> we've started documenting how GNU MediaGoblin is built and how to add<br /> new things.<br /> <br /> Third you'll need to get the requirements.<br /> <br /> Fourth, you'll need to build a development environment. We use buildout,<br /> but if you want to use virtualenv, there's a set of mediocre not-very-supported<br /> steps in the [https://gitorious.org/mediagoblin/pages/Home evil wiki].<br /> <br /> <br /> == Getting requirements ==<br /> <br /> First, you need to have the following installed before you can build<br /> an environment for hacking on GNU MediaGoblin:<br /> <br /> * Python 2.6 or 2.7 - http://www.python.org/ (You'll need Python as well as the dev files for building modules.)<br /> * python-lxml - http://lxml.de/<br /> * git - http://git-scm.com/<br /> * MongoDB - http://www.mongodb.org/<br /> <br /> If you're running Debian GNU/Linux or a Debian-derived distribution<br /> such as Mint or [http://bugs.foocorp.net/issues/478 Ubuntu 10.10+], running the following should install these<br /> requirements:<br /> <br /> sudo apt-get install mongodb git-core python python-dev \<br /> python-lxml<br /> <br /> On Fedora:<br /> <br /> yum install mongodb-server python-paste-deploy python-paste-script \<br /> git-core python python-devel python-lxml<br /> <br /> <br /> '''You can help:'''<br /> <br /> If you have instructions for other GNU/Linux distributions to set<br /> up requirements, let us know!<br /> <br /> == How to set up and maintain an environment for hacking with buildout ==<br /> <br /> '''Requirements'''<br /> <br /> No additional requirements.<br /> <br /> <br /> '''Create a development environment'''<br /> <br /> After installing the requirements, follow these steps:<br /> <br /> # Clone the repository: &lt;tt&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git&lt;/tt&gt;<br /> # Bootstrap and run buildout: &lt;tt&gt;cd mediagoblin&lt;/tt&gt; and then &lt;tt&gt;python bootstrap.py &amp;&amp; ./bin/buildout&lt;/tt&gt;<br /> <br /> <br /> That's it! Using this method, buildout should create a &lt;tt&gt;user_dev&lt;/tt&gt;<br /> directory, in which certain things will be stored (media, beaker<br /> session stuff, etc). You can change this, but for development<br /> purposes this default should be fine.<br /> <br /> <br /> '''Updating for dependency changes'''<br /> <br /> While hacking on GNU MediaGoblin over time, you'll eventually have to<br /> update your development environment because the dependencies have<br /> changed. To do that, run:<br /> <br /> ./bin/buildout &amp;&amp; ./bin/gmg migrate<br /> <br /> <br /> '''Updating for code changes'''<br /> <br /> You don't need to do anything---code changes are automatically available.<br /> <br /> <br /> '''Deleting your buildout'''<br /> <br /> At some point, you may want to delete your buildout. Perhaps it's to<br /> start over. Perhaps it's to test building development environments<br /> with buildout.<br /> <br /> To do this, do:<br /> <br /> rm -rf bin develop-eggs eggs mediagoblin.egg-info parts user_dev<br /> <br /> <br /> == Running the server ==<br /> <br /> If you want to get things running quickly and without hassle, just<br /> run:<br /> <br /> ./lazyserver.sh<br /> <br /> This will start up a python server where you can begin playing with<br /> mediagoblin. It will also run celery in &quot;always eager&quot; mode so you<br /> don't have to start a separate process for it.<br /> <br /> This is fine in development, but if you want to actually run celery<br /> separately for testing (or deployment purposes), you'll want to run<br /> the server independently:<br /> <br /> ./bin/paster serve paste.ini --reload<br /> <br /> <br /> == Running celeryd ==<br /> <br /> If you aren't using &lt;tt&gt;./lazyserver.sh&lt;/tt&gt; or otherwise aren't running celery<br /> in always eager mode, you'll need to do this if you want your media to<br /> process and actually show up. It's probably a good idea in<br /> development to have the web server (above) running in one terminal and<br /> celeryd in another window.<br /> <br /> Run:<br /> <br /> CELERY_CONFIG_MODULE=mediagoblin.init.celery.from_celery ./bin/celeryd<br /> <br /> <br /> == Running the test suite ==<br /> <br /> Run:<br /> <br /> ./runtests.sh<br /> <br /> <br /> == Running a shell ==<br /> <br /> If you want a shell with your database pre-setup and an instantiated<br /> application ready and at your fingertips....<br /> <br /> Run:<br /> <br /> ./bin/gmg shell<br /> <br /> <br /> == Troubleshooting ==<br /> <br /> === pymongo.errors.AutoReconnect: could not find master/primary ===<br /> <br /> If you see this:<br /> <br /> pymongo.errors.AutoReconnect: could not find master/primary<br /> <br /> then make sure mongodb is installed and running.<br /> <br /> If it's installed, check the mongodb log. On my machine, that's <br /> &lt;tt&gt;/var/log/mongodb/mongodb.log&lt;/tt&gt;. If you see something like:<br /> <br /> old lock file: /var/lib/mongodb/mongod.lock. probably means...<br /> <br /> in that case you might have had an unclean shutdown. Try:<br /> <br /> sudo mongod --repair<br /> <br /> If that didn't work, just delete the lock file and relaunch mongodb.<br /> <br /> Anyway, then start the mongodb server in whatever way is appropriate<br /> for your distro / OS.<br /> <br /> <br /> === pkg_resources.DistributionNotFound: distribute ===<br /> <br /> If you get this while running buildout:<br /> <br /> pkg_resources.DistributionNotFound: distribute<br /> <br /> Try this commmand instead:<br /> <br /> python bootstrap.py --distribute &amp;&amp; ./bin/buildout<br /> <br /> <br /> == Wiping your user data ==<br /> <br /> You can completely wipe all data from the instance by doing:<br /> <br /> gmg wipealldata<br /> <br /> <br /> '''Note:'''<br /> <br /> Unless you're doing development and working on and testing creating<br /> a new instance, you will probably never have to do this. Will<br /> plans to do this work and thus he documented it.<br /> <br /> <br /> == Quickstart for Django programmers ==<br /> <br /> We're not using Django, but the codebase is very Django-like in its<br /> structure.<br /> <br /> * &lt;tt&gt;routing.py&lt;/tt&gt; is like &lt;tt&gt;urls.py&lt;/tt&gt; in Django<br /> * &lt;tt&gt;models.py&lt;/tt&gt; has mongokit ORM definitions<br /> * &lt;tt&gt;views.py&lt;/tt&gt; is where the views go<br /> <br /> We're using MongoDB. Basically, instead of a relational database with<br /> tables, you have a big JSON structure which acts a lot like a Python<br /> dict.<br /> <br /> <br /> '''YouCanHelp'''<br /> <br /> If there are other things that you think would help orient someone<br /> new to GNU MediaGoblin but coming from Django, let us know!<br /> <br /> <br /> == Bite-sized bugs to start with ==<br /> <br /> '''May 3rd, 2011''': We don't have a list of bite-sized bugs, yet, but<br /> this is important to us. If you're interested in things to work on,<br /> let us know on [http://mediagoblin.org/join/ the mailing list] or<br /> on the [http://mediagoblin.org/join/ IRC channel].<br /> <br /> <br /> == Tips for people new to coding ==<br /> <br /> === Learning Python ===<br /> <br /> GNU MediaGoblin is written using a programming language called [http://python.org/ Python].<br /> <br /> There are two different incompatible iterations of Python which I'll<br /> refer to as Python 2 and Python 3. GNU MediaGoblin is written in<br /> Python 2 and requires Python 2.6 or 2.7. At some point, we might<br /> switch to Python 3, but that's a future thing.<br /> <br /> You can learn how to code in Python 2 from several excellent books<br /> that are freely available on the Internet:<br /> <br /> * [http://learnpythonthehardway.org/ Learn Python the Hard Way]<br /> * [http://diveintopython.org/ Dive Into Python]<br /> * [http://www.greenteapress.com/thinkpython/ Python for Software Design]<br /> * [http://www.swaroopch.com/notes/Python A Byte of Python]<br /> <br /> These are all excellent texts.<br /> <br /> '''You Can Help'''<br /> <br /> If you know of other good quality Python tutorials and Python<br /> tutorial videos, let us know!<br /> <br /> <br /> === Learning Libraries GNU MediaGoblin uses ===<br /> <br /> GNU MediaGoblin uses a variety of libraries in order to do what it<br /> does. These libraries are listed in the :ref:`codebase-chapter`<br /> along with links to the project Web sites and documentation for the<br /> libraries.<br /> <br /> There are a variety of Python-related conferences every year that have<br /> sessions covering many aspects of these libraries. You can find them<br /> at [http://python.mirocommunity.org Python Miro Community] -- This is a shameless plug; Will Kahn-Greene runs Python Miro Community.<br /> <br /> If you have questions or need help, find us on the mailing list and on<br /> IRC.<br /> <br /> === Learning git ===<br /> <br /> git is an interesting and very powerful tool. Like all powerful<br /> tools, it has a learning curve.<br /> <br /> If you're new to git, we highly recommend the following resources for<br /> getting the hang of it:<br /> <br /> * [http://learn.github.com/p/intro.html Learn Git] --- the GitHub intro to git<br /> * [http://progit.org/book/ Pro Git] --- fantastic book<br /> * [http://gitcasts.com/ Git casts] --- screencast covering git usage<br /> * [http://gitref.org/ Git Reference] --- Git reference that makes it easier to get the hang of git if you're coming from other version control systems<br /> <br /> There's also a git mission at [http://openhatch.org/ OpenHatch].<br /> <br /> === Learning other utilities ===<br /> <br /> The [http://openhatch.org/ OpenHatch] site has a series of<br /> [http://openhatch.org/missions/ training missions] which are<br /> designed to help you learn how to use these tools.<br /> <br /> If you're new to tar, diff, patch and git, we highly recommend you sign<br /> up with OpenHatch and do the missions.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=HackingHowto&diff=107 2011-08-13T16:03:53Z

<p>Cfdv: /* Getting requirements */</p> <hr /> <div>= Hacking HOWTO =<br /> <br /> <br /> == So you want to hack on GNU MediaGoblin? ==<br /> <br /> First thing to do is check out the [http://mediagoblin.org/join/ web site] where we list all the project<br /> infrastructure including:<br /> <br /> * the IRC channel<br /> * the mailing list<br /> * the issue tracker<br /> <br /> Additionally, we have information on how to get involved, who to talk<br /> to, what needs to be worked on, and other things besides!<br /> <br /> Second thing to do is take a look at :ref:`codebase-chapter` where<br /> we've started documenting how GNU MediaGoblin is built and how to add<br /> new things.<br /> <br /> Third you'll need to get the requirements.<br /> <br /> Fourth, you'll need to build a development environment. We use buildout,<br /> but if you want to use virtualenv, there's a set of mediocre not-very-supported<br /> steps in the [https://gitorious.org/mediagoblin/pages/Home evil wiki].<br /> <br /> <br /> == Getting requirements ==<br /> <br /> First, you need to have the following installed before you can build<br /> an environment for hacking on GNU MediaGoblin:<br /> <br /> * Python 2.6 or 2.7 - http://www.python.org/ (You'll need Python as well as the dev files for building modules.)<br /> * python-lxml - http://lxml.de/<br /> * git - http://git-scm.com/<br /> * MongoDB [http://bugs.foocorp.net/issues/478 v1.3+] - http://www.mongodb.org/<br /> <br /> If you're running Debian GNU/Linux or a Debian-derived distribution<br /> such as Mint or Ubuntu, running the following should install these<br /> requirements:<br /> <br /> sudo apt-get install mongodb git-core python python-dev \<br /> python-lxml<br /> <br /> On Fedora:<br /> <br /> yum install mongodb-server python-paste-deploy python-paste-script \<br /> git-core python python-devel python-lxml<br /> <br /> <br /> '''You can help:'''<br /> <br /> If you have instructions for other GNU/Linux distributions to set<br /> up requirements, let us know!<br /> <br /> == How to set up and maintain an environment for hacking with buildout ==<br /> <br /> '''Requirements'''<br /> <br /> No additional requirements.<br /> <br /> <br /> '''Create a development environment'''<br /> <br /> After installing the requirements, follow these steps:<br /> <br /> # Clone the repository: &lt;tt&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git&lt;/tt&gt;<br /> # Bootstrap and run buildout: &lt;tt&gt;cd mediagoblin&lt;/tt&gt; and then &lt;tt&gt;python bootstrap.py &amp;&amp; ./bin/buildout&lt;/tt&gt;<br /> <br /> <br /> That's it! Using this method, buildout should create a &lt;tt&gt;user_dev&lt;/tt&gt;<br /> directory, in which certain things will be stored (media, beaker<br /> session stuff, etc). You can change this, but for development<br /> purposes this default should be fine.<br /> <br /> <br /> '''Updating for dependency changes'''<br /> <br /> While hacking on GNU MediaGoblin over time, you'll eventually have to<br /> update your development environment because the dependencies have<br /> changed. To do that, run:<br /> <br /> ./bin/buildout &amp;&amp; ./bin/gmg migrate<br /> <br /> <br /> '''Updating for code changes'''<br /> <br /> You don't need to do anything---code changes are automatically available.<br /> <br /> <br /> '''Deleting your buildout'''<br /> <br /> At some point, you may want to delete your buildout. Perhaps it's to<br /> start over. Perhaps it's to test building development environments<br /> with buildout.<br /> <br /> To do this, do:<br /> <br /> rm -rf bin develop-eggs eggs mediagoblin.egg-info parts user_dev<br /> <br /> <br /> == Running the server ==<br /> <br /> If you want to get things running quickly and without hassle, just<br /> run:<br /> <br /> ./lazyserver.sh<br /> <br /> This will start up a python server where you can begin playing with<br /> mediagoblin. It will also run celery in &quot;always eager&quot; mode so you<br /> don't have to start a separate process for it.<br /> <br /> This is fine in development, but if you want to actually run celery<br /> separately for testing (or deployment purposes), you'll want to run<br /> the server independently:<br /> <br /> ./bin/paster serve paste.ini --reload<br /> <br /> <br /> == Running celeryd ==<br /> <br /> If you aren't using &lt;tt&gt;./lazyserver.sh&lt;/tt&gt; or otherwise aren't running celery<br /> in always eager mode, you'll need to do this if you want your media to<br /> process and actually show up. It's probably a good idea in<br /> development to have the web server (above) running in one terminal and<br /> celeryd in another window.<br /> <br /> Run:<br /> <br /> CELERY_CONFIG_MODULE=mediagoblin.init.celery.from_celery ./bin/celeryd<br /> <br /> <br /> == Running the test suite ==<br /> <br /> Run:<br /> <br /> ./runtests.sh<br /> <br /> <br /> == Running a shell ==<br /> <br /> If you want a shell with your database pre-setup and an instantiated<br /> application ready and at your fingertips....<br /> <br /> Run:<br /> <br /> ./bin/gmg shell<br /> <br /> <br /> == Troubleshooting ==<br /> <br /> === pymongo.errors.AutoReconnect: could not find master/primary ===<br /> <br /> If you see this:<br /> <br /> pymongo.errors.AutoReconnect: could not find master/primary<br /> <br /> then make sure mongodb is installed and running.<br /> <br /> If it's installed, check the mongodb log. On my machine, that's <br /> &lt;tt&gt;/var/log/mongodb/mongodb.log&lt;/tt&gt;. If you see something like:<br /> <br /> old lock file: /var/lib/mongodb/mongod.lock. probably means...<br /> <br /> in that case you might have had an unclean shutdown. Try:<br /> <br /> sudo mongod --repair<br /> <br /> If that didn't work, just delete the lock file and relaunch mongodb.<br /> <br /> Anyway, then start the mongodb server in whatever way is appropriate<br /> for your distro / OS.<br /> <br /> <br /> === pkg_resources.DistributionNotFound: distribute ===<br /> <br /> If you get this while running buildout:<br /> <br /> pkg_resources.DistributionNotFound: distribute<br /> <br /> Try this commmand instead:<br /> <br /> python bootstrap.py --distribute &amp;&amp; ./bin/buildout<br /> <br /> <br /> == Wiping your user data ==<br /> <br /> You can completely wipe all data from the instance by doing:<br /> <br /> gmg wipealldata<br /> <br /> <br /> '''Note:'''<br /> <br /> Unless you're doing development and working on and testing creating<br /> a new instance, you will probably never have to do this. Will<br /> plans to do this work and thus he documented it.<br /> <br /> <br /> == Quickstart for Django programmers ==<br /> <br /> We're not using Django, but the codebase is very Django-like in its<br /> structure.<br /> <br /> * &lt;tt&gt;routing.py&lt;/tt&gt; is like &lt;tt&gt;urls.py&lt;/tt&gt; in Django<br /> * &lt;tt&gt;models.py&lt;/tt&gt; has mongokit ORM definitions<br /> * &lt;tt&gt;views.py&lt;/tt&gt; is where the views go<br /> <br /> We're using MongoDB. Basically, instead of a relational database with<br /> tables, you have a big JSON structure which acts a lot like a Python<br /> dict.<br /> <br /> <br /> '''YouCanHelp'''<br /> <br /> If there are other things that you think would help orient someone<br /> new to GNU MediaGoblin but coming from Django, let us know!<br /> <br /> <br /> == Bite-sized bugs to start with ==<br /> <br /> '''May 3rd, 2011''': We don't have a list of bite-sized bugs, yet, but<br /> this is important to us. If you're interested in things to work on,<br /> let us know on [http://mediagoblin.org/join/ the mailing list] or<br /> on the [http://mediagoblin.org/join/ IRC channel].<br /> <br /> <br /> == Tips for people new to coding ==<br /> <br /> === Learning Python ===<br /> <br /> GNU MediaGoblin is written using a programming language called [http://python.org/ Python].<br /> <br /> There are two different incompatible iterations of Python which I'll<br /> refer to as Python 2 and Python 3. GNU MediaGoblin is written in<br /> Python 2 and requires Python 2.6 or 2.7. At some point, we might<br /> switch to Python 3, but that's a future thing.<br /> <br /> You can learn how to code in Python 2 from several excellent books<br /> that are freely available on the Internet:<br /> <br /> * [http://learnpythonthehardway.org/ Learn Python the Hard Way]<br /> * [http://diveintopython.org/ Dive Into Python]<br /> * [http://www.greenteapress.com/thinkpython/ Python for Software Design]<br /> * [http://www.swaroopch.com/notes/Python A Byte of Python]<br /> <br /> These are all excellent texts.<br /> <br /> '''You Can Help'''<br /> <br /> If you know of other good quality Python tutorials and Python<br /> tutorial videos, let us know!<br /> <br /> <br /> === Learning Libraries GNU MediaGoblin uses ===<br /> <br /> GNU MediaGoblin uses a variety of libraries in order to do what it<br /> does. These libraries are listed in the :ref:`codebase-chapter`<br /> along with links to the project Web sites and documentation for the<br /> libraries.<br /> <br /> There are a variety of Python-related conferences every year that have<br /> sessions covering many aspects of these libraries. You can find them<br /> at [http://python.mirocommunity.org Python Miro Community] -- This is a shameless plug; Will Kahn-Greene runs Python Miro Community.<br /> <br /> If you have questions or need help, find us on the mailing list and on<br /> IRC.<br /> <br /> === Learning git ===<br /> <br /> git is an interesting and very powerful tool. Like all powerful<br /> tools, it has a learning curve.<br /> <br /> If you're new to git, we highly recommend the following resources for<br /> getting the hang of it:<br /> <br /> * [http://learn.github.com/p/intro.html Learn Git] --- the GitHub intro to git<br /> * [http://progit.org/book/ Pro Git] --- fantastic book<br /> * [http://gitcasts.com/ Git casts] --- screencast covering git usage<br /> * [http://gitref.org/ Git Reference] --- Git reference that makes it easier to get the hang of git if you're coming from other version control systems<br /> <br /> There's also a git mission at [http://openhatch.org/ OpenHatch].<br /> <br /> === Learning other utilities ===<br /> <br /> The [http://openhatch.org/ OpenHatch] site has a series of<br /> [http://openhatch.org/missions/ training missions] which are<br /> designed to help you learn how to use these tools.<br /> <br /> If you're new to tar, diff, patch and git, we highly recommend you sign<br /> up with OpenHatch and do the missions.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=HackingHowto&diff=106 2011-08-13T15:57:00Z

<p>Cfdv: /* Getting requirements */</p> <hr /> <div>= Hacking HOWTO =<br /> <br /> <br /> == So you want to hack on GNU MediaGoblin? ==<br /> <br /> First thing to do is check out the [http://mediagoblin.org/join/ web site] where we list all the project<br /> infrastructure including:<br /> <br /> * the IRC channel<br /> * the mailing list<br /> * the issue tracker<br /> <br /> Additionally, we have information on how to get involved, who to talk<br /> to, what needs to be worked on, and other things besides!<br /> <br /> Second thing to do is take a look at :ref:`codebase-chapter` where<br /> we've started documenting how GNU MediaGoblin is built and how to add<br /> new things.<br /> <br /> Third you'll need to get the requirements.<br /> <br /> Fourth, you'll need to build a development environment. We use buildout,<br /> but if you want to use virtualenv, there's a set of mediocre not-very-supported<br /> steps in the [https://gitorious.org/mediagoblin/pages/Home evil wiki].<br /> <br /> <br /> == Getting requirements ==<br /> <br /> First, you need to have the following installed before you can build<br /> an environment for hacking on GNU MediaGoblin:<br /> <br /> * Python 2.6 or 2.7 - http://www.python.org/ (You'll need Python as well as the dev files for building modules.)<br /> * python-lxml - http://lxml.de/<br /> * git - http://git-scm.com/<br /> * MongoDB - http://www.mongodb.org/<br /> <br /> If you're running Debian GNU/Linux or a Debian-derived distribution<br /> such as Mint or Ubuntu [http://bugs.foocorp.net/issues/478 http://bugs.foocorp.net/issues/478 10.10+], running the following should install these<br /> requirements:<br /> <br /> sudo apt-get install mongodb git-core python python-dev \<br /> python-lxml<br /> <br /> On Fedora:<br /> <br /> yum install mongodb-server python-paste-deploy python-paste-script \<br /> git-core python python-devel python-lxml<br /> <br /> <br /> '''You can help:'''<br /> <br /> If you have instructions for other GNU/Linux distributions to set<br /> up requirements, let us know!<br /> <br /> == How to set up and maintain an environment for hacking with buildout ==<br /> <br /> '''Requirements'''<br /> <br /> No additional requirements.<br /> <br /> <br /> '''Create a development environment'''<br /> <br /> After installing the requirements, follow these steps:<br /> <br /> # Clone the repository: &lt;tt&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git&lt;/tt&gt;<br /> # Bootstrap and run buildout: &lt;tt&gt;cd mediagoblin&lt;/tt&gt; and then &lt;tt&gt;python bootstrap.py &amp;&amp; ./bin/buildout&lt;/tt&gt;<br /> <br /> <br /> That's it! Using this method, buildout should create a &lt;tt&gt;user_dev&lt;/tt&gt;<br /> directory, in which certain things will be stored (media, beaker<br /> session stuff, etc). You can change this, but for development<br /> purposes this default should be fine.<br /> <br /> <br /> '''Updating for dependency changes'''<br /> <br /> While hacking on GNU MediaGoblin over time, you'll eventually have to<br /> update your development environment because the dependencies have<br /> changed. To do that, run:<br /> <br /> ./bin/buildout &amp;&amp; ./bin/gmg migrate<br /> <br /> <br /> '''Updating for code changes'''<br /> <br /> You don't need to do anything---code changes are automatically available.<br /> <br /> <br /> '''Deleting your buildout'''<br /> <br /> At some point, you may want to delete your buildout. Perhaps it's to<br /> start over. Perhaps it's to test building development environments<br /> with buildout.<br /> <br /> To do this, do:<br /> <br /> rm -rf bin develop-eggs eggs mediagoblin.egg-info parts user_dev<br /> <br /> <br /> == Running the server ==<br /> <br /> If you want to get things running quickly and without hassle, just<br /> run:<br /> <br /> ./lazyserver.sh<br /> <br /> This will start up a python server where you can begin playing with<br /> mediagoblin. It will also run celery in &quot;always eager&quot; mode so you<br /> don't have to start a separate process for it.<br /> <br /> This is fine in development, but if you want to actually run celery<br /> separately for testing (or deployment purposes), you'll want to run<br /> the server independently:<br /> <br /> ./bin/paster serve paste.ini --reload<br /> <br /> <br /> == Running celeryd ==<br /> <br /> If you aren't using &lt;tt&gt;./lazyserver.sh&lt;/tt&gt; or otherwise aren't running celery<br /> in always eager mode, you'll need to do this if you want your media to<br /> process and actually show up. It's probably a good idea in<br /> development to have the web server (above) running in one terminal and<br /> celeryd in another window.<br /> <br /> Run:<br /> <br /> CELERY_CONFIG_MODULE=mediagoblin.init.celery.from_celery ./bin/celeryd<br /> <br /> <br /> == Running the test suite ==<br /> <br /> Run:<br /> <br /> ./runtests.sh<br /> <br /> <br /> == Running a shell ==<br /> <br /> If you want a shell with your database pre-setup and an instantiated<br /> application ready and at your fingertips....<br /> <br /> Run:<br /> <br /> ./bin/gmg shell<br /> <br /> <br /> == Troubleshooting ==<br /> <br /> === pymongo.errors.AutoReconnect: could not find master/primary ===<br /> <br /> If you see this:<br /> <br /> pymongo.errors.AutoReconnect: could not find master/primary<br /> <br /> then make sure mongodb is installed and running.<br /> <br /> If it's installed, check the mongodb log. On my machine, that's <br /> &lt;tt&gt;/var/log/mongodb/mongodb.log&lt;/tt&gt;. If you see something like:<br /> <br /> old lock file: /var/lib/mongodb/mongod.lock. probably means...<br /> <br /> in that case you might have had an unclean shutdown. Try:<br /> <br /> sudo mongod --repair<br /> <br /> If that didn't work, just delete the lock file and relaunch mongodb.<br /> <br /> Anyway, then start the mongodb server in whatever way is appropriate<br /> for your distro / OS.<br /> <br /> <br /> === pkg_resources.DistributionNotFound: distribute ===<br /> <br /> If you get this while running buildout:<br /> <br /> pkg_resources.DistributionNotFound: distribute<br /> <br /> Try this commmand instead:<br /> <br /> python bootstrap.py --distribute &amp;&amp; ./bin/buildout<br /> <br /> <br /> == Wiping your user data ==<br /> <br /> You can completely wipe all data from the instance by doing:<br /> <br /> gmg wipealldata<br /> <br /> <br /> '''Note:'''<br /> <br /> Unless you're doing development and working on and testing creating<br /> a new instance, you will probably never have to do this. Will<br /> plans to do this work and thus he documented it.<br /> <br /> <br /> == Quickstart for Django programmers ==<br /> <br /> We're not using Django, but the codebase is very Django-like in its<br /> structure.<br /> <br /> * &lt;tt&gt;routing.py&lt;/tt&gt; is like &lt;tt&gt;urls.py&lt;/tt&gt; in Django<br /> * &lt;tt&gt;models.py&lt;/tt&gt; has mongokit ORM definitions<br /> * &lt;tt&gt;views.py&lt;/tt&gt; is where the views go<br /> <br /> We're using MongoDB. Basically, instead of a relational database with<br /> tables, you have a big JSON structure which acts a lot like a Python<br /> dict.<br /> <br /> <br /> '''YouCanHelp'''<br /> <br /> If there are other things that you think would help orient someone<br /> new to GNU MediaGoblin but coming from Django, let us know!<br /> <br /> <br /> == Bite-sized bugs to start with ==<br /> <br /> '''May 3rd, 2011''': We don't have a list of bite-sized bugs, yet, but<br /> this is important to us. If you're interested in things to work on,<br /> let us know on [http://mediagoblin.org/join/ the mailing list] or<br /> on the [http://mediagoblin.org/join/ IRC channel].<br /> <br /> <br /> == Tips for people new to coding ==<br /> <br /> === Learning Python ===<br /> <br /> GNU MediaGoblin is written using a programming language called [http://python.org/ Python].<br /> <br /> There are two different incompatible iterations of Python which I'll<br /> refer to as Python 2 and Python 3. GNU MediaGoblin is written in<br /> Python 2 and requires Python 2.6 or 2.7. At some point, we might<br /> switch to Python 3, but that's a future thing.<br /> <br /> You can learn how to code in Python 2 from several excellent books<br /> that are freely available on the Internet:<br /> <br /> * [http://learnpythonthehardway.org/ Learn Python the Hard Way]<br /> * [http://diveintopython.org/ Dive Into Python]<br /> * [http://www.greenteapress.com/thinkpython/ Python for Software Design]<br /> * [http://www.swaroopch.com/notes/Python A Byte of Python]<br /> <br /> These are all excellent texts.<br /> <br /> '''You Can Help'''<br /> <br /> If you know of other good quality Python tutorials and Python<br /> tutorial videos, let us know!<br /> <br /> <br /> === Learning Libraries GNU MediaGoblin uses ===<br /> <br /> GNU MediaGoblin uses a variety of libraries in order to do what it<br /> does. These libraries are listed in the :ref:`codebase-chapter`<br /> along with links to the project Web sites and documentation for the<br /> libraries.<br /> <br /> There are a variety of Python-related conferences every year that have<br /> sessions covering many aspects of these libraries. You can find them<br /> at [http://python.mirocommunity.org Python Miro Community] -- This is a shameless plug; Will Kahn-Greene runs Python Miro Community.<br /> <br /> If you have questions or need help, find us on the mailing list and on<br /> IRC.<br /> <br /> === Learning git ===<br /> <br /> git is an interesting and very powerful tool. Like all powerful<br /> tools, it has a learning curve.<br /> <br /> If you're new to git, we highly recommend the following resources for<br /> getting the hang of it:<br /> <br /> * [http://learn.github.com/p/intro.html Learn Git] --- the GitHub intro to git<br /> * [http://progit.org/book/ Pro Git] --- fantastic book<br /> * [http://gitcasts.com/ Git casts] --- screencast covering git usage<br /> * [http://gitref.org/ Git Reference] --- Git reference that makes it easier to get the hang of git if you're coming from other version control systems<br /> <br /> There's also a git mission at [http://openhatch.org/ OpenHatch].<br /> <br /> === Learning other utilities ===<br /> <br /> The [http://openhatch.org/ OpenHatch] site has a series of<br /> [http://openhatch.org/missions/ training missions] which are<br /> designed to help you learn how to use these tools.<br /> <br /> If you're new to tar, diff, patch and git, we highly recommend you sign<br /> up with OpenHatch and do the missions.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=HackingHowto&diff=105 2011-08-13T15:56:19Z

<p>Cfdv: /* Getting requirements */</p> <hr /> <div>= Hacking HOWTO =<br /> <br /> <br /> == So you want to hack on GNU MediaGoblin? ==<br /> <br /> First thing to do is check out the [http://mediagoblin.org/join/ web site] where we list all the project<br /> infrastructure including:<br /> <br /> * the IRC channel<br /> * the mailing list<br /> * the issue tracker<br /> <br /> Additionally, we have information on how to get involved, who to talk<br /> to, what needs to be worked on, and other things besides!<br /> <br /> Second thing to do is take a look at :ref:`codebase-chapter` where<br /> we've started documenting how GNU MediaGoblin is built and how to add<br /> new things.<br /> <br /> Third you'll need to get the requirements.<br /> <br /> Fourth, you'll need to build a development environment. We use buildout,<br /> but if you want to use virtualenv, there's a set of mediocre not-very-supported<br /> steps in the [https://gitorious.org/mediagoblin/pages/Home evil wiki].<br /> <br /> <br /> == Getting requirements ==<br /> <br /> First, you need to have the following installed before you can build<br /> an environment for hacking on GNU MediaGoblin:<br /> <br /> * Python 2.6 or 2.7 - http://www.python.org/ (You'll need Python as well as the dev files for building modules.)<br /> * python-lxml - http://lxml.de/<br /> * git - http://git-scm.com/<br /> * MongoDB - http://www.mongodb.org/<br /> <br /> If you're running Debian GNU/Linux or a Debian-derived distribution<br /> such as Mint or Ubuntu ([http://bugs.foocorp.net/issues/478 http://bugs.foocorp.net/issues/478 10.10+]), running the following should install these<br /> requirements:<br /> <br /> sudo apt-get install mongodb git-core python python-dev \<br /> python-lxml<br /> <br /> On Fedora:<br /> <br /> yum install mongodb-server python-paste-deploy python-paste-script \<br /> git-core python python-devel python-lxml<br /> <br /> <br /> '''You can help:'''<br /> <br /> If you have instructions for other GNU/Linux distributions to set<br /> up requirements, let us know!<br /> <br /> == How to set up and maintain an environment for hacking with buildout ==<br /> <br /> '''Requirements'''<br /> <br /> No additional requirements.<br /> <br /> <br /> '''Create a development environment'''<br /> <br /> After installing the requirements, follow these steps:<br /> <br /> # Clone the repository: &lt;tt&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git&lt;/tt&gt;<br /> # Bootstrap and run buildout: &lt;tt&gt;cd mediagoblin&lt;/tt&gt; and then &lt;tt&gt;python bootstrap.py &amp;&amp; ./bin/buildout&lt;/tt&gt;<br /> <br /> <br /> That's it! Using this method, buildout should create a &lt;tt&gt;user_dev&lt;/tt&gt;<br /> directory, in which certain things will be stored (media, beaker<br /> session stuff, etc). You can change this, but for development<br /> purposes this default should be fine.<br /> <br /> <br /> '''Updating for dependency changes'''<br /> <br /> While hacking on GNU MediaGoblin over time, you'll eventually have to<br /> update your development environment because the dependencies have<br /> changed. To do that, run:<br /> <br /> ./bin/buildout &amp;&amp; ./bin/gmg migrate<br /> <br /> <br /> '''Updating for code changes'''<br /> <br /> You don't need to do anything---code changes are automatically available.<br /> <br /> <br /> '''Deleting your buildout'''<br /> <br /> At some point, you may want to delete your buildout. Perhaps it's to<br /> start over. Perhaps it's to test building development environments<br /> with buildout.<br /> <br /> To do this, do:<br /> <br /> rm -rf bin develop-eggs eggs mediagoblin.egg-info parts user_dev<br /> <br /> <br /> == Running the server ==<br /> <br /> If you want to get things running quickly and without hassle, just<br /> run:<br /> <br /> ./lazyserver.sh<br /> <br /> This will start up a python server where you can begin playing with<br /> mediagoblin. It will also run celery in &quot;always eager&quot; mode so you<br /> don't have to start a separate process for it.<br /> <br /> This is fine in development, but if you want to actually run celery<br /> separately for testing (or deployment purposes), you'll want to run<br /> the server independently:<br /> <br /> ./bin/paster serve paste.ini --reload<br /> <br /> <br /> == Running celeryd ==<br /> <br /> If you aren't using &lt;tt&gt;./lazyserver.sh&lt;/tt&gt; or otherwise aren't running celery<br /> in always eager mode, you'll need to do this if you want your media to<br /> process and actually show up. It's probably a good idea in<br /> development to have the web server (above) running in one terminal and<br /> celeryd in another window.<br /> <br /> Run:<br /> <br /> CELERY_CONFIG_MODULE=mediagoblin.init.celery.from_celery ./bin/celeryd<br /> <br /> <br /> == Running the test suite ==<br /> <br /> Run:<br /> <br /> ./runtests.sh<br /> <br /> <br /> == Running a shell ==<br /> <br /> If you want a shell with your database pre-setup and an instantiated<br /> application ready and at your fingertips....<br /> <br /> Run:<br /> <br /> ./bin/gmg shell<br /> <br /> <br /> == Troubleshooting ==<br /> <br /> === pymongo.errors.AutoReconnect: could not find master/primary ===<br /> <br /> If you see this:<br /> <br /> pymongo.errors.AutoReconnect: could not find master/primary<br /> <br /> then make sure mongodb is installed and running.<br /> <br /> If it's installed, check the mongodb log. On my machine, that's <br /> &lt;tt&gt;/var/log/mongodb/mongodb.log&lt;/tt&gt;. If you see something like:<br /> <br /> old lock file: /var/lib/mongodb/mongod.lock. probably means...<br /> <br /> in that case you might have had an unclean shutdown. Try:<br /> <br /> sudo mongod --repair<br /> <br /> If that didn't work, just delete the lock file and relaunch mongodb.<br /> <br /> Anyway, then start the mongodb server in whatever way is appropriate<br /> for your distro / OS.<br /> <br /> <br /> === pkg_resources.DistributionNotFound: distribute ===<br /> <br /> If you get this while running buildout:<br /> <br /> pkg_resources.DistributionNotFound: distribute<br /> <br /> Try this commmand instead:<br /> <br /> python bootstrap.py --distribute &amp;&amp; ./bin/buildout<br /> <br /> <br /> == Wiping your user data ==<br /> <br /> You can completely wipe all data from the instance by doing:<br /> <br /> gmg wipealldata<br /> <br /> <br /> '''Note:'''<br /> <br /> Unless you're doing development and working on and testing creating<br /> a new instance, you will probably never have to do this. Will<br /> plans to do this work and thus he documented it.<br /> <br /> <br /> == Quickstart for Django programmers ==<br /> <br /> We're not using Django, but the codebase is very Django-like in its<br /> structure.<br /> <br /> * &lt;tt&gt;routing.py&lt;/tt&gt; is like &lt;tt&gt;urls.py&lt;/tt&gt; in Django<br /> * &lt;tt&gt;models.py&lt;/tt&gt; has mongokit ORM definitions<br /> * &lt;tt&gt;views.py&lt;/tt&gt; is where the views go<br /> <br /> We're using MongoDB. Basically, instead of a relational database with<br /> tables, you have a big JSON structure which acts a lot like a Python<br /> dict.<br /> <br /> <br /> '''YouCanHelp'''<br /> <br /> If there are other things that you think would help orient someone<br /> new to GNU MediaGoblin but coming from Django, let us know!<br /> <br /> <br /> == Bite-sized bugs to start with ==<br /> <br /> '''May 3rd, 2011''': We don't have a list of bite-sized bugs, yet, but<br /> this is important to us. If you're interested in things to work on,<br /> let us know on [http://mediagoblin.org/join/ the mailing list] or<br /> on the [http://mediagoblin.org/join/ IRC channel].<br /> <br /> <br /> == Tips for people new to coding ==<br /> <br /> === Learning Python ===<br /> <br /> GNU MediaGoblin is written using a programming language called [http://python.org/ Python].<br /> <br /> There are two different incompatible iterations of Python which I'll<br /> refer to as Python 2 and Python 3. GNU MediaGoblin is written in<br /> Python 2 and requires Python 2.6 or 2.7. At some point, we might<br /> switch to Python 3, but that's a future thing.<br /> <br /> You can learn how to code in Python 2 from several excellent books<br /> that are freely available on the Internet:<br /> <br /> * [http://learnpythonthehardway.org/ Learn Python the Hard Way]<br /> * [http://diveintopython.org/ Dive Into Python]<br /> * [http://www.greenteapress.com/thinkpython/ Python for Software Design]<br /> * [http://www.swaroopch.com/notes/Python A Byte of Python]<br /> <br /> These are all excellent texts.<br /> <br /> '''You Can Help'''<br /> <br /> If you know of other good quality Python tutorials and Python<br /> tutorial videos, let us know!<br /> <br /> <br /> === Learning Libraries GNU MediaGoblin uses ===<br /> <br /> GNU MediaGoblin uses a variety of libraries in order to do what it<br /> does. These libraries are listed in the :ref:`codebase-chapter`<br /> along with links to the project Web sites and documentation for the<br /> libraries.<br /> <br /> There are a variety of Python-related conferences every year that have<br /> sessions covering many aspects of these libraries. You can find them<br /> at [http://python.mirocommunity.org Python Miro Community] -- This is a shameless plug; Will Kahn-Greene runs Python Miro Community.<br /> <br /> If you have questions or need help, find us on the mailing list and on<br /> IRC.<br /> <br /> === Learning git ===<br /> <br /> git is an interesting and very powerful tool. Like all powerful<br /> tools, it has a learning curve.<br /> <br /> If you're new to git, we highly recommend the following resources for<br /> getting the hang of it:<br /> <br /> * [http://learn.github.com/p/intro.html Learn Git] --- the GitHub intro to git<br /> * [http://progit.org/book/ Pro Git] --- fantastic book<br /> * [http://gitcasts.com/ Git casts] --- screencast covering git usage<br /> * [http://gitref.org/ Git Reference] --- Git reference that makes it easier to get the hang of git if you're coming from other version control systems<br /> <br /> There's also a git mission at [http://openhatch.org/ OpenHatch].<br /> <br /> === Learning other utilities ===<br /> <br /> The [http://openhatch.org/ OpenHatch] site has a series of<br /> [http://openhatch.org/missions/ training missions] which are<br /> designed to help you learn how to use these tools.<br /> <br /> If you're new to tar, diff, patch and git, we highly recommend you sign<br /> up with OpenHatch and do the missions.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=102 2011-08-13T02:53:16Z

<p>Cfdv: /* Motivation */</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an [http://aws.amazon.com/ec2/ EC2] instance from an [http://aws.amazon.com/amis AMI] pre-loaded with MediaGoblin. The following [http://aws.amazon.com/articles/0155828273219400 recipe] should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-61be7908 ami-61be7908]. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not login to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=100 2011-08-12T22:41:07Z

<p>Cfdv: /* Motivation */</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an [http://aws.amazon.com/ec2/ EC2] instance from an [http://aws.amazon.com/amis AMI] pre-loaded with MediaGoblin. The following [http://aws.amazon.com/articles/0155828273219400 recipe] should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: ami-61be7908. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not login to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=99 2011-08-12T22:13:08Z

<p>Cfdv: /* Motivation */</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an [http://aws.amazon.com/ec2/ EC2] instance from an [http://aws.amazon.com/amis AMI] pre-loaded with MediaGoblin. The following recipe should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: ami-61be7908. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not login to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=98 2011-08-12T22:12:11Z

<p>Cfdv: /* Motivation */</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an [http://aws.amazon.com/ec2/ EC2] instance from an AMI pre-loaded with MediaGoblin. The following recipe should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: ami-61be7908. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not login to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Main_Page&diff=97 2011-08-12T22:04:09Z

<p>Cfdv: /* Want to hack on GNU MediaGoblin? */</p> <hr /> <div>= GNU MediaGoblin wiki of bizarre and unusual things =<br /> <br /> In this wiki you will find beasts the likes of which you have never laid eyes on before! Expand your imagination, ladies and gentlemen, and examine the errata in this corpus of knowledge. May it transform you and let you see the world in a new light forevermore.<br /> <br /> <br /> == Want to hack on GNU MediaGoblin? ==<br /> <br /> * [[HackingHowto]] - generally covers getting set up for hacking on GNU MediaGoblin<br /> ** FIXME - add distribution/OS specific hacking guides as separate pages here<br /> * [http://python.mirocommunity.org/video/4337/gnu-mediagoblin-for-a-federate A video with Chris Webber talking about MediaGoblin] at [http://chipy.org ChiPy]<br /> * [[Translations]] - How to translate stuff or update the translations<br /> * [[UnitTests]] - all about the unit tests<br /> * [[Configure MediaGoblin]] - how to configure MediaGoblin for all your local needs.<br /> * [[Scaling Down]] - Minimizing MediaGoblin's resource requirements<br /> * Deployment - How to run your own publicly available MediaGoblin server<br /> ** [[Virtual Machine Hosting]] - using [http://aws.amazon.com/free/?utm_source=adwords&amp;utm_medium=cpc&amp;utm_campaign=CPC_Google_AWS_ec2&amp;utm_content=TextV01_PP_V01_EC2&amp;trk=CPC_Google_AWS_ec2 Amazon's free EC2 tier]<br /> <br /> == Inner workings of the secret sanctum (aka project documentation) ==<br /> <br /> * [http://mediagoblin.org/irclogs/ IRC meeting logs]<br /> * [[IRCBot]] - covers our irc bot<br /> * [[ReleaseProcess]] - covers the release process<br /> <br /> * [[ManualStandards]] - covers the standards for writing the user manual<br /> * [https://gitorious.org/mediagoblin/mediagoblin/blobs/master/extlib/README External Library Policy] - covers use of external libraries<br /> * [[DesignDecisions]] - covers design decisions (FIXME - this needs to be split up)<br /> * [[User:Cwebber/braindumps]] - Chris Webber's braindumps (you can help refactoring these into real sections of the site!)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Amazon_Free_Tier&diff=96 2011-08-12T22:01:36Z

<p>Cfdv: moved Amazon Free Tier to Virtual Machine Hosting: original title suggests the link would go to an amazon page...</p> <hr /> <div>#REDIRECT [[Virtual Machine Hosting]]</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=95 2011-08-12T22:01:36Z

<p>Cfdv: moved Amazon Free Tier to Virtual Machine Hosting: original title suggests the link would go to an amazon page...</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an EC2 instance from an AMI pre-loaded with MediaGoblin. The following recipe should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: ami-61be7908. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not login to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Virtual_Machine_Hosting&diff=94 2011-08-12T21:38:02Z

<p>Cfdv: Created page with &quot;= Motivation = If you want to give MediaGoblin a try, but would prefer to run it on someone else&#039;s machine for a while, then you may be interested in spinning up an EC2 instance...&quot;</p> <hr /> <div>= Motivation =<br /> <br /> If you want to give MediaGoblin a try, but would prefer to run it on someone else's machine for a while, then you may be interested in spinning up an EC2 instance from an AMI pre-loaded with MediaGoblin. The following recipe should make a public MediaGoblin AMI. Make your own or skip ahead Martha Stewart style to [https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-3bf33252 ami-3bf33252]<br /> <br /> == Get your favorite distribution to fit in less than 10 Gb volume size ==<br /> <br /> Ubuntu makes this easy. Start with an official EC2 Ubuntu instance in us-east: ami-61be7908. Other [http://ubuntutym2.u-toyama.ac.jp/uec-images/lucid/20110719/ official Ubuntu AMIs] are also available<br /> <br /> Login to this fresh instance using [http://aws.amazon.com/archives/Amazon-EC2/5673744618146887 EC2 tools]<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com&lt;/pre&gt;<br /> <br /> Once logged in, update the links to package updating materials<br /> &lt;pre&gt;sudo apt-get update&lt;/pre&gt;<br /> <br /> Then run the package manager to download and install the latest patches<br /> &lt;pre&gt;sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> Reboot from the EC2 instance manager. Then log in and install any remaining upgrades<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get -u upgrade&lt;/pre&gt;<br /> <br /> == Limit remote access to improve security ==<br /> <br /> Disable password-based login by editing /etc/ssh/sshd_config to explicitly disallow it.<br /> &lt;pre&gt;+# Disable password-based login<br /> +PasswordAuthentication no&lt;/pre&gt;<br /> <br /> Also remove this moot parameter<br /> &lt;pre&gt;-# To enable empty passwords, change to yes (NOT RECOMMENDED)<br /> -PermitEmptyPasswords no&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> Disable root login, and specify login by ubuntu only by editing /etc/ssh/sshd_config<br /> &lt;pre&gt;-PermitRootLogin yes<br /> +PermitRootLogin no<br /> +AllowUsers ubuntu&lt;/pre&gt;<br /> <br /> Reboot the ssh server<br /> &lt;pre&gt;sudo restart ssh&lt;/pre&gt;<br /> <br /> == Install MediaGoblin Prerequisites ==<br /> <br /> Setup directory for mediagoblin source code<br /> &lt;pre&gt;mkdir src<br /> cd src&lt;/pre&gt;<br /> <br /> The following matches the [[HackingHowto]] except for how mongodb is installed. MongoDB is only at version 1.2.2 in Lucid 10.04, which the original AMI is based on, but MediaGoblin requires v1.3+<br /> &lt;pre&gt;sudo apt-get install git-core python python-dev python-lxml&lt;/pre&gt;<br /> <br /> [http://www.mongodb.org/display/DOCS/Ubuntu+and+Debian+packages Get the latest mongodb]<br /> <br /> First get the gpg key for the 10gen repository<br /> &lt;pre&gt;sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10&lt;/pre&gt;<br /> <br /> Add the 10gen repository to the list of apt sources by editing /etc/apt/sources.list<br /> &lt;pre&gt;+deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen&lt;/pre&gt;<br /> <br /> Install mongodb<br /> &lt;pre&gt;sudo apt-get update<br /> sudo apt-get install mongodb-10gen&lt;/pre&gt;<br /> <br /> Fetch the mediagoblin code from the git repository, buildout, and test<br /> &lt;pre&gt;git clone git://gitorious.org/mediagoblin/mediagoblin.git<br /> cd mediagoblin<br /> python bootstrap.py &amp;&amp; ./bin/buildout<br /> ./runtests.sh<br /> ###Ran 45 tests in 12.160s ... OK!&lt;/pre&gt;<br /> <br /> Install sendmail<br /> &lt;pre&gt;sudo apt-get install sendmail&lt;/pre&gt;<br /> <br /> [[Configure MediaGoblin]]<br /> &lt;pre&gt;cp paste.ini paste_local.ini<br /> cp mediagoblin.ini mediagoblin_local.ini&lt;/pre&gt;<br /> <br /> Edit paste_local.ini to point to mediagoblin_local.ini and allow remote connections<br /> &lt;pre&gt;-config = %(here)s/mediagoblin.ini<br /> +config = %(here)s/mediagoblin_local.ini<br /> -host = 127.0.0.1<br /> +host = 0.0.0.0&lt;/pre&gt;<br /> <br /> == Prepare instance for bundling into a public AMI ==<br /> <br /> The instance you've built so far is currently configured to accept your private key as a login. Lock yourself out now...or don't, and see if anyone notices. It's your call. <br /> <br /> Find and remove your public key<br /> &lt;pre&gt;sudo find / -name &quot;authorized_keys&quot; -print -exec rm {} \;&lt;/pre&gt;<br /> <br /> Verify you can not login to the instance anymore<br /> &lt;pre&gt;me@myhomemachine:~$ ssh -i $(KEY_PATH) ubuntu@ec2-##-##-##-##.compute-1.amazonaws.com<br /> ##Permission denied (publickey).&lt;/pre&gt;<br /> <br /> Take a snapshot, convert the snapshot to an AMI, then set the AMI permissions to public.</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Main_Page&diff=93 2011-08-12T18:58:29Z

<p>Cfdv: /* Want to hack on GNU MediaGoblin? */</p> <hr /> <div>= GNU MediaGoblin wiki of bizarre and unusual things =<br /> <br /> In this wiki you will find beasts the likes of which you have never laid eyes on before! Expand your imagination, ladies and gentlemen, and examine the errata in this corpus of knowledge. May it transform you and let you see the world in a new light forevermore.<br /> <br /> <br /> == Want to hack on GNU MediaGoblin? ==<br /> <br /> * [[HackingHowto]] - generally covers getting set up for hacking on GNU MediaGoblin<br /> ** FIXME - add distribution/OS specific hacking guides as separate pages here<br /> * [http://python.mirocommunity.org/video/4337/gnu-mediagoblin-for-a-federate A video with Chris Webber talking about MediaGoblin] at [http://chipy.org ChiPy]<br /> * [[Translations]] - How to translate stuff or update the translations<br /> * [[UnitTests]] - all about the unit tests<br /> * [[Configure MediaGoblin]] - how to configure MediaGoblin for all your local needs.<br /> * [[Scaling Down]] - Minimizing MediaGoblin's resource requirements<br /> * Deployment - How to run your own publicly available MediaGoblin server<br /> ** [[Amazon Free Tier]] - using [http://aws.amazon.com/free/?utm_source=adwords&amp;utm_medium=cpc&amp;utm_campaign=CPC_Google_AWS_ec2&amp;utm_content=TextV01_PP_V01_EC2&amp;trk=CPC_Google_AWS_ec2 EC2]<br /> <br /> == Inner workings of the secret sanctum (aka project documentation) ==<br /> <br /> * [http://mediagoblin.org/irclogs/ IRC meeting logs]<br /> * [[IRCBot]] - covers our irc bot<br /> * [[ReleaseProcess]] - covers the release process<br /> <br /> * [[ManualStandards]] - covers the standards for writing the user manual<br /> * [https://gitorious.org/mediagoblin/mediagoblin/blobs/master/extlib/README External Library Policy] - covers use of external libraries<br /> * [[DesignDecisions]] - covers design decisions (FIXME - this needs to be split up)<br /> * [[User:Cwebber/braindumps]] - Chris Webber's braindumps (you can help refactoring these into real sections of the site!)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Main_Page&diff=87 2011-08-10T06:40:00Z

<p>Cfdv: /* Want to hack on GNU MediaGoblin? */</p> <hr /> <div>= GNU MediaGoblin wiki of bizarre and unusual things =<br /> <br /> In this wiki you will find beasts the likes of which you have never laid eyes on before! Expand your imagination, ladies and gentlemen, and examine the errata in this corpus of knowledge. May it transform you and let you see the world in a new light forevermore.<br /> <br /> <br /> == Want to hack on GNU MediaGoblin? ==<br /> <br /> * [[HackingHowto]] - generally covers getting set up for hacking on GNU MediaGoblin<br /> ** FIXME - add distribution/OS specific hacking guides as separate pages here<br /> * [[Translations]] - How to translate stuff or update the translations<br /> * [[UnitTests]] - all about the unit tests<br /> * [[Configure MediaGoblin]] - how to configure MediaGoblin for all your local needs.<br /> * [[Scaling Down]] - Minimizing MediaGoblin's resource requirements<br /> <br /> == Inner workings of the secret sanctum (aka project documentation) ==<br /> <br /> * [http://mediagoblin.org/irclogs/ IRC meeting logs]<br /> * [[IRCBot]] - covers our irc bot<br /> * [[ReleaseProcess]] - covers the release process<br /> <br /> * [[ManualStandards]] - covers the standards for writing the user manual<br /> * [[ExternalLibraryPolicy]] - covers use of external libraries<br /> * [[DesignDecisions]] - covers design decisions (FIXME - this needs to be split up)<br /> * [[User:Cwebber/braindumps]] - Chris Webber's braindumps (you can help refactoring these into real sections of the site!)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Main_Page&diff=84 2011-08-10T05:30:36Z

<p>Cfdv: /* Want to hack on GNU MediaGoblin? */</p> <hr /> <div>= GNU MediaGoblin wiki of bizarre and unusual things =<br /> <br /> In this wiki you will find beasts the likes of which you have never laid eyes on before! Expand your imagination, ladies and gentlemen, and examine the errata in this corpus of knowledge. May it transform you and let you see the world in a new light forevermore.<br /> <br /> <br /> == Want to hack on GNU MediaGoblin? ==<br /> <br /> * [[HackingHowto]] - generally covers getting set up for hacking on GNU MediaGoblin<br /> ** FIXME - add distribution/OS specific hacking guides as separate pages here<br /> * [[Translations]] - How to translate stuff or update the translations<br /> * [[UnitTests]] - all about the unit tests<br /> * [[Configure MediaGoblin]] - how to configure MediaGoblin for all your local needs.<br /> * [[Scaling Down]] - Minimizing MediaGoblin's hardware resource requirements<br /> <br /> == Inner workings of the secret sanctum (aka project documentation) ==<br /> <br /> * [http://mediagoblin.org/irclogs/ IRC meeting logs]<br /> * [[IRCBot]] - covers our irc bot<br /> * [[ReleaseProcess]] - covers the release process<br /> <br /> * [[ManualStandards]] - covers the standards for writing the user manual<br /> * [[ExternalLibraryPolicy]] - covers use of external libraries<br /> * [[DesignDecisions]] - covers design decisions (FIXME - this needs to be split up)<br /> * [[User:Cwebber/braindumps]] - Chris Webber's braindumps (you can help refactoring these into real sections of the site!)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Configure_MediaGoblin&diff=78 2011-08-09T04:43:30Z

<p>Cfdv: Undo revision 77 by Cfdv (talk)</p> <hr /> <div>= The config files =<br /> <br /> So basically there are two config files (and one meta-config file).<br /> <br /> * '''mediagoblin.ini:''' Use this to configure MediaGoblin, the application. Want to use a different storage system? Configure it here!<br /> * '''paste.ini:''' This just actually configures the web server that launches the MediaGoblin application, and some other things (like actually sets up the applications that serve your static files).<br /> <br /> And then there's the meta-config file:<br /> * '''mediagoblin/config_spec.ini:''' This sets the defaults for config file options and the type conversion for things in mediagoblin.ini. Developers who add new config options should probably register them and their types here (and set some good defaults, if applicable).<br /> <br /> = Changing config files =<br /> <br /> So you want to turn on (or off) all the bells and whistles, set up mediagoblin to use a storage system running out of a distributed cluster of Commodore 64s, change your email server configuration, etc. Where do you set all this stuff up?<br /> <br /> You should do the following:<br /> &lt;pre&gt;<br /> # copy the config files<br /> $ cp paste.ini paste_local.ini<br /> $ cp mediagoblin.ini mediagoblin_local.ini<br /> <br /> # edit paste_local.ini to know where mediagoblin_local.ini is<br /> $ editor paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Find the line marked &quot;config =&quot; under [app:mediagoblin]; change to:<br /> <br /> &lt;pre&gt;<br /> [app:mediagoblin]<br /> use = egg:mediagoblin#app<br /> filter-with = beaker<br /> config = %(here)s/mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> If you want to use lazyserver.sh, you can run it like:<br /> <br /> &lt;pre&gt;<br /> ./lazyserver.sh -c paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Also, all the ./bin/gmg commands have arguments to allow you to pass in the config file. For example:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell -cf mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> (It's important to note that the ./bin/gmg commands don't care about the paster file, they just care about the mediagoblin config file.)<br /> <br /> BTW, all these ./bin/gmg subcommands have help. You can check them like:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell --help<br /> &lt;/pre&gt;<br /> <br /> for more info.<br /> <br /> = Setting up Cloud Files public storage =<br /> <br /> These settings also work with OpenStack Object Storage (Swift), but you will need to set the API endpoint to avoid it defaulting to Rackspace Cloud Files US.<br /> <br /> == Setting it up ==<br /> <br /> In mediagoblin.ini (or mediagoblin_local.ini), add this to the file and edit it to fit your needs.<br /> <br /> === Working example ===<br /> &lt;pre&gt;<br /> ##<br /> # BEGIN CloudFiles public storage<br /> ##<br /> # Uncomment the following line and fill in your details to enable Cloud Files<br /> # (or OpenStack Object Storage [Swift])<br /> # - <br /> publicstore_storage_class = mediagoblin.storage:CloudFilesStorage<br /> publicstore_cloudfiles_user = user<br /> publicstore_cloudfiles_api_key = 1a2b3c4d5e6f7g8h9i<br /> publicstore_cloudfiles_container = mediagoblin<br /> <br /> # Uncomment this and fill it in to set the API endpoint to anything other<br /> # than Rackspace Cloud Files US<br /> # publicstore_cloudfiles_host = https://example.org/v1.0 <br /> <br /> # Only applicable if you run MediaGoblin on a Rackspace Cloud Server<br /> # it routes traffic through the internal Rackspace network, this<br /> # means that the bandwith betis free.<br /> publicstore_cloudfiles_use_servicenet = false<br /> ##<br /> # END CloudFiles<br /> ##<br /> &lt;/pre&gt;<br /> <br /> === Options ===<br /> <br /> ==== publicstore_storage_class ====<br /> ''Default: mediagoblin.storage:BasicFileStorage''&lt;br /&gt;<br /> This is used internally in mediagoblin to decide which type the storage object should be.<br /> <br /> ==== publicstore_cloudfiles_user ====<br /> The user account that you use for authentication with the Cloud Files API.<br /> <br /> ==== publicstore_cloudfiles_api_key ====<br /> The API key for the Cloud Files API<br /> <br /> ==== publicstore_cloudfiles_container ====<br /> The container on your Cloud Files account in which the MediaGoblin public storage should be stored.<br /> <br /> ==== publicstore_cloudfiles_host ====<br /> ''Default: Your current version of [https://github.com/rackspace/python-cloudfiles python-cloudfiles]'s Rackspace Cloud Files US host.''&lt;br /&gt;<br /> The API endpoint of the Cloud Files (Swift, OpenStack Object Storage) provider.<br /> <br /> ==== publicstore_cloudfiles_use_servicenet ====<br /> ''Default: false''&lt;br /&gt;<br /> User the RackSpace internal network when transferring data between the MediaGoblin server and the Cloud Files provider. This only works when running MediaGoblin on Rackspace Cloud Servers.<br /> <br /> = Attachments =<br /> <br /> ''As of 6th of August `attachments` are not yet in mediagoblin master. Dev branch can be found at https://gitorious.org/~jwandborg/mediagoblin/jwandborgs-mediagoblin/commits/f482_media_attachments''<br /> <br /> Attachment are files that are associated to a media entry. <br /> <br /> For example, it could be the GIMP .xcf file for the image. So that others can inspect the source of your work.<br /> <br /> == Hazards ==<br /> <br /> Attachments are not filtered or scanned and therefore present a security risk. They can be used to perform XSS attacks or to upload malicious content. Make sure your environment is safe before enabling it.<br /> <br /> == Allow attachments ==<br /> <br /> To allow attachments, add<br /> <br /> allow_attachments = true<br /> <br /> to your mediagoblin.ini (or mediagoblin_local.ini)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Configure_MediaGoblin&diff=77 2011-08-09T04:25:23Z

<p>Cfdv: /* Attachments */</p> <hr /> <div>= The config files =<br /> <br /> So basically there are two config files (and one meta-config file).<br /> <br /> * '''mediagoblin.ini:''' Use this to configure MediaGoblin, the application. Want to use a different storage system? Configure it here!<br /> * '''paste.ini:''' This just actually configures the web server that launches the MediaGoblin application, and some other things (like actually sets up the applications that serve your static files).<br /> <br /> And then there's the meta-config file:<br /> * '''mediagoblin/config_spec.ini:''' This sets the defaults for config file options and the type conversion for things in mediagoblin.ini. Developers who add new config options should probably register them and their types here (and set some good defaults, if applicable).<br /> <br /> = Changing config files =<br /> <br /> So you want to turn on (or off) all the bells and whistles, set up mediagoblin to use a storage system running out of a distributed cluster of Commodore 64s, change your email server configuration, etc. Where do you set all this stuff up?<br /> <br /> You should do the following:<br /> &lt;pre&gt;<br /> # copy the config files<br /> $ cp paste.ini paste_local.ini<br /> $ cp mediagoblin.ini mediagoblin_local.ini<br /> <br /> # edit paste_local.ini to know where mediagoblin_local.ini is<br /> $ editor paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Find the line marked &quot;config =&quot; under [app:mediagoblin]; change to:<br /> <br /> &lt;pre&gt;<br /> [app:mediagoblin]<br /> use = egg:mediagoblin#app<br /> filter-with = beaker<br /> config = %(here)s/mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> If you want to use lazyserver.sh, you can run it like:<br /> <br /> &lt;pre&gt;<br /> ./lazyserver.sh -c paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Also, all the ./bin/gmg commands have arguments to allow you to pass in the config file. For example:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell -cf mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> (It's important to note that the ./bin/gmg commands don't care about the paster file, they just care about the mediagoblin config file.)<br /> <br /> BTW, all these ./bin/gmg subcommands have help. You can check them like:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell --help<br /> &lt;/pre&gt;<br /> <br /> for more info.<br /> <br /> = Setting up Cloud Files public storage =<br /> <br /> These settings also work with OpenStack Object Storage (Swift), but you will need to set the API endpoint to avoid it defaulting to Rackspace Cloud Files US.<br /> <br /> == Setting it up ==<br /> <br /> In mediagoblin.ini (or mediagoblin_local.ini), add this to the file and edit it to fit your needs.<br /> <br /> === Working example ===<br /> &lt;pre&gt;<br /> ##<br /> # BEGIN CloudFiles public storage<br /> ##<br /> # Uncomment the following line and fill in your details to enable Cloud Files<br /> # (or OpenStack Object Storage [Swift])<br /> # - <br /> publicstore_storage_class = mediagoblin.storage:CloudFilesStorage<br /> publicstore_cloudfiles_user = user<br /> publicstore_cloudfiles_api_key = 1a2b3c4d5e6f7g8h9i<br /> publicstore_cloudfiles_container = mediagoblin<br /> <br /> # Uncomment this and fill it in to set the API endpoint to anything other<br /> # than Rackspace Cloud Files US<br /> # publicstore_cloudfiles_host = https://example.org/v1.0 <br /> <br /> # Only applicable if you run MediaGoblin on a Rackspace Cloud Server<br /> # it routes traffic through the internal Rackspace network, this<br /> # means that the bandwith betis free.<br /> publicstore_cloudfiles_use_servicenet = false<br /> ##<br /> # END CloudFiles<br /> ##<br /> &lt;/pre&gt;<br /> <br /> === Options ===<br /> <br /> ==== publicstore_storage_class ====<br /> ''Default: mediagoblin.storage:BasicFileStorage''&lt;br /&gt;<br /> This is used internally in mediagoblin to decide which type the storage object should be.<br /> <br /> ==== publicstore_cloudfiles_user ====<br /> The user account that you use for authentication with the Cloud Files API.<br /> <br /> ==== publicstore_cloudfiles_api_key ====<br /> The API key for the Cloud Files API<br /> <br /> ==== publicstore_cloudfiles_container ====<br /> The container on your Cloud Files account in which the MediaGoblin public storage should be stored.<br /> <br /> ==== publicstore_cloudfiles_host ====<br /> ''Default: Your current version of [https://github.com/rackspace/python-cloudfiles python-cloudfiles]'s Rackspace Cloud Files US host.''&lt;br /&gt;<br /> The API endpoint of the Cloud Files (Swift, OpenStack Object Storage) provider.<br /> <br /> ==== publicstore_cloudfiles_use_servicenet ====<br /> ''Default: false''&lt;br /&gt;<br /> User the RackSpace internal network when transferring data between the MediaGoblin server and the Cloud Files provider. This only works when running MediaGoblin on Rackspace Cloud Servers.<br /> <br /> = Attachments =<br /> <br /> Attachment are files that are associated to a media entry. <br /> <br /> For example, it could be the GIMP .xcf file for the image. So that others can inspect the source of your work.<br /> <br /> == Hazards ==<br /> <br /> Attachments are not filtered or scanned and therefore present a security risk. They can be used to perform XSS attacks or to upload malicious content. Make sure your environment is safe before enabling it.<br /> <br /> == Allow attachments ==<br /> <br /> To allow attachments, add<br /> <br /> allow_attachments = true<br /> <br /> to your mediagoblin.ini (or mediagoblin_local.ini)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Configure_MediaGoblin&diff=76 2011-08-09T04:24:49Z

<p>Cfdv: /* Seting it up */</p> <hr /> <div>= The config files =<br /> <br /> So basically there are two config files (and one meta-config file).<br /> <br /> * '''mediagoblin.ini:''' Use this to configure MediaGoblin, the application. Want to use a different storage system? Configure it here!<br /> * '''paste.ini:''' This just actually configures the web server that launches the MediaGoblin application, and some other things (like actually sets up the applications that serve your static files).<br /> <br /> And then there's the meta-config file:<br /> * '''mediagoblin/config_spec.ini:''' This sets the defaults for config file options and the type conversion for things in mediagoblin.ini. Developers who add new config options should probably register them and their types here (and set some good defaults, if applicable).<br /> <br /> = Changing config files =<br /> <br /> So you want to turn on (or off) all the bells and whistles, set up mediagoblin to use a storage system running out of a distributed cluster of Commodore 64s, change your email server configuration, etc. Where do you set all this stuff up?<br /> <br /> You should do the following:<br /> &lt;pre&gt;<br /> # copy the config files<br /> $ cp paste.ini paste_local.ini<br /> $ cp mediagoblin.ini mediagoblin_local.ini<br /> <br /> # edit paste_local.ini to know where mediagoblin_local.ini is<br /> $ editor paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Find the line marked &quot;config =&quot; under [app:mediagoblin]; change to:<br /> <br /> &lt;pre&gt;<br /> [app:mediagoblin]<br /> use = egg:mediagoblin#app<br /> filter-with = beaker<br /> config = %(here)s/mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> If you want to use lazyserver.sh, you can run it like:<br /> <br /> &lt;pre&gt;<br /> ./lazyserver.sh -c paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Also, all the ./bin/gmg commands have arguments to allow you to pass in the config file. For example:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell -cf mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> (It's important to note that the ./bin/gmg commands don't care about the paster file, they just care about the mediagoblin config file.)<br /> <br /> BTW, all these ./bin/gmg subcommands have help. You can check them like:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell --help<br /> &lt;/pre&gt;<br /> <br /> for more info.<br /> <br /> = Setting up Cloud Files public storage =<br /> <br /> These settings also work with OpenStack Object Storage (Swift), but you will need to set the API endpoint to avoid it defaulting to Rackspace Cloud Files US.<br /> <br /> == Setting it up ==<br /> <br /> In mediagoblin.ini (or mediagoblin_local.ini), add this to the file and edit it to fit your needs.<br /> <br /> === Working example ===<br /> &lt;pre&gt;<br /> ##<br /> # BEGIN CloudFiles public storage<br /> ##<br /> # Uncomment the following line and fill in your details to enable Cloud Files<br /> # (or OpenStack Object Storage [Swift])<br /> # - <br /> publicstore_storage_class = mediagoblin.storage:CloudFilesStorage<br /> publicstore_cloudfiles_user = user<br /> publicstore_cloudfiles_api_key = 1a2b3c4d5e6f7g8h9i<br /> publicstore_cloudfiles_container = mediagoblin<br /> <br /> # Uncomment this and fill it in to set the API endpoint to anything other<br /> # than Rackspace Cloud Files US<br /> # publicstore_cloudfiles_host = https://example.org/v1.0 <br /> <br /> # Only applicable if you run MediaGoblin on a Rackspace Cloud Server<br /> # it routes traffic through the internal Rackspace network, this<br /> # means that the bandwith betis free.<br /> publicstore_cloudfiles_use_servicenet = false<br /> ##<br /> # END CloudFiles<br /> ##<br /> &lt;/pre&gt;<br /> <br /> === Options ===<br /> <br /> ==== publicstore_storage_class ====<br /> ''Default: mediagoblin.storage:BasicFileStorage''&lt;br /&gt;<br /> This is used internally in mediagoblin to decide which type the storage object should be.<br /> <br /> ==== publicstore_cloudfiles_user ====<br /> The user account that you use for authentication with the Cloud Files API.<br /> <br /> ==== publicstore_cloudfiles_api_key ====<br /> The API key for the Cloud Files API<br /> <br /> ==== publicstore_cloudfiles_container ====<br /> The container on your Cloud Files account in which the MediaGoblin public storage should be stored.<br /> <br /> ==== publicstore_cloudfiles_host ====<br /> ''Default: Your current version of [https://github.com/rackspace/python-cloudfiles python-cloudfiles]'s Rackspace Cloud Files US host.''&lt;br /&gt;<br /> The API endpoint of the Cloud Files (Swift, OpenStack Object Storage) provider.<br /> <br /> ==== publicstore_cloudfiles_use_servicenet ====<br /> ''Default: false''&lt;br /&gt;<br /> User the RackSpace internal network when transferring data between the MediaGoblin server and the Cloud Files provider. This only works when running MediaGoblin on Rackspace Cloud Servers.<br /> <br /> = Attachments =<br /> <br /> ''As of 6th of August `attachments` are not yet in mediagoblin master. Dev branch can be found at https://gitorious.org/~jwandborg/mediagoblin/jwandborgs-mediagoblin/commits/f482_media_attachments''<br /> <br /> Attachment are files that are associated to a media entry. <br /> <br /> For example, it could be the GIMP .xcf file for the image. So that others can inspect the source of your work.<br /> <br /> == Hazards ==<br /> <br /> Attachments are not filtered or scanned and therefore present a security risk. They can be used to perform XSS attacks or to upload malicious content. Make sure your environment is safe before enabling it.<br /> <br /> == Allow attachments ==<br /> <br /> To allow attachments, add<br /> <br /> allow_attachments = true<br /> <br /> to your mediagoblin.ini (or mediagoblin_local.ini)</div>

Cfdv https://wiki.mediagoblin.org/index.php?title=Configure_MediaGoblin&diff=75 2011-08-09T03:25:46Z

<p>Cfdv: /* editor paste_local.ini, not mediagoblin_local.ini */</p> <hr /> <div>= The config files =<br /> <br /> So basically there are two config files (and one meta-config file).<br /> <br /> * '''mediagoblin.ini:''' Use this to configure MediaGoblin, the application. Want to use a different storage system? Configure it here!<br /> * '''paste.ini:''' This just actually configures the web server that launches the MediaGoblin application, and some other things (like actually sets up the applications that serve your static files).<br /> <br /> And then there's the meta-config file:<br /> * '''mediagoblin/config_spec.ini:''' This sets the defaults for config file options and the type conversion for things in mediagoblin.ini. Developers who add new config options should probably register them and their types here (and set some good defaults, if applicable).<br /> <br /> = Changing config files =<br /> <br /> So you want to turn on (or off) all the bells and whistles, set up mediagoblin to use a storage system running out of a distributed cluster of Commodore 64s, change your email server configuration, etc. Where do you set all this stuff up?<br /> <br /> You should do the following:<br /> &lt;pre&gt;<br /> # copy the config files<br /> $ cp paste.ini paste_local.ini<br /> $ cp mediagoblin.ini mediagoblin_local.ini<br /> <br /> # edit paste_local.ini to know where mediagoblin_local.ini is<br /> $ editor paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Find the line marked &quot;config =&quot; under [app:mediagoblin]; change to:<br /> <br /> &lt;pre&gt;<br /> [app:mediagoblin]<br /> use = egg:mediagoblin#app<br /> filter-with = beaker<br /> config = %(here)s/mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> If you want to use lazyserver.sh, you can run it like:<br /> <br /> &lt;pre&gt;<br /> ./lazyserver.sh -c paste_local.ini<br /> &lt;/pre&gt;<br /> <br /> Also, all the ./bin/gmg commands have arguments to allow you to pass in the config file. For example:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell -cf mediagoblin_local.ini<br /> &lt;/pre&gt;<br /> <br /> (It's important to note that the ./bin/gmg commands don't care about the paster file, they just care about the mediagoblin config file.)<br /> <br /> BTW, all these ./bin/gmg subcommands have help. You can check them like:<br /> <br /> &lt;pre&gt;<br /> ./bin/gmg shell --help<br /> &lt;/pre&gt;<br /> <br /> for more info.<br /> <br /> = Setting up Cloud Files public storage =<br /> <br /> These settings also work with OpenStack Object Storage (Swift), but you will need to set the API endpoint to avoid it defaulting to Rackspace Cloud Files US.<br /> <br /> == Seting it up ==<br /> <br /> In mediagoblin.ini (or mediagoblin_local.ini), add this to the file and edit it to fit your needs.<br /> <br /> === Working example ===<br /> &lt;pre&gt;<br /> ##<br /> # BEGIN CloudFiles public storage<br /> ##<br /> # Uncomment the following line and fill in your details to enable Cloud Files<br /> # (or OpenStack Object Storage [Swift])<br /> # - <br /> publicstore_storage_class = mediagoblin.storage:CloudFilesStorage<br /> publicstore_cloudfiles_user = user<br /> publicstore_cloudfiles_api_key = 1a2b3c4d5e6f7g8h9i<br /> publicstore_cloudfiles_container = mediagoblin<br /> <br /> # Uncomment this and fill it in to set the API endpoint to anything other<br /> # than Rackspace Cloud Files US<br /> # publicstore_cloudfiles_host = https://example.org/v1.0 <br /> <br /> # Only applicable if you run MediaGoblin on a Rackspace Cloud Server<br /> # it routes traffic through the internal Rackspace network, this<br /> # means that the bandwith betis free.<br /> publicstore_cloudfiles_use_servicenet = false<br /> ##<br /> # END CloudFiles<br /> ##<br /> &lt;/pre&gt;<br /> <br /> === Options ===<br /> <br /> ==== publicstore_storage_class ====<br /> ''Default: mediagoblin.storage:BasicFileStorage''&lt;br /&gt;<br /> This is used internally in mediagoblin to decide which type the storage object should be.<br /> <br /> ==== publicstore_cloudfiles_user ====<br /> The user account that you use for authentication with the Cloud Files API.<br /> <br /> ==== publicstore_cloudfiles_api_key ====<br /> The API key for the Cloud Files API<br /> <br /> ==== publicstore_cloudfiles_container ====<br /> The container on your Cloud Files account in which the MediaGoblin public storage should be stored.<br /> <br /> ==== publicstore_cloudfiles_host ====<br /> ''Default: Your current version of [https://github.com/rackspace/python-cloudfiles python-cloudfiles]'s Rackspace Cloud Files US host.''&lt;br /&gt;<br /> The API endpoint of the Cloud Files (Swift, OpenStack Object Storage) provider.<br /> <br /> ==== publicstore_cloudfiles_use_servicenet ====<br /> ''Default: false''&lt;br /&gt;<br /> User the RackSpace internal network when transferring data between the MediaGoblin server and the Cloud Files provider. This only works when running MediaGoblin on Rackspace Cloud Servers.<br /> <br /> = Attachments =<br /> <br /> ''As of 6th of August `attachments` are not yet in mediagoblin master. Dev branch can be found at https://gitorious.org/~jwandborg/mediagoblin/jwandborgs-mediagoblin/commits/f482_media_attachments''<br /> <br /> Attachment are files that are associated to a media entry. <br /> <br /> For example, it could be the GIMP .xcf file for the image. So that others can inspect the source of your work.<br /> <br /> == Hazards ==<br /> <br /> Attachments are not filtered or scanned and therefore present a security risk. They can be used to perform XSS attacks or to upload malicious content. Make sure your environment is safe before enabling it.<br /> <br /> == Allow attachments ==<br /> <br /> To allow attachments, add<br /> <br /> allow_attachments = true<br /> <br /> to your mediagoblin.ini (or mediagoblin_local.ini)</div>

Cfdv