### Example Dockerfile for Loginom Server

Source: https://help.loginom.ru/adminguide/linux/server/update-docker.html

This is an example Dockerfile for building a Loginom server image. It includes base image selection, labels, argument definitions, package installations, library linking, and environment variable configurations. Uncomment specific lines to install additional packages like ODBC drivers or Python.

```dockerfile
FROM docker.io/debian:trixie-slim
#FROM docker.io/debian:bookworm-slim
#FROM docker.io/debian:bullseye-slim
#FROM docker.io/ubuntu:22.04
#FROM docker.io/ubuntu:24.04
#FROM registry.astralinux.ru/library/astra/ubi18:1.8

LABEL "org.opencontainers.image.vendor"="Loginom Company"
LABEL "org.opencontainers.image.title"="Loginom Server"

ARG DEBIAN_FRONTEND=noninteractive
ARG ACCEPT_EULA=Y

COPY server/ /app/
COPY libs/ /app/

RUN apt-get update && apt-get install -y --no-install-recommends \
    tzdata \
    libpcre2-8-0 \
    zlib1g \
    '^libicu[678][0-9]$' \
    librdkafka1 \
    libmariadb3 \
    libsqlite3-0 \
    #unixodbc \
    #tdsodbc \
    libtomcrypt1 \
    libtommath1 && \
    apt-get clean && rm -rf /var/lib/apt/lists/* && \
    mkdir -p /app/firebird/lib && \
    ln -snf /app/firebird/lib/libfbclient.so.5.0.2 /app/firebird/lib/libfbclient.so.2 && \
    ln -snf /app/firebird/lib/libfbclient.so.2 /app/firebird/lib/libfbclient.so && \
    ln -snf /app/firebird/lib/libfbclient.so /usr/lib/x86_64-linux-gnu/libfbclient.so

# Installing the package required to add certificates into container {#installing-the-package-required-to-add-certificates-into-container}
#RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates && \
#   apt-get clean && rm -rf /var/lib/apt/lists/* {#-apt-get-clean--rm--rf-varlibaptlists}

# Installing Microsoft ODBC Driver 18 for SQL Server {#installing-microsoft-odbc-driver-18-for-sql-server}
# The msodbcsql18_18.4.1.1-1_amd64.deb file should be located in the 'server/libs' directory of the distribution {#the-msodbcsql1818411-1amd64deb-file-should-be-located-in-the-serverlibs-directory-of-the-distribution}
#RUN apt-get update && apt-get install -y --no-install-recommends \
#    libgssapi-krb5-2 \
#    /app/msodbcsql18_18.4.1.1-1_amd64.deb \
#    locales && \
#    localedef -i ru_RU -f UTF-8 ru_RU.UTF-8 && \
#    rm -f /app/msodbcsql18_18.4.1.1-1_amd64.deb && \
#    apt-get clean && rm -rf /var/lib/apt/lists/* {#apt-get-clean--rm--rf-varlibaptlists}

# Installing Python and some of its libraries {#installing-python-and-some-of-its-libraries}
#RUN apt-get update && apt-get install -y --no-install-recommends python3 \
#    python3-pandas python3-numpy python3-sklearn && \
#    apt-get clean && rm -rf /var/lib/apt/lists/* {#apt-get-clean--rm--rf-varlibaptlists}

ENV LANG=ru_RU.UTF-8
ENV LD_PRELOAD=/app/libtcmalloc_minimal.so.4.4.5
ENV TCMALLOC_AGGRESSIVE_DECOMMIT=true
ENTRYPOINT ["/app/loginomd", "--run", "-workdir=/workdir"]
```

--------------------------------

### Start Loginom Services

Source: https://help.loginom.ru/adminguide/linux/server/update-native.html

After the update is installed, start the previously stopped Loginom services.

```bash
sudo systemctl start loginomd
sudo systemctl start loginomi
```

--------------------------------

### Install Loginom Desktop via Command Line

Source: https://help.loginom.ru/adminguide/desktop/setup.html

Use this command to install Loginom Desktop with custom MSI parameters. Refer to 'msiexec /?' for a full list of available keys. The '/l* "%TEMP%\loginom.msi.log"' key enables installation logging, and '/qn' performs a silent installation without a GUI.

```bash
msiexec /i "LoginomPersonal_7.x.x.msi" ключи_msi

```

--------------------------------

### Start Loginom Services from Command Line

Source: https://help.loginom.ru/adminguide/windows/server/setup.html

