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.