prestogres 0.1.0

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/extensiontask'
+
+spec = eval File.read("prestogres.gemspec")
+Rake::ExtensionTask.new('prestogres', spec) do |ext|
+  ext.cross_compile = true
+  ext.lib_dir = File.join(*['lib', 'prestogres', ENV['FAT_DIR']].compact)
+  #ext.cross_platform = 'i386-mswin32'
+end
+
+task :default => [:build]

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/bin/prestogres

@@ -0,0 +1,254 @@
+#!/usr/bin/env ruby
+
+config = {
+  data_dir: nil,
+  command: nil,
+  binary: nil,
+}
+
+def usage(error=nil)
+  puts "usage: #{File.basename($0)} -D <data dir> <command>"
+  puts "commands:"
+  puts "  setup                 setup <data dir>"
+  puts "  pgpool                start pgpool as a daemon process"
+  puts "  pgpool stop           stop  pgpool daemon process"
+  puts "  pgpool -n             start pgpool as a foreground process"
+  puts "  pg_ctl start          start postgres server as a daemon process"
+  puts "  pg_ctl stop           stop  postgres server daemon process"
+  puts "  postgres              start postgres server as a foreground process"
+  puts "  passwd <USER NAME>    add new md5 password entry for an user"
+  puts ""
+  puts "error: #{error}" if error
+  exit 0
+end
+
+config_key = false
+
+arg_offset = 0
+ARGV.each_with_index do |a,i|
+  arg_offset = i + 1
+
+  if config_key
+    config[config_key] = a
+    config_key = nil
+    next
+  end
+
+  case a
+  when "-D"
+    config_key = :data_dir
+  when "-h", "-?", "--help"
+    config[:command] = :help
+  when "setup"
+    config[:command] = :setup
+  when "pgpool"
+    config[:command] = :pgpool
+    break
+  when "pg_ctl"
+    config[:command] = :pg_ctl
+    break
+  when "postgres"
+    config[:command] = :postgres
+    break
+  when "passwd"
+    config[:command] = :passwd
+    break
+  end
+end
+
+usage nil if config_key
+usage nil unless config[:command]
+
+args = ARGV[arg_offset..-1]
+
+setup_params = {
+ port: 9900,
+ backend_port: 6432,
+ pgpool_pid_file: nil,
+ pgpool_status_dir: nil,
+ unix_socket_directory: nil,
+}
+
+case config[:command]
+when :help
+  usage nil
+
+when :setup
+  unless config[:data_dir]
+    usage "-D option is required"
+  end
+  unless args.empty?
+    usage nil
+  end
+
+  require "erb"
+  require "fileutils"
+
+  def run_setup_command(cmdline)
+    if cmdline.is_a?(Array)
+      puts "setup> #{cmdline.join(' ')}"
+      system *cmdline
+    else
+      puts "setup> #{cmdline}"
+      system cmdline
+    end
+    unless $?.success?
+      puts "******************"
+      puts "** setup failed **"
+      puts "******************"
+      puts ""
+      puts "-D directory is inconsistent."
+      puts "If you're running command on Mac OS X, you might need to run following commands:"
+      puts ""
+      puts "  $ sudo sysctl -w kern.sysv.shmmax=1073741824"
+      puts "  $ sudo sysctl -w kern.sysv.shmall=1073741824"
+      puts ""
+      puts "Please delete the directory (rm -rf) first before retrying."
+      puts ""
+      exit 1
+    end
+  end
+
+  config_src_dir = File.join(File.dirname(__FILE__), "..", "config")
+  pgsql_dir = File.join(File.dirname(__FILE__), "..", "pgsql")
+
+  puts "Setting up '#{config[:data_dir]}'..."
+  data_dir = File.expand_path(config[:data_dir])
+
+  @config = setup_params  # used by erb files
+  @config[:pgpool_pid_file] = File.join(data_dir, "run", "pgpool.pid")
+  @config[:pgpool_status_dir] = File.join(data_dir, "run")
+  @config[:unix_socket_directory] = File.join(data_dir, "run")
+
+  # log & socket dirs
+  FileUtils.mkdir_p File.join(data_dir, "log")
+  FileUtils.mkdir_p File.join(data_dir, "run")
+
+  # pgpool
+  FileUtils.mkdir_p File.join(data_dir, "pgpool")
+  %w[pcp.conf.sample pgpool.conf pool_hba.conf pool_passwd].each do |fname|
+    File.open(File.join(data_dir, "pgpool", fname), "w") {|f|
+      f.write ERB.new(File.read(File.join(config_src_dir, fname))).result
+    }
+  end
+
+  # postgresql
+  run_setup_command %w[initdb -U pg --no-locale -E UNICODE] + [File.join(data_dir, "postgres")]
+  File.open(File.join(data_dir, "postgres", "postgresql.conf"), "a") {|f|
+    f.write ERB.new(File.read(File.join(config_src_dir, "postgresql.conf"))).result
+  }
+
+  # setup functions
+  run_setup_command %w[pg_ctl -D] + [File.join(data_dir, 'postgres')] + %w[start]
+  begin
+    sleep 1
+
+    run_setup_command "psql -h 127.0.0.1 -p #{setup_params[:backend_port]} -U pg postgres < #{File.join(pgsql_dir, "setup_language.sql")}"
+    run_setup_command "psql -h 127.0.0.1 -p #{setup_params[:backend_port]} -U pg postgres < #{File.join(pgsql_dir, "setup_functions.sql")}"
+  ensure
+    run_setup_command %w[pg_ctl -D] + [File.join(data_dir, 'postgres')] + %w[stop]
+  end
+
+  puts <<EOF
+
+************************************************************
+**         PostgreSQL protocol gateway for Presto         **
+************************************************************
+
+           +------------+   +------------+   +--------+
+  client ---> pgpool-II ----> PostgreSQL ----> Presto |
+           +------------+   +------------+   +--------+
+           rewrite query     proxy           run query
+
+You can run queries on Presto as following:
+
+  * Set presto_server and presto_catalog to pgpool.conf:
+    #{config[:data_dir]}/pgpool/pgpool.conf
+
+  * Start pgpool-II:
+    $ prestogres -D "#{config[:data_dir]}" pgpool
+    (stop> prestogres -D "#{config[:data_dir]}" pgpool stop)
+
+  * Start PostgreSQL:
+    $ prestogres -D "#{config[:data_dir]}" pg_ctl start
+    (stop> prestogres -D "#{config[:data_dir]}" pg_ctl stop)
+
+  * Connect to pgpool-II:
+    $ psql -h localhost -p #{setup_params[:port]} -U pg postgres
+
+  If you run PostgreSQL on Mac OS X, you need to run following commands:
+
+    $ sudo sysctl -w kern.sysv.shmmax=1073741824
+    $ sudo sysctl -w kern.sysv.shmall=1073741824
+
+You need to update 'presto_server' and 'presto_catalog' in
+pgpool.conf at least.
+
+EOF
+
+when :passwd
+  if args.empty?
+    usage nil
+  end
+  unless config[:data_dir]
+    usage "-D option is required"
+  end
+
+  require "prestogres_config"
+  prefix = Prestogres::CONFIG["prefix"]
+  binary = File.join(prefix, "bin", 'pg_md5')
+
+  data_dir = config[:data_dir]
+  args = ["-f", File.join(data_dir, "pgpool", "pgpool.conf"), "-p", "-m", "-u"].concat(args)
+
+  puts "#{binary} #{args.join(' ')}"
+  system binary, *args
+
+  if $?.success?
+    puts "Successfully pdated pgpool/pool_passwd file. Edit pgpool/pool_passwd file directly to remove the entry."
+  else
+    exit $?.exitstatus
+  end
+
+else
+  unless config[:data_dir]
+    usage "-D option is required"
+  end
+  require "prestogres_config"
+
+  if config[:command] == :pgpool
+    prefix = Prestogres::CONFIG["prefix"]
+    binary = File.join(prefix, "bin", config[:command].to_s)
+  else
+    # TODO configurable postgres install prefix (by ENV?)
+    binary = config[:command].to_s
+  end
+
+  pgsql_dir = File.expand_path File.join(File.dirname(__FILE__), "..", "pgsql")
+  ENV['PYTHONPATH'] = [pgsql_dir, ENV['PYTHONPATH']].compact.join(':')
+
+  data_dir = config[:data_dir]
+  case config[:command]
+  when :pgpool
+    args = ["--pcp-file", File.join(data_dir, "pgpool", "pcp.conf")].concat(args)
+    args = ["--hba-file", File.join(data_dir, "pgpool", "pool_hba.conf")].concat(args)
+    args = ["--config-file", File.join(data_dir, "pgpool", "pgpool.conf")].concat(args)
+  when :pg_ctl
+    args = ["-D", File.join(data_dir, "postgres")].concat(args)
+    args = ["-l", File.join(data_dir, "log", "postgres.log")].concat(args)
+  when :postgres
+    args = ["-D", File.join(data_dir, "postgres")].concat(args)
+  end
+
+  puts "PYTHONPATH=#{ENV['PYTHONPATH']}"
+  puts "#{binary} #{args.join(' ')}"
+
+  if Kernel.respond_to?(:exec)
+    exec binary, *args
+  else
+    system binary, *args
+    exit $?.exitstatus
+  end
+
+end
+

