Configure and Start Apache WebHCat (Templeton)

Before you can upgrade Apache WebHCat, you must have first upgraded your HDP components to the latest version (in this case, 2.4.0). This section assumes that you have already upgraded your components for HDP 2.4.0. If you have not already completed these steps, return to Getting Ready to Upgrade and Upgrade 1.3 Components for instructions on how to upgrade your HDP components to 2.4.0.

RHEL/CentOS/Oracle Linux

Copy the appropriate configurations from /etc/hcatalog/conf to /etc/hive- webhcat/conf/.
Copy the new Pig, Hive and Hadoop-streaming jars to HDFS using the path you specified in ./etc/hive-webhcat/conf/ and change ownership to the hcat user with 755 permissions. For example:
hdfs dfs -copyFromLocal /usr/share/HDP-webhcat/hive.tar.gz /usr/share/HDP-webhcat/pig.tar.gz/usr/hdp/version/hadoop-mapreduce/hadoop-streaming.jar hdfs:///apps/webhcat/.
hdfs dfs -chmod -R 755 hdfs:///apps/webhcat/*
hdfs dfs -chown -R hcat hdfs:///apps/webhcat/*
Replace your WebHCat configuration after upgrading. Copy your modified /etc/webhcat/conf from the template to the configuration directory in all your WebHCat hosts.
Start WebHCat:
sudo su -l $WEBHCAT_USER -c "//hive-hcatalog/sbin/webhcat_server.sh start"
Smoke test WebHCat.
On the WebHCat host machine, run the following command:
http://$WEBHCAT_HOST_MACHINE:50111/templeton/v1/status
If you are using a secure cluster, run the following command:
curl --negotiate -u:http://cluster.$PRINCIPAL.$REALM:50111/templeton/v1/ status{"status":"ok","version":"v1"}[machine@acme]$
Remove shared libraries from old Templeton installation.
On the WebHCat host machine, run the following command:
sudo su -l $HDFS_USER -c "hdfs dfs -rmr -skipTrash /apps/templeton" rm -rf /usr/share/HDP-templeton
where
- $WEBHCAT_USERis the WebHCat Service user. For example, hcat.
- $HDFS_USERis the HDFS Service user. For example, hdfs.

SLES

Copy the appropriate configurations from /etc/hcatalog/conf to /etc/hive-webhcat/conf/.
Copy the new Pig, Hive and Hadoop-streaming jars to HDFS using the path you specified in ./etc/hive-webhcat/conf/ and change ownership to the hcat user with 755 permissions. For example:
hdfs dfs -copyFromLocal /usr/share/HDP-webhcat/hive.tar.gz /usr/share/HDP-webhcat/pig.tar.gz/usr/hdp/version/hadoop-mapreduce/hadoop-streaming.jar hdfs:///apps/webhcat/.
hdfs dfs -chmod -R 755 hdfs:///apps/webhcat/*
hdfs dfs -chown -R hcat hdfs:///apps/webhcat/*
Replace your WebHCat configuration after upgrading. Copy your modified /etc/webhcat/conf from the template to the configuration directory in all your WebHCat hosts.

Modify the WebHCat configuration files.

Upload Pig, Hive and Sqoop tarballs to HDFS as the $HDFS_User. In this example, hdfs:

hdfs dfs -mkdir -p /hdp/apps/2.4.0.0-$BUILD/pig/
hdfs dfs -mkdir -p /hdp/apps/2.4.0.0-$BUILD/hive/
hdfs dfs -mkdir -p /hdp/apps/2.4.0.0-$BUILD/sqoop/
hdfs dfs -put /usr/hdp/2.4.0.0-$BUILD/pig/pig.tar.gz /hdp/apps/2.4.0.0-$BUILD/pig/
hdfs dfs -put /usr/hdp/2.4.0.0-$BUILD/hive/hive.tar.gz /hdp/apps/2.4.0.0-$BUILD/hive/
hdfs dfs -put /usr/hdp/2.4.0.0-$BUILD/sqoop/sqoop.tar.gz /hdp/apps/2.4.0.0-$BUILD/sqoop/
hdfs dfs -chmod -R 555 /hdp/apps/2.4.0.0-$BUILD/pig
hdfs dfs -chmod -R 444 /hdp/apps/2.4.0.0-$BUILD/pig/pig.tar.gz
hdfs dfs -chmod -R 555 /hdp/apps/2.4.0.0-$BUILD/hive
hdfs dfs -chmod -R 444 /hdp/apps/2.4.0.0-$BUILD/hive/hive.tar.gz
hdfs dfs -chmod -R 555 /hdp/apps/2.4.0.0-$BUILD/sqoop
hdfs dfs -chmod -R 444 /hdp/apps/2.4.0.0-$BUILD/sqoop/sqoop.tar.gz
hdfs dfs -chown -R hdfs:hadoop /hdp

Update the following properties in the webhcat-site.xml configuration file, as their values have changed:

<property>
 <name>templeton.pig.archive</name>
 <value>hdfs:///hdp/apps/${hdp.version}/pig/pig.tar.gz</value>
