npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

ewd-ripple

v1.28.0

Published

EWD 3/ ewd-xpress Middle Tier for Ripple OSI

Downloads

109

Readme

rippleosi-ewd3

Email: [email protected] 2016 Ripple Foundation Community Interest Company http://rippleosi.org

Author: Rob Tweed, M/Gateway Developments Ltd (@rtweed)

Introduction

rippleosi-ewd3 is a Node.js-based Middle Tier for the Ripple OSI project.

Installing and Configuring the RippleOSI Node.js / EWD 3 Middle Tier

Please follow ALL the steps listed below:

  1. Assumptions

The EWD 3 Middle Tier for RippleOSI is designed to run on a Linux platform (eg Ubuntu 16.04). The embedded Open Source GT.M database is used as a high-performance cache and session store.

  1. If your Linux machine / VM only has a root user, you'll need to create a non-root user with sudo privileges. If you already log in to your Linux machine with a non-root user, the user will need sudo privileges.

To create a new user named ripple (change to whatever you want) (when logged in as root):

 adduser ripple

You'll be asked for a password. You'll also be asked for user details which you can just leave blank by hitting the Enter key each time.

To give the user sudo privileges:

 usermod -aG sudo ripple
  1. Use the installer script from this repo to create the EWD 3 Node.js-based Ripple Middle Tier and UI:

    cd ~ wget https://raw.githubusercontent.com/RippleOSI/Org-Ripple-NodeJS-EWD3/master/installer/install_ripple.sh source install_ripple.sh

The installer script installs and configures the following:

  • The Open Source GT.M database (used by RippleOSI's middle tier as a high-performance session cache)
  • Node.js
  • The EWD 3 / Node.js-based RippleOSI Middle Tier
  • The RippleOSI User Interface files
  • A MySQL-based Patient Administration (PAS) database
  1. When the installer has completed, you'll find two template startup files in the ~/ewd3 directory:
  • ripple-demo.js (Designed to run the RippleOSI system in demo mode)
  • ripple-secure.js (Designed to run the RippleOSI system in secure mode, using Auth0 for identity management)

Demo Mode

If you just want to try out RippleOSI, use the demo startup file - no changes are needed to it. Just type the following in a terminal window to start it up:

    cd ~/ewd3
    node ripple-demo

In this mode, the UI will bypass the user login and you'll be automatically logged in as a user named Bob Smith, with access to all the simulated patient data.

Secure Mode

If you want proper user authentication, use the secure mode startup file. This expects to use Auth0 as an OAuth2 identity management provider.

You'll need to modify these lines in the ripple-secure.js file:

   var config = {
    auth0: {
      domain:       'xxxxxxxxx.eu.auth0.com',
      clientID:     'xxxxxxxxxxxxxxxxxxxxxxxx',
      callbackURL:  'http://xxx.xxx.xxx.xxx/auth0/token',
      clientSecret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',

to correspond with the values for your Auth0 client. You can set up a client for free on Auth0 (https://auth0.com/)

The callbackURL should use the IP address/domain name of the server on which you've installed RippleOSI, but must point to /auth0/token on this machine. The callbackURL must be defined as an allowed callback URL in your Auth0 client configuration.

Once you've edited the ripple-secure.js file, you should now be able to start the RippleOSI Middle Tier by typing:

  cd ~/ewd3
  node ripple-secure
  1. Point at the browser at the server's IP address and it should start up, eg:

    http://123.221.100.21

If you're running in secure mode, the first time you connect you'll be redirected to Auth0's Lock screen, through which you can log in.

The RippleOSI User Interface should then appear.

  1. You'll probably want to run the Ripple middle tier as a background service. The easiest way is to use PM2. First install it using:

    cd ~/ewd3 sudo npm install -g pm2

If you want to run the demo mode as a service:

 cd ~/ewd3
 pm2 start ripple-demo.js

The console output from the middle tier process is piped by PM2 to a log file in:

 ~/ewd3/.pm2/logs

It will initially be:

 ~/ewd3/.pm2/logs/ripple-demo-out-0.log

YOu can view it using:

 tail -f ~/.pm2/logs/ripple-demo-out-0.log

If, for some reason, the middle tier crashes, PM2 will automatically restart it.

To stop the middle tier service:

 pm2 stop ripple-demo

For more information about PM2, see:

https://www.digitalocean.com/community/tutorials/how-to-set-up-a-node-js-application-for-production-on-ubuntu-16-04

License

Copyright (c) 2016 Ripple Foundation Community Interest Company All rights reserved.

http://rippleosi.org Email: [email protected]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.