[IMPALA-704] Impala 1.2.1 Doc Bug - Does not mentions settings for new catalog server host name / port name if remote

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: Impala 1.2.1
• Component/s: Docs
• Labels: configuration impala missing
• Environment: Centos
• Assignee: John Russell
• Reporter: Manoj Samel
• Created: 13/Dec/13 19:32
• Updated: 17/Jul/14 17:59
• Resolved: 17/Jul/14 17:59

Description

Impala 1.2.1 documentation recommends colocating the new catalogd with statestore-d and having these on separate machine than impala-d. The documentation however does not mentions that in /etc/default/impala, parameters -catalog_service_host (& also port if non-default) has to be set for this recommended setup to work. The documentation does not mentions any setup for the new catalog server.

Without this, you get error "ERROR: Couldn't open transport for localhost:26000(connect() failed: Connection refused)" when trying to run a DDL or "invalidate metadata" in impala-shell

• Add the catalogd setup in the documentation for /etc/default/impala
• Move this documentation as part of the initial configuration section (before section on starting impala) so users don't hit errors. At moment, the documentation on /etc/default/impala is towards the end of documentation which most people will miss when doing the initial setup.

Please refer to https://groups.google.com/a/cloudera.org/forum/#!topic/impala-user/gKVHQBmGA2c for background.