Start the Loginom Server and Loginom HTTPD services using the 'net start' command. Ensure you run these commands with administrator privileges.

```bash
net start loginom
```

```bash
net start httpd_loginom
```

--------------------------------

### Install and Start grddaemon

Source: https://help.loginom.ru/adminguide/linux/licenses/sp-key-activate.html

Execute the installation script for the grddaemon component, which is part of the license protection system. This command requires superuser privileges.

```bash
sudo ./install.sh

```

--------------------------------

### Install Loginom Integrator via Command Line

Source: https://help.loginom.ru/adminguide/windows/integrator/setup.html

Use msiexec for command-line installation. Specify MSI keys for logging and silent installation, and integrator parameters for configuration.

```bash
msiexec /i "LoginomIntegrator_7.x.x.msi" ключи_msi параметры_integrator

```

```bash
msiexec /i "LoginomIntegrator_7.0.2.msi" /L*v С:\Temp\IntegratorInstallerLog.log /qn

```

--------------------------------

### Basic BatchLauncher Execution Example (Windows)

Source: https://help.loginom.ru/userguide/scheduler/batchlauncher.html

A simple example demonstrating how to launch a Loginom package with the /Teach option using BatchLauncher on Windows.

```bash
"C:\ Program Files\Loginom\Server\BatchLauncher.exe" /Package=test.lgp /Teach
```

--------------------------------

### Manually Start grddaemond Service

Source: https://help.loginom.ru/adminguide/linux/licenses/sp-key-activate.html

If the grddaemon service does not start automatically after installation, use this command to start it manually. This requires superuser privileges.

```bash
sudo systemctl start grddaemond

```

--------------------------------

### Start License Server

Source: https://help.loginom.ru/adminguide/linux/licenses/license-server.html

Navigate to the server's sbin directory and execute this command to start the license server service.

```bash
cd /opt/guardant/glds/sbin/
./gldsd

```

--------------------------------

### Install Loginom Update

Source: https://help.loginom.ru/adminguide/linux/server/update-native.html

Run the installation script to apply the new version of Loginom.

```bash
sudo bash install_loginom.sh
```

--------------------------------

### Navigate and Extract Installation Script

Source: https://help.loginom.ru/adminguide/linux/server/update-native.html

Navigate to the distribution directory, extract the installation script archive, and change into the resulting directory.

```bash
cd <директория_с_дистрибутивом>
tar -xf <архив_с_установочным_скриптом>.tgz
cd <директория_с_установочным_скриптом>
```

--------------------------------

### Start Loginom Services

Source: https://help.loginom.ru/adminguide/linux/server/loginom-linux.html

Starts the Loginom server and integrator services using systemctl. Ensure the service names are correct for your system.

```bash
sudo systemctl start loginomd
 sudo systemctl start loginomi
```

--------------------------------

### Start Loginom Server Service

Source: https://help.loginom.ru/adminguide/linux/mssql-odbc

Use this command to start the Loginom Server service after configuration changes.

```bash
sudo systemctl start loginomd
```

--------------------------------

### Install License Server (RedOS)

Source: https://help.loginom.ru/adminguide/linux/licenses/license-server.html

Use this command to install the license server package on RedOS 7.3.

```bash
sudo dnf install /путь до пакета/

```

--------------------------------

### Install License Server (Debian/Ubuntu)

Source: https://help.loginom.ru/adminguide/linux/licenses/license-server.html

Use this command to install the license server package on Debian-based systems.

```bash
sudo dpkg -i /путь до пакета/

```

--------------------------------

### Install Podman and Podman-Compose

Source: https://help.loginom.ru/adminguide/linux/server/docker-Fedora_43.html

Update system packages and install Podman and Podman-Compose. This is the first step for containerizing Loginom.

```bash
sudo dnf update && sudo dnf install -y podman podman-compose
```

--------------------------------

### Install Docker and Docker Compose

Source: https://help.loginom.ru/adminguide/linux/server/docker-AstraLinux.html

Installs Docker and Docker Compose packages on Astra Linux.

```bash
sudo apt-get install -y docker docker-compose
__
```

--------------------------------

### Install Podman and related packages

Source: https://help.loginom.ru/adminguide/linux/server/docker-OpenSUSE.html

Installs Podman, podman-compose, and the cni-plugin-dnsname package using zypper.

```bash
sudo zypper install -y podman podman-compose cni-plugin-dnsname
```

--------------------------------

### Install Loginom Server

Source: https://help.loginom.ru/adminguide/linux/server/loginom-linux.html

