Skip to main content

Madhava Intermediate Server Installation

Network Connectivity Requirements​

Madhava Intermediate servers connect to Shyama Central server and also communicate with Partha Host Agents and Node Webserver.

It is recommended that the Madhava server and its PostgresDB be in the same Network Region and Zone to limit Network costs and for better performance.

Firewall rules must allow inbound access to the Madhava server on the configured Madhava port (default port is 10038).

Installation Instructions​

Different Install Options exist :

Except for Kubernetes installs, please ensure that the Postgres DB instance is installed and the Madhava Config file in JSON format is ready as per Madhava Config.

Install using Shell script​

Users can download a shell script that takes care of the installation and configuration of the Madhava instance.

note

Before installing Madhava, users need to create a JSON config file as per the Madhava Config.


curl -o /tmp/install-gyeeta-madhava.sh -s https://gyeeta.io/packages/install-gyeeta-madhava.sh

# Then run the install script as : 
# sudo bash /tmp/install-gyeeta-madhava.sh <Path to Madhava Config file in JSON format>

# Example Install Command (Please configure the /tmp/madhava.json config file first) :

sudo bash /tmp/install-gyeeta-madhava.sh /tmp/madhava.json

The install script SHA256 can be checked before installing. The SHA256 of the install script is available at SHA256 file

Stopping/Starting/Uninstalling the Madhava Server​

Command to stop the Madhava Server

sudo systemctl stop gyeeta-madhava

Command to start the Madhava Server

sudo systemctl start gyeeta-madhava

Command to uninstall Madhava Server

sudo systemctl disable gyeeta-madhava; sudo apt-get remove gyeeta-madhava

Install using Kubernetes Helm Chart​

Kubernetes 1.19 or higher is needed along with Helm v3.

Refer to Madhava Helm Chart for a detailed explanation on installing Madhava servers in Kubernetes.

A short explanation is shown below :


helm repo add gyeeta https://gyeeta.io/helmcharts
helm repo update
helm show values gyeeta/madhava > /tmp/madhava.yaml

# Thereafter you can edit the /tmp/madhava.yaml file if you need to change any option. 
# After editing the /tmp/madhava.yaml, install the Madhava Helm chart using :

helm install --namespace gyeeta --create-namespace madhava1  gyeeta/madhava -f /tmp/madhava.yaml

Running as a Docker container​

A JSON config file needs to be created first as per Madhava Config

In the example command below, /tmp/madhava.json config file has already been created on the main host.

The docker container will only run under userid 1001 and groupid 1001.


docker run --rm -td --name madhava --read-only --user 1001:1001 -p 10037:10037 --env CFG_MAIN_JSON=/tmp/madhava.json -v /tmp/madhava.json:/tmp/madhava.json:ro ghcr.io/gyeeta/madhava start

Install using native rpm or deb packages​

Gyeeta native rpm or deb packages are available. The install is to be followed by Madhava configuration.

curl https://pkg.gyeeta.workers.dev/pgp-key.public | sudo gpg --yes --dearmor --output /usr/share/keyrings/gyeeta-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/gyeeta-keyring.gpg] https://pkg.gyeeta.workers.dev/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/gyeeta.list
sudo apt-get update
sudo apt-get install -y gyeeta-madhava

Madhava Configuration post Installation​

After the deb or rpm package has been installed, the Madhava config file /opt/gyeeta/madhava/cfg/madhava_main.json needs to be edited as per Madhava Config.

Start Madhava after editing the madhava_main.json

# After editing the /opt/gyeeta/madhava/cfg/madhava_main.json config file
sudo systemctl start gyeeta-madhava
sudo systemctl enable gyeeta-madhava

Stopping/Starting/Uninstalling the Madhava Server​

Command to stop the Madhava Server

sudo systemctl stop gyeeta-madhava

Command to start the Madhava Server

sudo systemctl start gyeeta-madhava

Command to uninstall Madhava Server

sudo systemctl disable gyeeta-madhava; sudo apt-get remove gyeeta-madhava

Manual Tar Package install​

If none of the above options can be used to install the Gyeeta Madhava component, a manual tarball extract and configure can be used to install.

Example Install Command

mkdir ~/gyeeta
cd ~/gyeeta
curl -L https://github.com/gyeeta/gyeeta/releases/download/$( curl https://api.github.com/repos/gyeeta/gyeeta/releases/latest -s | grep tag_name | awk -F\" '{print $4}' )/madhava.tar.gz | tar xzf -
cd ./madhava

# Thereafter create the cfg/madhava_main.json Madhava config file and then start the Madhava server as

./runmadhava.sh start

Madhava Failover / Redundancy​

Madhava servers can be setup for Multi Node High Availablity by installing 2 or more instances of Madhava which interact with the same instance of Postgres DB.

Please refer to Failover for further details.