Depricated - please use Homer11 http://github.com/sipcapture/homer

HOMER WebApp

This repository hosts homer-app, the the GO webapplication for the HEP/HOMER 7.7+ stack.

Instructions

If you want to install Homer please refer to the project readme

If you're just interested in using homer-app, download, configure and run the latest release or package.

Requirements

• golang 1.23+
• postgres 11+
• git 2.7+
• optional

Installation

make modules
make all

make binary
make frontend

Configuration

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

NOTE: The default location for settings and provisioning files is /usr/local/homer

Usage

./homer-app -h

./homer-app -webapp-config-path=/etc

##### Initialization The application is able to initialize its database and tables it requires with the following commands: ###### Create User

./homer-app -create-homer-user -database-root-user=postgres -database-host=localhost -database-root-password=postgres

./homer-app -show-db-users -database-root-user=postgres -database-host=localhost -database-root-password=postgres

./homer-app -create-config-db -database-root-user=postgres -database-host=localhost -database-root-password=postgres -database-homer-user=homer_user
./homer-app -create-data-db -database-root-user=postgres -database-host=localhost -database-root-password=postgres -database-homer-user=homer_user

./homer-app -create-homer-role -database-root-user=postgres -database-host=localhost -database-root-password=postgres -database-homer-data=homer_data -database-homer-config=homer_config

###### Please setup the correct credentials for homer_config and homer_data DB in your webapp_config.json !!! if your webapp_config.json isn't in the default directory: "/usr/local/homer/etc", use the flag "-webapp-config-path" to correct it. Same have to be applied to all steps there you read settings from "webapp_config.json"

###### Create Table / Migration - connection data will be read from webapp_config.json

./homer-app -create-table-db-config

./homer-app -create-table-db-config -webapp-config-path=/etc/webapp_config.json

###### Populate DB

./homer-app -populate-table-db-config

###### Upgrade / Migration - connection data will be read from webapp_config.json

./homer-app -upgrade-table-db-config

./homer-app -populate-table-db-config -force-populate

###### Re- Populate Config DB for specific table/tables

./homer-app -populate-table-db-config -force-populate -populate-table=mapping_schema -populate-table=user_settings

###### Reset UI password for any user:

./homer-app -update-ui-user=admin -update-ui-password=mypassword

------------

Swagger APIs

Requirements

• go-swagger 2.0

To generate swagger.json file run below command insider homer-app

swagger generate spec -m -o ./swagger.json

To Serve swagger.json file run below command

swagger serve -F=swagger swagger.json

DEB, RPM Packages

make package

The application will deploy to /usr/local/bin with config in /etc

Docker Image

make docker

For working examples and ready to run recipes see homer7-docker

This project is part of HOMER

----

License & Copyright

Made by Humans