步骤1：启动Web服务

1. 以yashan用户登录192.168.1.2服务器。

2. 执行如下命令，进入安装目录。

   $ cd /home/yashan/install
   

3. 执行如下命令，使用yasom启动Web服务端：

   $ ./bin/yasom --web --listen 192.168.1.2:9001
   

   • --web：指定以Web服务端启动。
   • --listen：指定监听的地址（即可视化安装的网页地址），格式为IP:PORT，通常设置为当前服务器的IP，端口推荐使用9001。

4. 在PC端浏览器中访问可视化安装的网页地址。

   

步骤2：配置数据库基本信息与服务器信息

1. 根据实际情况，配置数据库基本信息：

   • 数据库名称：填写数据库集群名称，该名称也将作为初始数据库的名称（database name）。必须以字母开头，长度为[1,63]个字符，例如yashandb。
   • 数据库类型：选择数据库部署形态，例如集群。
   • 安装包路径：填写安装包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-23.2.1.100-linux-x86_64.tar.gz。
   • 插件包路径：选填参数，如需使用DBLINK功能和更丰富的内置函数（例如LSFA_LISTAGG），需先下载plugin插件包至服务器并填写插件包所在路径，安装用户需有该路径的操作权限，例如/home/yashan/install/yashandb-plugins-all-23.2.1.100-linux-x86_64.tar.gz。安装完成后，无法单独安装该插件包。

2. 在服务器列表中，默认识别Web服务所在服务器的信息，检查确认安装路径等信息无误后单击【尝试连接】检查连通性。

   

3. 单击服务器列表上方的【添加】。

4. 在弹出的对话框中，配置其他服务器信息，单击【确定】保存配置。

   • 主机地址：服务器的IP地址，格式：192.168.1.3或192.168.1.[3-4]，允许配置多个IP地址/集，使用换行符分割。
   • 用户名：安装用户的名称，例如yashan。
   • 密码：可选参数，安装用户的密码，若已配置当前服务器对其他服务器SSH免密，无需填写密码。
   • SSH端口：SSH端口，例如22。
   • 安装路径：数据库安装路径，即安装前划分的安装目录，例如/data/yashan/yasdb_home。

   

5. 单击【全部尝试连接】检查连通性。

   

6. 确认信息无误后，单击【下一步】。

步骤3：配置服务器sudo

1. 在数据库配置区域，可以配置以下功能：

   • 创建cgroup：开启表示创建用于YashanDB CPU资源管理的cgoup目录，并需填写服务器其他配置区域的cgroup目录。CPU资源管理功能不适用于共享集群部署，必须设置为关闭。
   • 开机自启monit：如需开启该功能，需先参照依赖项准备检查并确保所有服务器中已安装符合要求的monit。开启时，守护进程将在服务器开机后自行启动并拉起YashanDB的各个进程，间接实现数据库的开机自启动。
   • 用户添加到YASDBA用户组：开启表示将安装用户加入YASDBA组，可免密登录数据库。

   上述功能开启后均需安装用户具备sudo权限，本示例使用默认配置，即仅开启将用户添加到YASDBA用户组。

   Note:

   若【开机自启monit】参数设置为关闭但后续需使用相关功能，可参考守护进程完成相关配置。

   

2. 确认信息无误后，单击【下一步】。

步骤4：配置集群节点信息

1. 在弹出的节点规模配置对话框中，根据实际规划的实例数调整相关配置，单击【确定】保存信息。

   • 集群节点数量：选择数据库实例数量。
   • 起始端口：填写数据库监听端口的起始值，若存在多个监听端口系统会根据端口划分规则自行计算，默认值为1688。
   • 节点默认路径：填写YashanDB的数据目录，置空则默认使用服务器安装路径下的DATA目录，安装后修改不生效，例如/data/yashan/yasdb_data。
   • 磁阵数据存储盘路径：填写为数据盘规划的共享存储LUN路径，例如/dev/mapper/storraid5。
   • 磁阵投票盘路径：填写为投票盘规划的共享存储LUN路径，例如/dev/mapper/storraid10。
   • 磁阵YCR盘路径：填写为YCR盘规划的共享存储LUN路径，例如/dev/mapper/storraid15。

   

2. 在yasom配置区域，可根据实际情况调整yasom所在服务器和监听端口。

   • yasom所在主机：默认为当前服务器IP。
   • LISTEN_ADDR：yasom的监听端口，默认为1675。

3. 在yasagent配置区域，可按需调整以下配置：

   • yasagent LISTEN_ADDR：yasagent的监听端口，默认为1676。
   • DB自适应内存限制：仅当开启推荐配置时，必须配置内存限制，格式为数字 + 空/K/M/G/T，取值范围[实例数 * 1536M,服务器最大内存]。
   • 包含节点：显示每个服务器上对应部署的数据库实例信息，带星标的实例角色为主，其他为备。可拖拽实例调整其分布。

4. 在集群特有参数配置区域，可根据实际情况调整各磁盘对应的共享存储LUN路径。

5. 在节点配置区域，展开数据库实例列表，单击实例名称，可查看实例信息，并可按需调整部分配置。

6. 确认信息无误后，单击【下一步】。

步骤5：设置建库参数

在【数据库建库参数】页面，可参考共享集群配置文件按需增/删/改建库参数，确认信息无误后，单击【下一步】。

步骤6：设置配置参数

在【数据库节点参数】页面，可按需增/删/改各数据库实例的参数，确认信息无误后，单击【保存并下一步】。

步骤7：部署数据库

1. 在【数据库全局信息】页面，确认信息无误后，单击【部署】。

   

2. 部署任务进度达到100%时，表示部署完成，单击【退出部署程序】退出。

   若不手动退出，服务端也会在一定时间内自动退出。

Note:

部署完成后，yasom会在/home/yashan/install/conf/SE/yashandb目录中生成hosts.toml和yashandb.toml文件，其中yashandb为数据库名称，此目录为安装目录。

步骤8：配置环境变量

以安装用户登录到每个服务器上，执行如下命令生效环境变量。

# 部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件
$ cd /data/yashan/yasdb_home/yashandb/23.2.1.100/conf
# 如~/.bashrc中已存在YashanDB相关的环境变量，将其清除

$ cat yashandb.bashrc >> ~/.bashrc
$ source ~/.bashrc

步骤9：检查安装结果

若连接报错或执行SQL语句报错，请根据错误提示信息检查安装步骤，或咨询我们的技术支持。

1. YashanDB不提供系统初始口令，需使用yasboot工具设置数据库sys用户的密码，以安装用户登录到服务器并执行如下命令设置密码。

   $ yasboot cluster password set -n newpasswd -c yashandb
   

2. 使用yasql工具连接数据库，查看实例状态。

   $ yasql sys/password@192.168.1.2:1688
   SQL> SELECT STATUS FROM V$INSTANCE;
   
   STATUS        
   ------------- 
   OPEN        
   
   SQL> SELECT database_name FROM v$database;
   
   DATABASE_NAME                                                    
   ---------------------------------------------------------------- 
   yashandb
   

3. （可选）创建数据库用户并赋权，更多操作请查阅用户管理。

   SQL> CREATE USER sales IDENTIFIED BY sales;
   
   SQL> GRANT CONNECT TO SALES;