Executes the installation script for the Loginom Server component. This should be run from the server component's directory within the extracted distribution.

```bash
sudo ./install_server.sh
```

--------------------------------

### Install Loginom Integrator

Source: https://help.loginom.ru/adminguide/linux/server/loginom-linux.html

Executes the installation script for the Loginom Integrator component. This should be run from the integrator component's directory within the extracted distribution.

```bash
sudo ./install_integrator.sh
```

--------------------------------

### Continuous Binning Table Example

Source: https://help.loginom.ru/userguide/processors/preprocessing/coarse-classes/configure-external-binning.html

Example of a table structure for continuous external binning. Ensure 'ColumnName', 'UpperBound', and 'IncludeUpperBound' columns are correctly populated.

```text
Имя столбца | Верхняя граница | Верхняя граница включена  
---|---|---
COL2 | 3728129 | False  
COL2 | 7934343 | False  
COL2 | 10533052 | False  
COL2 | 30721946 | False  
COL2 | 36494956 | False  
COL2 | 39509806 | False  
COL8 | 490,01 | False  
COL8 | 2308,07 | False  
COL8 | 5981,98 | False  
COL8 | 6600,01 | False  
COL8 | 10050,99 | False  
COL8 | 14870 | False  
```

--------------------------------

### Package Parameter Example (Windows)

Source: https://help.loginom.ru/userguide/scheduler/batchlauncher.html

Illustrates using the /Package parameter with a simple file path and a path containing spaces for BatchLauncher on Windows.

```bash
"C:\ Program Files\Loginom\Server\BatchLauncher.exe" /Package=/user/test.lgp
```

```bash
"C:\ Program Files\Loginom\Server\BatchLauncher.exe" "/Package=/user/test and log.lgp"
```

--------------------------------

### Node Parameter Example (Windows)

Source: https://help.loginom.ru/userguide/scheduler/batchlauncher.html

Shows how to specify a particular node for execution using the /Node parameter with BatchLauncher on Windows. Handles node names with and without spaces.

```bash
"C:\ Program Files\Loginom\Server\BatchLauncher.exe" /Package=/user/test.lgp "/Node=executable node"
```

```bash
"C:\ Program Files\Loginom\Server\BatchLauncher.exe" /Package=/user/test.lgp /Node=executable_node
```

--------------------------------

### Get IP Address

Source: https://help.loginom.ru/adminguide/linux/licenses/license-server.html

Run this command to determine the IP address of the machine where the license server will be installed.

```bash
ifconfig

```

--------------------------------

### Get Display Name by Path

Source: https://help.loginom.ru/userguide/processors/func/calc-func/data-tree.html

Use DisplayName() to get the label (display name) of a node, expression, or variable by its path. If no path is provided, it returns the label of the current expression. Example: DisplayName("Root.Node1").

```calc
DisplayName("ПутьУзла")
```

--------------------------------

### ES6 Absolute Import Path on Loginom Server

Source: https://help.loginom.ru/userguide/processors/programming/java-script/external-modules.html

Example of using an absolute path starting with '/' for importing an ES6 module on the Loginom server.

```javascript
import { cube, foo, sayHello } from "/user/foo/foo.js";

```

--------------------------------

### Install Podman and Dependencies

Source: https://help.loginom.ru/adminguide/linux/server/docker-RedOS_7.html

Installs Podman, network utilities, and Python dependencies required for container management. Ensure your system is updated before installation.

```bash
sudo dnf update && sudo dnf install -y podman slirp4netns fuse-overlayfs dnsmasq python3-pip

sudo pip3 install podman-compose
```

--------------------------------

### Run Setup Script with Podman

Source: https://help.loginom.ru/adminguide/linux/server/install-docker-podman.html

Execute the setup script using Podman to build container images and configuration files. This command is used when Podman is the chosen containerization engine.

```bash
./setup.sh
```

--------------------------------

### Install Podman and Pip

Source: https://help.loginom.ru/adminguide/linux/server/docker-Debian-Ubuntu.html

Installs Podman and Pip for managing Python packages.

```bash
sudo apt-get update && sudo apt-get install -y podman

sudo apt-get install -y pip && sudo pip3 install podman-compose__
```

--------------------------------

### Example Loginom Integrator Configuration

Source: https://help.loginom.ru/adminguide/linux/integrator/config.html

This XML configuration file demonstrates how to set up logging, connection settings, and server details for Loginom Integrator. It includes examples for defining log levels, enabling Swagger UI, and specifying server connection parameters.

```xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="log" type="Integrator.Core.LogConfigurationSection, IntegratorCore" />
    <section name="loginom" type="Integrator.Core.LoginomConfigurationSection, IntegratorCore" />
  </configSections>
  <log>
    <fileSystem level="Off" maxArchiveFiles="30" encoding="utf-8" />
    <eventLog level="Off" />
    <console level="Off" />
    <journald level="Info" maxEntrySize="65536" />
    <internal level="Error" />
  </log>
  <settings swaggerUI="true" urlPathPrefix="Service.svc" sessionCacheSize="3">
    <server unixsocket="/run/loginom/loginomd.socket" address="localhost" port="4580" userName="service" password="service" />
    <!--<server address="localhost" port="4580" userName="service" password="service" reserved="true"/>-->
  </settings>
</configuration>
```

--------------------------------

### Loginom Integrator Configuration Example

Source: https://help.loginom.ru/adminguide/windows/integrator/config.html

This XML configuration file demonstrates how to set up Loginom Integrator to connect to Loginom Server. It includes logging configurations and specifies server connection details such as the socket path, address, port, and user credentials. It also shows how to enable Swagger UI and set a URL path prefix.

```xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="log" type="Integrator.Core.LogConfigurationSection, IntegratorCore" />
    <section name="loginom" type="Integrator.Core.LoginomConfigurationSection, IntegratorCore" />
  </configSections>
  <log>
    <fileSystem level="Info" maxArchiveFiles="30" encoding="utf-8" />
    <eventLog level="Off" />
    <database connectionString="Provider=SQLNCLI11;Data Source=.\SQLEXPRESS;Integrated Security=SSPI;Initial Catalog=LgiLog" level="Off" table="Logs" dateColumn="Date" levelColumn="Level" machineNameColumn="MachineName" appDomainColumn="AppDomain" requestIdColumn="RequestId" packageNameColumn="PackageName" nodeNameColumn="NodeName" messageColumn="Message" exceptionColumn="Exception" requestColumn="Request" responseColumn="Response" />
    <!--sqlCommand="insert into Logs (Date, Level, MachineName, AppDomain, RequestId, PackageName, NodeName, Message, Exception, Request, Response) 
              values (:date, :level, :machinename, :appdomain, :requestid, :packagename, :nodename, :message, :exception, :request, :response)"-->
    <console level="Off" />
    <journald level="Off" maxEntrySize="65536" />
    <internal level="Error" />
  </log>
  <settings swaggerUI="true" urlPathPrefix="Service.svc">
    <server unixsocket="/run/loginom/loginomd.socket" address="localhost" port="4580" userName="service" password="service" />
    <!--<server address="localhost" port="4580" userName="service" password="service" reserved="true"/>-->
  </settings>
</configuration>
```

--------------------------------

### Start Loginom Docker Containers

Source: https://help.loginom.ru/adminguide/linux/mssql-odbc

Command to start the Loginom containers in detached mode after rebuilding the images.

```bash
sudo docker compose -f /var/opt/loginom-docker/docker-compose.yml up -d
```

--------------------------------

### Running a Package in Training Mode

Source: https://help.loginom.ru/userguide/scheduler/batchlauncher.html

Use the /Teach parameter to launch a package in training mode. If omitted, the package runs in execution mode.

```bash
"C:\Program Files\Loginom\Server\BatchLauncher.exe" /Package=/user/test.lgp /Teach
```

--------------------------------

### Run Setup Script with Docker

Source: https://help.loginom.ru/adminguide/linux/server/install-docker-podman.html

Execute the setup script using Docker to build container images and configuration files. This command requires sudo privileges and is used when Docker is the chosen containerization engine.

```bash
sudo ./setup.sh
```

--------------------------------

### ES6 Relative Import Path Example

Source: https://help.loginom.ru/userguide/processors/programming/java-script/external-modules.html

Example of using a relative path for importing an ES6 module.

```javascript
import { cube, foo, sayHello } from "./foo/foo.js";

```

--------------------------------

### Date and Time Formatting Example

Source: https://help.loginom.ru/userguide/processors/transformation/trans-datatime/syntax.html

Demonstrates how to transform a date and time string using a custom format string with predefined markers. The example shows the input, the format string, and the resulting output.

```text
11.08.2017 13:50 → any text Aug, more text 2017, 13.
Formatting string: "any text %M, more text %Y, %G", result: "any text Aug, more text 2017, 13"
```