作者：马顺华
在运维管理领域深耕多年，具备扎实的理论基础与丰富的实践经验。我深耕于技术前沿，不断追求运维自动化与效率的最大化。
我精通运维自动化流程，熟悉OceanBase、MySQL等多种数据库的部署与运维，具备从部署到维护的全流程管理能力。此外，我还持有OceanBase的OBCA和OBCP证书，以及OpenGauss社区认证结业证书、崖山DBCA、亚信AntDBCA、翰高HDCA、GBase 8a | 8c | 8s 等多项权威认证，这些不仅证明了我的专业技能，也展示了我对技术的深厚理解和热爱。
在OceanBase & 墨天轮的技术征文大赛中，我凭借深厚的技术实力和独到的见解，多次荣获一、二、三等奖。同时，在openGauss第五届、第六届技术征文大赛，TiDB 社区第三届专栏征文大赛，我也屡获殊荣。此外，我还经常在墨天轮等平台发布原创技术文章，多次被首页推荐，积极与业界分享我的运维经验和见解。
前言
YashanDB提供了多种部署形态，不同形态的安装过程，尤其是初始安装参数配置上的差异很大。基于不可能选择同时部署多种形态的YashanDB，我们将其分开描述，用户按需选择，并按描述中步骤顺序操作，即可完成YashanDB产品的安装和初始配置。
可视化安装YashanDB通常涉及使用图形用户界面（GUI）工具来简化和方便安装过程。这样的工具可以提供直观的界面，引导用户完成安装的各个步骤，而无需手动执行复杂的命令和配置。
安装步骤
以下是可视化安装YashanDB的一般步骤（请注意，具体步骤可能会因所使用的工具和版本而有所不同）：
下载可视化安装工具：首先，从YashanDB官方网站或可信来源下载适用于你的操作系统的可视化安装工具。
1、运行安装程序：双击下载的安装文件，启动可视化安装工具。
2、欢迎界面：安装程序通常会显示一个欢迎界面，介绍安装过程和步骤。
3、许可协议：阅读并接受软件许可协议，然后继续下一步。
4、选择安装选项：选择你希望安装的组件和选项。通常包括服务器组件、客户端工具等。
5、配置设置：在设置界面中，提供必要的配置信息，如数据库管理员密码、端口号等。
6、系统检查：安装程序可能会进行系统检查，确保你的系统满足最低要求。
7、安装：点击“安装”按钮开始安装过程。安装程序将复制文件、配置系统并设置所需的环境变量。
8、完成安装：安装完成后，程序会显示一个确认界面，告知你YashanDB已成功安装。
9、完成安装后，你可以使用相应的工具和管理界面来连接和管理YashanDB数据库。请记住，在实际操作中，请务必参考官方文档和指南，以确保正确、安全地完成安装和配置。
设置环境：需要在你的服务器或开发环境中安装和配置 YashanDB。确保你的系统满足 YashanDB 的运行要求，并按照官方文档进行安装和配置。
一、YashanDB可视化安装
1、切换用户环境
1.1 切换用户
[root@worker2 opt]# su yashan
1.2进入安装目录
[yashan@worker2 opt]$ cd /home/yashan/install/
2、启动 web 服务
[yashan@worker2 install]$ ./bin/yasom --web --listen 172.20.2.122:9001
2023-11-25 11:13:20 INFO [console] yasom.go:125 Version: 23.1.1.100
2023-11-25 11:13:20 INFO [console] deploy.go:60 deploy manager starting...
2023-11-25 11:13:20 INFO [console] convert.go:112 opt.GroupConfig: map[]
2023-11-25 11:13:20 INFO [console] static.go:20 routing vue app
2023-11-25 11:13:20 INFO [console] web.go:21 Server listen on: 172.20.2.122:9001
[YASRPC] 2023/11/25 - 11:13:34 | 200 | 326.393?s | 10.9.0.14 | GET "/"
[YASRPC] 2023/11/25 - 11:13:35 | 200 | 756.177864ms | 10.9.0.14 | GET "/assets/index.931cd522.css"
[YASRPC] 2023/11/25 - 11:13:36 | 200 | 1.771055469s | 10.9.0.14 | GET "/assets/index.35dbe09f.js"
[YASRPC] 2023/11/25 - 11:13:36 | 200 | 310.971?s | 10.9.0.14 | GET "/assets/Deploy.1c9cf7d8.css"
[YASRPC] 2023/11/25 - 11:13:36 | 200 | 274.846?s | 10.9.0.14 | GET "/assets/favicon.c096f8ac.ico"
[YASRPC] 2023/11/25 - 11:13:36 | 200 | 315.772685ms | 10.9.0.14 | GET "/assets/Deploy.9fc516d6.js"
[YASRPC] 2023/11/25 - 11:13:36 | 200 | 201.87?s | 10.9.0.14 | GET "/api/task/deploy"
[YASRPC] 2023/11/25 - 11:13:36 | 200 | 9.328423ms | 10.9.0.14 | GET "/api/initial/info"
上述命令将使用yasom拉起web服务端，其中，–web参数指定以web服务端启动，–listen参数指定监听的地址。
3、进入web服务
首先，请在本地检查可视化安装的网页是否可以正常打开，如可以的话，表示yasom web服务端已启动，下述步骤无需操作。
127.0.0.1:9001
二、单机主备部署 YashanDB
Step1：打开可视化安装网页
127.0.0.1:9001
Step2：填写数据库基本信息和主机信息
数据库名称使用默认yashandb，选择单机类型，填入安装包路径/home/yashan/install/yashandb-23.1.0.2-linux-x86_64.tar.gz。
主机规格参考服务器准备中服务器配置建议章节。
点击选择单机部署模式，填写安装的主机和安装路径等信息（安装用户需要有安装路径的操作权限）。
想部署到多台主机也可以选择添加主机并填写新主机信息。
当前主机如果对其他主机ssh免密，不填写密码则默认使用免密方式安装。
填写主机信息后可以点击"尝试连接"按钮，检查主机的连通性。
本示例单机部署就部署在一台机器上，确认完信息后点击下一步。
Step3：sudo相关配置
Step4：生成推荐配置和调整节点配置
如果之前没有生成过配置，会自动弹出生成推荐配置窗口，可以选择节点数量，起始端口，和节点默认路径（可不填，使用默认路径）。
默认开启推荐参数配置，填入YashanDB内存占用百分比，选择表类型。
这里使用直接使用默认配置，点击确定生成。
生成默认配置后，确认OM配置端口以及节点端口保证端口不被占用，这里使用默认配置进行下一步。
Step5：配置建库参数
调整安装参数可参考单机配置文件。
可以在配置建库参数页面增删和修改建库参数，这里使用默认配置进行下一步。
Step6：配置节点参数
可以在配置节点参数页面增删和修改节点参数，这里使用默认配置进行下一步。
#Step7：确认总览信息，确认无误后点击部署
Step8：等待部署完成
点击部署后，等待部署完成。
部署成功后服务端会再一定时间内自动退出，也可以在页面点击退出部署程序。
Step9：退出部署程序。
三、连接使用数据库
以下步骤需登录到部署服务器上执行。
Step1：修改sys用户口令
YashanDB不提供系统初始口令，请通过yasboot工具设置集群内所有节点sys用户的密码。
$ cd /home/yashan/install
[yashan@worker2 install]$ ./bin/yasboot cluster password set -n newpasswd -c yashandb
type | uuid | name | hostid | index | status | return_code | progress | cost
----------------------------------------------------------------------------------------------------------
task | 95993a2a62e1a79d | YasdbPasswordSet | - | yashandb | SUCCESS | 0 | 100 | 2
------+------------------+------------------+--------+----------+---------+-------------+----------+------
task completed, status: SUCCESS
[yashan@worker2 install]$
Step2：验证安装是否成功
2.1 生效环境变量（此步骤需以yashan用户登录到每个节点上执行）。
部署命令成功执行后将会在$YASDB_HOME目录下的conf文件夹中生成<<集群名称>>.bashrc环境变量文件
[yashan@worker2 install]$ cd /home/yashan/yasdb_home/yashandb/23.1.1.100/conf/
[yashan@worker2 conf]$
如~/.bashrc中已存在YashanDB相关的环境变量，将其清除
[yashan@worker2 conf]$ cat yashandb.bashrc >> ~/.bashrc
[yashan@worker2 conf]$ source ~/.bashrc
[yashan@worker2 conf]$
2.2 使用yasql工具连接数据库，查看实例状态。
[yashan@worker2 install]$ ./bin/yasql sys/password@192.168.1.2:1688
YashanDB SQL Personal Edition Release 23.1.1.100 x86_64
Connected to:
YashanDB Server Personal Edition Release 23.1.1.100 x86_64 - X86 64bit Linux
SQL> SELECT STATUS FROM V$INSTANCE;
STATUS
-------------
OPEN
1 row fetched.
SQL> SELECT database_name FROM v$database;
DATABASE_NAME
----------------------------------------------------------------
yashandb
1 row fetched.
SQL>
2.3 创建数据库用户（可选）。
SQL> CREATE USER sales IDENTIFIED BY sales;
Succeed.
SQL> GRANT CONNECT TO SALES;
Succeed.
SQL>
部署报错问题处理
1、生成推荐配置和调整节点配置 报错
生成配置文件失败: [ip:127.0.0.1 scan failed, 主机扫描失败:host scan, stdout:hostid: host0001, file /home/yashan/.yasboot/yashandb.env is already exist, confirm whether a cluster with the same name: 'yashandb' has been deployed. you can delete /home/yashan/.yasboot/yashandb.env manually or use '--force' skip check , stderr: err:Process exited with status 1]
解决办法：手动删除现有的文件：你可以使用以下命令来删除这个文件
[root@worker2 ~]# su yashan
[yashan@worker2 root]$ rm /home/yashan/.yasboot/yashandb.env
[yashan@worker2 root]$
2、点击部署报错
安装数据库包错误: yasdb path: /home/yashan/yasdb_home/yashandb/23.1.1.100 is already installed
错误提示“yasdb path: /home/yashan/yasdb_home/yashandb/23.1.1.100 is already installed”表示你试图安装的数据库包已经存在于指定路径 /home/yashan/yasdb_home/yashandb/23.1.1.100 下。
为了解决这个问题，你可以尝试以下步骤：
检查版本：首先确认你已经安装的数据库版本和你要安装的版本是否一致。如果已经安装的版本是你需要的，那么你不需要再次安装。
解决办法：删除旧的安装：如果你确定旧的安装是错误的或者不再需要，你可以删除它并重新安装。使用如下命令删除旧的安装：
[yashan@worker2 root]$ rm -rf /home/yashan/yasdb_home/yashandb/23.1.1.100
[yashan@worker2 root]$
3、部署任务结果
部署失败
必须卸载清理才能重新部署，清理后会返回到第一步
解决办法：卸载清理,重新部署
结语
在部署和维护方面，YashanDB提供了易于使用的工具平台，包括开发平台、运维平台和迁移平台。这些平台可以帮助开发人员快速开发和部署应用程序，同时也提供了监控和管理功能，使运维人员可以轻松地进行维护和管理。
总之，YashanDB的分布式部署是一个高效、可靠且易于管理的解决方案，适用于各种场景下的数据存储和管理需求。
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
