Skip to content

palladiumkenya/dwapi

This branch is 20 commits ahead of, 32 commits behind master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

68c1d27 · Apr 9, 2024
Apr 9, 2024
Jun 3, 2020
Apr 9, 2024
Mar 17, 2021
Oct 29, 2023
Jun 19, 2018
Feb 8, 2018
May 4, 2020
Aug 24, 2022
May 11, 2021
May 4, 2021
Apr 28, 2020
Jun 19, 2018
May 4, 2020
Jan 23, 2023
Sep 6, 2023
Dec 14, 2022
Feb 29, 2024
Sep 6, 2023
Aug 24, 2022
Nov 27, 2023
Mar 24, 2022
Dec 1, 2023
Sep 6, 2023
Mar 24, 2022

Repository files navigation

DWAPI

.NET Core

Running DWAPI with docker

If you do not have Docker installed, visit https://docs.docker.com/get-started/#download-and-install-docker and choose your preferred operating system to download and install Docker

DWAPI Setup

a) New Installation

  1. Install DWAPI
sudo docker run --name dwapi -p 5757:5757 -p 5753:5753 -d --restart unless-stopped kenyahmis/dwapi:latest

b) Upgrading Existing Installation

  1. Upgrading DWAPI to latest version
sudo docker ps -a | grep "dwapi" | awk '{print $1}' | xargs sudo docker rm -f
sudo docker images -a | grep "dwapi" | awk '{print $3}' | xargs sudo docker rmi
sudo docker run --name dwapi -p 5757:5757 -p 5753:5753 -d --restart unless-stopped kenyahmis/dwapi:latest

MySQL Setup

  1. Configure MySQL to allow remote access. Edit your my.cnf file which is found on /etc/mysql/my.cnf OR /etc/mysql/mysql.conf.d/mysqld.cnf depending on your mysql installation.

a) MySQL 5.5

Change line bind-address = 127.0.0.1 to #bind-address = 127.0.0.1

b) MySQL 5.6 - add the line if it does not exists

	bind-address = *
  1. Create a DWAPI database user for MySQL
 create user 'dwapi'@'%' identified by 'dwapi';
  1. Assign privileges to the DWAPI database user for MySQL
GRANT ALL PRIVILEGES ON *.* TO 'dwapi'@'%' IDENTIFIED BY 'dwapi' WITH GRANT OPTION; 
FLUSH PRIVILEGES;

Using DWAPI

  1. Start DWAPI

On your browser open dwapi on https://localhost:5753

  1. Configure your data sources and verify registries

Please note that for the database connection will need to specify the IP address of the computer and NOT localhost or 127.0.0.1

  1. Restart DWAPI
sudo docker restart dwapi

Troubleshooting DWAPI

i) View log files

sudo docker exec -it dwapi ls logs

ii) Copying log files folder to your pc current directory.

sudo docker cp dwapi:/app/logs/ .

Dwapi for Windows Instruction

  1. Install prerequisite(NetCore Runtime) https://www.microsoft.com/net/download/dotnet-core/2.1
  2. Install DWAPI https://data.kenyahmis.org:444/dwapi/client/downloads/dwapi.exe