#YashanDB客户端安装

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

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

# 创建安装用户

切换至root用户，并执行如下命令创建新用户yasdb：
```
$ su root
# useradd yasdb
```

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

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

# 创建安装目录

执行如下命令切换至yasdb用户：
```
# su yasdb
$ cd
```
执行如下命令创建目录 yashandb_client ：
```
$ mkdir yashandb_client
```

# 解压安装包

执行如下命令进入目录 yashandb_client，此时用户所在路径为/home/yasdb/yashandb_client：
```
$ cd yashandb_client
$ pwd
/home/yasdb/yashandb_client
```
将软件包上传至 yashandb_client 目录中。

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

$ tar -zxf yashandb-client-23.2.9.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.2.9.100-linux-x86_64.tar.gz

# 配置环境变量

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

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

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

通过Esc键退出输入模式，然后输入:wq保存并关闭文件：
执行如下命令生效环境变量：
```
$ source ~/.bashrc
```

# 连接YashanDB

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

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

Connected to:
YashanDB Server Personal Edition Release 23.2.9.100 x86_64 - X86 64bit Linux

SQL>

# 服务端配置

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

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

show parameter LISTEN_ADDR;

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

执行如下SQL命令更改监听地址，请将其修改为服务端所在IP地址及端口号：
```
ALTER SYSTEM SET LISTEN_ADDR = ip:port SCOPE=SPFILE;
```

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

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.2.9.100 x86_64

Connected to:
YashanDB Server Personal Edition Release 23.2.9.100 x86_64 - X86 64bit Linux

SQL>

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

show parameter LISTEN_ADDR;

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