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

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

创建安装用户

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

   ```
   $ su root

```

Copied!

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

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

   Copied!

创建安装目录

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

   
   $ cd
   

   Copied!

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

   $ mkdir yashandb_client
   

   Copied!

解压安装包

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

   $ cd yashandb_client
   $ pwd
   /home/yasdb/yashandb_client
   

   Copied!

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
   

   Copied!

配置环境变量

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

   $ vi ~/.bashrc
   

   Copied!

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

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

   Copied!

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

   

4. 执行如下命令生效环境变量：

   $ source ~/.bashrc
   

   Copied!

连接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>

Copied!

服务端配置

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

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

   show parameter LISTEN_ADDR;
   
   NAME             VALUE
   
   LISTEN_ADDR      127.0.0.1:1688
   

   Copied!

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

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

   Copied!

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>
   

   Copied!

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

   show parameter LISTEN_ADDR;
   
   NAME             VALUE
   
   LISTEN_ADDR      123.4.5.6:1688
   

   Copied!