CDH5使用安装报错方解决办法

# CDH5安装报错常见问题及解决方法

## 一、前言

CDH（Cloudera Distribution Including Apache Hadoop）是企业级Hadoop生态系统的领先发行版。CDH5作为经典版本，在安装过程中常因环境配置、依赖关系等问题出现报错。本文将针对典型错误提供解决方案。

---

## 二、环境准备阶段的报错

### 1. 系统环境不兼容
**报错现象**：
```bash
Unsupported major.minor version 52.0

原因：
JDK版本不匹配（CDH5要求JDK 1.7）

解决方案：

# 检查当前JDK版本
java -version

# 安装OpenJDK 7
sudo yum install java-1.7.0-openjdk-devel

# 或使用Oracle JDK
wget [JDK7下载链接]
tar -zxvf jdk-7u80-linux-x64.tar.gz

2. SELinux/防火墙未关闭

报错现象：
节点间通信失败，Cloudera Manager Agent启动异常

解决方法：

# 临时关闭SELinux
setenforce 0

# 永久关闭（需重启）
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

# 关闭防火墙
systemctl stop firewalld
systemctl disable firewalld

---

三、Cloudera Manager安装报错

1. 数据库连接失败

报错日志：

Failed to connect to database: Access denied for user 'scm'@'localhost'

解决步骤： 1. 检查MySQL权限：

GRANT ALL PRIVILEGES ON scm.* TO 'scm'@'%' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

1. 修改/etc/cloudera-scm-server/db.properties中的连接参数

2. 端口冲突

报错现象：
Cloudera Manager Server启动失败，7180端口被占用

排查方法：

netstat -tulnp | grep 7180
kill -9 [占用进程PID]

---

四、Parcel分发阶段的错误

1. 主机时钟不同步

报错日志：

Clock offset check failed

解决方案：

# 安装NTP服务
yum install ntp -y
ntpdate pool.ntp.org
systemctl start ntpd

2. 磁盘空间不足

报错信息：

Insufficient disk space on /var

处理方法：

# 清理旧日志
rm -rf /var/log/cloudera-*

# 或修改Parcel存储路径
在CM界面修改：Administration > Settings > Parcel Directory

---

五、服务启动阶段的典型错误

1. HDFS NameNode启动失败

报错原因：
NameNode元数据损坏

恢复步骤：

# 1. 停止所有Hadoop服务
# 2. 执行恢复
hdfs namenode -recover
# 3. 选择最新FSImage恢复

2. YARN ResourceManager崩溃

报错日志：

java.lang.OutOfMemoryError: GC overhead limit exceeded

优化方案： 1. 在YARN配置中增加JVM参数：

-XX:+UseG1GC -Xmx8g -Xms8g

1. 调整yarn.scheduler.maximum-allocation-mb

---

六、其他常见问题

1. Python依赖缺失

报错现象：
Agent安装时提示No module named psycopg2

解决方法：

yum install postgresql-devel
pip install psycopg2-binary

2. Kerberos集成失败

关键报错：

GSS initiate failed

检查要点： 1. 确认/etc/krb5.conf配置正确 2. 检查keytab文件权限 3. 验证KDC服务可用性

---

七、总结表格

错误类型	典型报错	解决方式
环境问题	JDK版本不符	降级至JDK7
数据库错误	连接被拒绝	授权远程访问
网络问题	节点通信超时	关闭防火墙
资源不足	OOM错误	调整JVM参数

---

八、附录

1. 日志路径：

   • Cloudera Manager: /var/log/cloudera-scm-server/
   • Agent: /var/log/cloudera-scm-agent/

2. 官方文档：
   Cloudera Troubleshooting Guide

提示：复杂问题建议结合CM界面”收集诊断信息”功能打包日志分析。 “`

注：实际使用时可根据具体环境调整命令参数，建议在操作前做好配置备份。