XMS микросервисная система включает в себя:

• API-шлюз;
• сервис логирования;
• конфигурационный сервис;
• регистрационный сервис;
• коммуникационный компонент SDK;
• базу данных для чтения и записи SDK.

За исключением модулей типа SDK, остальные модули должны иметь возможность независимого развёртывания в кластере. Система XMS предоставляет интерфейс управления системой C/S, который позволяет выполнять управление конфигурацией, мониторинг состояния сервисов и функции запроса журналов.

Подготовка среды компиляции Windows

Установите VS2017 Community Edition и QT5.9.

Подготовка компиляционной среды Linux

Используйте Ubuntu 18.04.02 x64.

Общие инструменты

Выполните команду: apt-get install perl g++ make automake libtool unzip git.

Компиляция и установка зависимостей

1. Zlib (необходим для protobuf и libevent) (сжатие):

   • распакуйте архив zlib-1.2.11.tar.gz;
   • перейдите в каталог zlib-1.2.11;
   • выполните команду ./configure;
   • выполните команду make -j32;
   • выполните команду make install.

   Установка будет произведена в каталоги /usr/local/include/ и /usr/local/lib.

2. OpenSSL (необходим для libevent) (безопасность и шифрование):

   • распакуйте архив openssl-1.1.1.tar.gz;
   • перейдите в каталог openssl-1.1.1;
   • выполните команду ./config;
   • выполните команду make -j32;
   • выполните команду make install.

   Команда openssl будет доступна в каталоге /usr/local/bin. Файлы конфигурации будут установлены в каталог /usr/local/ssl. Заголовочные файлы — в /usr/local/include/openssl. Библиотеки — в /usr/local/lib.

3. Protobuf (коммуникационный протокол):

   • разархивируйте файл protobuf-all-3.8.0.zip;
   • перейдите в каталог protobuf-3.8.0;
   • выполните команду ./configure;
   • выполните команду make -j32;
   • выполните команду make install.

   Файлы будут установлены в каталог /usr/local/include/google/protobuf. Утилита protoc будет доступна в каталоге /usr/local/bin. Библиотеки — в каталоге /usr/local/lib.

4. Libevent (сетевое взаимодействие):

   • разархивируйте архив libevent-master.zip;
   • запустите скрипт autogen.sh;
   • запустите скрипт configure;
   • выполните команду make -j32;
   • выполните команду make install.

   Библиотеки будут установлены в каталоги /usr/local/lib и /usr/local/include.

Установка системы XMS

1. Установка сервера базы данных (Linux):

• установка клиентской библиотеки базы данных:

  • apt-get install libmysqlclient-dev;

• установка сервера базы данных:

  • sudo apt-get install mysql-server;

• настройка имени пользователя и пароля:

  • файл /etc/mysql/debian.cnf содержит информацию о пользователе и пароле, назначенных системой по умолчанию;
  • mysql -u debian-sys-maint -p;
  • set password for 'root'@'localhost' = password('123456').

2. Установка библиотеки LXMysql:

• apt-get install libmysqlclient-dev;
• перейдите в каталог /root/xms/src/LXMysql;
• выполните команды make -j32 и make install;
• библиотека будет установлена в каталог /usr/lib/libLXMysql.so.

3. Установка коммуникационной библиотеки XPlatform:

• перейдите в каталог xplatform;

• сгенерируйте код C++ на основе прототипа:

  • make proto;

• скомпилируйте:

  • make -j32;

• установите:

  • make install;

• библиотека будет установлена в каталог /usr/lib/libxcom.so.

4. Установка регистрационного центра XRC:

• зависит от XPlatform и подключается к XLOG;
• установка серверной части службы регистрации:
  • cd ../register_server;
  • скомпилируйте и установите:
    • make -j32;
    • make install.

5. Регистрация клиентского приложения:

• cd ../register_client;
• скомпилируйте и установите:
  • make -j32;
  • make install.

6. Установка центра регистрации XLOG:

• зависит от XPlatform, LXMysql, register_client и подключается к регистрационному центру XRC;
• установка центра регистрации:
  • cd ../xlog/;
  • скомпилируйте и установите:
    • make -j32;
    • make install.

7. Конфигурационный центр:

• установка серверного приложения:

  • cd ../config_server;
  • скомпилируйте и установите:
    • make -j32;
    • make install;

• установка клиентского приложения:

  • cd ../config_client;
  • скомпилируйте и установите:
    • make -j32;
    • make install.

8. Центр аутентификации XAUTH:

• зависит от LXMysql, XPlatform, register_client, config_client;
• подключение к регистрационному центру через register_client;
• получение конфигурации через config_client:

  • cd ../xauth;

  • скомпилируйте микросервисную службу аутентификации:

    • make -j32;

  • скомпилируйте клиентское приложение аутентификации и создайте библиотеку libxauth.so:

    • make libxauth.so;

  • установите:

    • make install.

9. Шлюз XAG:

• зависит от xplatform, register_client, config_client;
• подключение к register_client для получения списка доступных микросервисов;
• подключение к config_client для получения конфигурации шлюза:
  • сделайте следующее:

    • cd ../xag;

    • скомпилируйте шлюз:

      • make -j32;

    • установите шлюз:

      • make install.