Руководство для начинающих

В этом Руководстве описывается упрощенная установка Tarantool Column Store в тестовой среде, без использования инстяллятора Ansible Tarantool Enterprise.

Возможны 2 вида установки кластера TCS:

• с локальным файлом конфигурации;
• с файлом конфигурации, хранящимся в etcd.

Также кластер TCS можно разворачивать как на одном сервере (по умолчанию), так и на нескольких серверах.

TCS поддерживает установку на следующие операционные системы (ОС) семейства Linux:

• Astra Linux 1.7;
• РЕД ОС 7.3 Стандарт;
• МосОС Арбат 15.5.

Также возможна установка на Ubuntu и CentOS, но без гарантии полноценной работоспособности.

Если для хранения конфигурации TCS планируется использовать etcd, то нужно дополнительно установить и запустить etcd версии не ниже 3.4.

Здесь описано, как развернуть простейший кластер TCS: один экземпляр Storage на локальном сервере, с локальным файлом конфигурации.

1. Распаковать архив с поставкой TCS и перейти в распакованную директорию.

2. Подготовить файлы конфигурации:

   • В файл config.yml скопировать конфигурацию TCS из примера статического инвентаря для локального кластера.

   • В файле instances.yml указать один экземпляр Storage, который будет развернут на текущем сервере:

      
     instance1: {}

3. Запустить команду ./tt start, чтобы развернуть кластер.

4. Запустить команду ./tt status для проверки того, что кластер поднят.

Пример результата успешной установки:

 
/tt start• Starting an instance [tarantool_column_store: instance1].../tt statusINSTANCE                           STATUS   PID     MODE  CONFIG  BOX      UPSTREAMtarantool_column_store: instance1  RUNNING  319481  RW    ready   running  --

Здесь описано, как развернуть простейший кластер TCS из одного экземпляра Storage на локальном сервере, с файлом конфигурации в etcd.

1. Распаковать архив с поставкой TCS и перейти в распакованную директорию.

2. Подготовить файлы конфигурации:

   • В файле config.yml прописать, откуда в etcd следует брать конфигурацию.

      
     config:  etcd:    prefix: /tarantool/tcs    endpoints:    - http://localhost:2379    http:      request:        timeout: 1

   • В файле instances.yml указать один экземпляр Storage, который будет развернут на текущем сервере:

      
     instance1: {}

   • Создать файл для загрузки в etcd (file.yml), куда нужно скопировать конфигурацию TCS из примера статического инвентаря для локального кластера.

3. Загрузить конфигурацию в etcd:

    
   etcdctl put /tarantool/tcs/config/all "$(cat file.yml)"

4. Запустить команду ./tt start, чтобы развернуть кластер.

5. Запустить команду ./tt status для проверки того, что кластер поднят.

На каждом сервере нужно выполнить установку нужного типа (с локальным файлом конфигурации или хранящимся в etcd). При этом:

• Файлы конфигурации TCS (config.yml) на серверах должны совпадать и содержать настройки для всех экземпляров TCS на всех серверах.

• В файле instances.yml для каждого сервера нужно указать те экземпляры TCS, которые нужно развернуть на данном сервере.

Например:

• instances.yml на сервере А:

   
  instance1:instance2:

• instances.yml на сервере B:

   
  instance3:instance4:

1. Выполнить команду ./tt stop -y для остановки кластера.
2. (Необязательно) Выполнить команду ./tt clean для зачистки журналов и данных.

1. Остановить старый кластер, чтобы он не помешал поднять новую версию, если экземпляры старой и новой версии привязаны к одинаковым портам на одном сервере. Журналы и данные можно не очищать.
2. Установить новую версию системы, не забыв обновить файл конфигурации.