Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Утилита ecss-control служит для создания резервных архивов конфигурации, восстановления ECSS-10 из этих архивов, а также для разделения кластера на 2 независимые ноды для дальнейшего независимого обновления каждой из них. Данная утилита включена в состав пакета ecss-node.

Оглавление

Описание аргументов ecss-control

man

Без форматирования
ECSS-10(8)                                               BSD System Manager's Manual                                               ECSS-10(8)

NAME
     ecss-control

SYNOPSIS
     ecss-controlS
     ACTION

Actions
     debug | de
              Включить отладочный режим

     verbose | v
              Включить отладочные логи

     stash <DESTINATION DIRECTORY>
              Архивация текущей конфигурации и логов ECSS-10

     stash-config | stash-cfg <DESTINATION DIRECTORY>
              Архивация текущей конфигурации ECSS-10 без логов.

     rollback | rb <SOURCE FILE>
              Применить конфигурацию ECSS-10 из указанного файла

     detash   Изолировать текущий хост, кроме SSH/22 и KA/112

     attach   Снять изолицию с хоста

     log-clean | lc
              Очистить логи ECSS-10

     help     Показать справку

DESCRIPTION
     ecss-control — Утилита для еправления ECSS-10. Предназначена для сохранения конфигов, а также для их накатывания. Также возможно
     использовать для изоляции хоста.

FILES
     /usr/bin/ecss-control

 Manual page ecss-control(8) line 1/45 90% (press h for help or q to quit)

debug

Данный аргумент является необязательным и используется в связке с другими аргументами. При его использовании на терминале отображается подробный трейс выполняемых команд.

...

Без форматирования
ssw@ecss1:~$ sudo ecss-control debug stash
+ export DEBUG=true
+ DEBUG=true
+ shift
+ [[ -n stash ]]
+ CMD=stash

verbose

Данный аргумент является необязательным и используется в связке с другими аргументами. При его использовании в терминале отображается последовательность действий, выполняемых той или иной командой.

...

Без форматирования
ssw@ecss1:~$ sudo ecss-control verbose stash
please enter root password for mysql db:
Enter password: 
-- Connecting to localhost...
-- Starting transaction...
-- Setting savepoint...
-- Retrieving table structure for table ecss_audit_commands...
-- Sending SELECT query...
-- Retrieving rows...

stash

Синтаксис:

stash [--no-sql | --no-log | --no-config | --last-log | --push ] [<каталог>] - в имени итогового файла будет указано, с какими опциями он был создан

...

В дальнейшем при помощи созданного архива можно восстановить конфигурацию ECSS-10 при помощи команды 3.11 Приложение О Описание утилиты ecss-control.rollback.

Пример:

Без форматирования
sasha@ecss1:~/ssw1_3.12$ sudo ecss-control stash
[sudo] password for sasha: 
please enter root password for mysql db:
Enter password: 
stashing ECSS-10...

...

Без форматирования
sasha@ecss1:~/ssw1_3.12$ sudo ecss-control stash
[sudo] password for sasha: 
please enter root password for mysql db:
Enter password: 
stashing ECSS-10...

Якорь
rollback
rollback
rollback

Данный аргумент позволяет восстановить конфигурацию ECSS-10 из ранее созданного архива.

...

Без форматирования
sasha@ecss1:~/ssw1_3.12$ sudo ecss-control rollback ecss-stash-full-20181217-104135.tar.gz 
WARNING: Before rollback current configuration and logs will be stashed and then cleared
         Stash archive will be saved at /home/sasha/ssw1_3.12
please enter root password for mysql db:
Enter password: 
stashing ECSS-10...
create stashed file: /home/sasha/ssw1_3.12/ecss-stash-full-20181217-111939.tar.gz
done
cleaning ECSS-10...
done
rollback configuration from ecss-stash-full-20181217-104135.tar.gz
please enter root password for mysql db:
Enter password: 
stashed file successfull rollbacked

detach

Использование данного аргумента позволяет вывести ноду из кластера. Это требуется для обновления обновления ПО на новую версию без перерыва в обслуживании, подробное описание данного процесса приведено в пункте  Методика разделения (split) кластера. В результате выполнения команды будет заблокирован весь трафик между нодами за исключением SSH, keepalive/multicast, а в консоле будет вывод о том, от какой ноды было произведено отсоединение + ее IP адрес.

...

Без форматирования
sasha@ecss1:~/ssw1_3.14$ sudo ecss-control detach
detach host: ecss2, ip: 192.168.1.22

attach

Аргумент возвращает ранее изолированную ноду в кластер и разблокирует весь трафик между ними, подробное описание данного процесса приведено в пункте  Методика разделения (split) кластера. В выводе команды будет отображаться разблокированный IP адрес.

...

Без форматирования
sasha@ecss1:~/ssw1_3.14$ sudo ecss-control attach
unlock ip: 192.168.1.22, rules: 7
complete

status

Позволяет просмотреть статус ноды, находится ли она в кластере или же изолирована от него.

...

Без форматирования
ssw@ecss1:~$ sudo ecss-control status
all nodes attached

clean

Команда с данным аргументом удаляет логи, сохраняя структуру каталогов, а также файлы конфигурации

...

Без форматирования
sasha@ecss1:~/ssw1_3.14$ sudo ecss-control clean --no-config
[sudo] password for sasha: 
cleaning ECSS-10...
don

log-clean

Команда с данным аргументом удаляет файлы логов из каталога /var/log/ecss/

...

Другие подсистемы перезапускать не нужно.

help

Вывод справки.

Пример:

Без форматирования
sasha@ecss2:/var/log/ecss$ ecss-control help
    Usage: sudo /usr/bin/ecss-control [ACTION]
     where ACTION - one of:
        attach - back host to opertate
        detach - isolate current host from other ecss hosts, except SSH/22 and KA/112
        debug|de - enable debug trace
        help - print current help
        log-clean|lc - clean logs
        rollback|rb [--no-clean] [--no-stash] <DESTINATION FILE> - rollback configuration ecss10 from selected archive
            For correct execution before rollback current configuration and logs will be stashed and then cleared.
            After will be started rollback.
            Options:
                --no-clean - current configuration and logs won't be cleared;
                --no-stash - current configuration and logs won't be stashed;
        stash [<OPTIONS>] [<DESTINATION DIRECTORY>] [--push [<PUSH OPTIONS>]] - make archive of current configuration and logs ecss10
            If <DESTINATION DIRECTORY> not specified, then using current directory
            Options:
                --last-log  - stash only last logs;
                --no-sql    - skip SQL-database stashing;
                --no-config - skip configuration stashing$;
                --no-log    - skip logs stashing;
                --push      - push stashed data to tech support;
            Push options:
                --clear   - archive will be removed after executing;
                --files   - all files or directories specified between this and another option will be included to pushing;
                --comment - all input between this and another option will be used as issue description in pushing;
        clean [<OPTIONS>] - clean current configuration and logs ecss10
            Options:
                --no-config - skip configuration cleaning
                --no-log    - skip logs cleaning
        verbose|v - enable verbose output

    examples:
     /usr/bin/ecss-control stash ~

...