Skip to main content
Version: 5.0

Module Installation

Installation Prerequisites

Installation requires following files to be present:

  • A kuber-installer-1.0.tar.gz archive containing the following module kubersm component files:
    • installation script for OpenSearch
    • installation script for OpenSearch Dashboards
    • installation script for Search Anywhere Framework interface
    • installation script for Logstash

Installation Procedure

Unzip the archive into a directory of your choice.

OpenSearch

To install the module component for the OpenSearch servers with the data role, do the following in the data folder:

Add connection settings into the config file:

apiVersion: v1
clusters:
- cluster:
certificate-authority-data: [insert CA data here]
server: https://[insert IP address of Kubernetes master server here]:6443
name: kubernetes
contexts:
- context:
cluster: kubernetes
user: kubernetes-admin
name: kubernetes-admin@kubernetes
current-context: kubernetes-admin@kubernetes
kind: Config
preferences: {}
users:
- name: kubernetes-admin
user:
client-certificate-data: [client certificate path here]
client-key-data: [client key path here]

Launch the script in the data folder via following terminal command:

sudo bash install.sh

Before installation set following parameters:

  • OpenSearch home directory - path to the OpenSearch root directory. Default value: /app/opensearch

  • KuberSM license key - special token key for module access. Mandatory. Provided by the vendor. Without the token present, OpenSearch will not launch after the module installation process is done. No default values set

Every parameter must be confirmed with a press of y and Enter after input. Pressing n allows to re-enter the parameter.

After installation token values and broker parameters can be changed in the configuration file at the path  {opensearch_root_directory}/config/nn2/kuber_plugin.yml

During the installation an additional confirmation will be necessary. For that press y and then Enter.

OpenSearch Dashboards

To install the module component for opensearch-dashboards, launch the script in the web folder via following terminal command:

bash install.sh

Before installation set following parameters:

  • Opensearch-dashboards home directory - path to the opensearch-dashboards. Default value: /app/opensearch-dashboards

  • SAF Beat Manager home directory - path to the SAF Beat Manager root directory. Default value: /app/SAFBeat

  • Logstash host - Logstash host IP address. No default value set

  • All kubernetes server ip addresses with SAF Beat - IP addresses of Kubernetes servers that have SAF Beat installed. No default value set

During the installation an additional confirmation will be necessary. For that press y and then Enter.

Logstash

To install the module component for the Logstash servers, launch the script in the logstash folder via following terminal command:

sudo bash install.sh

Before installation set following parameters:

Output file parameters:

  • Hosts - IP-addresses for OpenSearch servers in the https://[ip:port] format. No default values set
  • User - OpenSearch username for authorization. No default value set
  • Password - OpenSearch password for authorization. It's possible to pull the value from keystore (y to insert the keystore password, n for manual input). No default value set
  • Set the desired SSL setting - y to turn it on or n to turn it off
  • Set the CA certificate path. Usually it can be found at /app/opensearch/config/ca-cert.pem. No default value set

Every parameter must be confirmed with a press of y after input. Pressing n allows to re-enter the parameter.

Cluster parameters:

  • Logstash home directory - path to Logstash root directory. Default value: /app/logstash
  • Logstash pipelines configuration directory - path to directory containing pipeline configuration files. Default value: /app/logstash/config/conf

Every parameter must be confirmed with a press of y and Enter after input. Pressing n allows to re-enter the parameter. After installation ip and alias parameters can be changed in the configuration file at the path {directory_containing_pipeline_configuration_files}/jmx_conf/

Search Anywhere Framework Interface

To install the module Search Anywhere Framework interface component for the server with the opensearch-dashboards installation, launch the script in the saf-interface older via following terminal command:

bash install.sh

Before installation set following parameters:

  • User - username for authorization. No default value set
  • Password – password for authorization. No default value set

Every parameter must be confirmed with a press of y and Enter after input. Pressing n allows to re-enter the parameter.

After the entry of all correct parameters and successful authorization the script will begin the installation process. Otherwise an authorization error will abort the install and it will be necessary to relaunch the script.

Kubernetes Module Initialization for Kubernetes Server

It is assumed that Kubernetes servers have SAF Beat installed and are connected to SAF Beat Manager.