Skip to content

mgitonga/dwapi

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docker Setup

  1. Download docker if not already installed. Use the following links based on you Ubuntu OS version

    Ubuntu 12 64 bit

    Ubuntu 14 64 bit

    Ubuntu 16 64 bit

  2. Install docker Run the command below change the path to your downloaded the Docker package

    sudo dpkg -i /path/to/package.deb
  3. Upgrade docker upgrade to latest version (for Ubuntu 14 and 16 Only)

    sudo apt-get update
    sudo apt-get upgrade docker-ce

DWAPI Setup

a) New Installation

Install DWAPI

sudo docker run --name dwapi -p 5757:5757 -d --restart unless-stopped kenyahmis/dwapi:latest

b) Upgrading Existing Installation

Upgrading DWAPI to latest version

sudo docker pull kenyahmis/dwapi
sudo docker stop dwapi
sudo docker rm dwapi
sudo docker run --name dwapi -p 5757:5757 -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 http://localhost:5757

  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 http://data.kenyahmis.org:81/dwapi/client/downloads/dwapi.exe

Dwapi Linux Installation (Ubuntu 64 bit 14 and above ONLY)

  1. Install prerequisite(NetCore SDK)

open terminal (CTRL+ALT+T)

run the following commands as per you ubuntu dist

Ubuntu 14 wget -q https://packages.microsoft.com/config/ubuntu/14.04/packages-microsoft-prod.deb

Ubuntu 16 wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb

Ubuntu 18 wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb

sudo dpkg -i packages-microsoft-prod.deb

sudo apt-get install apt-transport-https

sudo apt-get update

sudo apt-get install dotnet-sdk-2.2

sudo apt-get wget

  1. Install DWAPI

option 1 form commandline

wget -q data.kenyahmis.org:81/dwapi/client/downloads/dwapi.zip

option 2 download from browser

http://data.kenyahmis.org:81/dwapi/client/downloads/dwapi.zip

unzip dwapi.zip

go to unzipped dwapi folder

cd dwapi

start dwapi by running this command

dotnet Dwapi.dll

restarting dwapi

close terminal

go to unzipped dwapi folder

start dwapi by running this command

dotnet Dwapi.dll

Packages

No packages published

Languages

  • C# 42.9%
  • CSS 42.6%
  • TypeScript 11.5%
  • HTML 2.9%
  • JavaScript 0.1%
  • Dockerfile 0.0%