Установка Picodata

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

Установка готовых пакетов

Picodata поставляется для поддерживаемых операционных систем и предназначена для архитектуры x86_64 (в случае с macOS также поддерживается Apple Silicon). Для Linux мы поддерживаем собственные репозитории с готовыми пакетами для RHEL/CentOS 7-8 И Rocky Linux 8, РЕД ОС 7.3 "Муром", Astra Linux 1.7 SE, Debian 11, Ubuntu 20.04, 22.04, Alt Linux p10 и ROSA Chrome 2021.1. Внутри пакетов находится статически слинкованная версия исполняемого файла picodata. Более подробная информация об установке приведена на сайте https://picodata.io/download.

Установка из исходного кода

Необходимые инструменты

Rust и Cargo 1.71 или новее
cmake 3.16 или новее
gcc, g++
libstdc++-static
NodeJS и Yarn (для сборки с веб-интерфейсом)

Далее приведены команды для их установки под разные ОС.

CentOS 8

sudo dnf config-manager --set-enabled powertools
sudo dnf in -y gcc gcc-c++ make cmake git patch nodejs:19 yarnpkg libstdc++-static
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

Fedora 37-39

sudo dnf in -y perl automake libtool libstdc++-static
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

Ubuntu 22.04

sudo apt-get install build-essential git cmake nodejs yarnpkg -y
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env

Alt Server p10

su -
apt-get install -y gcc gcc-c++ cmake git patch libstdc++10-devel-static libgomp10-devel-static node yarn
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

macOS

Сборка под macOS почти не отличается от таковой в Linux. Потребуется macOS 10.15 Catalina, либо более новая версия (11+).

Для начала следует установить актуальные версии Rust и Cargo:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Если планируется сборка Picodata c веб-интерфейсом, то нужно будет установить дополнительно NodeJS и Yarn при помощи пакетного менеджера Brew.

Установка Brew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Установка NodeJS и Yarn:

brew install node yarn

Получение исходного кода

git clone https://git.picodata.io/picodata/picodata/picodata.git
cd picodata
git submodule update --init --recursive

Сборка

Сборка Picodata только c консольным интерфейсом:

cargo build --release

Сборка Picodata c консольным и веб-интерфейсом:

cargo build --release --features webui

Исполняемый файл picodata появится в директории target/release.

Проверка установки

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

which picodata

Ответом на неё должно быть значение /usr/bin/picodata, либо — если вы устанавливали ПО вручную с другим префиксом — иное расположение, включенное в $PATH. Чтобы убедиться в работоспособности ПО, а также посмотреть его версию, используйте следующую команду:

picodata --help

В состав ПО также включены юнит-тесты, позволяющие проверить работоспособность основных функций. Юнит-тесты можно запустить следующей командой:

picodata test

Пример вывода команды:

running 6 tests
test test_traft_pool ... ok
test test_storage_peers ... ok
test test_storage_state ... ok
test test_storage_log ... ok
test test_mailbox ... ok
test test_version ... ok

test result: ok. 6 passed; 0 failed; finished in 0.88s

Подробнее о запуске Picodata и работе с кластером см. в разделе Запуск кластера. Параметры запуска из командной строки описаны в разделе Аргументы командной строки Picodata.