天玄技术文档
  • 平台介绍
    • 天玄区块链
    • 版本信息
  • 快速开始
    • 快速搭建天玄链
      • 硬件要求
      • 软件要求
      • 构建节点安装包
      • 安装并启动节点
    • 应用部署示例
  • 安装手册
    • 天玄链
      • 打包可执行文件
      • 安装
      • 配置说明
      • 证书说明
      • 日志说明
    • 天玄网关
      • 安装
      • 配置说明
  • 应用开发手册
    • 创建和使用账户
    • 智能合约
    • Java SDK
      • 快速入门
      • 配置说明
      • 远程调用接口
    • 天玄链功能接口列表
  • 系统架构
    • 整体架构
    • 天玄链交易流程
    • 数据结构&编码
    • 核心模块
      • 共识算法
      • P2P网络
      • 交易并行
      • 存储
      • 流水线执行
      • CA机制
      • 网关
      • 虚拟机
      • 密码
  • 社区
    • 团队介绍
    • 合作伙伴
    • 社群入口
Powered by GitBook
On this page
  • 硬件要求
  • 天玄网关安装
  • 前置准备
  • 节点网关系统配置
  1. 安装手册
  2. 天玄网关

安装

硬件要求

配置
最低配置
推荐配置

CPU

1.5GHz

2.4GHz

内存

2GB

4GB

核心数

2核

4核

网络带宽

1Mb

5Mb

操作系统

CentOS (7及以上 64位) 或 Ubuntu(18.04 64位)

JAVA

JDK 1.8

天玄网关安装

前置准备

1)在安装节点网关之前,请确保已经安装并运行了节点应用

2)网关安装所需依赖

  • Oracle JDK 1.8

  • Maven .3.9

  • Git

3)创建操作目录

创建网关部署操作的目录,以node0为例:

cd ~ && mkdir -p thanos-gateway/node0 && cd thanos-gateway/node0

在节点目录下创建database,logs和resource子目录。其中,logs目录用于存放链执行日志。resource目录用于存放网关的配置文件。

mkdir logs resource

在resource目录下创建tls目录,用于存放证书相关文件。

mkdir resource/tls

4)添加可执行文件

将thanos-gateway.jar放在操作目录下,如~/thanos-gateway/node0/。

节点网关系统配置

1)在~/thanos-gateway/node0/resource/目录下 添加网关的总配置文件thanos-gateway.conf和日志管理配置gateway-logback.xml。

thanos-gateway.conf内容如下。注意,涉及路径的配置项必须是绝对路径。

gateway {
    #本机节点信息,用于与其他gateway节点互连
    node.myself = "1:101.35.234.159:100"
 
    rpc {
        #本机rpc服务ip和端口,用于向sdk提供rpc服务。
        address = "127.0.0.1:8180"
        acceptCount = 300
        maxThreads = 400
        readWriteTimeout = 60000
    }
 
    http {
        #本机http服务端口号,用于向sdk提供http服务。
        port = 8580
        acceptCount = 300
        maxThreads = 400
        readWriteTimeout = 12000
    }
    #广播节点列表
   # broadcast = ["2:10.246.199.210:200"]
    broadcast =[]
    push {
        #推送地址
        address = "101.35.234.159:7580"
    }
    sync {
        #同步出块地址
        address = 7180
        cache {
            blockLimit = 10
            txPoolDSCacheSizeLimit = 2000
        }
    }
    switch {
        #是否仅广播全局节点事件
        only.broadcast.globalEvent = 0
    }
    log {
        logConfigPath = "/root/thanos-gateway/node0/resource/gateway-logback.xml"
    }
}
#tls settings, such as path of keystore,truststore,etc
tls {
    #与web3j的通信方式,是否使用tls加密
    needTLS = false
    keyPath="/root/thanos-gateway/node0/resource/tls/node.key"
    certsPath="/root/thanos-gateway/node0/resource/tls/chain.crt"
}

gateway-logback.xml内容如下:

<?xml version="1.0" encoding="UTF-8"?>
 
<configuration debug="false">
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <charset>UTF-8</charset>
            <pattern>
                %d %-4relative [%thread] %-5level %logger{36} - %msg%n
            </pattern>
        </encoder>
    </appender>
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/thanos-gateway.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>logs/thanos-gateway.log.%d{yyyy-MM-dd}.%i</fileNamePattern>
            <maxHistory>14</maxHistory>
            <maxFileSize>500MB</maxFileSize>
            <totalSizeCap>15GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>[%d{yyyy-MM-dd HH:mm:ss}] [%thread] %level %logger{35} [T:%X{trans}] %msg%n</pattern>
        </encoder>
    </appender>
 
    <root level="INFO">
        <appender-ref ref="FILE"/>
        <appender-ref ref="CONSOLE"/>
    </root>
 
</configuration>

而后,添加tls相关证书和密钥等文件。

由于节点网关和节点应用是一一对应的,需要将应用部署中生成的tls配置(在~/thanos-chain/node0/resource/tls目录下的node.key和chain.crt两个文件)添加至~/thanos-gateway/node0/resource/tls目录下。

至此,网关配置完成,可以启动。启动方法为:在网关操作目录~/thanos-gateway/node0/下,运行如下指令启动节点:

java  -Xmx256m -Xms256m -Xmn256m -Xss4M -jar thanos-gateway.jar
Previous天玄网关Next配置说明

Last updated 8 months ago

获取可执行文件thanos-gateway.jar,获取方式见:。

以node0节点为例,进行网关系统的配置,包括网络端口配置、tls配置、日志配置等。配置文件中各配置项的具体含义参见:

获取可执行文件
网关配置说明