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.
- Install Docker
- Install Heplify Server
- Install Portainer
- Install Homer App
- Conclusion
- 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.