Skip to content

Latest commit

 

History

History
84 lines (71 loc) · 2.78 KB

Onboarding.md

File metadata and controls

84 lines (71 loc) · 2.78 KB

Onboarding

Introduction

In this document we'll walk through the setup for the Central Directory. It consists of three sections:

Software List

  1. Github
  2. brew
  3. Docker
  4. PostgreSQL 9.4
  5. pgAdmin4
  6. Visual Studio Code
  7. nvm
  8. npm
  9. central_directory

Setup

Make sure you have access to Mojaloop and clone the project.

To install Homebrew run this in a terminal window:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

To install Docker, follow these instructions: Docker for Mac

To install Visual Studio Code, follow these instructions: Visual Studio Code

Setup Docker
  • create a docker-compose.yml file that looks like this:
version: '2'
services:
  postgres:
    ports:
     - "5432:5432"
    image: postgres:9.4
    environment:
     - POSTGRES_PASSWORD=postgres
     - POSTGRES_USER=postgres
  • run docker-compose up -d from the folder where docker-compose.yml is located.
  • PostgreSQL 9.4 should now be installed
  • run docker ps to verify Docker is running
  • to install pgAdmin4, run brew cask pgAdmin4
Setup pgAdmin4
  • create a central_directory user by right clicking on Login/Group Roles and then Create
  • right click on the central_directory user and select Properties
  • make sure the username and password match the username and password in the .env file
  • click on privileges and set Can login? to Yes
Setup nvm & npm
  • run curl -udwolla:AP6vR3LGrB6zm8WQjLvJHnQzjJp "https://modusbox.jfrog.io/modusbox/api/npm/level1-npm/auth/@mojaloop" >> ~/.npmrc
  • run cp ~/.npmrc .npmrc which will allow you to run the functional tests on your machine
  • to install nvm run curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.32.1/install.sh | bash
  • create a .bash_profile file with touch ~/.bash_profile and verify your .bash_profile looks like this:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
export CDIR_DATABASE_URI=postgres://central_directory:cVq8iFqaLuHy8jjKuA@localhost:5432/central_directory
  • cd into the central_directory project
  • run nvm install 6.5.0
  • run nvm use
  • run npm install -g node-gyp
  • run brew install libtool autoconf automake
  • run npm install
  • run source ~/.bash_profile
  • run npm rebuild
  • run npm start (to run it locally) or npm run dev (to run it on your Docker host)

Errors On Setup

  • ./src/argon2_node.cpp:6:10: fatal error: 'tuple' file not found
    • resolved by running CXX='clang++ -std=c++11 -stdlib=libc++' npm install argon2