Установка и запуск платформы Waves Enterprise

На данный момент мы поддерживаем операционные системы на базе Unix (например, популярные дистрибутивы Linux или MacOS). Однако платформа Waves Enterprise может быть запущена и под Windows в экспериментальном режиме. Вы также можете использовать такие решения, как виртуальные машины с Unix подобной системой или среду Docker для установки и запуска платформы Waves Enterprise на операционной системе Windows.

Платформа Waves Enterprise поддерживает два вида криптографии: ГОСТ-криптографию на базе ПО «КриптоПро Java CSP» или встроенный модуль Waves-криптографии. Если хотите использовать ГОСТ-криптографию, обратитесь в службу поддержки Waves Enterprise для получения дополнительной информации.

Важно

Нода Waves Enterprise устанавливается на отдельную машину от других блокчейн-нод платформы Waves.

Виды установки платформы

Платформа Waves Enterprise может конфигурироваться в ручном и автоматическом режимах. Процесс разворачивания и запуска платформы для систем Linux и MacOS одинаковый. Для конфигурации и запуска всех сервисов платформы необходимо установить дополнительно приложения Docker CE и Docker-compose.

Если вы запускаете и настраиваете только ноду, например, для подключения к сетям Mainnet или Partnernet, выполните перед запуском ручную конфигурацию ноды. В остальных случаях легче устанавливать и настраивать платформу в автоматическом режиме. После разворачивания платформы локально вы всегда можете обратиться к конфигурационным файлам нод, входящих в блокчейн, для последующей настройки платформы Waves Enterprise.

Автоматическое развертывание платформы

  1. Скачайте и установите дистрибутивы Docker CE и Docker-compose. Для скачивания потребуется регистрация на сайте.

    После установки убедитесь, что успешно установились приложения Docker CE и Docker-compose (часть дистрибутива Docker CE):
    ../_images/docker_check_linuxMac.png
    Для операционных систем семейств Linux и macOS используются команды docker --version и docker-compose --version.
  2. Скачайте актуальный установочный файл install.sh с официальной страницы платформы Waves Enterprise на GitHub.

  1. Откройте терминал, создайте рабочую директорию и перейдите в неё.

  2. Запустите следующую команду:

sh install.sh

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

Внимание

На ОС Linux данная команда выполняется с правами администратора (права root).

  1. Платформа запускается следующей командой:

    docker-compose up -d
    

Внимание

При запуске ноды выполняется проверка доступных ресурсов. Если доступных ресурсов меньше минимальных, то нода не сможет стартовать! Минимальные и рекомендованные требования к аппаратным характеристикам приведены в разделе Системные требования. Если вы запускаете все три ноды на одной машине, необходимо выделить не менее 10 ГБ оперативной памяти и 6 ядер процессора для Docker.

  1. Остановка ноды выполняется командой:

    docker-compose down
    

Отправка транзакций из веб-клиента

После того, как блокчейн-платформа стартовала, выполните следующие действия:

  1. Откройте браузер и введите в адресную строку значение http://localhost.

  2. Зарегистрируйтесь в веб-клиенте, используя любой действительный электронный адрес, и зайдите в веб-клиент.

  3. Откройте страницу Выберите адрес -> Добавить адрес вручную.

  4. Заполните поля, указанные ниже. Значения вы можете взять из конфигурационного файла accounts.conf для первой ноды в каталоге nodes/node-1.

    • Сетевой адрес ноды - укажите значение http://localhost/nodeAddress.

    • Адрес - укажите адрес ноды. См. поле Address, отмеченное на картинке ниже.

    • Пароль от ключевой пары - укажите пароль от ключевой пары ноды. См. поле Key-pair password, отмеченное на картинке ниже.

../_images/accountsConf.png
  1. Также вы можете просто создать новый пользовательский блокчейн-адрес, используя страницу Выберите адрес -> Создать адрес и следуя подсказкам веб-интерфейса.

Теперь можно отправлять транзакции из веб-клиента от адреса ноды.

Развертывание одной ноды в ручном режиме

  1. Проверьте, установлены ли приложения Docker CE и Docker-compose в вашей операционной системе.

  2. Скачайте актуальный релиз ноды и шаблон соответствующего конфигурационного файла со страницы проекта в GitHub. В релиз входят следующие файлы:

    • утилита generators-x.x.x.jar, которая используется для создания аккаунта и ключевой пары;

    • конфигурационный файл docker-compose-one-node.yml для запуска ноды.

  3. Выполните конфигурацию ноды в соответствии с руководством «Ручная конфигурация ноды». Ручная конфигурация также нужна, если вы хотите дополнительно настроить ноду, например, включить или отключить опции, изменить параметры консенсуса или майнинга и др.

  4. Создайте рабочий каталог, например, node, и поместите туда следующие файлы:

    • конфигурационный файл запуска ноды docker-compose-one-node.yml;

    • конфигурационный файл ноды node.conf;

    • файл keystore.dat, созданный в процессе генерации аккаунта и ключевой пары.

  1. В рабочем каталоге откройте терминал от имени администратора и выполните следующую команду для запуска ноды:

    docker-compose -f docker-compose-one-node.yml up -d
    

Внимание

При запуске ноды выполняется проверка доступных ресурсов. Если доступных ресурсов меньше минимальных, то нода не сможет стартовать! Минимальные и рекомендованные требования к аппаратным характеристикам приведены в разделе Системные требования.

  1. Остановка ноды выполняется командой:

    docker-compose -f docker-compose-one-node.yml down