Debug TiDB Documentation: TiDB 数据库快速上手指南

[qiancai]

此 issue 为 Debug TiDB Documentation: TiDB 中文文档测试说明・Issue #15772・pingcap/docs-cn 的 sub-issue，目的是为了测试和验证 TiDB 数据库快速上手指南 | PingCAP 文档中心 文档。

请参考 https://github.com/pingcap/docs-cn/issues/15772 中的说明测试该文档。

1. 在完成文档验证后，将您的验证结果以评论的形式添加到当前 issue 上。验证结果可以是您遇到的问题、发现的错误或其他任何发现。如果验证顺利通过，您也可以添加评论说明。
2. 对于在验证过程中发现的任何问题或错误，欢迎创建 Pull Request（PR）直接修正文档。创建 PR 时，请在 PR 描述中指明该 PR 解决了哪个 issue (例如，Fix #15773)。关于如何创建 PR 的详情，请参考TiDB 中文文档贡献指南。

非常感谢您对测试和验证文档的贡献！

[PokIsemaine]

/assign

[PokIsemaine]

验证过程中碰到的问题：

• 文档版本：v7.5.0
• 环境：VMware 虚拟机新配的环境，Centos7.9，内存 16GB, 硬盘 40 GB，处理器 8

部署本地测试集群

碰到的问题是，直接用 Centos7.9 装好自带的 FireFox 浏览器，tiup playground 启动集群后，访问 Dashboard 网页一直是加载等待的状态。tidb 可以正常连接，Grafana, Prometheus 可以正常访问。

Firefox 版本 查阅了 Dashboard 相关的文档，应该是兼容这个版本的 https://docs.pingcap.com/zh/tidb/stable/dashboard-access#%E6%B5%8F%E8%A7%88%E5%99%A8%E5%85%BC%E5%AE%B9%E6%80%A7

后面尝试更换浏览器安装新版的 Chrome，同样方法启动集群，可以正常访问 Dashboard

在单机上模拟部署生产环境集群

按照文档执行到第 8 步：启动集群，出现报错

根据提示查阅日志 tidb.log，发现如下 WARN 和 ERROR

[2024/01/09 19:37:41.690 +08:00] [WARN] [runaway.go:172] ["get runaway watch record failed"] [error="[schema:1146]Table 'mysql.tidb_runaway_watch' doesn't exist"]
[2024/01/09 19:37:42.689 +08:00] [ERROR] [runaway.go:145] ["try to get new runaway watch"] [error="[schema:1146]Table 'mysql.tidb_runaway_watch' doesn't exist"]

在社区论坛查阅，发现情况相似的两个问答 https://asktug.com/t/topic/1018496/6 [状态：已解决] https://asktug.com/t/topic/1019395/11

应该是缺少了 mysql.tidb_runaway_watch 这个表造成的，目前我没有解决这个问题。因为是新环境，所以并不像第一条问答那样之前就有部署好的集群，可以手动连数据库建表。参考第二条回答尝试重启集群以及直接销毁集群，重复了几次，问题仍然存在。

Tips：

由于初次接触 TiDB，上述问题可能是本人操作不当造成的，还需进一步讨论验证确定问题

[Oreoxmt]

@PokIsemaine 非常感谢您对 TiDB 数据库快速上手指南 文档的验证和详细反馈，您的反馈对于持续改进 TiDB 文档和用户体验至关重要。关于您在部署 TiDB v7.5.0 版本时遇到的问题：

1. TiDB Dashboard 与 FireFox 68.10 的兼容性
2. 单机模拟部署生产环境集群时，tiup cluster start 报错：Table 'mysql.tidb_runaway_watch' doesn't exist"

我们将会进行进一步的调查，并根据需要更新文档描述，以确保其他用户可以顺利部署 TiDB。