rhoconnect 3.0.0.beta1 → 3.0.0.beta3

data/installer/deb-scripts/install.sh

@@ -0,0 +1,300 @@
+#!/bin/bash
+
+# CONSTANTS
+
+PASSENGER_VERSION="passenger-3.0.9"
+
+RUBY="ruby-enterprise-1.8.7-2011.03"
+REDIS="redis-2.2.12"
+SQLITE3="sqlite-autoconf-3070701"
+SOFTWARE= ($REDIS $SQLITE3)
+
+RUBY_TAR="${RUBY}.tar.gz"
+REDIS_TAR="${REDIS}.tar.gz"
+SQLITE3_TAR="${SQLITE3}.tar.gz"
+TARS=($REDIS_TAR $SQLITE3_TAR)
+
+RUBY_URL="http://rubyenterpriseedition.googlecode.com/files/${RUBY_TAR}"
+REDIS_URL="http://redis.googlecode.com/files/${REDIS_TAR}"
+SQLITE3_URL="http://www.sqlite.org/${SQLITE3_TAR}"
+URLS=($REDIS_URL $SQLITE3_URL)
+
+GEMS=("bundler" "passenger")
+
+PKG_MGR="apt-get"
+
+WEB_SERVER="nginx"
+
+WEB_SERVER_URL="http://localhost/"
+
+DEFAULT_INSTALL_DIR="/opt/rhoconnect"
+
+# INITIALIZATIONS
+
+timeInitial=`date +%H%M%S`
+installTime=$timeInitial
+
+# FUNCTIONS
+
+echoLog(){
+  echo -e $1 | tee -a $log
+} #end echoLog
+
+# cmd
+# This method issues the given system command and calls log_print for output
+cmd(){
+  cmd=$1
+  echoLog cmd
+  echoLog `${cmd}`
+} #end cmd
+
+checkDeps(){
+  deps=("zlib1g-dev" "libreadline5-dev" "build-essential" "libssl-dev"
+        "libcurl4-openssl-dev" "libapr1-dev" "libaprutil1-dev" 
+        "gcc" "make" "wget")
+  i="0"
+  missing=""
+
+  while [[ ${deps[$i]} != "" ]]; do
+    pkg=${deps[$i]}
+    pkgChk=`dpkg -l | grep -w ${pkg}`
+    if [[ $pkgChk == "" ]]; then
+      missing=$missing$pkg"\n"
+    fi
+    i=$[i+1]
+  done
+
+  if [[ $missing != "" ]]; then
+    echoLog "Some dependencies must be installed before the setup can continue..."
+    echoLog  $missing
+    exit
+  fi
+
+} #end checkDeps
+
+setPrefixDependantPaths (){
+  # if rubyBinDir not specified
+  if [$rubyBinDir == ""]; then
+    rubyBinDir="${prefix}/ruby/bin"
+  fi
+
+  # If logs directory does not exist, create it
+  if ! [[ -d "${prefix}/logs/" ]]; then
+    mkdir "${prefix}/logs/"
+  fi
+
+  # Make path to log file absolute and create directory if not already existent
+  log="${prefix}/logs/${log}"
+  touch $log
+
+  # Add the log file path to the info file
+  echo $log >> info.dat
+  cat info.dat
+
+  # Move info.dat into installation directory if not already there
+  if ! [ -e "${prefix}/info.dat" ]; then
+    mv info.dat "${prefix}/info.dat"
+  fi
+} #end setPrefixDependantPaths
+
+setDefaults (){
+  # if $prefix not specified set to /opt/rhoconnect
+  if [$prefix == ""]; then
+    prefix=$DEFAULT_INSTALL_DIR
+  fi
+
+  # if $webServer not specified set to apache2
+  if [$webServer == ""]; then
+    webServer=$WEB_SERVER
+  fi
+} #end setDefaults
+
+logAndPrint (){
+  $1 > tempout 2>&1  
+  exitStatus=$?
+  cat tempout | tee -a $log
+} #end logAndPrint
+
+# installRuby
+# Installs ruby enterprise edition
+installRuby (){
+  if [[ ! -d "${prefix}${RUBY}" ]]; then
+    echoLog "Loading ruby tarball ..."
+    cmd     "wget -P ${prefix} ${RUBY_URL}"
+    cmd     "tar -xzf ${prefix}/${RUBY_TAR} -C ${prefix}"
+  fi
+
+  echoLog "Installing ruby. This may take some time..."
+
+  logAndPrint "${prefix}/${RUBY}/installer --dont-install-useful-gems --no-dev-docs --auto ${prefix}"
+
+  if [[ $exitStatus != 0 ]]; then
+    echoLog "Some dependencies not installed..."
+    echoLog "Please install them and then re-run the installation script."
+    exit
+  fi
+
+  PATH=${prefix}:$PATH
+
+  rm tempout
+} #end installRuby
+
+# download
+# Downloads file stored at given URL to the given prefix unlessit already 
+# exists
+download(){
+  url=$1
+  prefix=$2
+  downloads="./downloads"
+  found=""
+
+  if [ -e $downloads ]; then
+    while read line; do
+      if ! [ "${line}" == "${url}" ]; then
+        found="found"
+      fi
+    done < $downloads
+  fi
+
+  if [ "${found}" == "" ]; then
+    cmd "wget -P ${prefix} ${url}"
+    echo ${url} >> $downloads
+  fi
+
+  rm $downloads
+} #end download
+
+# decompress
+# Decompresses downloaded files unless already decompressed directory
+# exists
+decompress(){
+  tar=$1
+  prefix=$2
+
+  cmd "tar -xzvf ${prefix}/${tar} -C ${prefix}"
+} #end decompress
+
+# downloadAndDecompress
+# 1) Iterates through the the list of URLs and downloads each item
+# 2) Iterates through the list of TARs and unpacks each one
+downloadAndDecompress(){
+  prefix=$1
+  for (( i=0; i < ${#URLS[@]}; i++ )); do
+    download ${URLS[$i]} ${prefix}
+  done #for
+
+  for (( i=0; i < ${#TARS[@]}; i++ )); do
+    decompress ${#TARS[$i]} ${prefix}
+  done #for 
+} #end downloadAndDecompress
+
+rhoinstaller(){
+
+} #end rhoinstaller
+
+# SCRIPT
+checkDeps
+
+# define log file name
+datefile=`date +%Y%m%d%H%M%S`
+log=rhoconnect_$(date +$datefile).log
+
+# define option variables
+opts=""
+prefix=""
+getVal=""
+webServer=""
+rubyBinDir=""
+
+# Set default Values
+setDefaults
+
+# Set ruby insatallation variables
+setRubyVars
+
+# Once the prefix path is cleaned up...
+setPrefixDependantPaths
+
+# Install ruby if not already installed
+if ! [ -e "${prefix}/bin/ruby" ]; then
+  installRuby
+else
+  echoLog "Ruby already installed" | tee -a $log
+fi
+
+#!/opt/rhoconnect/bin/ruby
+
+#require 'rho_connect_install_constants'
+#require 'rho_connect_install_installers'
+
+include Installers
+
+module Utilities
+  extend self
+  
+  # cleanup
+  # This method moves all compressed files from the installation directory
+  # that were downloaded by this installation process
+  def cleanup(options)
+    prefix = options[:prefix]
+
+    print_header "Cleaning up"
+
+    Dir.mkdir("#{prefix}/downloads") unless File.directory?("#{prefix}/downloads")
+    Constants::URLS.each do |url|
+      file = get_version url
+      if File.exists?("#{prefix}/#{file}")
+        cmd "rm -rf #{prefix}/downloads/#{file}"
+        cmd "mv #{prefix}/#{file}* #{prefix}/downloads"
+      end #if
+    end # do
+  end #cleanup
+end #utilities
+
+# set necessary variables
+            :dist       => "debian",
+            :pkg_mgr    => 'apt-get -y',
+            :pkg_chkr   => 'dpkg -l',
+            :start_dir  => `pwd`.strip,
+            :web_server => Constants::WEB_SERVER}
+
+log = Logger.new(IO.readlines("#{@options[:prefix]}/info.dat").last.strip)
+log.datetime_format = "%Y-%m-%d %H:%M:%S"  # simplify time output
+
+# execute_installation
+# This method orchestrates the actual installation process
+def execute_installation
+  install_sqlite @options
+
+  # Start installing
+  install_all_gems @options
+  configure_passenger @options
+
+  # Install Redis
+  install_redis @options
+
+  # Install rhoconnect
+  install_rhoconnect @options
+              
+  # Remove downloaded tarballs and extracted directories
+  cleanup @options
+end #execute_installation
+
+# Start installation process
+download_and_decompress @options[:prefix]
+
+execute_installation
+
+
+
+
+
+
+
+
+
+
+# Cleanup
+rm "${prefix}/info.dat"
+
+${prefix}/bin/ruby ./utils/create_texts.rb

data/installer/deb-scripts/scripts/rho_connect_install_constants.rb

@@ -0,0 +1,32 @@
+#!/opt/rhoconnect/bin/ruby
+
+module Constants
+
+PASSENGER_VERSION	= "passenger-3.0.9"
+
+#RUBYGEMS                = "rubygems-1.8.5"
+REDIS                   = "redis-2.2.12"
+SQLITE3                 = "sqlite-autoconf-3070701"
+
+SOFTWARE                = [REDIS,
+                           SQLITE3]
+
+#RUBYGEMS_URL            = "http://rubyforge.org/frs/download.php/74954/" + 
+#                          "#{ RUBYGEMS }.tgz"
+REDIS_URL               = "http://redis.googlecode.com/files/#{ REDIS }.tar.gz"
+SQLITE3_URL             = "http://www.sqlite.org/sqlite-autoconf-3070701.tar.gz"
+
+
+URLS                    = [REDIS_URL,
+                           SQLITE3_URL]
+
+GEMS                    = ["bundler", "passenger"]
+
+SUPPORTED_PKG_MGRS      = ["apt-get", "yum"]
+
+WEB_SERVER              = "nginx"
+
+WEB_SERVER_URL          = "http://localhost/"
+
+DEFAULT_INSTALL_DIR     = "/opt/rhoconnect"
+end #Constants

data/installer/deb-scripts/scripts/rho_connect_install_installers.rb

@@ -0,0 +1,103 @@
+#!/opt/rhoconnect/bin/ruby
+
+require 'rho_connect_install_constants'
+require 'readline'
+
+module Installers
+  extend self
+  # configure_passenger
+  # This method installs items that were retrieved via wget as well as
+  # passenger
+  def configure_passenger(options)
+    @options = options
+    installs = 0
+    print_header "Configuring Passenger"
+    print_header "Configuring Nginx to work with Passenger"
+    cmd "#{@options[:prefix]}/bin/passenger-install-#{@options[:web_server]}-module " + 
+        "--auto --auto-download --prefix=/opt/rhoconnect/bin"
+    if $? != 0
+      log_print "Passenger not configured."
+      exit
+    end #if
+  end #configure_passenger
+  
+  # install_all_gems
+  # This method installs all gems specified in the GEMS list defined in the
+  # Constants file
+  def install_all_gems(options)
+    @options = options
+    @gem_path = "#{@options[:prefix]}/bin/gem"
+    Constants::GEMS.each do |gem|
+      install_gem gem
+    end #do
+  end #install_all_gems
+
+  # install_gem
+  # This method installs the given gem
+  def install_gem(gem)
+    cmd "#{@gem_path} install #{ gem } --no-ri --no-rdoc"
+  end #install_gem
+
+  # install_rubygems
+  # This method installs rubygems which was downloaded and untarred earlier
+  def install_rubygems
+    print_header "Installing Rubygems"
+    Dir.chdir("#{@options[:prefix]}/#{Constants::RUBYGEMS}")
+    cmd "#{@options[:prefix]}/bin/ruby setup.rb --prefix=#{@options[:prefix]}/#{Constants::RUBYGEMS}"
+    @gem_path = "#{@options[:prefix]}/bin/gem"
+    cmd "sed -n '1 c\#!/opt/rhoconnect/bin/ruby' #{@options[:prefix]}/bin/gem"
+  end #install_rubygems
+
+  # install_redis
+  # This method installs redis
+  def install_redis(options)
+    @options = options
+    puts "\nWould you like to install Redis (yes / no)?"
+    answer = STDIN.readline.strip.downcase
+    while answer != "yes" &&
+          answer != "no"
+      puts "Please answer yes or no."
+    end
+    
+    if answer == "yes"
+      Dir.chdir("#{@options[:prefix]}/#{Constants::REDIS}/src")
+      cmd "make; make PREFIX=#{@options[:prefix]} install"
+      cmd "mkdir #{@options[:prefix]}/etc" unless File.exist? "#{@options[:prefix]}/etc"
+      
+      #cmd "cp ../redis.conf #{@options[:prefix]}etc"
+      redis_conf_file = File.new("#{@options[:prefix]}/etc/redis.conf", 'w')
+      File.foreach("../redis.conf") do |line|
+        # daemonize no   --> daemonize yes
+        # logfile stdout --> logfile /var/log/redis.log
+        if line =~ /^daemonize/
+          redis_conf_file << "daemonize yes" << "\n"
+        elsif line =~ /^logfile/
+          redis_conf_file << "logfile /var/log/redis.log"  << "\n"
+        else
+          redis_conf_file << line
+        end
+      end
+      redis_conf_file.close
+    end #if
+  end #install_redis
+
+  # install_sqlite
+  # This method installs sqlite
+  def install_sqlite(options)
+    @options = options
+    Dir.chdir("#{@options[:prefix]}/#{Constants::SQLITE3}")
+    cmd "./configure --prefix=#{@options[:prefix]}"
+    cmd "make; make install"
+  end #install_sqlite
+
+  # install_rhoconnect
+  # This method installs rhoconnect
+  def install_rhoconnect(options)
+    @options = options
+    print_header "Installing Rhoconnect"
+
+    cmd "#{@gem_path} install rhoconnect-*.gem --no-ri --no-rdoc"
+    cmd "rm -f rhoconnect-*.gem"
+
+  end #install_rhoconnect
+end #Installers

data/installer/deb-scripts/scripts/rho_connect_install_utilities.rb

@@ -0,0 +1,110 @@
+#!/opt/rhoconnect/bin/ruby
+
+require 'rho_connect_install_constants'
+require 'rho_connect_install_installers'
+
+include Installers
+
+module Utilities
+  extend self
+  
+  # log_print
+  # This method displays, in minutes, how long the installation process took
+  def log_print(string)
+    puts string 
+    @log.info {string}  unless @log == nil
+  end #log_print
+
+  # cmd
+  # This method issues the given system command and calls log_print for output
+  def cmd(cmd)
+    log_print cmd
+    log_print `#{ cmd }`
+  end #cmd
+
+  #set_log_file
+  def set_log_file(log)
+    @log = log
+  end #set_log_file 
+  
+  # print_header
+  # This method displays a header surrounded by '=' characters consisting of
+  # the given string
+  def print_header(string)
+    header = "\n"
+    border = "===="
+    string.each_char { border << "=" }
+    header << border + "\n"
+    header << "= " + string + " =\n"
+    header << border +"\n"
+    log_print header
+  end #print_header
+ 
+  # download_and_decompress
+  # Delegates the download and decompression duties
+  def download_and_decompress(prefix)
+    print_header "Downloading and Decompressing"
+    downloads = 0
+    Constants::URLS.each do |url|
+      if !File.exists?("#{ get_tarball_name url }") ||
+         !File.exists?("#{ get_version url }")
+        wget_download prefix, url
+        decompress prefix, url
+        downloads += 1
+      end #if
+    end #do
+  end #download_and_decompress
+  
+  # wget_download
+  # Takes a URL and the name of a tarball and issues a wget command on said 
+  # URL  unless the tarball or directory already exists
+  def wget_download(prefix, url)
+    if !File.exists?("#{ prefix }/#{ get_tarball_name url }") &&
+       !File.directory?("#{ prefix }/#{ get_version url }")
+      cmd "wget -P #{ prefix } #{ url }"
+    end #if
+  end #wget_download
+
+  # decompress
+  # Decompress downloaded files unless already decompressed directory
+  # exists
+  def decompress(prefix, url)
+    tarball = get_tarball_name(url)
+    dir = get_version(url)
+    cmd "tar -xzf #{ prefix }/#{ tarball } -C #{ prefix }"  unless
+      File.directory? "#{ prefix }/#{ dir }"
+  end #decompress
+
+  # get_version
+  # This method extracts the untarballed name of files retrieved via wget
+  # from their URL
+  def get_version(url)
+    url =~ /.*\/(.*)\.t.*\Z/
+    $1
+  end #get_version
+
+  # get_tarball_name
+  # This method extracts the name of files retrieved via wget from their URL
+  def get_tarball_name(url)
+    url =~ /.*\/(.*\.t.*)/
+    $1
+  end #get_tarball_name
+
+  # cleanup
+  # This method moves all compressed files from the installation directory
+  # that were downloaded by this installation process
+  def cleanup(options)
+    prefix = options[:prefix]
+
+    print_header "Cleaning up"
+
+    Dir.mkdir("#{prefix}/downloads") unless File.directory?("#{prefix}/downloads")
+    Constants::URLS.each do |url|
+      file = get_version url
+      if File.exists?("#{prefix}/#{file}")
+        cmd "rm -rf #{prefix}/downloads/#{file}"
+        cmd "mv #{prefix}/#{file}* #{prefix}/downloads"
+      end #if
+    end # do
+  end #cleanup
+end #Utilities

data/installer/deb-scripts/scripts/rhoinstaller.rb

@@ -0,0 +1,55 @@
+#!/opt/rhoconnect/bin/ruby
+
+$:.unshift File.expand_path(File.join(File.dirname(__FILE__), "..", "scripts"))
+
+require 'logger'
+require 'time'
+require 'rho_connect_install_constants'
+require 'rho_connect_install_utilities'
+
+include Utilities
+
+# Simplify logger output format: [timestamp] message
+class Logger
+  class Formatter
+    #Format = "[%s] %s\n"
+    def call(severity, time, progname, msg)
+      "[%s] %s\n" % [format_datetime(time), msg]
+    end
+  end
+end
+
+# set necessary variables
+@options = {:prefix     => Constants::DEFAULT_INSTALL_DIR,
+            :dist       => "debian",
+            :pkg_mgr    => 'apt-get -y',
+            :pkg_chkr   => 'dpkg -l',
+            :start_dir  => `pwd`.strip,
+            :web_server => Constants::WEB_SERVER}
+
+log = Logger.new(IO.readlines("#{@options[:prefix]}/info.dat").last.strip)
+log.datetime_format = "%Y-%m-%d %H:%M:%S"  # simplify time output
+
+# execute_installation
+# This method orchestrates the actual installation process
+def execute_installation
+  install_sqlite @options
+
+  # Start installing
+  install_all_gems @options
+  configure_passenger @options
+
+  # Install Redis
+  install_redis @options
+
+  # Install rhoconnect
+  install_rhoconnect @options
+              
+  # Remove downloaded tarballs and extracted directories
+  cleanup @options
+end #execute_installation
+
+# Start installation process
+download_and_decompress @options[:prefix]
+
+execute_installation

data/installer/deb-scripts/utils/README

@@ -0,0 +1,67 @@
+Thank you for choosing Rhomobile for your cross-platform app needs!
+To finish this setup, please complete the following...
+
+1) Add necessary bins to the path(s) of the users who will
+   be using this software.  You may also wish to add these items
+   to ~/.profile to automatically add them upon login.
+   Ex:
+
+   A) All bins in the main bin deposit:
+      export PATH=/opt/rhoconnect/bin:$PATH
+
+   B) Bins specifically placed in the ruby/bin directory
+      export PATH=/opt/rhoconnect/ruby/1.8/bin:$PATH
+
+   Or if you had other versions of ruby installed previously to running
+   this installation, you may instead wish to simply create an alias
+   for the newly installed ruby.
+
+   Ex:
+       alias rubyee=/opt/rhoconnect/bin/ruby
+
+    B) Add the export line to ~/.profile:
+       export PATH=/opt/rhoconnect/bin:opt/rhoconnect/ruby/bin:$PATH
+
+2) Rhoconnect installer configured redis server with the following settings:
+
+    A) redis.conf file is located in /opt/rhoconnect/etc/ directory with properties:
+       daemonize yes
+       pidfile /var/run/redis.pid
+       logfile /var/log/redis.log
+
+    B) Redis logrotate settings for /var/log/redis.log files defined in '/etc/logrotate.d/redis': 
+
+        /var/log/redis.log {
+          rotate 3
+          missingok
+          notifempty
+          size 250k
+          create 0644 root root
+          compress
+        }
+
+    C) Redis start-up script '/etc/init.d/redis'. 
+       You can start/stop redis server by running the following commands:
+       /etc/init.d/redis {start|stop}
+
+3) Setup rhoconnect application directory
+    
+    A) Put your application code in a directory called /var/www/rhoconnect 
+       (make sure this is the root of your applictaion directory, i.e. /var/www/rhoconnect/config.ru should exist).
+    
+    B) Make an empty public folder in the directory
+       $ mkdir /var/www/rhoconnect/public
+
+4) Configure Apache2
+    A) Configure virtual host for rhoconnect application:
+       Edit the file /etc/apache2/sites-available/rhoconnect so that it 
+       reflects your specifications.
+
+    B) Enable the virtual host:
+       $ sudo a2ensite rhoconnect
+
+    C) Load the passenger.load module
+       $ sudo a2enmod passenger
+
+    D) Restart apache to pick up the changes:
+       $ sudo /etc/init.d/apache2 restart