Empact-deprec 1.99.21

data/lib/deprec/templates/monit/monitrc.erb

@@ -0,0 +1,227 @@
+###############################################################################
+## Monit control file
+###############################################################################
+##
+## Comments begin with a '#' and extend through the end of the line. Keywords
+## are case insensitive. All path's MUST BE FULLY QUALIFIED, starting with '/'.
+##
+## Below you will find examples of some frequently used statements. For 
+## information about the control file, a complete list of statements and 
+## options please have a look in the monit manual.
+##
+##
+###############################################################################
+## Global section
+###############################################################################
+##
+## Start monit in the background (run as a daemon) and check services at 
+## 2-minute intervals.
+#
+set daemon  <%= monit_check_interval %>
+#
+#
+## Set syslog logging with the 'daemon' facility. If the FACILITY option is
+## omitted, monit will use 'user' facility by default. If you want to log to 
+## a stand alone log file instead, specify the path to a log file
+#
+set logfile <%= monit_log %>                       
+#
+#
+## Set the list of mail servers for alert delivery. Multiple servers may be 
+## specified using comma separator. By default monit uses port 25 - this
+## is possible to override with the PORT option.
+#
+<%= '# ' unless monit_mailserver %>set mailserver <%= monit_mailserver || 'localhost' %>     # primary mailserver (append a comma
+#				# to this line if you add more.)
+#                backup.bar.baz port 10025,  # backup mailserver on port 10025
+#                localhost                   # fallback relay
+#
+#
+## By default monit will drop alert events if no mail servers are available. 
+## If you want to keep the alerts for a later delivery retry, you can use the 
+## EVENTQUEUE statement. The base directory where undelivered alerts will be 
+## stored is specified by the BASEDIR option. You can limit the maximal queue
+## size using the SLOTS option (if omitted, the queue is limited by space 
+## available in the back end filesystem).
+#
+# set eventqueue
+#     basedir /var/monit  # set the base directory where events will be stored
+#     slots 100           # optionaly limit the queue size
+#
+#
+## Monit by default uses the following alert mail format:
+##
+## --8<--
+## From: monit@$HOST                         # sender
+## Subject: monit alert --  $EVENT $SERVICE  # subject
+##
+## $EVENT Service $SERVICE                   #
+##                                           #
+## 	Date:        $DATE                   #
+## 	Action:      $ACTION                 #
+## 	Host:        $HOST                   # body
+## 	Description: $DESCRIPTION            #
+##                                           #
+## Your faithful employee,                   #
+## monit                                     #
+## --8<--
+##
+## You can override this message format or parts of it, such as subject
+## or sender using the MAIL-FORMAT statement. Macros such as $DATE, etc.
+## are expanded at runtime. For example, to override the sender:
+#
+<%= '# ' unless monit_mailserver %>set mail-format { from: <%= monit_mail_from %> }
+#
+#
+## You can set alert recipients here whom will receive alerts if/when a 
+## service defined in this file has errors. Alerts may be restricted on 
+## events by using a filter as in the second example below. 
+#
+<% monit_alert_recipients.each do |recipient| %>
+<%= '# ' unless monit_mailserver %>set alert <%= recipient %>                       # receive all alerts
+<% end %>
+<% monit_timeout_recipients.each do |recipient| %>
+<%= '# ' unless monit_mailserver %>set alert <%= recipient %> only on { timeout }  # receive just service-
+	                                                			# timeout alert
+<% end %>
+
+#
+#
+## Monit has an embedded web server which can be used to view status of 
+## services monitored, the current configuration, actual services parameters
+## and manage services from a web interface.
+#
+<% if monit_webserver_enabled %>
+set httpd port <%= monit_webserver_port %> and
+     use address <%= monit_webserver_address %>  # listen on <%= monit_webserver_address %>
+  <% monit_webserver_allowed_hosts_and_networks.each do |host| %>
+     allow <%= host %> # allow <%= host %> to connect to the server
+  <% end %>
+     allow <%= monit_webserver_auth_user %>:<%= monit_webserver_auth_pass %>      # require user <%= monit_webserver_auth_user %> with password <%= monit_webserver_auth_pass %>
+<% end %>
+#
+#
+###############################################################################
+## Services
+###############################################################################
+##
+## Check general system resources such as load average, cpu and memory
+## usage. Each test specifies a resource, conditions and the action to be
+## performed should a test fail.
+#
+#  check system myhost.mydomain.tld
+#    if loadavg (1min) > 4 then alert
+#    if loadavg (5min) > 2 then alert
+#    if memory usage > 75% then alert
+#    if cpu usage (user) > 70% then alert
+#    if cpu usage (system) > 30% then alert
+#    if cpu usage (wait) > 20% then alert
+#
+#    
+## Check a file for existence, checksum, permissions, uid and gid. In addition
+## to alert recipients in the global section, customized alert will be sent to 
+## additional recipients by specifying a local alert handler. The service may 
+## be grouped using the GROUP option.
+#    
+#  check file apache_bin with path /usr/local/apache/bin/httpd
+#    if failed checksum and 
+#       expect the sum 8f7f419955cefa0b33a2ba316cba3659 then unmonitor
+#    if failed permission 755 then unmonitor
+#    if failed uid root then unmonitor
+#    if failed gid root then unmonitor
+#    alert security@foo.bar on {
+#           checksum, permission, uid, gid, unmonitor
+#        } with the mail-format { subject: Alarm! }
+#    group server
+#
+#    
+## Check that a process is running, in this case Apache, and that it respond
+## to HTTP and HTTPS requests. Check its resource usage such as cpu and memory,
+## and number of children. If the process is not running, monit will restart 
+## it by default. In case the service was restarted very often and the 
+## problem remains, it is possible to disable monitoring using the TIMEOUT
+## statement. This service depends on another service (apache_bin) which
+## is defined above.
+#    
+#  check process apache with pidfile /usr/local/apache/logs/httpd.pid
+#    start program = "/etc/init.d/httpd start"
+#    stop program  = "/etc/init.d/httpd stop"
+#    if cpu > 60% for 2 cycles then alert
+#    if cpu > 80% for 5 cycles then restart
+#    if totalmem > 200.0 MB for 5 cycles then restart
+#    if children > 250 then restart
+#    if loadavg(5min) greater than 10 for 8 cycles then stop
+#    if failed host www.tildeslash.com port 80 protocol http
+#       and request "/monit/doc/next.php"
+#       then restart
+#    if failed port 443 type tcpssl protocol http
+#       with timeout 15 seconds
+#       then restart
+#    if 3 restarts within 5 cycles then timeout
+#    depends on apache_bin
+#    group server
+#    
+#    
+## Check device permissions, uid, gid, space and inode usage. Other services,
+## such as databases, may depend on this resource and an automatically graceful
+## stop may be cascaded to them before the filesystem will become full and data
+## lost.
+#
+#  check device datafs with path /dev/sdb1
+#    start program  = "/bin/mount /data"
+#    stop program  = "/bin/umount /data"
+#    if failed permission 660 then unmonitor
+#    if failed uid root then unmonitor
+#    if failed gid disk then unmonitor
+#    if space usage > 80% for 5 times within 15 cycles then alert
+#    if space usage > 99% then stop
+#    if inode usage > 30000 then alert
+#    if inode usage > 99% then stop
+#    group server
+#
+#
+## Check a file's timestamp. In this example, we test if a file is older 
+## than 15 minutes and assume something is wrong if its not updated. Also,
+## if the file size exceed a given limit, execute a script
+#
+#  check file database with path /data/mydatabase.db
+#    if failed permission 700 then alert
+#    if failed uid data then alert
+#    if failed gid data then alert
+#    if timestamp > 15 minutes then alert
+#    if size > 100 MB then exec "/my/cleanup/script"
+#
+#
+## Check directory permission, uid and gid.  An event is triggered if the 
+## directory does not belong to the user with uid 0 and gid 0.  In addition, 
+## the permissions have to match the octal description of 755 (see chmod(1)).
+#
+#  check directory bin with path /bin
+#    if failed permission 755 then unmonitor
+#    if failed uid 0 then unmonitor
+#    if failed gid 0 then unmonitor
+#
+#
+## Check a remote host network services availability using a ping test and 
+## check response content from a web server. Up to three pings are sent and 
+## connection to a port and a application level network check is performed.
+#
+#  check host myserver with address 192.168.1.1
+#    if failed icmp type echo count 3 with timeout 3 seconds then alert
+#    if failed port 3306 protocol mysql with timeout 15 seconds then alert
+#    if failed url
+#       http://user:password@www.foo.bar:8080/?querystring
+#       and content == 'action="j_security_check"'
+#       then alert
+#
+#
+###############################################################################
+## Includes
+###############################################################################
+##
+## It is possible to include additional configuration parts from other files or
+## directories.
+#
+include /etc/monit.d/*
+#
+#

data/lib/deprec/templates/mysql/create_databases.sql

@@ -0,0 +1,20 @@
+create database <%= @username %>_prod;
+GRANT USAGE ON *.* TO '<%= @username %>_db'@'%';
+
+GRANT ALL PRIVILEGES 
+ON <%= @username %>_prod.*
+TO <%= @username %>_db@'%'
+IDENTIFIED BY '<%= @mysqlpass %>';
+
+FLUSH PRIVILEGES;
+
+
+create database <%= @username %>_stage;
+GRANT USAGE ON *.* TO '<%= @username %>_db'@'%';
+
+GRANT ALL PRIVILEGES 
+ON <%= @username %>_stage.*
+TO <%= @username %>_db@'%'
+IDENTIFIED BY '<%= @mysqlpass %>';
+
+FLUSH PRIVILEGES;

data/lib/deprec/templates/mysql/database.yml.prod

@@ -0,0 +1,6 @@
+production:
+  adapter:   mysql
+  database:  <%= @username %>_prod
+  username:  <%= @username %>_db
+  password:  <%= @mysqlpass %>
+  host:      <%= @mysql_host %>

data/lib/deprec/templates/mysql/database.yml.stage

@@ -0,0 +1,6 @@
+production:
+  adapter:   mysql
+  database:  <%= @username %>_stage
+  username:  <%= @username %>_db
+  password:  <%= @mysqlpass %>
+  host:      <%= @mysql_host %>

data/lib/deprec/templates/mysql/my.cnf.erb

@@ -0,0 +1,140 @@
+#
+# The MySQL database server configuration file.
+#
+# You can copy this to one of:
+# - "/etc/mysql/my.cnf" to set global options,
+# - "~/.my.cnf" to set user-specific options.
+# 
+# One can use all long options that the program supports.
+# Run program with --help to get a list of available options and with
+# --print-defaults to see which it would actually understand and use.
+#
+# For explanations see
+# http://dev.mysql.com/doc/mysql/en/server-system-variables.html
+
+# This will be passed to all mysql clients
+# It has been reported that passwords should be enclosed with ticks/quotes
+# escpecially if they contain "#" chars...
+# Remember to edit /etc/mysql/debian.cnf when changing the socket location.
+[client]
+port		= 3306
+socket		= /var/run/mysqld/mysqld.sock
+
+# Here is entries for some specific programs
+# The following values assume you have at least 32M ram
+
+# This was formally known as [safe_mysqld]. Both versions are currently parsed.
+[mysqld_safe]
+socket		= /var/run/mysqld/mysqld.sock
+nice		= 0
+
+[mysqld]
+#
+# * Basic Settings
+#
+user		= mysql
+pid-file	= /var/run/mysqld/mysqld.pid
+socket		= /var/run/mysqld/mysqld.sock
+port		= 3306
+basedir		= /usr
+datadir		= /var/lib/mysql
+tmpdir		= /tmp
+language	= /usr/share/mysql/english
+skip-external-locking
+#
+# Instead of skip-networking the default is now to listen only on
+# localhost which is more compatible and is not less secure.
+bind-address		= 127.0.0.1
+#
+# * Fine Tuning
+#
+key_buffer		= 16M
+max_allowed_packet	= 16M
+thread_stack		= 128K
+thread_cache_size	= 8
+#max_connections        = 100
+#table_cache            = 64
+#thread_concurrency     = 10
+#
+# * Query Cache Configuration
+#
+query_cache_limit       = 1M
+query_cache_size        = 16M
+#
+# * Logging and Replication
+#
+# Both location gets rotated by the cronjob.
+# Be aware that this log type is a performance killer.
+#log		= /var/log/mysql/mysql.log
+#
+# Error logging goes to syslog. This is a Debian improvement :)
+#
+# Here you can see queries with especially long duration
+#log_slow_queries	= /var/log/mysql/mysql-slow.log
+#long_query_time = 2
+#log-queries-not-using-indexes
+#
+# The following can be used as easy to replay backup logs or for replication.
+# note: if you are setting up a replication slave, see README.Debian about
+#       other settings you may need to change.
+#server-id		= 1
+log_bin			= /var/log/mysql/mysql-bin.log
+# WARNING: Using expire_logs_days without bin_log crashes the server! See README.Debian!
+expire_logs_days	= 10
+max_binlog_size         = 100M
+#binlog_do_db		= include_database_name
+#binlog_ignore_db	= include_database_name
+#
+# * BerkeleyDB
+#
+# Using BerkeleyDB is now discouraged as its support will cease in 5.1.12.
+skip-bdb
+#
+# * InnoDB
+#
+# InnoDB is enabled by default with a 10MB datafile in /var/lib/mysql/.
+# Read the manual for more InnoDB related options. There are many!
+# You might want to disable InnoDB to shrink the mysqld process by circa 100MB.
+#skip-innodb
+#
+# * Security Features
+#
+# Read the manual, too, if you want chroot!
+# chroot = /var/lib/mysql/
+#
+# For generating SSL certificates I recommend the OpenSSL GUI "tinyca".
+#
+# ssl-ca=/etc/mysql/cacert.pem
+# ssl-cert=/etc/mysql/server-cert.pem
+# ssl-key=/etc/mysql/server-key.pem
+
+
+
+[mysqldump]
+quick
+quote-names
+max_allowed_packet	= 16M
+
+[mysql]
+#no-auto-rehash	# faster start of mysql but no tab completition
+
+[isamchk]
+key_buffer		= 16M
+
+#
+# * NDB Cluster
+#
+# See /usr/share/doc/mysql-server-*/README.Debian for more information.
+#
+# The following configuration is read by the NDB Data Nodes (ndbd processes)
+# not from the NDB Management Nodes (ndb_mgmd processes).
+#
+# [MYSQL_CLUSTER]
+# ndb-connectstring=127.0.0.1
+
+
+#
+# * IMPORTANT: Additional settings that can override those from this file!
+#
+!includedir /etc/mysql/conf.d/
+

