|
InstallingJaikuengineUsingOSX
How to install and deploy Jaikuengine using OS X
IntroductionGetting a Jaikuengine instance running on Google App Engine is probably a lot easier than you think. Still, it's not for everyone, at least not without instructions. So here goes. Preconditions
InstallingUsing macports, it should be as simple as the following:
Observe that you can't (easily) run Jaikuengine in a virtualenv so sudo is the way to go for the moment. Checking out Jaikuengine
Local settingsTake a look at both settings.py and local_settings.py if you're interested in seeing how Jaikuengine can be configured. You can use local_settings.py to override settings in settings.py.
Run locallyThe below loads test data, changes you make will be overwritten next time you run it. The advantage is that you have a few users and channels already defined.
Browse to http://localhost:8080 and log in as username and password "popular". If you want to run without test data, use the following:
Browse to http://localhost:8080/install to install the root user. Afterwards, click sign up to create your user. If you want to start over with a fresh local database, run the following:
App Engine setupLogin to https://appengine.google.com/ and create an application. Now we need to configure some things. Let's assume you named your application "helloworld":
application: "helloworld" Enter a site name []: Hello World! Enter a secret key [a259515a9b1369b9349b12ce15c2a943]: Enter an appspot domain []: helloworld.appspot.com Enabled Hosted Domains (yes|no) [yes]: no Enter your namespace domain [helloworld.appspot.com]: Enter the nick for your admin user [admin@helloworld.appspot.com]: Enable SSL login (yes|no) [yes]: Enter an email address to send from []: your-email-address@gmail.com Now do a quick verification of local_settings.py to see that it looks like you expected. Deploying to App Engine
While running the update script, you'll have to enter the email address and password you use to log into Google App Engine. When the update script has finished, browse to http://helloworld.appspot.com/install (remember to replace helloworld with your App Engine application name) and create a root user. Now sign up and start using your own instance of Jaikuengine! :) Email queues, etc.In order to process some of queues, you might have to kick jaikuengine by browsing to http://helloworld.appspot.com/_ah/queue/default?secret=SECRET (replace "helloworld" by your application name and "SECRET" with what is defined by settings.py and QUEUE_VENDOR_SECRET) Running the test suiteAfter checking out jaikuengine and copying local_settings.example.py to local_settings.py, it's a good idea to run the test suite. You run it as follows:
It will print out a lot of things, including warnings, before hopefully ending with "OK". If not, check the errors and post a question on channel #jaikuengine on http://jaiku.com. |