Как установить SBOS?#

Состав дистрибутива#

Элемент дистрибутива

Описание

/package/ReleaseNotes.json

Служебный файл, редактирование запрещено

/package/bh/SBOS.oxt

Расширение SberOLAP (SBOS) для LibreOffice Calc

/package/conf/

Каталог содержит служебные файлы, редактирование запрещено

Подготовка окружения#

  1. Установите LibreOffice в соответствии с системными требованиями.

  2. Скачайте дистрибутив SBOS, название дистрибутива: sbos-bin-{версия модуля}-{номер сборки}-distrib.zip.

  3. Установите виртуальную машину Java в соответствии с системными требованиями.

Установка#

Выбор способа установки#

Модуль устанавливается только вручную.

Ручная установка сервиса#

Для установки:

  1. Распакуйте дистрибутив SBOS.

  2. Опционально. Если аутентификация пользователя будет осуществляться по JWT-токену (Open ID Connect) в директории {домашняя директория пользователя}/.palooca создайте файл AuthServers.xml с настройками для подключения к серверам аутентификации.

    XSD-схема файла AuthServers.xml
        <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
            <xs:element name="AuthServers">
                <xsd:annotation>
                <xsd:documentation xml:lang="ru">
                    Серверы аутентификации
                </xsd:documentation>
                </xsd:annotation>
                <xs:complexType>
                <xs:sequence>
                    <xs:element name="AuthServer" maxOccurs="unbounded">
                    <xsd:annotation>
                        <xsd:documentation xml:lang="ru">
                            Сервер аутентификации
                        </xsd:documentation>
                    </xsd:annotation>
                    <xs:complexType>
                        <xs:sequence>
                        <xs:element type="xs:string" name="Url">
                            <xsd:annotation>
                            <xsd:documentation xml:lang="ru">
                                Адрес сервера аутентификации
                            </xsd:documentation>
                            </xsd:annotation>
                        </xs:element>
                        <xs:element type="xs:string" name="ClientId">
                            <xsd:annotation>
                            <xsd:documentation xml:lang="ru">
                                Идентификатор толстого клиента(в base64), создается на стороне Open ID Provider
                            </xsd:documentation>
                            </xsd:annotation>
                        </xs:element>
                        <xs:element type="xs:string" name="ClientSecret">
                            <xsd:annotation>
                            <xsd:documentation xml:lang="ru">
                                Секрет для аутентификации толстого клиента(в base64)
                            </xsd:documentation>
                            </xsd:annotation>
                        </xs:element>
                        <xs:element type="xs:string" name="Scopes">
                            <xsd:annotation>
                            <xsd:documentation xml:lang="ru">
                                Области доступа Open ID Connect, перечисленные через запятую
                            </xsd:documentation>
                            </xsd:annotation>
                        </xs:element>
                        </xs:sequence>
                        <xs:attribute type="xs:string" name="Name" use="required"/>
                    </xs:complexType>
                    </xs:element>
                </xs:sequence>
                </xs:complexType>
            </xs:element>
         </xs:schema>
    
    Пример файла AuthServers.xml
        <AuthServers xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AuthServers.xsd'>
          <AuthServer Name="prod">
              <Url>https://{host}:{port}/auth/realms/{realm}</Url>
              <ClientId>c...Q==</ClientId>
              <ClientSecret>RUh...bHQ=</ClientSecret>
              <Scopes>openid, basic, legacy</Scopes>
          </AuthServer>
        </AuthServers>
    
  3. Опционально. Если установка выполняется на SberOS и используется подключение по HTTPS с mTLS в директории {домашняя директория пользователя}/.palooca создайте файлы pkcs11-truststore.properties и pkcs11-keystore.properties для использования сертификатов из NSS DB.

    Конфигурация доступа сертификатам через NSS DB

    Видны все сертификаты, которые добавлялись через браузер, за исключением сертификатов из внешних слотов (TPM).

    # Имя провайдера PKCS11, должно быть одинаковым для всех конфигураций
    name=SberOS-nssdb
    # Путь до директории с NSS DB в кавычках, так как может содержать спецсимволы, например, @
    nssSecmodDirectory="sql:/home/{полное имя учетной записи}/.pki/nssdb"
    nssDbMode=readOnly
    nssModule=keystore
    
  4. Запустите файл {каталог SberOLAP}/package/bh/SBOS.oxt для установки плагина.

  5. После завершения установки перезагрузите LibreOffice, если он был запущен.

В результате установки в toolbar Calc (компонент LibreOffice для работы с таблицами) должен появиться пункт меню OLAP.

Если пункт меню OLAP не появился, установка не завершилась или прервалась ошибкой:

Причина:

Виртуальная машина Java отсутствует или не настроена в LibreOffice.

Решение:

В LibreOffice откройте меню СервисПараметрыLibreOfficeРасширенные возможности и:

  • проверьте, что включено использование виртуальной машины Java;

  • проверьте, что версия виртуальной машины Java удовлетворяет системным требованиям.