Multiple Internet Load balancing application
Ruby Shell
Switch branches/tags
Latest commit ce31c4e Jul 23, 2016 @pratik14 pratik14 Create SUMMARY.md
Permalink
Failed to load latest commit information.
bin
config fix# json file issue Jul 13, 2012
doc cron value generation through command May 18, 2012
lib By default sticky session if false Jun 8, 2012
log TDD branch changes Mar 23, 2012
spec Added specs for ISPUnity Mar 23, 2012
test Script added to clear rules Apr 20, 2012
.gitignore FIX# Error while executing monit Apr 20, 2012
.rspec Added specs for rt table entry Feb 24, 2012
Gemfile
README modified README. took out puts from bin/ispunity as it mails them whe… May 29, 2012
Rakefile Intial commit Feb 17, 2012
SUMMARY.md Create SUMMARY.md Jul 23, 2016
isp_unity.gemspec Fix# Added rspec dependency and Typo Fixed Jun 1, 2012
ispunity.sh FIX# Added rspec dependency Jun 1, 2012
license bin folder added Apr 27, 2012
monitor.rb Monitor and seup filed added Apr 1, 2012
setup.rb FIX# Error while executing monit Apr 20, 2012

README

1.Install rvm
  - curl -L get.rvm.io | bash -s stable
  - source /etc/profile.d/rvm.sh

Find the requirements;

        rvm requirements

install the additional dependencies as mentioned. 

2. Install ruby
   - rvm install 1.9.3

3. Install
  3.1 Install from gem
  ======================
    1. gem install ispunity
   

  3.2 Install from source
  =======================
    1. cd /opt

    2. Install IspUnity ( make sure you have git installed)
      -  git clone git://github.com/aruntomar/isp_unity.git

    3. cd /opt/isp_unity

    4. bundle install

4. Using configuration file
   - We have provided with sample configuration file under config folder with the name configuration.json.example that must be copied under /etc folder.
   - cp -v config/configuration.json.example /etc/ispunity.json

5. modify the json file to suit your network. 

6. How to execute
   - As user root execute the following command 
   - ispunity

7. Usage
  ispunity clear_rules  # Clear the rules setup by the routing policy
  ispunity help [TASK]  # Describe available tasks or one specific task
  ispunity license      # Displays the license
  ispunity monitor      # Start monitoring the isp connections.
  ispunity setup        # Setup the application
  ispunity version      # Displays the version of Ispunity

      
8. Starting with Ispunity
   - Follow the following process after successful installation of ispunity
    
    i.  ispunity setup       : This will setup your load balancing using the ispunity configuration file.
        Whenever you will change the configuration file, you need to run this command to take effect.
    
    ii. ispunity monitor     : This will check for the availability of isp connections. If any connection any network connection is down then it will load balance the network traffic on available connections.
 

Note : We recommend to add cron job for checking the available network connections. Add following into the crontab : 
    */5 * * * * bash -c 'source /etc/profile.d/rvm.sh && /usr/bin/env ruby /usr/local/rvm/gems/ruby-1.9.3-p125/bin/ispunity monitor'