Title: | SaberNet DCS Installation Guide |
---|---|
Authors: | Seth Remington <sremington@saberlogic.com>
Matthew Ranostay <mranostay@saberlogic.com> |
Date: | 2006-08-16 |
Revision: | 1.8 |
Description: | Documentation for installing SaberNet DCS from source. |
This installation guide will describe how to install SaberNet DCS from source.
SaberNet DCS is a client/server application. Both the client and server are installed from the same source code but they have separate dependencies and installation procedures. The instructions below will specify when certain instructions apply to only the client, the server, or both.
In addition there may be some differences between installing on Linux and win32. Those differences will be noted as well. Otherwise assume the instructions apply to all architectures.
The SaberNet DCS server is named sndcsd (SaberNet DCS Daemon). There are several clients (and more planned) but for right now the most mature is the GTK+ client for Linux and win32. It is named sndcs_gtk.
If you are using Microsoft SQL Server as your database backend you will also require the following dependencies to be installed: * mxBase (http://www.egenix.org) * mxODBC (http://www.egenix.org)
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"
The configuration files for the server and clients are initially created by running the configure_sndcs.py script. This is a simple command line program that will prompt you for configuration parameters. Most prompts will end with a default answer and/or available answers to choose from within square brackets [...]. For example, [y,N] means that the available answers are y(es) and n(o) and the capitalized 'N' means that no is the default which will be selected if you just press <Enter>. If configure_sndcs.py has been run previously the defaults will be read in from your previous configuration so you can simply <Enter> through the prompts that you don't want to change and it will keep your old configuration.
When running the configure_sndcs.py script you will first be prompted:
Do you want to install the client, server, or both? [c/s/b]:
Selecting c(lient) will configure the clients and s(erver) the server. Selection b(oth) will simply run the server configuration followed by the client one. It is important to note that the actual installation will only install the pieces for which there is a configuration file for. So if you only configure the client, the server (sndcsd) will NOT be installed.
Instructions on creating a DCS database: