> 作者:马顺华
> 从事运维管理工作多年,目前就职于某科技有限公司,熟悉运维自动化、OceanBase部署运维、MySQL 运维以及各种云平台技术和产品。并已获得OceanBase认证OBCA、OBCP 证书、OpenGauss社区认证结业证书。OceanBase & 墨天轮第二、三、四届技术征文大赛,多次获得 一、二、三 等奖,时常在墨天轮发布原创技术文章,并多次被首页推荐。
前言
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的分布式部署是一个高效、可靠且易于管理的解决方案,适用于各种场景下的数据存储和管理需求。