This is the documentation for Cloudera Manager 5.1.1.
Documentation for other versions is available at Cloudera Documentation.

Troubleshooting Installation and Upgrade Problems

For information on known issues, see http://www.cloudera.com/content/cloudera-content/cloudera-docs/CM5/latest/Cloudera-Manager-Release-Notes/cm5rn_known_issues.html.

Symptom Reason Solution
"Failed to start server" reported by cloudera-manager-installer.bin. /var/log/cloudera-scm-server/cloudera-scm-server.log contains a message beginning Caused by: java.lang.ClassNotFoundException: com.mysql.jdbc.Driver... You may have SELinux enabled. Disable SELinux by running sudo setenforce 0 on the Cloudera Manager Server host. To disable it permanently, edit /etc/selinux/config.
Installation interrupted and installer won't restart. You need to do some manual cleanup. See Uninstalling Cloudera Manager and Managed Software.
Cloudera Manager Server fails to start and the Server is configured to use a MySQL database to store information about service configuration. Tables may be configured with the ISAM engine. The Server will not start if its tables are configured with the MyISAM engine, and an error such as the following will appear in the log file:
Tables ... have unsupported engine type ... .  InnoDB is required. 
Make sure that the InnoDB engine is configured, not the MyISAM engine. To check what engine your tables are using, run the following command from the MySQL shell: mysql> show table status;

For more information, see MySQL Database.

Agents fail to connect to server. Error 113 ('No route to host') in /var/log/cloudera-scm-agent/cloudera-scm-agent.log. You may have SELinux or iptables enabled. Check /var/log/cloudera-scm-server/cloudera-scm-server.log on the Server host and /var/log/cloudera-scm-agent/cloudera-scm-agent.log on the Agent hosts. Disable SELinux and iptables.
Some cluster hosts do not appear when you click Find Hosts in install or update wizard. You may have network connectivity problems.
  • Make sure all cluster hosts have SSH port 22 open.
  • Check other common causes of loss of connectivity such as firewalls and interference from SELinux.
"Access denied" in install or update wizard during database configuration for Activity Monitor or Reports Manager. Hostname mapping or permissions are incorrectly set up.
  • For hostname configuration, see Configuring Network Names (for CDH 5) or Configuring Network Names (for CDH 4).
  • For permissions, make sure the values you enter into the wizard match those you used when you configured the databases. The value you enter into the wizard as the database hostname must match the value you entered for the hostname (if any) when you configured the database.

    For example, if you entered the following for the Activity Monitor database:

    grant all on activity_monitor.* TO 'amon_user'@'localhost' IDENTIFIED BY 'amon_password';

    the value you enter here for the database hostname must be localhost. On the other hand, if you had entered the following when you created the database

    grant all on activity_monitor.* TO 'amon_user'@'myhost1.myco.com' IDENTIFIED BY 'amon_password';

    the value you enter here for the database hostname must be myhost1.myco.com. If you did not specify a host, or used a wildcard to allow access from any host, you can enter either the fully-qualified domain name (FQDN), or localhost. For example, if you entered

    grant all on activity_monitor.* TO 'amon_user'@'%' IDENTIFIED BY 'amon_password';

    the value you enter for the database hostname can be either the FQDN or localhost. Similarly, if you entered

    grant all on activity_monitor.* TO 'amon_user' IDENTIFIED BY 'amon_password';

    the value you enter for the database hostname can be either the FQDN or localhost.

Activity Monitor, Reports Manager, or Service Monitor databases fail to start. MySQL binlog format problem. Set binlog_format=mixed in /etc/my.cnf. For more information, see this MySQL bug report. See also Cloudera Manager and Managed Service Databases.
You have upgraded the Cloudera Manager Server, but now cannot start services. You may have mismatched versions of the Cloudera Manager Server and Agents. Make sure you have upgraded the Cloudera Manager Agents on all hosts. (The previous version of the Agents will heartbeat with the new version of the Server, but you can't start HDFS and MapReduce with this combination.)
Cloudera services fail to start. Java may not be installed or may be installed at a custom location. See Configuring a Custom Java Home Location for more information on resolving this issue.
The Activity Monitor displays a status of BAD in the Cloudera Manager Admin Console. The log file contains the following message:
ERROR 1436 (HY000): Thread stack overrun: 7808 bytes used of a 131072 byte stack, and 128000 bytes needed. 
Use 'mysqld -O thread_stack=#' to specify a bigger stack. 
The MySQL thread stack is too small.
  1. Update the thread_stack value in my.cnf to 256KB. The my.cnf file is normally located in /etc or /etc/mysql.
  2. Restart the mysql service: $ sudo service mysql restart
  3. Restart Activity Monitor.
The Activity Monitor fails to start. Logs contain the error read-committed isolation not safe for the statement binlog format. The binlog_format is not set to mixed. Modify the mysql.cnf file to include the entry for binlog format as specified in MySQL Database.
Attempts to reinstall older versions of CDH or Cloudera Manager using yum fails. It is possible to install, uninstall, and reinstall CDH and Cloudera Manager. In certain cases, this does not complete as expected. If you install Cloudera Manager 5 and CDH 5, then uninstall Cloudera Manager and CDH, and then attempt to install CDH 4 and Cloudera Manager 4, incorrect cached information may result in the installation of an incompatible version of the Oracle JDK. Clear information in the yum cache:
  1. Connect to the CDH host.
  2. Execute either of the following commands: $ yum --enablerepo='*'clean all or $ rm -rf /var/cache/yum/cloudera*
  3. After clearing the cache, proceed with installation.
Hive, Impala, or Hue complains about a missing table in the Hive Metastore database. The Hive Metastore database must be upgraded after a major Hive version change (Hive had a major version change in CDH 4.0, 4.1, 4.2, and 5.0). Follow the instructions in the Upgrading Hive for upgrading the Hive Metastore database schema. Stop all Hive services before performing the upgrade.
The Create Hive Metastore Database Tables command fails due to a problem with an escape string. PostgreSQL versions 9 and later require special configuration for Hive because of a backward-incompatible change in the default value of the standard_conforming_strings property. Versions up to PostgreSQL 9.0 defaulted to off, but starting with version 9.0 the default is on. As the administrator user, use the following command to turn standard_conforming_strings off:
ALTER DATABASE <hive_db_name> SET standard_conforming_strings = off; 
After upgrading to CDH 5, HDFS DataNodes fail to start with exception:
Exception in secureMainjava.lang.RuntimeException: Cannot start datanode because the configured max locked memory size (dfs.datanode.max.locked.memory) of 4294967296 bytes is more than the datanode's available RLIMIT_MEMLOCK ulimit of 65536 bytes.
HDFS caching, which is enabled by default in CDH 5, requires new memlock functionality from Cloudera Manager 5 Agents. Do the following:
  1. Stop all CDH and managed services.
  2. On all hosts with Cloudera Manager Agents, run the command:
    $ sudo service cloudera-scm-agent hard_restart
    Before performing this step, ensure you understand the semantics of the hard_restart command by reading Hard Stopping and Restarting Agents.
  3. Start all services.