YashanDB客户端安装

本章节将介绍Linux环境下YashanDB数据库客户端安装方式，本文以yashandb-client-23.3.1.100-linux-x86_64.tar.gz软件包为例进行阐述，本文示例中YashanDB客户端安装于服务端所在服务器另一用户中。

YashanDB客户端中内置yasql工具，可连接至YashanDB服务端，通过SQL命令执行数据库操作。

创建安装用户

1.切换至root用户，并执行如下命令创建新用户yasdb：

$ su root
# useradd yasdb

2.执行如下命令为用户yasdb指定密码：

# passwd yasdb
Changing password for user yasdb.
New password:
Retype new password:
passwd: all authentication tokens updated successfully.

创建安装用户

1.切换至root用户，并执行如下命令创建新用户yasdb：

$ su root
# useradd yasdb

2.执行如下命令为用户yasdb指定密码：

# passwd yasdb
Changing password for user yasdb.
New password:
Retype new password:
passwd: all authentication tokens updated successfully.

创建安装目录

1.执行如下命令切换至yasdb用户：

# su yasdb
$ cd

2.执行如下命令创建目录 yashandb_client ：
$ mkdir yashandb_client

解压安装包

1.执行如下命令进入目录 yashandb_client，此时用户所在路径为/home/yasdb/yashandb_client：

$ cd yashandb_client
$ pwd
/home/yasdb/yashandb_client

2.将软件包上传至 yashandb_client 目录中。

3.执行如下命令解压软件包，并查看解压后目录中所有文件，解压命令后的软件包名称须更改为实际使用的软件包名称：

$ tar -zxf yashandb-client-23.3.1.100-linux-x86_64.tar.gz
$ ll

total 15548
drwxrwxr-x. 2 yasdb yasdb       19 Aug 13 10:29 bin
drwxrwxr-x. 2 yasdb yasdb       21 Aug 13 10:29 include
drwxrwxr-x. 2 yasdb yasdb     4096 Aug 13 10:29 lib
-rw-rw-r--. 1 yasdb yasdb 15915616 Aug 13 10:29 yashandb-client-23.3.1.100-linux-x86_64.tar.gz

配置环境变量

1.执行如下命令使用vi编辑器打开文件~/.bashrc：
$ vi ~/.bashrc

2.通过i键打开输入模式，并将如下内容输入至文件中：

export PATH=$PATH:/home/yasdb/yashandb_client/bin
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb/yashandb_client/lib

3.通过Esc键退出输入模式，然后输入:wq保存并关闭文件：

4.执行如下命令生效环境变量：
$ source ~/.bashrc

连接YashanDB

执行如下命令连接至YashanDB服务端，请将password更改成设置的sys用户密码，ip:port更换成服务端IP地址及端口号：

$ yasql sys/password@ip:port
YashanDB SQL Personal Edition Release 23.3.1.100 x86_64

Connected to:
YashanDB Server Personal Edition Release 23.3.1.100 x86_64 - Linux

SQL> 

服务端配置

如部署服务端时没有对监听地址参数进行修改，则服务端的监听地址默认为127.0.0.1:1688，即本地地址，此时仅支持同服务器不同用户下安装的YashanDB客户端进行连接，如位于不同服务器则无法连接至服务端，需要对服务端的监听地址进行修改。

1.于数据库服务端执行如下SQL命令查看监听地址参数值：

show parameter LISTEN_ADDR;

NAME             VALUE
---------------- -------------------------
LISTEN_ADDR      127.0.0.1:1688

2.执行如下SQL命令更改监听地址，请将其修改为服务端所在IP地址及端口号：

ALTER SYSTEM SET LISTEN_ADDR = ip:port SCOPE=SPFILE;

3.执行如下命令重启数据库服务端：

SQL> SHUTDOWN;

EXIT

$ yasboot cluster restart -c yashandb
 type | uuid             | name                | hostid | index    | status  | return_code | progress | cost
-------------------------------------------------------------------------------------------------------------
 task | 78d6449df62594b5 | ReStartYasdbCluster | -      | yashandb | SUCCESS | 0           | 100      | 3
------+------------------+---------------------+--------+----------+---------+-------------+----------+------
task completed, status: SUCCESS

$ yasql sys/password
YashanDB SQL Personal Edition Release 23.3.1.100 x86_64

Connected to:
YashanDB Server Personal Edition Release 23.3.1.100 x86_64 - Linux

SQL>

4.执行如下SQL命令重新查看监听地址参数值：

show parameter LISTEN_ADDR;

NAME             VALUE
---------------- -------------------------
LISTEN_ADDR      123.4.5.6:1688