File: README

package info (click to toggle)
virtuoso-opensource 7.2.5.1+dfsg-3
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 284,776 kB
  • sloc: ansic: 641,220; sql: 490,409; xml: 269,570; java: 83,893; javascript: 79,900; cpp: 36,927; sh: 31,648; cs: 25,702; php: 12,690; yacc: 10,227; lex: 7,601; makefile: 7,125; jsp: 4,523; awk: 1,697; perl: 1,013; ruby: 1,003; python: 326
file content (501 lines) | stat: -rw-r--r-- 14,149 bytes parent folder | download
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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
Virtuoso Open-Source Edition: Building
======================================

Copyright (C) 1998-2018 OpenLink Software <vos.admin@openlinksw.com>


Table of Contents
-----------------

* Building Virtuoso Open-Source Edition
 * .. Introduction
 * .. Package Dependencies
 * .. Diskspace Requirements
 * .. Make FAQ
 * .... Generic build environment
 * .... AIX 4.x 32-bit
 * .... AIX 4.x 64-bit
 * .... AIX 5.x 32-bit
 * .... AIX 5.x 32-bit
 * .... Digital Unix/OSF1 V5.0 64-bit
 * .... HP/UX 11.00 32-bit
 * .... HP/UX 11.00 64-bit
 * .... HP/UX 11.23 Itanium 32-bit
 * .... HP/UX 11.23 Itanium 64-bit
 * .... Linux 32-bit
 * .... Linux 64-bit
 * .... Mac OS X 10.2 and 10.3 PPC 32-bit
 * .... Mac OS X 10.4 PPC 32-bit
 * .... Mac OS X 10.4 PPC 64-bit
 * .... Mac OS X 10.4 Universal 32-bit
 * .... Mac OS X 10.5 32-bit
 * .... Mac OS X 10.5 64-bit
 * .... Mac OS X 10.5 Universal
 * .... Mac OS X 10.6 32-bit
 * .... Mac OS X 10.6 64-bit
 * .... Mac OS X 10.6 Universal
 * .... Mac OS X 10.7 32-bit
 * .... Mac OS X 10.7 64-bit
 * .... Mac OS X 10.7 Universal
 * .... Solaris 2.x i386 32-bit
 * .... Solaris 2.10 Opteron 32-bit
 * .... Solaris 2.10 Opteron 64-bit
 * .... Solaris 2.8 and above SPARC 32-bit
 * .... Solaris 2.8 and above SPARC 32-bit
 * .. Installation
 * .... Test Suite
 * .. Getting Started
 * .... VAD Packages


Introduction
============

This document explains steps to take after obtaining a Virtuoso source
snapshot or git clone.

These sections explain how to compile, test and install and what
components are produced by the make process and how one can interact
with them.


Package Dependencies
====================

To generate the configure script and all other build files necessary,
please make sure the following packages and recommended versions are
installed on your system.

    Package  Version                         From
    -------  -------                         ----
    autoconf 2.57               http://www.gnu.org/software/autoconf/
    automake 1.9                http://www.gnu.org/software/automake/
    libtool  1.5.16             http://www.gnu.org/software/libtool/
    flex     2.5.33 (was 2.5.4) http://www.gnu.org/software/non-gnu/flex/
    bison    2.3 (was 1.35)     http://www.gnu.org/software/bison/
    gperf    2.7.2              http://www.gnu.org/software/gperf/
    gawk     3.1.1              http://www.gnu.org/software/gawk/
    m4       1.4.1              http://www.gnu.org/software/m4/
    make     3.79.1             http://www.gnu.org/software/make/
    OpenSSL  0.9.8e             http://www.openssl.org/

and any GNU packages required by these. The autogen.sh and configure
scripts check for the presence and right version of some of the required
components.

The above version are the minimum recommended versions of these packages.
Older version of these packages can sometimes be used, but could cause
build problems.

