SaberNet DCS
DEPENDENCIES
============
CLIENT:
* Python >= 2.3 (http://www.python.org)
* PyGTK >= 2.4 (http://www.pygtk.org) including Glade support
* Pyro >= 3.5 (http://pyro.sourceforge.net) NOTE: some problems reported with 3.4 on the client
SERVER:
* Webware >= 0.9 (http://www.webwareforpython.org/)
* A RDBMS supported by Webware/MiddleKit and it's associated Python wrapper (i.e. MySQL/MySQLdb, PostgreSQL/psycopg, MSSQL/mx.ODBC)
* Pyro >= 3.5 (http://pyro.sourceforge.net) NOTE: some problems reported with 3.4 on the server
* PyRSS2Gen >=1.0.0 (http://www.dalkescientific.com/Python/PyRSS2Gen.html)
MSSQL DEPENDENCIES
==================
Python >= 2.4 (http://python.org)
mxBase (http://www.egenix.org)
mxODBC (http://www.egenix.org)
OVERVIEW
========
INSTALLATION
============
Linux:
Note: the installation uses the builtin Python distutils module. Many Linux distributions split this off into a python-dev (or similarly named) package. Please make sure you have that installed before proceeding or you may get an error when you run "python setup.py install"
* Untar sndcs-<version>.tar.gz
* cd sndcs-<version>
* ./configure_sndcs.py
* TODO: DCS is a client/server application
* python setup.py install (as root) --or-- run configure_sndcs as root and choose to install when prompted
* Start the server
* Run your frontend of choice (i.e. sndcs_gtk, sndcs_curses, etc...)
* If you want to install the web server...
--- SUPER QUICK START ---
* As root: "/usr/share/sndcs/web/sndcs2httpd start"
--- QUICK START ---
* As root: "ln -s /usr/share/sndcs/web/sndcs2httpd /etc/init.d/sndcs2httpd"
* As root: "/etc/init.d/sndcs2httpd start"
--- LESS QUICK START ---
* There is a start script named sndcs2httpd in the sndcs/web folder that can be used to automatically start the web server at boot time. This script is really just a copy of the generic WebKitstart script. There are more specialized start scripts in the WebKit/StartScripts folder of the Webware distribution if you would rather use on of them (which you probably should). Just overwrite the sndcs2httpd file with one of them. See Webware docs for more details about options and configuration.
* The installation will place the generic start script in <python's sys.prefix>/share/sndcs/web (probably /usr/share/sndcs/web). You can replace this with a more appropriate WebKit start script if you so desire.
* Create a symbolic link in /etc/init.d to the sndcs2httpd start script (i.e. "ln -s /usr/share/sndcs/web/sndcs2httpd /etc/init.d/sndcs2httpd")
* Follow the instructions for your particular distro to enable runlevel startup and shutdown properly (i.e. for Debian: "update-rc.d sndcs2httpd defaults 75" )
* The web server will now be listening on port 8080 by default
Windows:
* Untar sndcs-<version>.tar.gz
* cd sndcs-<version>
* python configure_sndcs.py
* TODO: DCS is a client/server application
* python setup.py install (as administrator)
* Start the server
* Run your frontend of choice (i.e. sndcs_gtk, sndcs_curses, etc...)
* If you want to install the web server...
--- SUPER QUICK START ---
* Run "python \pythonXX\share\sndcs\web\Launch.py
DEVELOPMENT
===========
* When a change is made to the object model (i.e. sndcs.mkmodel/Classes.csv) you need to run the configure_sndcs script to regenerate the model (and re-create the proper database schema if necessary)