Skip to content

Latest commit

 

History

History
95 lines (67 loc) · 3.6 KB

03_installation.md

File metadata and controls

95 lines (67 loc) · 3.6 KB
<< architecture Installation Part II >>

Installation

Exosphere is not just a simple application, but a framework for large-scale software development of micro-service based applications. Developing applications consisting of many different code bases requires:

  • a package management system for installing/updating the various pieces of platforms and tools as needed. You don't want to get into the business of having to install several programming languages, frameworks, and other dependencies of your polyglot applications manually.

The installation instructions below include making these infrastructure components available on your system.

MacOS (OS X)

The easiest way to install Exosphere on OS X is to run its installer app:

curl https://raw.githubusercontent.com/Originate/exosphere-sdk/master/bin/install_osx | sh

This script will check whether all needed components are present and working on your system, and install missing ones. It confirms with you before making any changes to your system, so running it is safe. You can exit it at any time via Ctrl-C, and re-run it at any time to verify proper installation.

Manual installation on OS X

To install the SDK manually:

  • install Homebrew: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • install Node.js version 6 or above: brew install node
  • install Exosphere: npm i -g exosphere-sdk
  • verify that you can run exosphere commands: exo version

Windows

Windows 7

Some of the commands below have to be run in an administrative command shell. Instructions for how to open such a shell are available for windows 8-10 and Windows 7).

  • install the package manager
    • in an administrative shell, install Chocolatey
    • when done, close the current shell and open a new one to load the environment changes prepared by the installer
  • install Node.js version 6 or above
    • in another administrative shell: choco install nodejs.install -y
  • install Exosphere:
    • in a normal shell: npm install --global exosphere-sdk
    • close this shell, open a normal one, and run exo to make sure it works
  • install other tools you will need
    • in an administrative shell: Git (choco install git.install -y
    • optionally Github Desktop (install manually, the choco package is broken)

Contributing

If you want to become an Exosphere contributor and you are on Windows, you need some additional infrastructure:

  • Git for the Git command line and Git Bash: choco install git.install -y
  • you also need to set up SSH keys for Github. The easiest way is via Github Desktop: choco install github -y (Note: this install is currently broken, you might want to install this manually)

Please perform all

Linux

Installation instructions given for Ubuntu, please adapt them to your distro as needed:

  • install ZeroMQ
  • install Node.js version 6 or above: sudo apt-get install node
>>