Link

Linux Installation Instructions

Dependencies

Linux installation has not been tested exhaustively. Please submit an issue if you run into installation errors

  1. Install Ruby 2.2.4. We recommend using rbenv to manage and install Ruby 2.2.4
    Note: URBANopt will update to Ruby 2.5 when OpenStudio 3.0 is released
  2. Install Bundler version 1.17:

    gem install bundler -v 1.17
    
  3. Install OpenStudio 2.8.1
  4. Manually install libpng12
    If you get gdbm libs errors like the following, you need to create symlinks to the appropriate version (libgdbm.so.5 and libgdbm_compat.so.4):

     /usr/local/openstudio-2.8.1/bin/openstudio: error while loading shared libraries: libgdbm.so.3: cannot open shared object file: No such file or directory
    

    or:

     /usr/local/openstudio-2.8.1/bin/openstudio: error while loading shared libraries: libgdbm_compat.so.3: cannot open shared object file: No such file or directory
    
  5. Add the RUBYLIB environment variable path pointing to OpenStudio Ruby location by pasting the following line into your .bash_profile or similar file:

         export RUBYLIB=/usr/local/openstudio-2.8.1/Ruby
    
  6. Install Git if not already installed. A list of optional git GUIs can be found here, along with some help using git with OpenStudio.

Basic Set-up

  1. Install the URBANopt Command Line Interface (CLI):

     gem install urbanopt-cli
    
  2. View available CLI commands with:

     uo -h
    
  3. For detailed instructions, see our example instructions