Homer Installation Steps

Introduction

The purpose of this guide is to provide step-by-step instructions for installing Homer, including setting up Docker, Heplify Server, Portainer, and the Homer app. Homer is a VoIP monitoring and troubleshooting tool that offers various features for analyzing SIP and RTP traffic.

1. Install Docker
2. Install Heplify Server
3. Install Portainer
4. Install Homer App
5. Conclusion

1. Install Docker:

vi /etc/yum.repos.d/docker-ce.repo

Add the following content:

[docker-ce-stable]
name=Docker CE Stable - $basearch
baseurl=https://download.docker.com/linux/centos/$releasever/$basearch/stable
enabled=1
gpgcheck=1
gpgkey=https://download.docker.com/linux/centos/gpg

Then, install Docker:

yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Start Docker:

systemctl start docker

Download and install Docker Compose:

curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose --version

Reload and restart the Docker service:

systemctl daemon-reload
systemctl restart docker

2. Install Heplify Server:

Create a directory for Docker containers:

mkdir -p /data/dockers

Create a Docker Compose file for Heplify Server:

vi /data/dockers/docker-compose.yml

Add the following content:

version: '2.1'
services:
  AWS-HS-Promo-Cluster-1:
    image: sipcapture/heplify-server:latest
    container_name: AWS-HS-Promo-Cluster-1
    ports:
      - "10041:10041"
      - "10041:10041/udp"
      - "10091:10091"
    command:
      - './heplify-server'
    environment:
      - "HEPLIFYSERVER_HEPADDR=0.0.0.0:9041"
      - "HEPLIFYSERVER_HEPTLSADDR=0.0.0.0:9041"
      - "HEPLIFYSERVER_HEPTCPADDR="
      - "HEPLIFYSERVER_LOGLVL=info"
      - "HEPLIFYSERVER_LOGSTD=true"
      - "HEPLIFYSERVER_PROMADDR=0.0.0.0:9091"
      - "HEPLIFYSERVER_DEDUP=false"
      - "HEPLIFYSERVER_DBPARTLOG=1h"
      - "HEPLIFYSERVER_DBPARTSIP=1h"
      - "HEPLIFYSERVER_DBPARTQOS=1h"
      - "HEPLIFYSERVER_LOKITIMER=2"
      - "HEPLIFYSERVER_DBMAXSIZE=50GB"
    restart: unless-stopped
    expose:
      - 9090
    labels:
      org.label-schema.group: "FixedLandlineKamailioProdBanglore Monitoring"

Then, start the Heplify Server:

docker-compose -f /data/dockers/docker-compose.yml up -d
docker ps

3. Install Portainer:

docker run -d -p 8080:8080 -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:2.11.1

4. Install Homer app:

vi /etc/yum.repos.d/qxip_sipcapture.repo

Add the following content:

[qxip_sipcapture]
name=qxip_sipcapture
baseurl=https://packagecloud.io/qxip/sipcapture/el/7/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/qxip/sipcapture/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

[qxip_sipcapture-source]
name=qxip_sipcapture-source
baseurl=https://packagecloud.io/qxip/sipcapture/el/7/SRPMS
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/qxip/sipcapture/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

Then, install the Homer app:

yum install homer-app

Edit the Homer web app configuration file as needed:

vi /usr/local/homer/etc/webapp_config.json

Edit DB settings as needed

systemctl start homer-app

Conclusion

In conclusion, this guide has provided instructions for setting up Homer, a powerful VoIP monitoring tool, by installing Docker, Heplify Server, Portainer, and the Homer app. By following these steps, users can effectively monitor and troubleshoot their VoIP infrastructure.

This comprehensive guide should assist you in successfully setting up Homer for your VoIP monitoring needs. If you encounter any issues during the installation process, refer back to the corresponding sections or consult the documentation provided by the respective software packages.