Servers: Configuration Installation and Setup

Table of Contents

• General Description
• Utility Purpose
• Requirements
• Project Structure
• Installation Sequence
  • Step 1. Smart Monitor Data Collector and SmartBeatManager Integration
  • Step 2. Environment Preparation
  • Step 3. Running Configuration Installation
  • Step 4. Checking Results in Interface

General Description

The servers_ko_maker utility is used to deploy infrastructure objects of the Servers module. The main installation script make_servers.py and auxiliary script install_dependencies.sh for preparing Python environment and dependencies are located in the bin directory.

---

Utility Purpose

• creating basic technical dependencies of the module
• creating index templates
• creating index patterns
• creating inventory settings

---

Requirements

• Python 3.12 and higher
• Python dependencies of the utility
• Access to Smart Monitor cluster with administrator rights

---

Project Structure

./
├── bin/                    # Installation scripts and dependency preparation
├── data/
│   ├── index_templates/    # Module index templates
│   ├── index-patterns/     # Index patterns
│   └── inv/
│       └── inventories/    # Inventory settings
├── pyproject.toml          # Python package description and dependencies
└── README.md               # Launch instructions

---

Installation Sequence

Step 1. Smart Monitor Data Collector and SmartBeatManager Integration

Before running the utility, make sure that actions from the Servers: Integration section have been completed. At this stage, the following should be prepared:

• pipeline for Logstash
• configurations of SmartBeatManager applications
• serverclasses settings

Step 2. Environment Preparation

Go to the utility root directory and prepare the environment.

Recommended method:

chmod +x bin/install_dependencies.sh
./bin/install_dependencies.sh

The install_dependencies.sh script:

• creates virtual environment .venv
• updates pip
• installs utility dependencies

Alternatively, you can perform manual installation:

python3 -m venv .venv
source .venv/bin/activate
pip install .

Step 3. Running Configuration Installation

python bin/make_servers.py \
  --sm_host <SMART_MONITOR_HOST> \
  --sm_api_port <SMART_MONITOR_API_PORT> \
  --sm_cluster_port <OPENSEARCH_PORT> \
  --sm_user <SMART_MONITOR_USER> \
  --sm_password '<SMART_MONITOR_PASSWORD>'

Parameter	Required	Type	Default	Description
--sm_host	Yes	string	—	Smart Monitor server
--sm_api_host	No	string	value of --sm_host	Smart Monitor API server
--sm_api_port	Yes	int	—	Smart Monitor API port
--sm_cluster_host	No	string	value of --sm_host	OpenSearch server
--sm_cluster_port	Yes	int	—	OpenSearch port
--sm_user	Yes	string	—	Username
--sm_password	Yes	string	—	User password

Attention!

--sm_api_port is used for frontend API and saved objects, while --sm_cluster_port is used for uploading index templates. If frontend API and OpenSearch are published on different servers, you can explicitly specify --sm_api_host and --sm_cluster_host.

Step 4. Checking Results in Interface

After successful utility execution, check for created objects:

1. Index Templates

   • In the Templates section: (Navigation Menu - System Settings - Index Management - Templates)

2. Index Patterns

   • In the Index Patterns section: (Navigation Menu - System Settings - Module Settings - OpenSearch - Index Patterns)

3. Inventory

   • In the Assets section: (Navigation Menu - Inventory - Assets)

After this, you can proceed to loading the content module.