To check the version number of the tools installed on your system,
use one of the following commands:

    $ autoconf --version
    $ automake --version
    $ libtoolize --version
    $ flex --version
    $ bison --version
    $ gperf --version
    $ gawk --version
    $ m4 --version
    $ make --version
    $ openssl version

If you have an older version than automake version 1.9 you can edit
the configure.ac script around line 47 using the examples provided for
each version.

Note that uptodate operating systems (particularly all Linux distibutions)
split some of these packages into runtime and development
packages, so users of these platforms may need to run e.g.:

    apt-get install libssl-dev

or

    yum install openssl-devel 

to get development headers & libraries for OpenSSL.


Diskspace Requirements
======================

The build produces a demo database and Virtuoso application packages
that are quite large. At least 800 MB of free space should be available
in the build file system.

When running `make install', the target file system should have about 460
MB free. By default, the install target directories are under /usr/local/,
but you can specify

    ./configure --prefix=/path/to/dir

instead.

The minimum working configuration consists of the server executable
and config files plus database, no more than a few MB for the server
executable, depending on platform and options.


Make FAQ
========

In the root directory of the checkout perform the following commands:

    ./autogen.sh        # should only be needed in git clone
    ./configure
    make

to produce the default binaries, VAD packages and demo database. This
takes some time, principally due to building and filling the demo
database, rendering the XML documentation into several target formats
and composing various Virtuoso application packages. It takes about 30
minutes on a 2GHz machine.

The default configure does not enable most of the runtime-hosting and
extension features. See the links on the building page for instructions
on how to enable these and what additional software is required.

Some builds require additional C compiler and other environment flags to
be set before running the configure command, especially when building
64-bit versions of the server. If your system is not in this list,
please try to run the configure command without any environment settings.

Warning: if VAD or other packages fail to be built, especially on
64-bit Linux platforms, ensure you're not using excessive optimization.
CFLAGS="-O2" is known to work but there are reports of -O3 failing.

If your system requires additional flags not listed below, please contact
us at <vos.admin@openlinksw.com>.

Generic build environment
-------------------------
    CC=cc
    CFLAGS="-O"
    export CFLAGS CC
    ./configure
    make
    make install

AIX 4.x 32-bit
--------------
    CC=cc_r7
    CFLAGS="-O -q32"
    LDFLAGS="-brtl"
    OBJECT_MODE=32
    export CC CFLAGS LDFLAGS OBJECT_MODE
    ./configure ...

AIX 4.x 64-bit
--------------
    CC=cc_r7
    CFLAGS="-O -q64"
    LDFLAGS="-brtl"
    OBJECT_MODE=64
    export CC CFLAGS LDFLAGS OBJECT_MODE
    ./configure ...

AIX 5.x 32-bit
--------------
    CC=cc_r
    CFLAGS="-O -q32"
    LDFLAGS="-brtl"
    OBJECT_MODE=32
    export CC CFLAGS LDFLAGS OBJECT_MODE
    ./configure ...

AIX 5.x 32-bit
--------------
    CC=cc_r
    CFLAGS="-O -q64"
    LDFLAGS="-brtl"
    OBJECT_MODE=64
    export CC CFLAGS LDFLAGS OBJECT_MODE
    ./configure ...

Digital Unix/OSF1 V5.0 64-bit
-----------------------------
    CFLAGS="-O"
    export CFLAGS
    ./configure ...

HP/UX 11.00 32-bit
------------------
    CFLAGS="-O -Ae +DA1.1"
    export CFLAGS
    ./configure ...

HP/UX 11.00 64-bit
------------------
    CFLAGS="-O -Ae +DA2.0W"
    export CFLAGS
    ./configure ...

HP/UX 11.23 Itanium 32-bit
--------------------------
    CFLAGS="-O -Ae +DD32"
    export CFLAGS
    ./configure ...

HP/UX 11.23 Itanium 64-bit
--------------------------
    CFLAGS="-O -Ae +DD64"
    export CFLAGS
    ./configure ...

Linux 32-bit
------------
    CFLAGS="-O2"
    export CFLAGS
    ./configure ...

Linux 64-bit
------------
    CFLAGS="-O2 -m64"
    export CFLAGS
    ./configure ...

Mac OS X 10.2 and 10.3 PPC 32-bit
---------------------------------
    CFLAGS="-O -m32 -mmacosx-version-min=10.4"
    export CFLAGS
    ./configure ...

Mac OS X 10.4 PPC 32-bit
------------------------
    CFLAGS="-O -m32 -mmacosx-version-min=10.4"
    export CFLAGS
    ./configure ...

Mac OS X 10.4 PPC 64-bit
------------------------
    CFLAGS="-O -m64 -mmacosx-version-min=10.4"
    export CFLAGS
    ./configure ...

Mac OS X 10.4 Universal 32-bit
------------------------------
    CFLAGS="-O -isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch ppc -arch i386 -mmacosx-version-min=10.4"
    export CFLAGS
    ./configure --disable-dependency-tracking ...

Mac OS X 10.5 32-bit
--------------------
    CFLAGS="-O -m32 -mmacosx-version-min=10.5"
    export CFLAGS
    ./configure ...

Mac OS X 10.5 64-bit
--------------------
    CFLAGS="-O -m64 -mmacosx-version-min=10.5"
    export CFLAGS
    ./configure ...

Mac OS X 10.5 Universal 
-----------------------
    CFLAGS="-O -isysroot /Developer/SDKs/MacOSX10.5.sdk -arch ppc -arch i386 -arch ppc64 -arch x86_64 -mmacosx-version-min=10.5"
    export CFLAGS
    ./configure --disable-dependency-tracking ...

Mac OS X 10.6 32-bit
--------------------
    CFLAGS="-O -m32 -mmacosx-version-min=10.6"
    export CFLAGS
    ./configure ...

Mac OS X 10.6 64-bit
--------------------
    CFLAGS="-O -m64 -mmacosx-version-min=10.6"
    export CFLAGS
    ./configure ...

Mac OS X 10.6 Universal 
-----------------------
    CFLAGS="-O -isysroot /Developer/SDKs/MacOSX10.6.sdk -arch i386 -arch x86_64 -mmacosx-version-min=10.6"
    export CFLAGS
    ./configure --disable-dependency-tracking ...

Mac OS X 10.7 32-bit
--------------------
    CFLAGS="-O -m32 -mmacosx-version-min=10.7"
    export CFLAGS
    ./configure ...

Mac OS X 10.7 64-bit
--------------------
    CFLAGS="-O -m64 -mmacosx-version-min=10.7"
    export CFLAGS
    ./configure ...

Mac OS X 10.7 Universal 
-----------------------
    CFLAGS="-O -arch i386 -arch x86_64 -mmacosx-version-min=10.7"
    export CFLAGS
    ./configure --disable-dependency-tracking ...

Solaris 2.x i386 32-bit
-----------------------
Note: on Solaris or Open Solaris we recommend you use gmake either from
/usr/ sfw/bin/ or install it from sunfreeware, as long as it's version
3.80 or better.

    CC=cc
    CFLAGS="-O"
    PATH=/opt/SUNWspro/bin:/usr/ccs/bin:$PATH
    export CFLAGS CC PATH
    ./configure ...

Solaris 2.10 Opteron 32-bit
---------------------------
    CC=cc
    CFLAGS="-O -xtarget=opteron"
    PATH=/opt/SUNWspro/bin:/usr/ccs/bin:$PATH
    export CFLAGS CC PATH
    ./configure ...

Solaris 2.10 Opteron 64-bit
---------------------------
    CC=cc
    CFLAGS="-O -xtarget=opteron -xarch=amd64"
    PATH=/opt/SUNWspro/bin:/usr/ccs/bin:$PATH
    export CFLAGS CC PATH
    ./configure ...

Solaris 2.8 and above SPARC 32-bit
----------------------------------
    CC=cc
    CFLAGS="-O"
    PATH=/opt/SUNWspro/bin:/usr/ccs/bin:$PATH
    export CFLAGS CC PATH
    ./configure ...

Solaris 2.8 and above SPARC 32-bit
----------------------------------
    CC=cc
    CFLAGS="-O -xtarget=ultra -xarch=v9"
    PATH=/opt/SUNWspro/bin:/usr/ccs/bin:$PATH
    export CFLAGS CC PATH
    ./configure ...

Installation
============

After running configure && make,

    make install

at the root of the build tree copies the files to the locations
specified by the --prefix option to configure. The default of --prefix
is /usr/local/. You can override this by specifying `make install
prefix=/home/virtuoso' instead, for example.

