Version 7

    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