Установка

root@host:~# telnet localhost 2181
Trying 127.0.0.1...
Connected to myhost.
Escape character is '^]'.
stats
Zookeeper version: 3.4.3-cdh4.0.1--1, built on 06/28/2012 23:59 GMT
Clients:

Latency min/avg/max: 0/0/677
Received: 4684478
Sent: 4687034
Outstanding: 0
Zxid: 0xb00187dd0
Mode: leader
Node count: 127182
Connection closed by foreign host.

Компиляция из исходного кода

Требования к компиляции включают:

• Система Linux
• Java Development Kit 1.6 или более поздняя версия
• GnuPlot 4.2 или более поздняя версия
• Autotools
• Make
• Python
• Git
• Подключение к Интернету

Загрузите последнюю версию, используя команду git clone или загрузите выпуск с сайта или Github. Затем просто запустите скрипт build.sh. Этот скрипт помогает выполнить все необходимые процессы для компиляции OpenTSDB: он запускает ./bootstrap (только один раз, при первом получении кода), затем ./configure и make. Выходные данные процесса сборки помещаются в папку build, и JAR-файлы, необходимые OpenTSDB, будут загружены.

git clone git://github.com/OpenTSDB/opentsdb.git
cd opentsdb
./build.sh

Если компиляция прошла успешно, у вас должен быть файл tsdb.jar в ./build, а также скрипт tsdb. Теперь вы можете выполнить инструмент командной строки, вызвав ./build/tsdb, или вы можете запустить make install, чтобы установить OpenTSDB в вашей системе. Если вы передумаете, есть также make uninstall, так что никаких ограничений нет.

Если вам нужно распространить OpenTSDB на машины без подключения к Интернету, вызовите ./build.sh dist, чтобы упаковать каталог сборки в tar-архив, который можно затем скопировать на дополнительные машины.

Структура исходного кода

В репозитории GIT есть две основные ветки. Ветка master — это последняя стабильная версия вместе со всеми исправлениями ошибок, внесёнными между выпусками. В настоящее время ветка master — это OpenTSDB 2.0.1. Ветка next — это следующая основная или дополнительная версия OpenTSDB с новыми функциями и разработкой. Когда next будет стабильной, она будет объединена с master. В настоящее время ветка next — это 2.1.0 RC 1. Могут присутствовать и другие ветки, используемые для тестирования или разработки определённых функций.

Пакет Debian

Вы можете сгенерировать пакет Debian, вызвав sh build.sh debian. Пакет будет расположен в ./build/opentsdb-2.x.x/opentsdb-2.x.x_all.deb. Затем просто распределите пакет и установите его в обычном порядке. Например dpkg -i opentsdb-2.0.0_all.deb.

Пакет Debian создаст следующие каталоги:

• /etc/opentsdb — Файлы конфигурации
• /tmp/opentsdb — Временные кеш-файлы
• /usr/share/opentsdb — Файлы приложения
• /usr/share/opentsdb/bin — Скрипт запуска «tsdb», который запускает TSD или инструменты командной строки
• /usr/share/opentsdb/lib — Файлы Java JAR-библиотеки
• /usr/share/opentsdb/plugins — Местоположение для файлов плагинов и зависимостей
• /usr/share/opentsdb/static — Статические файлы для графического интерфейса
• /usr/share/opentsdb/tools — Скрипты и другие инструменты
• /var/log/opentsdb — Логи

Установка включает скрипт инициализации в /etc/init.d/opentsdb, который может запускать, останавливать и перезапускать OpenTSDB. Просто вызовите service opentsdb start, чтобы запустить tsd, и service opentsdb stop, чтобы корректно завершить работу. Обратите внимание, что после установки tsd не будет запущена, чтобы вы могли изменить файл конфигурации. Измените файл конфигурации, затем запустите TSD.

Пакет Debian также создаёт пользователя и группу opentsdb для запуска TSD, что повышает безопасность. TSD требует только права записи в каталоги временных файлов и логов. Если вы не можете использовать стандартные расположения, измените их в /etc/opentsdb/opentsdb.conf и /etc/opentsdb/logback.xml соответственно и примените соответствующие права для пользователя opentsdb.

При первой установке OpenTSDB вам потребуется создать таблицы HBase с помощью скрипта, расположенного в /usr/share/opentsdb/tools/create_table.sh. Следуйте инструкциям ниже.

Создание таблиц

Если это первый запуск OpenTSDB с вашим экземпляром HBase, вам сначала необходимо создать необходимые таблицы HBase. Предоставлен простой скрипт для создания соответствующих таблиц с возможностью включения или выключения сжатия. Выполните:

env COMPRESSION=NONE HBASE_HOME=path/to/hbase-0.94.X ./src/create_table.sh

где значение COMPRESSION равно NONE, LZO, GZIP или SNAPPY. Это создаст четыре таблицы: tsdb, tsdb-uid, tsdb-tree и tsdb-meta. Если вы просто тестируете OpenTSDB, пока не беспокойтесь о сжатии. В производстве и при масштабировании обязательно используйте действительную библиотеку сжатия, так как это значительно сэкономит объём хранилища.

Запуск TSD

OpenTSDB 2.3 работает с файлом конфигурации, который совместно используется между демоном и инструментами командной строки. Если вы скомпилировали из исходного кода, скопируйте файл ./src/opentsdb.conf в соответствующий каталог, как описано в Конфигурация, и отредактируйте следующие необходимые параметры:

• tsd.http.cachedir — Путь для записи временных файлов
• tsd.http.staticroot — Путь к статическим файлам графического интерфейса, расположенным в ./build/staticroot
• tsd.storage.hbase.zk_quorum — Если HBase и Zookeeper не работают на одной машине, укажите здесь хост и порт.

После написания файла конфигурации вы можете запустить tsd с помощью команды:

./build/tsdb tsd

В качестве альтернативы, вы также можете использовать следующие команды для создания временного каталога и передачи только флагов командной строки:

tsdtmp=${TMPDIR-'/tmp'}/tsd  # For best performance, make sure
mkdir -p "$tsdtmp"       # your temporary directory uses tmpfs
./build/tsdb tsd --port=4242 --staticroot=build/staticroot --cachedir="$tsdtmp" --zkquorum=myhost:2181

В этот момент вы можете получить доступ к веб-интерфейсу TSD по адресу http://127.0.0.1:4242 (если он запущен на вашем локальном компьютере).

env COMPRESSION=NONE HBASE_HOME=path/to/hbase-0.94.X ./src/upgrade_1to2.sh