</property>
 
</property>
 <name>templeton.hive.archive</name>
 <value>hdfs:///hdp/apps/${hdp.version}/hive/hive.tar.gz</value>
</property>
 
</property>
 <name>templeton.streaming.jar</name>
 <value>hdfs:///hdp/apps/${hdp.version}/mapreduce/hadoop-streaming.jar</value>
 <description>The hdfs path to the Hadoop streaming jar file.</description>
</property>
 
</property>
 <name>templeton.sqoop.archive</name>
 <value>hdfs:///hdp/apps/${hdp.version}/sqoop/sqoop.tar.gz</value>
 <description>The path to the Sqoop archive.</description>
</property>
 
</property>
 <name>templeton.sqoop.path</name>
 <value>sqoop.tar.gz/sqoop/bin/sqoop</value>
 <description>The path to the Sqoop executable.</description>
</property>
 
</property>
 <name>templeton.sqoop.home</name>
 <value>sqoop.tar.gz/sqoop</value>
 <description>The path to the Sqoop home in the exploded archive.</description>
</property>

	Note
	You do not need to modify ${hdp.version}.

Remove the following obsolete properties from webhcat-site.xml:

<property>
 <name>templeton.controller.map.mem</name>
 <value>1600</value>
 <description>Total virtual memory available to map tasks.</description>
</property>

</property>
 <name>hive.metastore.warehouse.dir</name>
 <value>/path/to/warehouse/dir</value>
</property>

Add new proxy users, if needed. In core-site.xml, make sure the following properties are also set to allow WebHcat to impersonate your additional HDP 2.4.0 groups and hosts:
```
<property>
 <name>hadoop.proxyuser.hcat.groups</name>
 <value>*</value>
</property> 
 
</property>
 <name>hadoop.proxyuser.hcat.hosts</name>
 <value>*</value>
</property>
```
Where:
hadoop.proxyuser.hcat.group
Is a comma-separated list of the Unix groups whose users may be impersonated by 'hcat'.
hadoop.proxyuser.hcat.hosts
A comma-separated list of the hosts which are allowed to submit requests by 'hcat'.

Start WebHCat:
su -l hcat -c "/usr/hdp/current/hive-webhcat/sbin/webhcat_server.sh start"
Smoke test WebHCat.
On the WebHCat host machine, run the following command:
http://$WEBHCAT_HOST_MACHINE:50111/templeton/v1/status
If you are using a secure cluster, run the following command:
curl --negotiate -u:http://cluster.$PRINCIPAL.$REALM:50111/templeton/v1/ status{"status":"ok","version":"v1"}[machine@acme]$
Remove shared libraries from old Templeton installation.
On the WebHCat host machine, run the following command:
sudo su -l $HDFS_USER -c "hdfs dfs -rmr -skipTrash /apps/templeton" rm -rf /usr/share/HDP-templeton
where
- $WEBHCAT_USER is the WebHCat Service user. For example, hcat.
- $HDFS_USER is the HDFS Service user. For example, hdfs.

Ubuntu/Debian

HDP support for Debian 6 is deprecated with HDP 2.4.0. Future versions of HDP will no longer be supported on Debian 6.

Copy the appropriate configurations from /etc/hcatalog/conf to /etc/hive- webhcat/conf/.
Copy the new Pig, Hive and Hadoop-streaming jars to HDFS using the path you specified in ./etc/hive-webhcat/conf/ and change ownership to the hcat user with 755 permissions. For example:
hdfs dfs -copyFromLocal /usr/share/HDP-webhcat/hive.tar.gz /usr/share/HDP- webhcat/pig.tar.gz/usr/hdp/version/hadoop-mapreduce/hadoop-streaming.jar hdfs:///apps/webhcat/.
hdfs dfs -chmod -R 755 hdfs:///apps/webhcat/*
hdfs dfs -chown -R hcat hdfs:///apps/webhcat/*
Replace your WebHCat configuration after upgrading. Copy your modified /etc/webhcat/conf from the template to the configuration directory in all your WebHCat hosts.
Start WebHCat:
sudo su -l $WEBHCAT_USER -c "/usr/lib/hive-hcatalog/sbin/webhcat_server.sh start"
Smoke test WebHCat.
On the WebHCat host machine, run the following command:
http://$WEBHCAT_HOST_MACHINE:50111/templeton/v1/status
If you are using a secure cluster, run the following command:
curl -&-negotiate -u:http://cluster.$PRINCIPAL.$REALM:50111/templeton/v1/ status{"status":"ok","version":"v1"}[machine@acme]$
Remove shared libraries from old Templeton installation.
On the WebHCat host machine, run the following command:
sudo su -l $HDFS_USER -c "hdfs dfs -rmr -skipTrash /apps/templeton" rm -rf /usr/share/HDP-templeton
where
- $WEBHCAT_USER is the WebHCat Service user. For example, hcat.
- $HDFS_USER is the HDFS Service user. For example, hdfs.

​Configure and Start Apache WebHCat (Templeton)

Configure and Start Apache WebHCat (Templeton)