These subdirectories are all appended to the specified prefix,
i.e. /usr/local/ by default:

 * share/virtuoso/doc/html
 * share/virtuoso/doc/pdf
 * share/virtuoso/vad - VAD packages BPEL, Conductor, tutorials, documentation
 * var/lib/virtuoso/db - Empty database
 * var/lib/virtuoso/demo - Demo database - obsolete as of version 5.0.3
 * bin/ - The virtuoso-t, isql, isqlw, virt_mail, virtuoso-sample-t, inifile
    executables
 * lib/ - libvirtuoso-t.a libvirtuoso-t.la virtodbc32.a virtodbc32.la
    virtodbc32 r.a virtodbc32_r.la virtodbc_r.so wikiv.so, plus any plugins
    that may be enabled.
 * lib/virtuoso - hosting sample.a hosting_sample.la hosting_sample.so
    plugin_sample.a plugin_sample.so

Note: as of version 5.0.2, the ./configure script supports different
subdirectory structures with the --with-layout= parameter. If you've
specified something other than the default, the above may differ
accordingly.

As of version 5.0.3, the demo is a VAD package, not a separate directory.


Test Suite
==========

Optionally, you can run

    make check

at the root of the build tree to start the automated test suite. This
takes about an hour on a 2GHz machine and requires approximately 1 GB
of free disk space.


