本章节将介绍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

   Copied!

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

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

   Copied!

#创建安装目录

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

   # su 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 15548drwxrwxr-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/binexport 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>

#服务端配置

如部署服务端时没有对监听地址参数进行修改，则服务端的监听地址默认为 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