some notes on trying to install Taarifa on a Linux box..

[Willow Brugh]

I'll also work on folding these into the github documentation, but I don't want to lose them, so here is:

Taarifa Installation for Demo

User: Someone who has heard of Taarifa, is interested in seeing how the tool works. Next to no coding ability, but interface-savvy and open enthusiast. 

Right now, there isn't a summary of what Taarifa does, nor link to website/blog/twitter/etc from github. There are also a LOT of possible repos for me to look at. How do I pick one? I've picked "Taarifa Waterpoints" because of my actual experience. After doing this, there is a *fantastic* overview of what Taarifa is. I wonder why this doesn't exist at the upper level at GitHub.com/Taarifa.

I installed pip. We might include a line about "how to install" versus "how to upgrade," which is all that currently exists.

Installation "note" section seems weird. Needs formatting or rewording.

I *then* get booted over to the API page. Would it have made sense to install that first? Or to include this as a prereq in the overview descriptions listed on the github.com/taarifa landing page

A link to MongoDB or some sort of heads up that it needs to be installed separately would be solid

>>Installed pip, MongoDB

>>Both had issues: "Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?"

If it's spitting errors, try these to be sure everything is the most up-to-date...

apt-get update

apt-get upgrade

pip install -U pip

nodejs -v

>> not working? apt-get install nodejs nodejs-dev npm

MongoDB install, via JC at Aspiration

:

As for MongoDB, oh jevus, this one was a bit complicated as it was not

doing to well finding anything archives online, I think there is

something wrong on part of the distributors, nothing wrong on the

computers, but anyway this installation documentation worked out

wonderfully for me:

http://docs.mongodb.org/manual/tutorial/install-mongodb-on-linux/

This has the installation process for both the 64bit and 32 bit, to find

out which type of system you are running you can use the search box that

is in the "Menu" and type System Info and it will say it next to

Operating System.

Now for the tutorial, which ever you have, either 64bit or 32bit, just

do up to step 3, step 4 is not necessary.

Now to check if it is installed do the following (in terminal, each line

is a different input, not all at once):

mkdir -p /data/db

mongod

mongo

Once you input mongo you should just see this ">". You can type in help

and a list of commands will be listed that only work with mongo, but if

you see all this you know that mongo is working, you can exit this by

simply typing in exit :D

Oh and to get rid of the computer god privileges just type in exit,

otherwise if you don't, terminal will tell you that it is still working

on something, which is nothing bad, but I freaked out when I first saw

that haha >.<

reassert where it's installed: source ~/.profile

Also from JC

Not sure why but what you have to do next time you run TaarifaWaterpoints:

mongo

use TaarifaAPI;

db.dropDatabase();

exit

Now you can run both without any error:

python manage.py create_facility

python manage.py create_service

** Waring **

Apparently using db.dropDatabase(); will drop all inputs in the

TaarifaAPI database , so it was recommended not to use this when you

have any input because you will have to re-create everything. There

might be an alternative but I don't know how to use mongodb, so I would

recommend just using this option when messing around with Taarifa and

getting used to it.

Willow Brugh // willowbl00 // tinyletter

schedule research, work, or social time with me

0xf8a3976b56a2db35

[Willow Brugh]

Also useful to note:b efore you start using the TaarifaAPI you have to do to "source
~/.profile"

Willow Brugh // willowbl00 // tinyletter

schedule research, work, or social time with me

0xf8a3976b56a2db35

[Paul Mason]

--
You received this message because you are subscribed to the Google Groups "Taarifa-Dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to taarifa-dev...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Paul Mason]

I have a draft reply to this but it is absurd in length. I know Willow appreciates a tl;dr it is thus:

Yes!  Barrier for entry still too high, pip and mongodb not well enough doc'd, but docsso so much better than before... but barrier for entry too high. That is the loop I went round on spaceapps... said no we need a bash install script.. got as far as import pip I think!

Willow this is what I have been quietly moaing in my own mind about (you will get this) creating a feedback loop I am even too scared to help in, or break out in my mind. What is the barrier to entry for tarrifa, forget security, lets get a "point and oh, my, me, it is up and running"

You will hate this,but from my mind... the one with cars and transport... that's the one I could do a baseline on... but that was the one with fewer docs.... then I spun round in a circle for a bit then I gave up.

 

I know two comps in Scotland aggressively with v v insecure products to map water breaks... I keep on seeing "Let's map red squirrels" appeals on TV taarifa could do all of this. I suppose it comes down to the direction it all takes?

Willow? That's one for you, it is not my domain at all.

[Paul Mason]

p.s.forgot to say....

very very happy to help in anyway that lowers the barrier to entry..

P

[Willow Brugh]

Even if we can have a "start here" packet where anyone can try something out, that would be major.

OR clearer "if you want to do X, use this repo"

AND/OR archiving stuff not in use, even if only to have a leading "No longer in use" on the github name.

I think that would get us way further than we are right now.

Will work on folding in these notes to the documentation, but the meta-level directory will still need work, which I am happy to help with, but out of my depth in executing on my own.

<3

Willow Brugh // willowbl00 // tinyletter

schedule research, work, or social time with me

0xf8a3976b56a2db35

[Paul Mason]

That is the loop that got me. From what I can see with my "duh I know nothing" hat on is, now a week or two out, I don't keep it all in my head,waterhole- awesome but too complex for quick deploy, the other one Main I think great, but I needed the waterwhole docs and whatever the transport one was, totally great, I could see how I could tweak it.

After that,spaceapps remember, I just gave up.

A good push on up and running on *.nix I would happily work with Willow etc.. on. That I would support 100%

Paul

[Paul Mason]