1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
# Developer Installation on Ubuntu
*This guide is for Ubuntu 14.04*
## Ruby (rbenv and ruby-build)
We recommend to use rbenv for managing
ruby on your system. Sam Stephenson gives a good
installation guide on the [Github page](https://github.com/sstephenson/rbenv#installation).
But here is what you have to do:
- `$ git clone https://github.com/sstephenson/rbenv.git ~/.rbenv`
Now we just have to tell the shell to use rbenv
to determine the Ruby Version.
- `$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc`
- `$ echo 'eval "$(rbenv init -)"' >> ~/.bashrc`
If you are using **zsh**, just replace the *.bashrc* with
*.zshrc* (or the config file for your shell, if you are using
different one).
if you restart your shell you could check if rbenv is installed correctly
with:
```
$ type rbenv
#=> "rbenv is a function"
````
to install a ruby version, first install ruby-build with
```
git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
```
The file `.ruby-version` contains the ruby version, e.g. 2.1.7, which you should install with this command
```
rbenv install 2.1.7
```
### rbenv aliases
As we use the *.ruby-version* to specify ontohubs ruby version,
you might need rbenv aliases in order to use the **right**
local version.
- `mkdir -p ~/.rbenv/plugins`
- `git clone git://github.com/tpope/rbenv-aliases.git \
~/.rbenv/plugins/rbenv-aliases`
- `rbenv alias --auto`
## PostgreSQL
```
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo sh -c 'echo deb http://apt.postgresql.org/pub/repos/apt/ precise-pgdg main > /etc/apt/sources.list.d/pgdg.list'
sudo apt-get install -y postgresql-9.3
sudo service postgresql reload
```
Next, we should allow the connection to the database with the postgres user. Edit the `/etc/postgresql/9.3/main/pg_hba.conf` as super user. Somewhere on the bottom there is the line
```
local all postgres peer
```
change it to
```
local all postgres trust
```
After this we should create the config directory for postgres:
- `initdb /usr/local/var/postgres -E utf8`
As the postgres user you have to create two databases
- `sudo su -l postgres`
- `createdb ontohub_development`
- `createdb ontohub_test`
When you type in
- `psql`
you should be connected to the database (`\q` lets you quit).
## gems
Switch to the directory where you clone ontohub.
We use **capybara-webkit** for integration testing. This gem needs a **qt**-Engine
on the system, so we will have to install one:
- `sudo apt-get install libqtwebkit-dev`
Clone the ontohub sources:
- `git clone git@github.com:ontohub/ontohub.git`
(Side note: if you want to push later on, you need to get access rights from the Ontohub team first.)
Now we can actually start installing the necessary gems:
- `cd ontohub`
- `gem install bundler`
- `bundle install`
## redis
In order for sidekiq to work, we need to install redis.
```
add-apt-repository ppa:chris-lea/redis-server
apt-get update
apt-get install -y redis-server
```
## elasticsearch
```
wget -qO - https://packages.elasticsearch.org/GPG-KEY-elasticsearch | sudo apt-key add -
sudo add-apt-repository "deb http://packages.elasticsearch.org/elasticsearch/1.4/debian stable main”
sudo apt-get update
sudo apt-get install -y elasticsearch
sudo update-rc.d elasticsearch defaults 95 10
```
And then after a reboot the elasticsearch service should be running.
## hets
The Heterogenous Toolset is needed to perform Operations during Ontology import.
To Install it you have to do the following steps:
```
apt-add-repository ppa:hets/hets
apt-add-repository "deb http://archive.canonical.com/ubuntu precise partner"
apt-get update
apt-get -y install hets-core subversion
ln -s libpng12.so.0 libpng14.so.14
```
If you need the latest nightly build, just update hets (assure you have a working internet connection):
```
hets -update
```
## phantomjs
We use `phantomjs` as a headless javascript-enabled browser for our integration
tests. You only need to install the package:
```
sudo apt-get install -y phantomjs
```
## Extra executables
The SSH-Key handling requires an additional executable `data/.ssh/cp_keys` to exist.
This can be compiled easily from the supplied C-code with (in the ontohub directory)
GIT_HOME=$(pwd)/tmp/git bundle exec rake git:compile_cp_keys
Providing the `GIT_HOME` variable is mandatory for this rake task.
It will print a message about changing permissions, but you don't need to do as the message says as long as you are in a development environment.
It is only important for securing production systems.
## setup
In ontohub directory:
You can start everything needed with (in the ontohub directory):
```
invoker start invoker.ini
```
And you can (re)build the database with:
```
```
Now you should be ready...
## Troubleshooting
### Remote Access
If you want to access the rails server (WEBrick) remotely, it gets very slow.
To speed things up, you can change the WEBrick config:
Find the `webrick/config.rb` of your ruby (rbenv) installation and change
`:DoNotReverseLookup => nil` to `:DoNotReverseLookup => true`.
[Source](https://www.ruby-forum.com/topic/218316)