data/lib/deprec/templates/mysql/sphinx.conf.prod

@@ -0,0 +1,542 @@
+#
+# Sphinx configuration file sample
+#
+
+#############################################################################
+## data source definition
+#############################################################################
+
+source src1
+{
+	# data source type
+	# for now, known types are 'mysql', 'pgsql' and 'xmlpipe'
+	# MUST be defined
+	type				= mysql
+
+	# whether to strip HTML
+	# values can be 0 (don't strip) or 1 (do strip)
+	# WARNING, only works with mysql source for now
+	# WARNING, should work ok for PERFECTLY formed XHTML for now
+	# WARNING, POSSIBLE TO BUG on malformed everday HTML
+	# optional, default is 0
+	strip_html			= 0
+
+	# what HTML attributes to index if stripping HTML
+	# format is as follows:
+	#
+	# index_html_attrs	= img=alt,title; a=title;
+	#
+	# optional, default is to not index anything
+	index_html_attrs	=
+
+	#####################################################################
+     
+	# some straightforward parameters for 'mysql' source type
+	sql_host			= <%= @mysql_host %>
+	sql_user			= <%= @username %>_db
+	sql_pass			= <%= @mysqlpass %>
+	sql_db				= <%= @username %>_prod
+	sql_port			= 3306	# optional, default is 3306
+
+	# sql_sock			= /tmp/mysql.sock
+	#
+	# optional
+	# usually '/var/lib/mysql/mysql.sock' on Linux
+	# usually '/tmp/mysql.sock' on FreeBSD
+
+	# pre-query, executed before the main fetch query
+	# useful eg. to setup encoding or mark records
+	# optional, default is empty
+	#
+	# sql_query_pre		= SET CHARACTER_SET_RESULTS=cp1251
+	sql_query_pre		=
+
+	# main document fetch query
+	#
+	# you can specify up to 32 (formally SPH_MAX_FIELDS in sphinx.h) fields;
+	# all of the fields which are not document_id or attributes (see below)
+	# will be full-text indexed
+	#
+	# document_id MUST be the very first field
+	# document_id MUST be positive (non-zero, non-negative)
+	# document_id MUST fit into 32 bits
+	# document_id MUST be unique
+	#
+	# mandatory
+	sql_query			= \
+		SELECT id, group_id, UNIX_TIMESTAMP(date_added) AS date_added, title, content \
+		FROM documents
+
+	# query range setup
+	#
+	# useful to avoid MyISAM table locks and big result sets
+	# when indexing lots of data
+	#
+	# to use query ranges, you should
+	# 1) provide a query to fetch min/max id (ie. id range) from data set;
+	# 2) configure step size in which this range will be walked;
+	# 3) use $start and $end macros somewhere in the main fetch query.
+	#
+	# 'sql_query_range' must return exactly two integer fields
+	# in exactly min_id, max_id order
+	#
+	# 'sql_range_step' must be a positive integer
+	# optional, default is 1024
+	#
+	# 'sql_query' must contain both '$start' and '$end' macros
+	# if you are using query ranges (because it obviously would be an
+	# error to index the whole table many times)
+	#
+	# note that the intervals specified by $start/$end do not
+	# overlap, so you should NOT remove document ids which are exactly
+	# equal to $start or $end in your query
+	#
+	# here's an example which will index 'documents' table
+	# fetching (at most) one thousand entries at a time:
+	#
+	# sql_query_range		= SELECT MIN(id),MAX(id) FROM documents
+	# sql_range_step		= 1000
+	# sql_query			= \
+	#	SELECT doc.id, doc.id AS group, doc.title, doc.data \
+	#	FROM documents doc \
+	#	WHERE id>=$start AND id<=$end
+
+
+	# attribute columns
+	#
+	# attribute values MUST be positive (non-zero, non-negative) integers
+	# attribute values MUST fit into 32 bits
+	#
+	# attributes are additional values associated with each document which
+	# may be used to perform additional filtering and sorting during search.
+	# attributes are NOT full-text indexed; they are stored in the full text
+	# index as is.
+	#
+	# a good example would be a forum posts table. one might need to search
+	# through 'title' and 'content' fields but to limit search to specific
+	# values of 'author_id', or 'forum_id', or to sort by 'post_date', or to
+	# group matches by 'thread_id', or to group posts by month of the
+	# 'post_date' and provide statistics.
+	#
+	# this all can be achieved by specifying all the mentioned columns
+	# (excluding 'title' and 'content' which are full-text fields) as
+	# attributes and then using API calls to setup filtering, sorting,
+	# and grouping.
+	#
+	# sql_group_column is used to declare integer attributes.
+	#
+	# sql_date_column is used to declare UNIX timestamp attributes.
+	#
+	# sql_str2ordinal_column is used to declare integer attributes which 
+	# values are computed as ordinal numbers of corresponding column value
+	# in sorted list of column values. WARNING, all such strings values
+	# are going to be stored in RAM while indexing, and "C" locale will
+	# be used when sorting!
+	#
+	# starting with 0.9.7, there may be multiple attribute columns specified.
+	# here's an example for that mentioned posts table:
+	#
+	# sql_group_column	= author_id
+	# sql_group_column	= forum_id
+	# sql_group_column	= thread_id
+	# sql_date_column		= post_unix_timestamp
+	# sql_date_column		= last_edit_unix_timestamp
+	#
+	# optional, default is empty
+	sql_group_column	= group_id
+	sql_date_column		= date_added
+	# sql_str2ordinal_column	= author_name
+
+	# post-query, executed on the end of main fetch query
+	#
+	# note that indexing is NOT completed at the point when post-query
+	# gets executed and might very well fail
+	#
+	# optional, default is empty
+	sql_query_post		=
+
+	# post-index-query, executed on succsefully completed indexing
+	#
+	# $maxid macro is the max document ID which was actually
+	# fetched from the database
+	#
+	# optional, default is empty
+	#
+	# sql_query_post_index = REPLACE INTO counters ( id, val ) \
+	#	VALUES ( 'max_indexed_id', $maxid )
+
+
+	# document info query
+	#
+	# ONLY used by search utility to display document information
+	# MUST be able to fetch document info by its id, therefore
+	# MUST contain '$id' macro 
+	#
+	# optional, default is empty
+	sql_query_info		= SELECT * FROM documents WHERE id=$id
+
+	#####################################################################
+
+	# demo config for 'xmlpipe' source type is a little below
+	#
+	# with xmlpipe, indexer opens a pipe to a given command,
+	# and then reads documents from stdin
+	#
+	# indexer expects one or more documents from xmlpipe stdin
+	# each document must be formatted exactly as follows:
+	#
+	# <document>
+	# <id>123</id>
+	# <group>45</group>
+	# <timestamp>1132223498</timestamp>
+	# <title>test title</title>
+	# <body>
+	# this is my document body
+	# </body>
+	# </document>
+	#
+	# timestamp element is optional, its default value is 1
+	# all the other elements are mandatory
+
+	# type				= xmlpipe
+	# xmlpipe_command	= cat /usr/local/var/test.xml
+}
+
+
+# inherited source example
+#
+# all the parameters are copied from the parent source,
+# and may then be overridden in this source definition
+source src1stripped : src1
+{
+	strip_html			= 1
+}
+
+#############################################################################
+## index definition
+#############################################################################
+
+# local index example
+#
+# this is an index which is stored locally in the filesystem
+#
+# all indexing-time options (such as morphology and charsets)
+# are configured per local index
+index test1
+{
+	# which document source to index
+	# at least one MUST be defined
+	#
+	# multiple sources MAY be specified; to do so, just add more
+	# "source = NAME" lines. in this case, ALL the document IDs
+	# in ALL the specified sources MUST be unique
+	source			= src1
+
+	# this is path and index file name without extension
+	#
+	# indexer will append different extensions to this path to
+	# generate names for both permanent and temporary index files
+	#
+	# .tmp* files are temporary and can be safely removed
+	# if indexer fails to remove them automatically
+	#
+	# .sp* files are fulltext index data files. specifically,
+	# .spa contains attribute values attached to each document id
+	# .spd contains doclists and hitlists
+	# .sph contains index header (schema and other settings)
+	# .spi contains wordlists
+	#
+	# MUST be defined
+	path			= /data/<%= @username %>/shared/log/indexes/test1
+
+	# docinfo (ie. per-document attribute values) storage strategy
+	# defines how docinfo will be stored
+	#
+	# available values are "none", "inline" and "extern"
+	#
+	# "none" means there'll be no docinfo at all (no groups/dates)
+	#
+	# "inline" means that the docinfo will be stored in the .spd
+	# file along with the document ID lists (doclists)
+	#
+	# "extern" means that the docinfo will be stored in the .spa
+	# file separately
+	#
+	# externally stored docinfo should (basically) be kept in RAM
+	# when querying; therefore, "inline" may be the only viable option
+	# for really huge (50-100+ million docs) datasets. however, for
+	# smaller datasets "extern" storage makes both indexing and
+	# searching MUCH more efficient.
+	#
+	# additional search-time memory requirements for extern storage are
+	#
+	#	( 1 + number_of_attrs )*number_of_docs*4 bytes
+	#
+	# so 10 million docs with 2 groups and 1 timestamp will take
+	# (1+2+1)*10M*4 = 160 MB of RAM. this is PER DAEMON, ie. searchd
+	# will alloc 160 MB on startup, read the data and keep it shared
+	# between queries; the children will NOT allocate additional
+	# copies of this data.
+	#
+	# default is "extern" (as most collections are smaller than 100M docs)
+	docinfo			= extern
+
+	# morphology
+	#
+	# currently supported morphology preprocessors are Porter stemmers
+	# for English and Russian, and Soundex. more stemmers could be added
+	# at users request.
+	#
+	# available values are "none", "stem_en", "stem_ru", "stem_enru",
+	# and "soundex"
+	#
+	# optional, default is "none"
+	#
+	# morphology		= none
+	# morphology		= stem_en
+	# morphology		= stem_ru
+	# morphology		= stem_enru
+	# morphology		= soundex
+	morphology			= none
+
+	# stopwords file
+	#
+	# format is plain text in whatever encoding you use
+	# optional, default is empty
+	#
+	# stopwords			= /usr/local/var/data/stopwords.txt
+	stopwords			=
+
+	# minimum word length
+	#
+	# only the words that are of this length and above will be indexed;
+	# for example, if min_word_len is 4, "the" won't be indexed,
+	# but "they" will be.
+	#
+	# default is 1, which (obviously) means to index everything
+	min_word_len		= 1
+
+	# charset encoding type
+	#
+	# known types are 'sbcs' (Single Byte CharSet) and 'utf-8'
+	#
+	# optional, default is sbcs
+	charset_type		= sbcs
+
+	# charset definition and case folding rules "table"
+	#
+	# optional, default value depends on charset_type
+	#
+	# for now, defaults are configured to support English and Russian
+	# this behavior MAY change in future versions
+	#
+	# 'sbcs' default value is
+	# charset_table		= 0..9, A..Z->a..z, _, a..z, U+A8->U+B8, U+B8, U+C0..U+DF->U+E0..U+FF, U+E0..U+FF
+	#
+	# 'utf-8' default value is
+	# charset_table		= 0..9, A..Z->a..z, _, a..z, U+410..U+42F->U+430..U+44F, U+430..U+44F
+
+	# minimum prefix length
+	#
+	# if prefix length is positive, indexer will not only index all words,
+	# but all the possible prefixes (ie. word beginnings) as well
+	#
+	# for instance, "exam" query against such index will match documents
+	# which contain "example" word, even if they do not contain "exam"
+	#
+	# indexing prefixes will make the index grow significantly
+	# and could degrade search times
+	#
+	# currently there's no way to rank perfect word matches higher
+	# than prefix matches using only one index; you could setup two
+	# indexes for that
+	#
+	# default is 0, which means NOT to index prefixes
+	min_prefix_len		= 0
+
+	# minimum infix length
+	#
+	# if infix length is positive, indexer will not only index all words,
+	# but all the possible infixes (ie. characters subsequences starting
+	# anywhere inside the word) as well
+	#
+	# for instance, "amp" query against such index will match documents
+	# which contain "example" word, even if they do not contain "amp"
+	#
+	# indexing prefixes will make the index grow significantly
+	# and could degrade search times
+	#
+	# currently there's no way to rank perfect word matches higher
+	# than infix matches using only one index; you could setup two
+	# indexes for that
+	#
+	# default is 0, which means NOT to index infixes
+	min_infix_len		= 0
+
+	# n-grams length
+	#
+	# n-grams provide basic CJK support for unsegmented texts. if using
+	# n-grams, streams of CJK characters are indexed as n-grams. for example,
+	# if incoming stream is ABCDEF and n is 2, this text would be indexed
+	# as if it was AB BC CD DE EF.
+	#
+	# this feature is in alpha version state and only n=1 is currently
+	# supported; this is going to be improved.
+	#
+	# note that if search query is segmented (ie. words are separated with
+	# whitespace), words are in quotes and extended matching mode is used,
+	# then all matching documents will be returned even if their text was
+	# *not* segmented. in the example above, ABCDEF text will be indexed as
+	# A B C D E F, and "BCD" query will be transformed to "B C D" (where
+	# quotes is phrase matching operator), so the document will match.
+	#
+	# optional, default is 0, which means NOT to use n-grams
+	#
+	# ngram_len = 1
+
+	# n-gram characters table
+	#
+	# specifies what specific characters are subject to n-gram
+	# extraction. format is similar to charset_table.
+	#
+	# optional, default is empty
+	#
+	# ngrams_chars = U+3000..U+2FA1F
+}
+
+
+# inherited index example
+#
+# all the parameters are copied from the parent index,
+# and may then be overridden in this index definition
+index test1stemmed : test1
+{
+	path			= /data/<%= @username %>/shared/log/indexes/test1stemmed
+	morphology		= stem_en
+}
+
+
+# distributed index example
+#
+# this is a virtual index which can NOT be directly indexed,
+# and only contains references to other local and/or remote indexes
+#
+# if searchd receives a query against this index,
+# it does the following:
+#
+# 1) connects to all the specified remote agents,
+# 2) issues the query,
+# 3) searches local indexes (while the remote agents are searching),
+# 4) collects remote search results,
+# 5) merges all the results together (removing the duplicates),
+# 6) sends the merged resuls to client.
+#
+# this index type is primarily intenteded to be able to split huge (100GB+)
+# datasets into chunks placed on different physical servers and them search
+# through those chunks in parallel, reducing response times and server load;
+# it seems, however, that it could also be used to take advantage of
+# multi-processor systems or to implement HA (high-availability) search.
+index dist1
+{
+	# 'distributed' index type MUST be specified
+	type				= distributed
+
+	# local index to be searched
+	# there can be many local indexes configured
+	local				= test1
+	local				= test1stemmed
+
+	# remote agent
+	# multiple remote agents may be specified
+	# syntax is 'hostname:port:index1,[index2[,...]]
+	agent				= localhost:3313:remote1
+	agent				= localhost:3314:remote2,remote3
+
+	# remote agent connection timeout, milliseconds
+	# optional, default is 1000 ms, ie. 1 sec
+	agent_connect_timeout	= 1000
+
+	# remote agent query timeout, milliseconds
+	# optional, default is 3000 ms, ie. 3 sec
+	agent_query_timeout		= 3000
+}
+
+#############################################################################
+## indexer settings
+#############################################################################
+
+indexer
+{
+	# memory limit
+	#
+	# may be specified in bytes (no postfix), kilobytes (mem_limit=1000K)
+	# or megabytes (mem_limit=10M)
+	#
+	# will grow if set unacceptably low
+	# will warn if set too low and potentially hurting the performance
+	#
+	# optional, default is 32M
+	mem_limit			= 32M
+}
+
+#############################################################################
+## searchd settings
+#############################################################################
+
+searchd
+{
+	# IP address on which search daemon will bind and accept
+	# incoming network requests
+	#
+	# optional, default is to listen on all addresses,
+	# ie. address = 0.0.0.0
+	#
+	# address				= 127.0.0.1
+	# address				= 192.168.0.1
+
+
+	# port on which search daemon will listen
+	port				= 3312
+
+
+	# log file
+	# searchd run info is logged here
+	log					= /var/log/engineyard/sphinx/<%= @username %>/searchd.log
+
+
+	# query log file
+	# all the search queries are logged here
+	query_log			= /var/log/engineyard/sphinx/<%= @username %>/searchd_query.log
+
+
+	# client read timeout, seconds
+	read_timeout		= 5
+
+
+	# maximum amount of children to fork
+	# useful to control server load
+	max_children		= 30
+
+
+	# a file which will contain searchd process ID
+	# used for different external automation scripts
+	# MUST be present
+	pid_file			= /data/<%= @username %>/shared/log/searchd.pid
+
+
+	# maximum amount of matches this daemon would ever retrieve
+	# from each index and serve to client
+	#
+	# this parameter affects per-client memory and CPU usage
+	# (16+ bytes per match) in match sorting phase; so blindly raising
+	# it to 1 million is definitely NOT recommended
+	#
+	# starting from 0.9.7, it can be decreased on the fly through
+	# the corresponding API call; increasing is prohibited to protect
+	# against malicious and/or malformed requests
+	#
+	# default is 1000 (just like with Google)
+	max_matches			= 1000
+}
+
+# --eof--