• SequoiaS3 安装与配置
    • 安装
    • 配置 SequoiaDB
    • 配置 SequoiaS3
    • 启动
    • 配置说明
      • 基础配置
      • SequoiaS3 与 SequoiaDB 之间的连接池配置
      • 桶配置
      • 分段上传配置
      • 鉴权配置
      • 查询上下文配置

    SequoiaS3 安装与配置

    本章介绍 SequoiaS3 的安装、配置与启动。

    安装

    SequoiaS3 集成于 SequoiaDB 的安装包中,run 包安装完成后到安装路径下的 tools/sequoias3 目录。

    1. $ cd tools/sequoias3
    2. $ ls

    可以看到 config 目录、jar 包和 sequoias3.sh 可执行脚本

    1. config sequoia-s3-3.2.4.jar sequoias3.sh

    配置 SequoiaDB

    SequoiaS3 对接的 SequoiaDB 需开启RC级别事务,且配置为等锁模式

    1. > var db = new Sdb( "localhost", 11810 )
    2. > db.updateConf( { transactionon:true, transisolation:1, translockwait:true} )

    配置 SequoiaS3

    打开 config 目录中的 application.properties 文件

    1. $ vi config/application.properties

    配置对外监听端口

    1. server.port=8002

    配置 coord 节点的 IP 和端口,可以配置多组并使用逗号分隔

    1. sdbs3.sequoiadb.url=sequoiadb://192.168.20.37:11810,192.168.20.38:11810

    如果在 SequoiaDB 中已经为 SequoiaS3 的存储创建了专属的域,需在此处配置

    1. sdbs3.sequoiadb.meta.domain=domain1
    2. sdbs3.sequoiadb.data.domain=domain2

    上述配置是启动 SequoiaS3 的基础配置,其他配置请参考本章末尾的配置说明。

    启动

    配置修改完成后,通过 ./sequoias3.sh 可执行脚本启动 SequoiaS3

    1. $ ./sequoias3.sh start
    2. start sequoia-s3-3.2.4.jar
    3. pid:22754
    4. sequoias3(8002) is started. pid: 22754

    如需停止 SequoiaS3 进程,执行 stop -p {port} 停止监听指定端口的 SequoiaS3 进程,或执行 stop -a 停止所有 SequoiaS3 进程

    1. $ ./sequoias3.sh stop -p 8002
    2. Terminating process 22754: sequoias3(8002)

    配置说明

    基础配置

    参数配置说明
    server.portSequoiaS3 监听端口号
    sdbs3.sequoiadb.urlSequoiaS3 对接的 SequoiaDB 的 coord 节点 IP 和端口
    sdbs3.sequoiadb.authSequoiaS3 对接的 SequoiaDB 用户名密码。如果 SequoiaDB 未配置密码,此处不需要配置。
    sdbs3.sequoiadb.meta.csNameSequoiaS3 存储元数据的集合空间名称,默认为 S3_SYS_Meta,系统启动时检测如果没有此集合空间时会创建。
    sdbs3.sequoiadb.meta.domainSequoiaS3 存储元数据的集合空间所在的域,只在初次启动系统时生效。
    sdbs3.sequoiadb.data.csNameSequoiaS3 存储对象数据的集合空间名称前缀,默认为 S3_SYS_Data。系统会随着上传对象时的年份变化创建不同的集合空间,例如 2019 年上传的对象会存储在名为 S3_SYS_Data_2019 的集合空间中,上传对象数据时如果没有对应的集合空间,系统会自动创建。
    sdbs3.sequoiadb.data.domainSequoiaS3 存储对象数据的集合空间所在的域
    sdbs3.sequoiadb.data.csRangeSequoiaS3 在同一时间段可以创建的存储对象数据的集合空间数量。
    sdbs3.sequoiadb.data.lobPageSizeSequoiaS3 存储对象数据的集合空间的 lobPageSize
    sdbs3.sequoiadb.data.replSizeSequoiaS3 存储对象数据的集合空间内集合的 replSize

    SequoiaS3 与 SequoiaDB 之间的连接池配置

    参数配置说明
    sdbs3.sequoiadb.maxConnectionNumSequoiaS3 会建立与 SequoiaDB 数据库的连接池,该参数指定连接池内最大连接数量。
    sdbs3.sequoiadb.maxIdleNum连接池最大空闲连接数量,也是系统初始建立的连接数量。
    sdbs3.sequoiadb.deltaIncCount连接池单次增加连接的数量。
    sdbs3.sequoiadb.keepAliveTime连接池中空闲连接存活时间。单位:毫秒。0 表示不关心连接隔多长时间没有收发消息。
    sdbs3.sequoiadb.CheckInterval连接池检测空闲连接的周期,将超过 maxIdleNum 的空闲连接关闭。单位:毫秒。
    sdbs3.sequoiadb.validateConnection使用连接前先检查该连接是否可用。

    桶配置

    参数配置说明
    sdbs3.bucket.limit每位用户允许创建存储桶的最大数量。默认为 100 个。
    sdbs3.bucket.allowreput是否允许重复创建同名存储桶而不报错。

    分段上传配置

    参数配置说明
    sdbs3.multipartupload.partlistinuse是否使用 Complete Multipart Upload 请求中携带的分段列表进行合并,如果该配置为 true,则根据请求携带的分段列表中指定的分段进行合并;如果该配置为 false,则根据系统中已经收到的所有分段按分段编码顺序进行合并,不使用请求中的分段列表,也不检查请求中的分段列表的内容有效性。
    sdbs3.multipartupload.partsizelimit合并分段时是否检查分段的大小,当配置为 true 时,除最后一个分段外,其他分段必须处于 5M~5G 的范围内,超出范围则合并失败。仅当partlistinuse配置为 true 时,该配置生效。
    sdbs3.multipartupload.incompletelifecycle已初始化未完成的分段上传请求保留天数,默认配置为 3 天。当一个分段上传请求初始化三天后仍未完成,则清理该请求和已上传的分段。

    鉴权配置

    参数配置说明
    sdbs3.authorization.check是否对用户进行鉴权,如果配置为 false,则对所有访问用户都不做合法性检查,所有用户对系统进行访问都按照默认系统用户拥有最大权限进行访问。

    查询上下文配置

    参数配置说明
    sdbs3.context.lifecycle查询对象列表的上下文保存周期。单位:分钟。查询对象列表时,如果有未查完的记录,系统记录上下文,并返回上下文的 token,等待下一次查询。查询完成后清理上下文,如超时未收到下次查询,清理上下文。
    sdbs3.context.cron上下文过期清理检测周期。格式:cron。