Project: Twends

Twends is an app for discovering hyper-local Twitter trends

Team Members

• Dylan Ahearn
• Peter Wang
• Elliot Whitehead
• Evan Yin

Installation

1. Install pip (if needed)

   • Ubuntu: apt-get update; apt-get -y install python-pip
   • MacOS: sudo easy_install pip

2. Install virtualenv: sudo pip install virtualenv

3. Create a new virtualenv environment to isolate dependancies: virtualenv venv

4. Activate your new virtual environment (Must be done every time to run the codebase): source venv/bin/activate

   • To deactivate the virtual environment, simply run deactivate (or kill terminal session)

5. Install project dependencies: pip install -r requirements.txt (give it a minute, the Cassandra driver will take a while!)

6. Start a Cassandra server running in the foreground: cassandra/bin/cassandra -f (to check on node statuses, run cassandra/bin/nodetool status)

7. Sync the db: twends/manage.py sync_cassandra

8. To start the Django app server, run python twends/manage.py runserver

9. Visit http://localhost:8000 to see your running Django app!

10. Dowload DataStax at https://academy.datastax.com/ , you will have to create a free account.

11. Download for Mac or linux, select the install directory to be green-gopher. (Watch the install instruction video. You might have to reinstall it if you did it wrong)

12. To run cassandra go into the dse folder an type "bin/dse cassandra"

13. possible errors- if log error delete the logs in "dse/commitlog", if an error with gossiping to seeds, go into "dse/resources/cassandra/conf/cassandra.yaml and make the listen address blank.

14. To see if your cassandra node is up and running type "bin/nodetool status"

15. go into the cql shell with "bin/dse cqlsh".

16. to set up a test database run the commands in cqlCreateTable

17. to run spark use the command "bin/dse spark" this runs spark with scala. to close use 'exit()'

18. to check if spark is active use bin/dsetool ring

---

Dependency Information

Cassandra v3.10