annotate README @ 2:c25df71f7b68 default tip

Update to protk 1.2.2
author Ira Cooke <iracooke@gmail.com>
date Sun, 09 Jun 2013 08:13:09 -0500
parents dac478a72c1d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
dac478a72c1d Added readme
iracooke
parents:
diff changeset
1 This package is an installer for the protk rubygem
dac478a72c1d Added readme
iracooke
parents:
diff changeset
2
dac478a72c1d Added readme
iracooke
parents:
diff changeset
3 Installation of this package should proceed automatically however the
dac478a72c1d Added readme
iracooke
parents:
diff changeset
4 steps are outlined here to help troubleshoot potential issues.
dac478a72c1d Added readme
iracooke
parents:
diff changeset
5
dac478a72c1d Added readme
iracooke
parents:
diff changeset
6 The installer does the following
dac478a72c1d Added readme
iracooke
parents:
diff changeset
7 1. Downloads an install script from dropbox
2
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
8 2. Installs ruby version manager (rvm) into the home directory of the galaxy user (ie at $HOME/.rvm)
1
dac478a72c1d Added readme
iracooke
parents:
diff changeset
9 3. Uses rvm to download and compile ruby 1.9.3
dac478a72c1d Added readme
iracooke
parents:
diff changeset
10 4. Creates a gemset to install the protk rubygem
dac478a72c1d Added readme
iracooke
parents:
diff changeset
11 5. Installs the protk rubygem which involves compiling a libxml extension
dac478a72c1d Added readme
iracooke
parents:
diff changeset
12
dac478a72c1d Added readme
iracooke
parents:
diff changeset
13 System Requirements:
dac478a72c1d Added readme
iracooke
parents:
diff changeset
14
2
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
15 - General requirements:
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
16 Many of these requirements are for building rvm and ruby itself. If you have pre-installed
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
17 rvm and ruby you should already have most of these installed (See below for pre-installing RVM and Ruby)
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
18
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
19 Requires the ability to download files (an internet connection) curl wget
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
20 Requires basic build tools.
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
21 On Ubuntu, package build-essential is usually sufficient
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
22 On Centos, you should install gcc g++ make autoconf automake libtool pkg-config patch git openssl libreadline6 libreadline6-dev git-core zlib1g zlib1g-dev libssl-dev libc6-dev ncurses-dev bison subversion libxml2 libxml2-dev gawk
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
23
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
24 - Tested Systems:
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
25 Ubuntu-12.04-LTS 64 Bit Server With OpenSSH preinstalled:
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
26
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
27 Requires
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
28 build-essential mercurial libreadline6-dev zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev autoconf libgdbm-dev libncurses5-dev automake libtool bison pkg-config libffi-dev
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
29
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
30 - RVM (Ruby Version Manager)
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
31 The install script will attempt to install rvm for you if it is not already
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
32 installed but this will fail if there are unsatified system dependencies.
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
33 Alternatively you can pre-install rvm by following instructions at https://rvm.io/rvm/install/
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
34 before you proceed. Protk should work with rvm installed as root or as a local user.
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
35 This option has the advantage of allowing you control over how rvm is installed in your system.
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
36
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
37 (For example. Installing rvm as root user)
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
38
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
39 curl -L https://get.rvm.io | sudo bash -s stable
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
40 sudo usermod -a -G rvm yourusername
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
41
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
42 (logout and log back in and then execute the following comand to preinstall ruby and its dependencies)
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
43
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
44 rvm install --autolibs=3 1.9.3
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
45
c25df71f7b68 Update to protk 1.2.2
Ira Cooke <iracooke@gmail.com>
parents: 1
diff changeset
46