CloudNote

Appearance

4 快速开始 ​

4.1 关于本节 ​

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

4.2 安装准备 ​

  • 一个启动的数据库实例（以MySQL为例进行说明）

    假设您的机器上存在一个MySQL实例$url=localhost:3306,$user=test,$password=testPsw 请正确配置/etc/hosts，保证此MySQL实例可以正确访问，否则之后可能会报错 "NO ROUTE TO HOST"。 并且在本例中需要在mysql实例中新建几个数据库。

  • JVM环境 LIBRA是使用java开发的，所以需要在机器上先安装JDK1.8或者以上版本，并且确保JAVA_HOME参数被正确的设置。

4.3 安装部署 ​

​ 获取LIBRA的部署包，然后上传到服务器的指定目录，解压并安装LIBRA到指定文件夹中即可。例如：

shell
mkdir -p $working_dir
cd $working_dir
tar -xvf LIBRA-$version.tar.gz

4.4 初始化配置 ​

  • server.xml
xml
<!--登陆LIBRA用户以及密码 -->
<user name="root">
     <property name="password">123456</property>
     <property name="schemas">TESTDB</property>
 </user>
 <!--登陆LIBRA管理端及密码 -->
  <user name="manager">
     <property name="password">123456</property>
     <property name="manager">true</property>
 </user>
  • schema.xml
xml
    <schema name="TESTDB" dbType="mysql">
        <table name="acct" dataNode="dn1,dn2" primaryKey="acct_no" rule="rule">
        </table>
    </schema>
    <dataNode name="dn1" dataHost="localhost1" database="om"/>
    <dataNode name="dn2" dataHost="localhost2" database="oms"/>
    <dataHost name="localhost1" maxCon="500" minCon="10" balance="0">
        <heartbeat>select user()</heartbeat>
        <writeHost host="hostM1" url="jdbc:mysql://127.0.0.1:3306/om" user="root" password="root">
        </writeHost>
    </dataHost>
    <dataHost name="localhost2" maxCon="500" minCon="10" balance="0">
        <heartbeat>select user()</heartbeat>
        <writeHost host="hostM1" url="jdbc:mysql://127.0.0.1:3306/oms" user="root" password="root">
        </writeHost>
    </dataHost>
  • rule.xml
xml
    <tableRule name="rule">
        <rule>
            <columns>acct_no</columns>
            <algorithm>mod</algorithm>
        </rule>
    </tableRule>
     <!--拆分算法 -->
     <function name="mod" class="com.actiontech.dble.route.function.PartitionByLong">
        <property name="partitionCount">2</property>
        <property name="partitionLength">1</property>
    </function>

4.5 启动并连接 ​

  • 启动命令：

    shell
    $working_dir/LIBRA/bin/LIBRA start

  • 如果启动失败请使用此命令查看失败的详细原因

    shell
    tail -f logs/wrapper.log

  • 使用mysql客户端直接连接LIBRA服务，密码123456

    shell
    mysql -p -P8066 -h 127.0.0.1 -u root

  • 您可以使用mysql一样的方式执行sql或者使用mysql客户端工具进行登录；

  • 您可以使用以下命令登录到LIBRA的管理端口，并进行LIBRA服务状态的查看和管理

    shell
    mysql -p -P9066 -h 127.0.0.1 -u manager

    其中9066是管理端的端口，manager是server.xml中配置的管理用户，如果有变更，请自行修改。