-
Notifications
You must be signed in to change notification settings - Fork 2
/
install.html
204 lines (153 loc) · 8.11 KB
/
install.html
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
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="A layout example with a side menu that hides on mobile, just like the Pure website.">
<title>ELAG – Bootcamp</title>
<link rel="stylesheet" href="http://yui.yahooapis.com/pure/0.4.2/pure.css">
<link rel="stylesheet" href="css/layouts/side-menu.css">
<link rel="stylesheet" href="css/elag.css">
<link rel="stylesheet" href="css/default.css">
<link href='http://fonts.googleapis.com/css?family=Open+Sans:400italic,600italic,400,300,700,600' rel='stylesheet' type='text/css'>
<link href="//netdna.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css" rel="stylesheet">
</head>
<body>
<div id="layout">
<!-- Menu toggle -->
<a href="#menu" id="menuLink" class="menu-link">
<!-- Hamburger icon -->
<span></span>
</a>
<div id="menu">
<div class="pure-menu pure-menu-open">
<a class="pure-menu-heading" href="#">AMSL</a>
<ul>
<li id="menu_item_home"><a href="index.html">Home</a></li>
<li id="menu_item_start"><a href="start.html">Start</a></li>
<li id="menu_item_install"><a href="install.html">Installation</a></li>
<li id="menu_item_templates"><a href="templates.html">Templates</a></li>
<li id="menu_item_working"><a href="working.html">SPARQL Queries</a></li>
<li id="menu_item_isql"><a href="isql.html">ISQL</a></li>
<li id="menu_item_links"><a href="links.html">Links</a></li>
</ul>
</div>
</div>
<div id="main">
<div class="header">
<h1>Installation</h1>
<h2>Let's go!</h2>
</div>
<div class="content">
<h1 id="images-overview">Images Overview</h1>
<p>There are two images, namely</p>
<ul>
<li>elag2014_64 (for 64bit machines)</li>
<li>elag2014_32 (for 32bit machines)</li>
</ul>
<p>The computer name (not really needed) is <code-inline>elag</code-inline> and the the (only) user on these machines is:</p>
<ul>
<li>user name: elag</li>
<li>password: elag</li>
</ul>
<h2 id="virtualbox-installation-instructions">VirtualBox Installation Instructions</h2>
<h3 id="manjaroarch">Manjaro/Arch</h3>
<ul>
<li>Install VirtualBox with pacman</li>
<li>Install and enable the kernel modules, as pointed out here: <a href="https://wiki.archlinux.org/index.php/VirtualBox">https://wiki.archlinux.org/index.php/VirtualBox</a>, especially point 1.2 und 1.3</li>
</ul>
<h3 id="ubuntu">Ubuntu</h3>
<p>Install VirtualBox with apt-get:</p>
<pre><code>$ sudo apt-get install virtualbox virtualbox-qt virtualbox-dkms virtualbox-guest-dkms
</code></pre>
<h1 id="php-and-odbc">PHP and ODBC</h1>
<p>Most of the following instructions can be done with the help of your terminal and editor of choice. PHP has already been installed on the VM but to make it work with OntoWiki we need two additional packages:</p>
<pre><code>$ sudo apt-get install php5-odbc libapache2-mod-php5
</code></pre>
<p>The first package provides the required ODBC driver for PHP and the second one allows for the Apache2 to render PHP.</p>
<p>Now let’s configure php. Therefore locate php.ini via <code-inline>updatedb</code-inline>.</p>
<pre><code class="bash">$ sudo updatedb
$ locate php.ini
$ [editor] /path/to/php.ini
</code></pre>
<p>Now change the values as recommended:</p>
<pre><code class="bash">max_execution_time = 120
memory_limit = 512M
upload_max_filesize = 128M
post_max_size = 256M
short_open_tag = On
</code></pre>
<h1 id="virtuoso">Virtuoso</h1>
<p>If you are using the virtual machine you can install it from the official repositories. During the installation you will be asked to enter a password for the DBA user. For the purpose of this workshop please use <code-inline>dba</code-inline> as password.</p>
<pre><code>$ sudo apt-get install virtuoso-opensource</code></pre>
<p>You can now check if Virtuoso is running with: </p>
<pre><code>$ sudo service virtuoso-opensource-6.1 status</code></pre>
<p>Afterwards you can access the Virtuoso Conductor in your browser at <a href="http://localhost:8890/">http://localhost:8890/</a>.</p>
<h2 id="configuration">Configuration</h2>
<p>Now locate the virtuoso.ini and open it with an editor. On Ubuntu it is located at <code-inline>/etc/virtuoso-opensource-6.1/virtuoso.ini</code-inline>.</p>
<pre><code>$ sudo updatedb
$ locate virtuoso.ini
</code></pre>
<p>To give Virtuoso the permission to access the OntoWiki, we have to add the future OntoWiki directory to the <code-inline>DirsAllowed</code-inline> parameter.</p>
<p><i class="fa fa-exclamation fa-fw"></i> On this VM choose <code-inline>/var/www/html/OntoWiki/</code-inline> and add it to the <code-inline>DirsAllowed</code-inline> parameter:</p>
<pre><code class="apache">DirsAllowed = ., /usr/share/virtuoso-opensource-6.1/vad/, /var/www/html/OntoWiki, /tmp</code></pre>
<p>Now restart Virtuoso to let the changes take effect.</p>
<pre><code>$ sudo service virtuoso-opensource-6.1 restart</code></pre>
<h1 id="ontowiki-and-apache">OntoWiki and Apache</h1>
<p>Now it is time to checkout the OntoWiki from the official repository:</p>
<pre><code class="bash">$ cd /var/www/html
$ sudo mkdir OntoWiki
$ sudo chown -R elag:elag OntoWiki
$ sudo apt-get install git
$ git clone https://github.com/AKSW/OntoWiki.git OntoWiki
$ cd OntoWiki
$ git checkout --track -b deployment/erm-hd origin/deployment/erm-hd
$ make deploy
</code></pre>
<p>OntoWiki uses a global config file <code-inline>config.ini.dist</code-inline> which is located in the root directory. To use it rename it to <code-inline>config.ini</code-inline>. You can now enable debugging in by uncommenting <code-inline>debug = true</code-inline> to get exeptions in case OntoWiki runs into an error.</p>
<h2 id="odbc-configuration">ODBC Configuration</h2>
<p>By default, ODBC should be working out-of-the-box. To check if your ODBC connection is working correctly execute the ODBC test.</p>
<p><a class="pure-button" id="odbctest-button"><i class="fa fa-play-circle-o button-icon"></i> Start ODBC test</a></p>
<div id="odbctest-output"></div>
<p>If the test fails, click on the following button to see instructions.</p>
<p><a class="pure-button" id="odbc-instructions-button"><i class="fa fa-book button-icon"></i> Show instructions</a></p>
<div id="odbc-instructions" class="hidden-div">
To make ODBC work with Virtuoso, two config files have to be edited. Add following lines to <code-inline>/etc/odbc.ini</code-inline> (create if not existent):
<pre><code>[ODBC Data Sources]
VOS = Virtuoso
[VOS]
Driver = virtuoso-odbc
Description = Virtuoso Open-Source Edition
Address = localhost:1111
</code></pre>
Then edit <code-inline>/etc/odbcinst.ini</code-inline> and add the following lines:
<pre><code>[virtuoso-odbc]
Driver = /usr/lib/virtodbc.so
</code></pre>
</div>
<h2 id="apache-configuration">Apache Configuration</h2>
<p>Once Virtuoso, ODBC and PHP are running we can finally configure the Apache Webserver and OntoWiki. First, edit <code-inline>/etc/apache2/sites-enabled/000-default.conf</code-inline></p>
<pre><code class="xml"><Directory "/var/www/html">
Options Indexes FollowSymLinks
AllowOverride All
</Directory>
</code></pre>
<p>And don’t forget to activate Apache’s mod rewriting.</p>
<pre><code class="bash">$ sudo a2enmod rewrite</code></pre>
<p>Now Restart apache.</p>
<pre><code class="bash">$ sudo service apache2 restart</code></pre>
<p>Finally check <a href="http://localhost/OntoWiki">http://localhost/OntoWiki</a> if OntoWiki is running correctly.</p>
</div>
</div>
</div>
<script src="js/highlight.js"></script>
<script src="js/ui.js"></script>
<script src="js/jquery.js"></script>
<script src="js/elag.js"></script>
<script type="text/javascript">
$(document).ready(function() {
$("#menu_item_install").addClass("menu-item-divided pure-menu-selected");
});
</script>
</body>
</html>