Installation: HBase Cluster
Create axibase User
Create an axibase user on the server where you plan to install ATSD.
sudo adduser axibase
Install Java
Add the JAVA_HOME path to the axibase user environment in .bashrc.
sudo su axibase
jp=`dirname "$(dirname "$(readlink -f "$(which javac || which java)")")"`; sed -i "s,^export JAVA_HOME=.*,export JAVA_HOME=$jp,g" ~/.bashrc ; echo $jp
exit
Verify Zookeeper Connectivity
Check the connection from the ATSD server to the Zookeeper service.
telnet zookeeper-host 2181
Trying 192.0.2.6...
Connected to zookeeper-host.
Escape character is '^]'.
The Zookeeper client port is specified in:
- Zookeeper host:
/etc/zookeeper/conf.dist/zoo.cfg>clientPortsetting - HBase host:
/etc/hbase/conf.dist/hbase-site.xml>hbase.zookeeper.property.clientPortsetting
Download ATSD Enterprise Edition
HBase 1.0.x
curl -O https://www.axibase.com/public/atsd-cluster.tar.gz
Extract Files
sudo tar -xozvf atsd-cluster.tar.gz -C /opt
sudo chown -R axibase:axibase /opt/atsd
Configure HBase Connection
Open the hadoop.properties file.
nano /opt/atsd/atsd/conf/hadoop.properties
Set hbase.zookeeper.quorum to Zookeeper hostname zookeeper-host
If Zookeeper client port is different from 2181, set hbase.zookeeper.property.clientPort accordingly.
If Zookeeper Znode parent is not /hbase, set zookeeper.znode.parent to the actual value.
hbase.zookeeper.quorum = zookeeper-host
hbase.zookeeper.property.clientPort = 2181
zookeeper.znode.parent = /hbase
hbase.rpc.timeout = 120000
hbase.client.scanner.timeout.period = 120000
Request License Key
To obtain the license key, contact Axibase support with the following information from the server where you plan to install ATSD.
- Output of the
ip addrcommand.
ip addr
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 16436 qdisc noqueue state UNKNOWN
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
link/ether 00:50:56:b9:35:31 brd ff:ff:ff:ff:ff:ff
inet 192.0.2.6/24 brd 192.0.2.255 scope global eth1
inet6 2a01:4f8:140:53c6::7/64 scope global
valid_lft forever preferred_lft forever
inet6 fe80::250:56ff:feb9:3531/64 scope link
valid_lft forever preferred_lft forever
- Output of the
hostnamecommand.
hostname -f
NURSWGVML007
Email output of the above commands to Axibase support and copy the provided key to /opt/atsd/atsd/conf/license/key.properties.
Configure HBase Region Servers
Deploy ATSD coprocessors
Copy /opt/atsd/hbase/lib/atsd.jar to the /usr/lib/hbase/lib directory on each HBase region server.
Enable ATSD Coprocessors
Add the following property to {HBASE_HOME}/conf/hbase-site.xml.
<property>
<name>hbase.coprocessor.region.classes</name>
<value>com.axibase.tsd.hbase.coprocessor.DeleteDataEndpoint, com.axibase.tsd.hbase.coprocessor.CompactRawDataEndpoint, com.axibase.tsd.hbase.coprocessor.MessagesStatsEndpoint <!--, org.apache.hadoop.hbase.coprocessor.example.BulkDeleteEndpoint--></value>
</property>
Restart HBase Region Servers
Check for Port Conflicts
sudo netstat -tulpn | grep "8081\|8082\|8084\|8088\|8443"
If some of the above ports are taken, open the /opt/atsd/atsd/conf/server.properties file and change ATSD listening ports accordingly.
http.port = 8088
input.port = 8081
udp.input.port = 8082
pickle.port = 8084
https.port = 8443
Start ATSD
/opt/atsd/atsd/bin/start-atsd.sh
Review the start log for any errors:
tail -f /opt/atsd/atsd/logs/atsd.log
Watch for ATSD start completed message at the end of the start.log.
Web interface is now accessible on port 8443 (HTTPS).
Enable ATSD Auto-Start
To configure ATSD for automated restart on server reboot, add the following line to /etc/rc.local before the return 0 line.
su - axibase -c /opt/atsd/atsd/bin/start-atsd.sh
Troubleshooting
- Review troubleshooting guide.