---
title: "安装 obdiag - 敏捷诊断工具 V1.4.0 | OceanBase 文档中心"
description: 安装 obdiag 本文将介绍安装 obdiag 的方法。 环境要求 obdiag 支持在 Linux 环境上运行。 安装 obdiag 机器需要有 Python 环境 (python2.7.x 或者 python3 > python 3.9 均可)。 前提条件 obdiag 采集日志/在线分析日志和主机等信息时候需…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*5ZXST55u540AAAAAAAAAAAAADiGDAQ/original) 敏捷诊断工具V 1.4.0

# 安装 obdiag

更新时间：2026-04-13 20:21:11

[编辑](https://github.com/oceanbase/odt-doc/edit/V1.4.0/zh-CN/200.install-and-deploy-obdiag.md)  

本文将介绍安装 obdiag 的方法。

## 环境要求

1. obdiag 支持在 Linux 环境上运行。
 2. 安装 obdiag 机器需要有 Python 环境 (python2.7.x 或者 python3 > python 3.9 均可)。

## 前提条件

obdiag 采集日志/在线分析日志和主机等信息时候需要连接到被采集主机上，请确保网络可达。

## 安装步骤

obdiag 工具可以独立部署使用也可以通过 OBD 来使用，以下方式二选一。

### 方式一：obdiag 独立部署使用

如果你的待诊断集群是通过其他方式部署(非 OBD 部署)，可以下面的方式进行安装部署 obdiag。

- 在线部署(可访问外网的情况下可选择)

  ```bash
  sudo yum install -y yum-utils
  sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
  sudo yum install -y oceanbase-diagnostic-tool
  source /usr/local/oceanbase-diagnostic-tool/init.sh

  ```
 - 离线部署(不可访问外网的情况下可选择) OceanBase官网[下载页](https://www.oceanbase.com/softwarecenter) 下载最新版的 OceanBase 数据库定制的敏捷诊断工具（obdiag）。

  ```bash
  yum install -y oceanbase-diagnostic-tool.*rpm
  source /usr/local/oceanbase-diagnostic-tool/init.sh

  ```

### 方式二：OBD 部署方式

如果你的待诊断集群是 OBD 部署的，建议升级 OBD 到 V2.1.0 及以上版本，可通过 OBD 的命令直接使用 obdiag 工具，详细命令可参考 [诊断工具命令组](https://www.oceanbase.com/docs/community-obd-cn-10000000002049483)。

  ```bash
  # 开启 OBD 远程镜像拉取模式
  obd mirror enable remote
  # 通过 OBD 部署 obdiag
  obd obdiag deploy

  ```
 - 离线部署(不可访问外网的情况下可选择)

  OceanBase官网[下载页](https://www.oceanbase.com/softwarecenter) 下载最新版的 OceanBase 数据库定制的敏捷诊断工具（obdiag）。

  ```bash
  # 将离线的obdiag包拷贝到obd的镜像仓库中
  obd mirror clone oceanbase-diagnostic-tool-xxxxxxxx.rpm
  # 通过obd部署obdiag
  obd obdiag deploy

  ```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线