首页 > 代码库 > Tokyo Tyrant(TTServer)系列(二)-启动参数和配置

Tokyo Tyrant(TTServer)系列(二)-启动参数和配置

启动参数介绍

        ttserver命令可以启动一个数据库实例。因为数据库已经实现了Tokyo Cabinet的抽象API,所以可以在启动的时候指定数据库的配置类型。

支持的数据库类型有:

  1. 内存hash数据库
  2. 内存tree数据库
  3. hash数据库
  4. B+ tree数据库,
  命令通过下面的格式来使用,‘dbname’制定数据库名,如果省略,则被视作内存hash数据库。
ttserver [-host name] [-port num] [-thnum num] [-tout num] [-dmn] [-pid path] [-log path] [-ld|-le] [-ulog path] [-ulim num] [-uas] [-sidnum] [-mhost name] [-mport num] [-rts path] [-ext path] [-extpc name period] [-mask expr] [dbname] 
下面来说这些参数的功能:
  • -host name :指明服务器的hostname或者ip地址。默认服务器的所有地址都会被绑定。比如:指定127.0.0.1这样的ip,就只是本地可以访问了。
  • -port num : 指定服务启动的端口. 默认1978.如果要启动多个数据库实例,端口需要不一样。
  • -thnum num : 指定服务工作的线程数。默认8.
  • -tout num : 指定每个会话的超时时间。默认永不超时。
  • -dmn : 以守护进程方式运行。
  • -pid path : 输出进程IP到指定的文件。
  • -log path : 输出日志信息到指定文件。
  • -ld : 日志中记录debug信息。
  • -le :日志中只记录错误信息。
  • -ulog path : 指定存放更新日志(update log)的目录.可以用来备份恢复数据库,主从库之间的同步。
  • -ulim num : 指定每个更新日志文件的大小限制.
  • -uas :使用异步IO记录更新日志。(使用此项可以减少写入日志的IO开销,但是在服务器意外关机,进程被kill时可能会丢失数据。根据经验,一般可以不使用)。
  • -sid num : 指定服务的ID号。主从复制的时候通过不同的ID号来识别。
  • -mhost name : 指定主从复制模式下的主服务器的IP或域名。
  • -mport num : 指定主从模式下主服务器的端口号.
  • -rts path : 指定用于主从复制的时间戳存放文件.
  • -ext path : 指定扩展脚本语言文件。
  • -extpc name period : 指定被周期调用的函数名和间隔时间.
  • -mask expr : 指定被禁止的命令名(比如可以禁止使用清空vanish).
  • -unmask expr : 指定被允许的命令名.
  • 数据库类型

  •    下面我们再来看下数据库类型的详细配置。
  1.     数据库名的命名方式被Tokyo Cabinet的抽象API指定。
  2.     如果数据库名为"*",表示内存hash数据库。
  3.     如果数据库名为"+"表示内存tree数据库。
  4.     如果数据库名为".tch",则数据库为hash数据库。
  5.     如果数据库名的后缀为".tcb",数据库将为B+ tree数据库。
  6.     如果数据库名的后缀为".tcf"。则数据库将为fixed-length数据库。
  7.     如果数据库名的后缀为".tct",则数据将为一个table数据库(有表的概念)。
数据库的调整参数通过数据库名的延伸来指定,通过"#"分开,每个参数通过一个参数名和值来指定,用"="隔开。
内存hash数据库支持"bnum", "capnum", 和 "capsiz"
内存tree数据库支持"capnum" 和 "capsiz"
capnum指定记录的最大容量,capsiz指定最大的内存使用量(在内存数据库中),记录通过存储的顺序移除。
hash数据库支持"mode", "bnum", "apow", "fpow", "opts", "rcnum", 和 "xmsiz". 
`rcnum‘指定最大的缓存记录数。如果它不大于零,那么缓存记录不可用。默认不可用。
 xmsiz   指定外部内存的大小。如果不大于0,内存不可用。默认是67108864,即64M。
`bnum‘ 指定bucket存储桶的数量。如果指定的数目不大于0,将会使用默认的数值131071.推荐数量应该在所有需要存储的记录总数的0.4-4倍
`apow‘ 跟一个key关联的记录数,2的N次方表示.  如果不指定,默认2^4=16.
`fpow‘ specifies the maximum number of elements of the free block pool by power of 2.  默认2^10=1024.
`opts‘ 指定选项,位或:`HDBTLARGE‘ 指定数据库的大小通过使用64位数组桶能够超过2G。
                       `HDBTDEFLATE‘  指定每个记录被Deflate encoding压缩。
                      `HDBTBZIP‘ 指定每个记录被BZIP2 encoding压缩
                       `HDBTTCBS‘指定每个记录被 TCBS encoding压缩.
B+ tree数据库支持"mode", "lmemb", "nmemb", "bnum", "apow", "fpow", "opts", "lcnum", "ncnum", 和 "xmsiz". 
Fixed-length 数据库 支持 "mode", "width", and "limsiz". 
Table 数据库支持 "mode", "bnum", "apow", "fpow", "opts", "rcnum", "lcnum", "ncnum", "xmsiz", 和 "idx"
      "idx"指定表的索引。
     "mode"可以包含 "w" 写, "r" 读, "c" 创建, "t" 截断,"e" 无锁,和"f" 非阻塞锁。默认的的mod为"wc"。

例如如下启动参数:
./ttserver -port 9032 -pid ~/app/tokyotyrant-1.1.41/data/tt_account2/tt_9032.pid ~/app/tokyotyrant-1.1.41/data/tt_account2/tt_account2.tch