Jive Apps Command Line Tools - Ubuntu Linux Installation Instructions

Version 2

    Overview

     

    This document will guide you through the steps to install the Jive Apps Command Line Tools on Ubuntu Linux. These tools utilize the Ruby programming language and the Git version control system, so we will need to install these as well.

     

    Legend

    • This is a step-by-step tutorial. You need to substitute your own values in the various steps below.
    • Text in the comment-style boxes represents commands you will enter.

     

    $ fake command "Joe Smith"

    Installation Steps:

     

    1. Mandatory prerequisite:  Create your account via the  Dev Center

     

    The account credentials you enter when you create your account are used to create your login for the command line tools and the sandboxes.  If you are not already signed up, click on the link above; if someone from your company has already created a company account, please have them add you to that account; do not create another account as you will not be able to share/collaborate on the App and its submission.

     

    2. Install Git & Ruby

     

    From the terminal, run the following command to install the necessary packages:

    $ sudo apt-get -y install build-essential git-core ruby1.8-dev rubygems1.8 ruby1.8 ri1.8 rdoc1.8 irb1.8 libreadline-ruby1.8 libruby1.8 libopenssl-ruby

     

    3. Configure Git

     

    Configure the following options in Git using the Terminal:

    $ git config --global user.name "FirstName LastName"
    $ git config --global user.email "your_email@youremail.com"

    4. Generate SSH Keys

     

    Generate an SSH key pair if you don't already have one. From the Terminal, run this command. Press Enter at all prompts. No passphrase is needed provided you do not distribute your key files.

    $ ssh-keygen -t rsa -C "your_email@youremail.com"

    5. Update your PATH

     

    Ubuntu Linux does not automatically add the Ruby binaries to the PATH. Add this line to your ~/.bash_profile or ~/.bashrc file.

    export PATH=/var/lib/gems/1.8/bin:$PATH

    6. Install the Jive Apps Command Line Tools Gem


    From the Terminal, install the gem by running this command:

    $ sudo gem install jiveapps

     

    Now you are ready to start creating apps! Proceed to the Creating a Basic "Hello World" App tutorial.