0.3 快速开始

0.3.1 关于本节

• 本节内容为您介绍如何使用dble安装包快速部署并启动一个dble服务，并简单了解dble的使用和管理

0.3.2 安装准备

以下部分将被需要作为dble启动的基础支撑

• 一个启动的MySQL实例
  dble是通过连接mysql数据库实例来进行数据的存储，所以请至少准备一个正在运行的mysql实例，在此仅以一个最简单的情况举例，
  假设您的机器上存在一个MySQL实例$url=localhost:3306,$user=test,$password=testPsw
  请正确配置/etc/hosts，保证此MySQL实例可以正确访问，否则之后可能会报错 "NO ROUTE TO HOST"。
  并且在本例中需要在mysql实例中新建几个数据库:

  create database db1;  
  create database db2;  
  create database db3;  
  create database db4;
  

• JVM环境
  dble是使用java开发的，所以需要启动dble您先需要在机器上安装java版本1.8或以上，并且确保JAVA_HOME参数被正确的设置

0.3.3 下载并安装

• 通过此连接下载最新版本的安装包https://github.com/actiontech/dble/releases
• 解压并安装dble到指定文件夹中

  mkdir -p $working_dir  
  cd $working_dir  
  tar -xvf actiontech-dble-$version.tar.gz  
  cd $working_dir/dble/conf  
  cp rule_template.xml rule.xml  
  cp schema_template.xml schema.xml  
  cp server_template.xml server.xml
  

0.3.4 dble的初始化配置

• 修改schema.xml，找到其中的wirteHost将您对应的数据库信息进行替换

  <writeHost host="hostM1" url="$url" user="$user" password="$password"/>
  

• 在本例中替换之后对应的部分因为

  <writeHost host="hostM1" url="localhost:3306" user="test" password="testPsw"/>
  

0.3.5 启动并连接

• 启动命令$working_dir/dble/bin/dble start
• 如果启动失败请使用此命令查看失败的详细原因 tail -f logs/wrapper.log
• 使用mysql客户端直接连接dble服务，默认密码123456 mysql -p -P8066 -h 127.0.0.1 -u root
• 您可以使用mysql一样的方式执行以下语句

  use testdb;
  create table travelrecord(
  id int,
  name char(255) ,
  PRIMARY KEY (`id`)
  ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
  show full tables;
  

• 您可以使用以下命令登录到dble的管理端口进行dble服务状态的查看和管理,默认密码654321
  mysql -p -P9066 -h 127.0.0.1 -u man1
  其中9066是管理端的端口，man1是server.xml中默认的管理用户，如果有变更，请自行修改
  详细的管理命令可以查询2.1 管理命令文档