YETI Quickstart

YETI Quickstart is a non-production deployment. This deployment method is the fastest way to get YETI running on a system.

Requirements

The following are required for YETI Quickstart to succeed:

• Python 2.6 or 2.7 (http://www.python.org/download/)
• Django 1.4 or higher (https://www.djangoproject.com/download/)
• libtaxii 1.0.105 or higher (https://github.com/TAXIIProject/libtaxii/releases)

Instructions

1. Download and extract the latest release of YETI: https://github.com/TAXIIProject/yeti/releases
2. In a command shell, navigate to the yeti/ directory and start the server (Note: The script must be run from the yeti/ directory or it won't work)
   1. Windows: scripts\quickstart.bat
   2. Unix: ./scripts/quickstart.sh

If the quickstart script works, you should see output like this:

yeti>python manage.py syncdb
Creating tables ...
(Table creation output omitted for brevity)

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (leave blank to use 'mdavidson'):
Email address: [email protected]
Password: NotARealPassword
Password (again): NotARealPassword
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
Installed 9 object(s) from 1 fixture(s)

yeti>python manage.py runserver 80
Validating models...

0 errors found
July 24, 2013 - 07:45:32
Django version 1.5.1, using settings 'yeti.settings'
Development server is running at http://127.0.0.1:80/
Quit the server with CTRL-BREAK.

At this point the server is running. You should be able to navigate to http://localhost/admin/ and log in with the user you created during the quickstart script. There are two important notes to how this script works:

1. The script tells the server to listen on 127.0.0.1:80, which will not accept connections from remote machines. If you need to accept connections from remote machines, modify the quickstart script and replace 80 with 0.0.0.0:80.
2. If for any reason you ever want to delete the database (you forgot what user you created, forgot the password, etc), just delete the yeti\sqlite3.db file and re-run the quickstart script.

The quickstart deployment comes with two scripts to push and pull content from YETI.

1. To push STIX Content to YETI, use the inbox_client.py script. Run it by issuing this command: python scripts\inbox_client.py. The inbox_client script includes a default STIX document.
2. To pull content from YETI, use the poll_client.py script. Run it by issuing this command: python scripts\poll_client.py.

In order to see the content that is in the database, navigate to http://localhost/admin/taxii_services/contentblock/.