data/config/pcp.conf.sample

@@ -0,0 +1,28 @@
+# PCP Client Authentication Configuration File
+# ============================================
+#
+# This file contains user ID and his password for pgpool
+# communication manager authentication.
+#
+# Note that users defined here do not need to be PostgreSQL
+# users. These users are authorized ONLY for pgpool 
+# communication manager.
+#
+# File Format
+# ===========
+#
+# List one UserID and password on a single line. They must
+# be concatenated together using ':' (colon) between them.
+# No spaces or tabs are allowed anywhere in the line.
+#
+# Example:
+# postgres:e8a48653851e28c69d0506508fb27fc5
+#
+# Be aware that there will be no spaces or tabs at the
+# beginning of the line! although the above example looks
+# like so.
+#
+# Lines beginning with '#' (pound) are comments and will
+# be ignored. Again, no spaces or tabs allowed before '#'.
+
+# USERID:MD5PASSWD

data/config/pgpool.conf

@@ -0,0 +1,678 @@
+# ----------------------------
+# pgPool-II configuration file
+# ----------------------------
+#
+# This file consists of lines of the form:
+#
+#   name = value
+#
+# Whitespace may be used.  Comments are introduced with "#" anywhere on a line.
+# The complete list of parameter names and allowed values can be found in the
+# pgPool-II documentation.
+#
+# This file is read on server startup and when the server receives a SIGHUP
+# signal.  If you edit the file on a running system, you have to SIGHUP the
+# server for the changes to take effect, or use "pgpool reload".  Some
+# parameters, which are marked below, require a server shutdown and restart to
+# take effect.
+#
+
+
+#------------------------------------------------------------------------------
+# CONNECTIONS
+#------------------------------------------------------------------------------
+
+# - pgpool Connection Settings -
+
+listen_addresses = 'localhost'
+                                   # Host name or IP address to listen on:
+                                   # '*' for all, '' for no TCP/IP connections
+                                   # (change requires restart)
+port = <%= @config[:port] %>
+                                   # Port number
+                                   # (change requires restart)
+socket_dir = '<%= @config[:unix_socket_directory] %>'
+                                   # Unix domain socket path
+                                   # The Debian package defaults to
+                                   # /var/run/postgresql
+                                   # (change requires restart)
+
+# - Presto Settings -
+presto_server = 'localhost:8080'
+                                   # Address of Presto server.
+                                   # You can overwrite this parameter depending
+                                   # on user, database, or client address using
+                                   # pool_hba.conf.
+presto_catalog = 'native'
+                                   # Catalog name of Presto.
+                                   # You can overwrite this parameter depending
+                                   # on user, database, or client address using
+                                   # pool_hba.conf.
+presto_schema = 'default'
+                                   # Default schema name of Presto.
+                                   # You can overwrite this parameter depending
+                                   # on user, database, or client address using
+                                   # pool_hba.conf.
+
+# - pgpool Communication Manager Connection Settings -
+
+pcp_port = 9898
+                                   # Port number for pcp
+                                   # (change requires restart)
+pcp_socket_dir = '<%= @config[:unix_socket_directory] %>'
+                                   # Unix domain socket path for pcp
+                                   # The Debian package defaults to
+                                   # /var/run/postgresql
+                                   # (change requires restart)
+
+# - Backend Connection Settings -
+
+backend_hostname0 = '127.0.0.1'
+                                   # Host name or IP address to connect to for backend 0
+backend_port0 = <%= @config[:backend_port] %>
+                                   # Port number for backend 0
+backend_weight0 = 0
+                                   # Weight for backend 0 (only in load balancing mode)
+#backend_data_directory0 = '/data'
+                                   # Data directory for backend 0
+backend_flag0 = 'DISALLOW_TO_FAILOVER'
+                                   # Controls various backend behavior
+                                   # ALLOW_TO_FAILOVER or DISALLOW_TO_FAILOVER
+
+
+# - Authentication -
+
+enable_pool_hba = on
+                                   # Use pool_hba.conf for client authentication
+pool_passwd = 'pool_passwd'
+                                   # File name of pool_passwd for md5 authentication.
+                                   # "" disables pool_passwd.
+                                   # (change requires restart)
+authentication_timeout = 60
+                                   # Delay in seconds to complete client authentication
+                                   # 0 means no timeout.
+
+# - SSL Connections -
+
+ssl = off
+                                   # Enable SSL support
+                                   # (change requires restart)
+#ssl_key = './server.key'
+                                   # Path to the SSL private key file
+                                   # (change requires restart)
+#ssl_cert = './server.cert'
+                                   # Path to the SSL public certificate file
+                                   # (change requires restart)
+#ssl_ca_cert = ''
+                                   # Path to a single PEM format file
+                                   # containing CA root certificate(s)
+                                   # (change requires restart)
+#ssl_ca_cert_dir = ''
+                                   # Directory containing CA root certificate(s)
+                                   # (change requires restart)
+
+
+#------------------------------------------------------------------------------
+# POOLS
+#------------------------------------------------------------------------------
+
+# - Pool size -
+
+num_init_children = 32
+                                   # Number of pools
+                                   # (change requires restart)
+max_pool = 4
+                                   # Number of connections per pool
+                                   # (change requires restart)
+
+# - Life time -
+
+child_life_time = 300
+                                   # Pool exits after being idle for this many seconds
+child_max_connections = 0
+                                   # Pool exits after receiving that many connections
+                                   # 0 means no exit
+connection_life_time = 0
+                                   # Connection to backend closes after being idle for this many seconds
+                                   # 0 means no close
+client_idle_limit = 0
+                                   # Client is disconnected after being idle for that many seconds
+                                   # (even inside an explicit transactions!)
+                                   # 0 means no disconnection
+
+
+#------------------------------------------------------------------------------
+# LOGS
+#------------------------------------------------------------------------------
+
+# - Where to log -
+
+log_destination = 'stderr'
+                                   # Where to log
+                                   # Valid values are combinations of stderr,
+                                   # and syslog. Default to stderr.
+
+# - What to log -
+
+print_timestamp = on
+                                   # Print timestamp on each line
+                                   # (change requires restart)
+
+log_connections = off
+                                   # Log connections
+log_hostname = off
+                                   # Hostname will be shown in ps status
+                                   # and in logs if connections are logged
+log_statement = off
+                                   # Log all statements
+log_per_node_statement = off
+                                   # Log all statements
+                                   # with node and backend informations
+log_standby_delay = 'none'
+                                   # Log standby delay
+                                   # Valid values are combinations of always,
+                                   # if_over_threshold, none
+
+# - Syslog specific -
+
+syslog_facility = 'LOCAL0'
+                                   # Syslog local facility. Default to LOCAL0
+syslog_ident = 'pgpool'
+                                   # Syslog program identification string
+                                   # Default to 'pgpool'
+
+# - Debug -
+
+debug_level = 0
+                                   # Debug message verbosity level
+                                   # 0 means no message, 1 or more mean verbose
+
+
+#------------------------------------------------------------------------------
+# FILE LOCATIONS
+#------------------------------------------------------------------------------
+
+pid_file_name = '<%= @config[:pgpool_pid_file] %>'
+                                   # PID file name
+                                   # (change requires restart)
+logdir = '<%= @config[:pgpool_status_dir] %>'
+                                   # Directory of pgPool status file
+                                   # (change requires restart)
+
+
+#------------------------------------------------------------------------------
+# CONNECTION POOLING
+#------------------------------------------------------------------------------
+
+connection_cache = on
+                                   # Activate connection pools
+                                   # (change requires restart)
+
+                                   # Semicolon separated list of queries
+                                   # to be issued at the end of a session
+                                   # The default is for 8.3 and later
+reset_query_list = 'ABORT; DISCARD ALL'
+                                   # The following one is for 8.2 and before
+#reset_query_list = 'ABORT; RESET ALL; SET SESSION AUTHORIZATION DEFAULT'
+
+
+#------------------------------------------------------------------------------
+# REPLICATION MODE
+#------------------------------------------------------------------------------
+
+replication_mode = off
+                                   # Activate replication mode
+                                   # (change requires restart)
+replicate_select = off
+                                   # Replicate SELECT statements
+                                   # when in replication or parallel mode
+                                   # replicate_select is higher priority than
+                                   # load_balance_mode.
+
+insert_lock = off
+                                   # Automatically locks a dummy row or a table
+                                   # with INSERT statements to keep SERIAL data
+                                   # consistency
+                                   # Without SERIAL, no lock will be issued
+lobj_lock_table = ''
+                                   # When rewriting lo_creat command in
+                                   # replication mode, specify table name to
+                                   # lock
+
+# - Degenerate handling -
+
+replication_stop_on_mismatch = off
+                                   # On disagreement with the packet kind
+                                   # sent from backend, degenerate the node
+                                   # which is most likely "minority"
+                                   # If off, just force to exit this session
+
+failover_if_affected_tuples_mismatch = off
+                                   # On disagreement with the number of affected
+                                   # tuples in UPDATE/DELETE queries, then
+                                   # degenerate the node which is most likely
+                                   # "minority".
+                                   # If off, just abort the transaction to
+                                   # keep the consistency
+
+
+#------------------------------------------------------------------------------
+# LOAD BALANCING MODE
+#------------------------------------------------------------------------------
+
+load_balance_mode = on
+                                   # Activate load balancing mode
+                                   # (change requires restart)
+ignore_leading_white_space = on
+                                   # Ignore leading white spaces of each query
+white_function_list = ''
+                                   # Comma separated list of function names
+                                   # that don't write to database
+                                   # Regexp are accepted
+black_function_list = 'currval,lastval,nextval,setval,current_setting'
+                                   # Comma separated list of function names
+                                   # that write to database
+                                   # Regexp are accepted
+
+
+#------------------------------------------------------------------------------
+# MASTER/SLAVE MODE
+#------------------------------------------------------------------------------
+
+master_slave_mode = on
+                                   # Activate master/slave mode
+                                   # (change requires restart)
+master_slave_sub_mode = 'slony'
+                                   # Master/slave sub mode
+                                   # Valid values are combinations slony or
+                                   # stream. Default is slony.
+                                   # (change requires restart)
+
+# - Streaming -
+
+sr_check_period = 0
+                                   # Streaming replication check period
+                                   # Disabled (0) by default
+sr_check_user = 'nobody'
+                                   # Streaming replication check user
+                                   # This is neccessary even if you disable streaming
+                                   # replication delay check by sr_check_period = 0
+sr_check_password = ''
+                                   # Password for streaming replication check user
+delay_threshold = 0
+                                   # Threshold before not dispatching query to standby node
+                                   # Unit is in bytes
+                                   # Disabled (0) by default
+
+# - Special commands -
+
+follow_master_command = ''
+                                   # Executes this command after master failover
+                                   # Special values:
+                                   #   %d = node id
+                                   #   %h = host name
+                                   #   %p = port number
+                                   #   %D = database cluster path
+                                   #   %m = new master node id
+                                   #   %H = hostname of the new master node
+                                   #   %M = old master node id
+                                   #   %P = old primary node id
+								   #   %r = new master port number
+								   #   %R = new master database cluster path
+                                   #   %% = '%' character
+
+
+#------------------------------------------------------------------------------
+# PARALLEL MODE
+#------------------------------------------------------------------------------
+
+parallel_mode = off
+                                   # Activates parallel query mode
+                                   # (change requires restart)
+pgpool2_hostname = ''
+                                   # Set pgpool2 hostname
+                                   # (change requires restart)
+
+# - System DB info -
+
+#system_db_hostname  = 'localhost'
+                                   # (change requires restart)
+#system_db_port = 5432
+                                   # (change requires restart)
+#system_db_dbname = 'pgpool'
+                                   # (change requires restart)
+#system_db_schema = 'pgpool_catalog'
+                                   # (change requires restart)
+#system_db_user = 'pgpool'
+                                   # (change requires restart)
+#system_db_password = ''
+                                   # (change requires restart)
+
+
+#------------------------------------------------------------------------------
+# HEALTH CHECK
+#------------------------------------------------------------------------------
+
+health_check_period = 0
+                                   # Health check period
+                                   # Disabled (0) by default
+health_check_timeout = 20
+                                   # Health check timeout
+                                   # 0 means no timeout
+health_check_user = 'nobody'
+                                   # Health check user
+health_check_password = ''
+                                   # Password for health check user
+health_check_max_retries = 0
+                                   # Maximum number of times to retry a failed health check before giving up.
+health_check_retry_delay = 1
+                                   # Amount of time to wait (in seconds) between retries.
+
+
+#------------------------------------------------------------------------------
+# FAILOVER AND FAILBACK
+#------------------------------------------------------------------------------
+
+failover_command = ''
+                                   # Executes this command at failover
+                                   # Special values:
+                                   #   %d = node id
+                                   #   %h = host name
+                                   #   %p = port number
+                                   #   %D = database cluster path
+                                   #   %m = new master node id
+                                   #   %H = hostname of the new master node
+                                   #   %M = old master node id
+                                   #   %P = old primary node id
+								   #   %r = new master port number
+								   #   %R = new master database cluster path
+
+                                   #   %% = '%' character
+failback_command = ''
+                                   # Executes this command at failback.
+                                   # Special values:
+                                   #   %d = node id
+                                   #   %h = host name
+                                   #   %p = port number
+                                   #   %D = database cluster path
+                                   #   %m = new master node id
+                                   #   %H = hostname of the new master node
+                                   #   %M = old master node id
+                                   #   %P = old primary node id
+								   #   %r = new master port number
+								   #   %R = new master database cluster path
+                                   #   %% = '%' character
+
+fail_over_on_backend_error = on
+                                   # Initiates failover when reading/writing to the
+                                   # backend communication socket fails
+                                   # If set to off, pgpool will report an
+                                   # error and disconnect the session.
+
+search_primary_node_timeout = 10
+                                   # Timeout in seconds to search for the
+                                   # primary node when a failover occurs.
+                                   # 0 means no timeout, keep searching
+                                   # for a primary node forever.
+
+#------------------------------------------------------------------------------
+# ONLINE RECOVERY
+#------------------------------------------------------------------------------
+
+recovery_user = 'nobody'
+                                   # Online recovery user
+recovery_password = ''
+                                   # Online recovery password
+recovery_1st_stage_command = ''
+                                   # Executes a command in first stage
+recovery_2nd_stage_command = ''
+                                   # Executes a command in second stage
+recovery_timeout = 90
+                                   # Timeout in seconds to wait for the
+                                   # recovering node's postmaster to start up
+                                   # 0 means no wait
+client_idle_limit_in_recovery = 0
+                                   # Client is disconnected after being idle
+                                   # for that many seconds in the second stage
+                                   # of online recovery
+                                   # 0 means no disconnection
+                                   # -1 means immediate disconnection
+
+
+#------------------------------------------------------------------------------
+# WATCHDOG
+#------------------------------------------------------------------------------
+
+# - Enabling -
+
+use_watchdog = off
+                                    # Activates watchdog
+                                    # (change requires restart)
+
+# -Connection to up stream servers -
+
+trusted_servers = ''
+                                    # trusted server list which are used
+                                    # to confirm network connection
+                                    # (hostA,hostB,hostC,...)
+                                    # (change requires restart)
+ping_path = '/bin'
+                                    # ping command path
+                                    # (change requires restart)
+
+# - Watchdog communication Settings -
+
+wd_hostname = ''
+                                    # Host name or IP address of this watchdog
+                                    # (change requires restart)
+wd_port = 9000
+                                    # port number for watchdog service
+                                    # (change requires restart)
+wd_authkey = ''
+                                    # Authentication key for watchdog communication
+                                    # (change requires restart)
+
+# - Virtual IP control Setting -
+
+delegate_IP = ''
+                                    # delegate IP address
+                                    # If this is empty, virtual IP never bring up. 
+                                    # (change requires restart)
+ifconfig_path = '/sbin'
+                                    # ifconfig command path
+                                    # (change requires restart)
+if_up_cmd = 'ifconfig eth0:0 inet $_IP_$ netmask 255.255.255.0'
+                                    # startup delegate IP command
+                                    # (change requires restart)
+if_down_cmd = 'ifconfig eth0:0 down'
+                                    # shutdown delegate IP command
+                                    # (change requires restart)
+
+arping_path = '/usr/sbin'           # arping command path
+                                    # (change requires restart)
+
+arping_cmd = 'arping -U $_IP_$ -w 1'
+                                    # arping command
+                                    # (change requires restart)
+
+# - Behaivor on escalation Setting -
+
+clear_memqcache_on_escalation = on
+                                    # Clear all the query cache on shared memory
+                                    # when standby pgpool escalate to active pgpool
+                                    # (= virtual IP holder).
+                                    # This should be off if client connects to pgpool
+                                    # not using virtual IP.
+                                    # (change requires restart)
+wd_escalation_command = ''
+                                    # Executes this command at escalation on new active pgpool.
+                                    # (change requires restart)
+
+# - Lifecheck Setting - 
+
+# -- common --
+
+wd_lifecheck_method = 'heartbeat'
+                                    # Method of watchdog lifecheck ('heartbeat' or 'query')
+                                    # (change requires restart)
+wd_interval = 10
+                                    # lifecheck interval (sec) > 0
+                                    # (change requires restart)
+
+# -- heartbeat mode --
+
+wd_heartbeat_port = 9694
+                                    # Port number for receiving heartbeat signal
+                                    # (change requires restart)
+wd_heartbeat_keepalive = 2
+                                    # Interval time of sending heartbeat signal (sec)
+                                    # (change requires restart)
+wd_heartbeat_deadtime = 30
+                                    # Deadtime interval for heartbeat signal (sec)
+                                    # (change requires restart)
+heartbeat_destination0 = 'host0_ip1'
+                                    # Host name or IP address of destination 0
+                                    # for sending heartbeat signal.
+                                    # (change requires restart)
+heartbeat_destination_port0 = 9694 
+                                    # Port number of destination 0 for sending
+                                    # heartbeat signal. Usually this is the
+                                    # same as wd_heartbeat_port.
+                                    # (change requires restart)
+heartbeat_device0 = ''
+                                    # Name of NIC device (such like 'eth0')
+                                    # used for sending/receiving heartbeat
+                                    # signal to/from destination 0.
+                                    # This works only when this is not empty
+                                    # and pgpool has root privilege.
+                                    # (change requires restart)
+
+#heartbeat_destination1 = 'host0_ip2'
+#heartbeat_destination_port1 = 9694
+#heartbeat_device1 = ''
+
+# -- query mode --
+
+wd_life_point = 3
+                                    # lifecheck retry times
+                                    # (change requires restart)
+wd_lifecheck_query = 'SELECT 1'
+                                    # lifecheck query to pgpool from watchdog
+                                    # (change requires restart)
+wd_lifecheck_dbname = 'template1'
+                                    # Database name connected for lifecheck
+                                    # (change requires restart)
+wd_lifecheck_user = 'nobody'
+                                    # watchdog user monitoring pgpools in lifecheck
+                                    # (change requires restart)
+wd_lifecheck_password = ''
+                                    # Password for watchdog user in lifecheck
+                                    # (change requires restart)
+
+# - Other pgpool Connection Settings -
+
+#other_pgpool_hostname0 = 'host0'
+                                    # Host name or IP address to connect to for other pgpool 0
+                                    # (change requires restart)
+#other_pgpool_port0 = 5432
+                                    # Port number for othet pgpool 0
+                                    # (change requires restart)
+#other_wd_port0 = 9000
+                                    # Port number for othet watchdog 0
+                                    # (change requires restart)
+#other_pgpool_hostname1 = 'host1'
+#other_pgpool_port1 = 5432
+#other_wd_port1 = 9000
+
+
+#------------------------------------------------------------------------------
+# OTHERS
+#------------------------------------------------------------------------------
+relcache_expire = 1
+                                   # Life time of relation cache in seconds.
+                                   # 0 means no cache expiration(the default).
+                                   # The relation cache is used for cache the
+                                   # query result against PostgreSQL system
+                                   # catalog to obtain various information
+                                   # including table structures or if it's a
+                                   # temporary table or not. The cache is
+                                   # maintained in a pgpool child local memory
+                                   # and being kept as long as it survives.
+                                   # If someone modify the table by using
+                                   # ALTER TABLE or some such, the relcache is
+                                   # not consistent anymore.
+                                   # For this purpose, cache_expiration
+                                   # controls the life time of the cache.
+
+relcache_size = 256
+                                   # Number of relation cache
+                                   # entry. If you see frequently:
+								   # "pool_search_relcache: cache replacement happend"
+								   # in the pgpool log, you might want to increate this number.
+
+check_temp_table = off
+                                   # If on, enable temporary table check in SELECT statements.
+                                   # This initiates queries against system catalog of primary/master
+								   # thus increases load of master.
+								   # If you are absolutely sure that your system never uses temporary tables
+								   # and you want to save access to primary/master, you could turn this off.
+								   # Default is on.
+
+
+#------------------------------------------------------------------------------
+# ON MEMORY QUERY MEMORY CACHE
+#------------------------------------------------------------------------------
+memory_cache_enabled = off
+								   # If on, use the memory cache functionality, off by default
+memqcache_method = 'shmem'
+								   # Cache storage method. either 'shmem'(shared memory) or
+								   # 'memcached'. 'shmem' by default
+                                   # (change requires restart)
+memqcache_memcached_host = 'localhost'
+								   # Memcached host name or IP address. Mandatory if
+								   # memqcache_method = 'memcached'.
+								   # Defaults to localhost.
+                                   # (change requires restart)
+memqcache_memcached_port = 11211
+								   # Memcached port number. Mondatory if memqcache_method = 'memcached'.
+								   # Defaults to 11211.
+                                   # (change requires restart)
+memqcache_total_size = 67108864
+								   # Total memory size in bytes for storing memory cache.
+								   # Mandatory if memqcache_method = 'shmem'.
+								   # Defaults to 64MB.
+                                   # (change requires restart)
+memqcache_max_num_cache = 1000000
+								   # Total number of cache entries. Mandatory
+								   # if memqcache_method = 'shmem'.
+								   # Each cache entry consumes 48 bytes on shared memory.
+								   # Defaults to 1,000,000(45.8MB).
+                                   # (change requires restart)
+memqcache_expire = 0
+								   # Memory cache entry life time specified in seconds.
+								   # 0 means infinite life time. 0 by default.
+                                   # (change requires restart)
+memqcache_auto_cache_invalidation = on
+								   # If on, invalidation of query cache is triggered by corresponding
+								   # DDL/DML/DCL(and memqcache_expire).  If off, it is only triggered
+								   # by memqcache_expire.  on by default.
+                                   # (change requires restart)
+memqcache_maxcache = 409600
+								   # Maximum SELECT result size in bytes.
+								   # Must be smaller than memqcache_cache_block_size. Defaults to 400KB.
+                                   # (change requires restart)
+memqcache_cache_block_size = 1048576
+								   # Cache block size in bytes. Mandatory if memqcache_method = 'shmem'.
+								   # Defaults to 1MB.
+                                   # (change requires restart)
+memqcache_oiddir = '/var/log/pgpool/oiddir'
+				   				   # Temporary work directory to record table oids
+                                   # (change requires restart)
+white_memqcache_table_list = ''
+                                   # Comma separated list of table names to memcache
+                                   # that don't write to database
+                                   # Regexp are accepted
+black_memqcache_table_list = ''
+                                   # Comma separated list of table names not to memcache
+                                   # that don't write to database
+                                   # Regexp are accepted