Jive Developer Days Installfest

Document created by Rashed Talukder on Sep 12, 2016Last modified by Rashed Talukder on Nov 16, 2016
Version 7Show Document
  • View in full screen mode

This document will give you details on the software, libraries, and SDK's needed for participation in the Jive Developer Days series of events. Everything should be installed BEFORE you attend the event because otherwise you won't be able to follow along.

All commands to be copied/pasted into terminal are CYAN in color.

 

Required Software

  • NVM (optional, but recommended)
  • Node.JS (version 6.9.1—preferably installed via NVM, not system)
  • Jive Node SDK (Latest version — 0.2.9)
  • Ngrok
  • IDE with native JavaScript support

 

 


 

Uninstalling Node.JS (system installed)

If you have Node.JS version 6.3+, the Jive Node SDK doesn't fully support it yet, so you will need to downgrade. It is HIGHLY recommended to uninstall your default system installed instance of Node.JS and use NVM to have multiple version on your machine for compatibility reasons.

 

Mac:

  • sudo rm -rf /usr/local/{lib/node{,/.npm,_modules},bin,share/man}/{npm*,node*,man1/node*}
  • sudo rm -rf /usr/local/bin/npm /usr/local/share/man/man1/node* /usr/local/lib/dtrace/node.d ~/.npm ~/.node-gyp /opt/local/bin/node opt/local/include/node /opt/local/lib/node_modules

 

PC:

Control Panel --> Add/remove programs -->uninstall node.js

 

Ubuntu:

  • sudo apt-get remove nodejs
  • sudo apt-get clean

 


 

Installing NVM (Node Version Manager)

NVM allows the use of any version of Node.JS to be installed and run on your machine. You must first uninstall a regular system installed instance of Node.JS to avoid conflicts.

 

Mac

 

Windows

Goto and follow: https://github.com/coreybutler/nvm/releases

 

Linux

Std.out messages are hidden from the terminal since NVM acts as a proxy. You’ll need to output your logs to a file and read them later.

 


 

Installing Node.JS v6.9.1 Using NVM

This is our recommended method for running Node.JS. If you are going to use NVM, you must uninstall your system installed (e.g. if you installed from the download off from nodejs.org's site)—please see the uninstall instructions above.

Screen Shot 2016-09-12 at 1.13.30 AM.png

Mac/PC/Linux

  1. nvm install 6.9.1
    • If the only version installed, it’s automatically the default Node.js installation that is run and placed in PATH
  2. nvm list
    • Shows installed versions of Node.js
    • If 6.9.1 is not listed as the default version, use the command:
      • nvm use 6.9.1
  3. node -v

 


 

Installing Node.JS v6.9.1 Using Default Installer into System

Screen Shot 2016-09-12 at 1.13.30 AM.png

Mac

You can also install Node.JS version 5.x.x with brew install /homebrew/versions/node5

  1. Install HomeBrew:
  2. To install correct Node.js version use the following command:
    • brew install node
  3. Test installation and version
    • node –v

 

Troubleshooting

Fix permissions and path

  • sudo chown -R $(whoami) /usr/local
  • brew link --overwrite node
  • brew postinstall node

 

Test again

  • node -v

 

PC

  1. Download Installer from
  2. Follow the prompts in the installer
  3. Make sure installer “add to PATH” option is selected/installed
  4. Test
    • node –v

 

Linux

  1. Install dependencies
    • sudo apt-get install wget build-essentials
  2. Grab Linux version of Node.js 6.9.1, unpack, and make
  3. Test
    • which node

 


 

Installing Jive Node SDK

  1. Node.js global install using NPM
    • npm install –g jive-sdk

 

Screen Shot 2016-09-12 at 1.11.38 AM.png

 


 

Update Jive Node SDK to Latest Version

  1. Updating a global package via NPM is going to be the same as installing it
    • npm install -g jive-sdk

 


 

Installing Ngrok

If you're wondering what Ngrok is and how to use it, I wrote a detailed doc about it Ngrok: Warp Speed for Your Integration Iterations.

Screen Shot 2016-09-12 at 1.12.34 AM.png

 

With Installer

  1. Download ngrok - download  and add to PATH

 

With NPM (Node Package Manager

  • npm install -g ngrok

 

Start ngrok service

  • ngrok http 8090

 

Inspect requests

  1. Point browser to http://localhost:4040
  2. In another tab, visit your unique web address provided by the ngrok service window (e.g. http://dj23io.ngrok.io) and see what requests look like

 


 

IDE with JavaScript Support

If you don't have an Integrated Development Environment (IDE) installed on your machine that natively supports JavaScript, it's highly recommended you use one for the Developer Days events. Here are some great one's:

  • Visual Studio Code & Atom offer great Node.js experiences
  • All listed IDE’s have applications in OSX, Windows, Linux

Attachments

    Outcomes