Getting Started
===============

Run

    cd var/lib/virtuoso/db 
    virtuoso-t -f &

to start the server in the background. It will not detach from the shell,
so you see the startup messages.

By default, when no -c parameter is specified, virtuoso will use the
virtuoso.ini file in this directory, which is generated as part of
`make install'.

The first time it's run, it will create the empty database (no special
commands required) and install the Conductor VAD package. From here, you
can access http://localhost:8890/ and http://localhost:8890/conductor/ and
use the System Administration / Packages page to install other packages
such as Demo and the ODS suite (addressbook, weblog, feeds manager and
other applications) etc. 

The default login is `dba' with a password of `dba' for the Conductor and
isql (for DAV functions, the default login is `dav' with a password of
`dav').

You will see a checkpoint in the terminal for each package selected:

    15:33:54 INFO: Checkpoint made, log reused

To connect with the command line SQL tool,

    isql 1112 dba dba

gives a SQL> prompt.

If you've installed the demo VAD above, type
    SQL> use Demo;

to switch to the demo database, containing the Microsoft Northwind sample
tables. The `help' command in isql gives further instructions.


To use the web admin interface, point the browser to: 

    http://localhost:8890/conductor

To read the documents online: 

    http://localhost:8890/doc/html

To experiment with online tutorials you can use the conductor to install
the Tutorial vad package into your database, then point the browser to:

    http://localhost:8890/tutorial


VAD Packages
============

The different VAD packages can be installed via ISQL using the following
command (if the installation packages reside in the filesystem):

    SQL> vad_install ('file/system/path/package-name.vad', 0);

Alternatively, you can copy VAD packages to Virtuoso's DAV repository
and then execute the following command (also from ISQL):

    SQL> vad_install ('webdav/path>/package-name.vad', 1);

at the isql command line. Note that the DirsAllowed parameter of the
Parameters section of the ini-file must allow access to the directory
where the package file is located.