"2017-06-13T05:36:13.817763"^^ . . . . . . "VOSCentosNotes" . . . . . "b2bb4ecf4d220a45cd749774700422a8" . . . . "VOSCentosNotes" . . . "VOSCentosNotes" . . "2017-06-13T05:36:13Z" . "%META:TOPICPARENT{name=\"VOSBuild\"}%\n---+How to Install Virtuoso Open Source (VOS) on CentOS Linux\n\n%TOC%\n\n---++Starting Point\n\n 1 We start from a freshly installed Linux installation having chosen the \"server\"\npackage set.\n 1 Linux OS configurations: when first installed, CentOS runs setup(1) on reboot.\nAt that time or by running it again subsequently, we make a couple of changes:\n * On general principles, it is wise to disable the insecure & unrequired\nservices (e.g., RPC, portmapper, etc.), unless you're also going to use them.\n * It may be wise to open port 8890/tcp in the firewall configuration to allow\nexternal access to Virtuoso's web-based interfaces such as the Conductor.\n 1 Update the indexes of available packages by running\n\nyum update\n\n 1 We recommend installing as a normal user, and using sudo only for the final make\ninstall phase, so create a new user with the adduser command and run\nvisudo to add them to sudoers.\n\n---++Installing Virtuoso\n\nVirtuoso is not currently packaged for CentOS, so has to be built from source.\n\n*Note*: Useful prior reading: please see the pages\n[[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VOSBuild][VOSBuild]]\nand [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VOSMake][VOSMake]]\nin the VOS Wiki.\n\n---+++Dependencies\n\nProceed to install the required build dependencies:\n\n[tim@centos ~]$ sudo yum install gcc gmake autoconf automake libtool flex \\\n\tbison gperf gawk m4 make openssl-devel readline-devel wget\nLoaded plugins: fastestmirror\nLoading mirror speeds from cached hostfile\n * base: mirror.as29550.net\n * extras: mirror.as29550.net\n * updates: mirror.as29550.net\nSetting up Install Process\nNo package gmake available.\nPackage gawk-3.1.5-14.el5.i386 already installed and latest version\nPackage m4-1.4.5-3.el5.1.i386 already installed and latest version\nPackage 1:make-3.81-3.el5.i386 already installed and latest version\nNo package openssl-dev available.\nResolving Dependencies\n--> Running transaction check\n---> Package autoconf.noarch 0:2.59-12 set to be updated\n--> Processing Dependency: imake for package: autoconf\n[...]\n\nDependency Installed:\n cpp.i386 0:4.1.2-50.el5 glibc-devel.i386 0:2.5-58 \n glibc-headers.i386 0:2.5-58 imake.i386 0:1.0.2-3 \n kernel-headers.i386 0:2.6.18-238.5.1.el5 \n\nComplete!\n[tim@centos ~]$ \n\n\n---+++Unpacking\n\nDownload the latest VOS archive (source tarball such as\nvirtuoso-opensource-6.1.3.tar.gz) from\n[[http://virtuoso.openlinksw.com/dataspace/doc/dav/wiki/Main/VOSDownload#Latest%20source%20code%20on%20Github][GitHub]] and unpack it:\n\n\n[tim@centos ~]$ tar xvpfz virtuoso-opensource-6.1.3.tar.gz \nvirtuoso-opensource-6.1.3/\nvirtuoso-opensource-6.1.3/bin/\nvirtuoso-opensource-6.1.3/bin/installer/\nvirtuoso-opensource-6.1.3/bin/installer/virtuoso.ini\nvirtuoso-opensource-6.1.3/bin/installer/demo.ini\n...\n\n\n---+++Configuring\n\n 1 For this demonstration, we use a simple configuration with no frills:\n\n[tim@centos virtuoso-opensource-6.1.3]$ ./configure --prefix=/usr/local/ \\\n\t--with-readline \n\n 1 There are many other options that can be specified at this stage, to\nenable/disable the building of language-hosting plugins (Perl, Python, Ruby) or\nvarious VAD packages (sub-packages within Virtuoso); for more on these, read the\nrelevant README files in the source distribution and run './configure\n--help'.\n 1 Here we settle for asking for readline support, i.e., the ability to cursor-up/down\nand use typical readline key-combinations in the commandline isql tool\nonce built.\n\n---++++VOS component locations\n\n 1 Virtuoso instances usually take the form of a designated directory somewhere in\nthe filesystem, centered around a configuration file (nominally virtuoso.ini)\nwhich specifies operational parameters such as the filenames of database\npage-files to use, port-numbers to use, numbers of threads and buffers, etc.\n 1 In the above command, we specify a prefix of /usr/local to Virtuoso's\n./configure script. This forms a base directory under which Virtuoso\nwill create/use the following structure:\n * /usr/local/lib/\n * various libraries for Sesame, JDBC, Jena, Hibernate, and hosting\n * /usr/local/bin/\n * where the main executables (virtuoso-t, isql) live\n * /usr/local/share/virtuoso/vad/\n * used to store VAD archives prior to installation in an instance\n * /usr/local/share/virtuoso/doc/\n * local offline documentation\n * /usr/local/var/lib/virtuoso/db/\n * the default location for a virtuoso instance \n * /usr/local/var/lib/virtuoso/vsp/\n * various VSP scripts - the default homepage before the Conductor is installed\n 1 Other directory-structures are possible by specifying variously:\n * individual configure options such as --bindir, --libdir, etc.\n * --with-layout={GNU|Debian|Gentoo|RedHat|FreeBSD|opt|OpenLink}%BR%\nwhere each layout specifies a set of locations where the VADs,\ndocumentation (HTML and PDF), demo and default instance databases, and hosting\nlibraries will be installed, each compatible with the packaging requirements of the\nnamed OS distribution (\"opt\" means a prefix of /opt and OpenLink is the\ndefault, detailed above).\n\n---+++Building and Installing\n\n 1 Having chosen some configure options, run make: \n\n[tim@centos virtuoso-opensource-6.1.3]$ nice make\n\n 1 Optionally, you can run 'make check' to run the test-suite (beware, it takes\nhours and multiple gigabytes of disk-space).\n\n[tim@centos virtuoso-opensource-6.1.3]$ nice make check\n\n 1 Install it to the directory-structure chosen above:\n\n[tim@centos virtuoso-opensource-6.1.3]$ sudo make install\n\n\n---++Getting Started\n\n 1 Take a copy of the default virtuoso.ini and store it safely in case of making\nerroneous changes.\n 1 Change into the default database directory:\n\n[tim@centos v-oss]$ cd /usr/local/var/lib/virtuoso/db/\n[tim@centos db]$ ls\nvirtuoso.ini\n\n * (At this point, if you wish to run virtuoso as a non-root user you should change\nthe ownership on this directory (e.g., sudo chown -R tim .). Virtuoso\nonly requires root if you wish to use it as a webserver listening on port 80 or other \nprivileged port; by default, it listens only on high ports.)\n 1 Start the server:\n\n[tim@centos db]$ virtuoso-t -df\n\n Wed Apr 13 2011\n15:12:48 INFO: { Loading plugin 1: Type 'plain', file 'wikiv' in '/usr/local/lib/virtuoso/hosting'\n...\n15:13:10 INFO: Checkpoint finished, log reused\n15:13:10 INFO: PL LOG: Installing Virtuoso Conductor version 1.00.7890 (DAV)\n15:13:10 INFO: Checkpoint started\n15:13:14 INFO: Checkpoint finished, log reused\n15:13:14 INFO: HTTP/WebDAV server online at 8890\n15:13:14 INFO: Server online at 1111 (pid 4125)\n\n * Here we see the server running in foreground mode with maximum debugging\ninformation. Because it's the first time this instance has been run, virtuoso\nhas created a bunch of database files (virtuoso.db, virtuoso.trx (the\ntransaction log), etc.) and installed the Conductor VAD package into the\ndatabase.\n * If you close your terminal while this command is running, Virtuoso will stop. To\nrun it as a daemon instead, omit the \"-df\" flags. You can still see most of\nwhat's happening by running tail -f virtuoso.log.\n\n---+++Using Virtuoso\n\n---++++Web-based UI\n\nYou can access the Conductor menu by pointing your web-browser at\n[[http://localhost:8890/conductor/][http://localhost:8890/conductor/]] \n(substitute the hostname as appropriate).\n\nFrom the Conductor you can manage users and automated backups, install VAD\npackages, execute SQL commands in a web-based iSQL tool, configure the RDF\nSponger, and much more.\n\nThere are two system users of immediate importance: \n * dba -- the relational data administrative account\n * dav -- the WebDAV administrative account \n\nBy default, both of these accounts have their passwords set to their respective\nusernames; it is highly advised that you change these as soon as possible, for\nsecurity reasons.\n\n---++++Command-line\n\nVirtuoso provides a SQL/ODBC listener on port 1111/tcp \nby default (configurable in the INI). You can connect directly\nto this and execute SQL statements using the included isql tool:\n\n\n[tim@centos db]$ ../bin/isql localhost:1111 dba dba\nOpenLink Interactive SQL (Virtuoso), version 0.9849b.\nType HELP; for help and EXIT; to exit.\nSQL> tables;\nConnected to OpenLink Virtuoso\nDriver: 06.01.3127 OpenLink Virtuoso ODBC Driver\nShowing SQLTables of tables like 'NULL.NULL.NULL', tabletype/colname like 'NULL'\nTABLE_QUALIFIER TABLE_OWNER TABLE_NAME TABLE_TYPE REMARKS\nVARCHAR VARCHAR VARCHAR VARCHAR VARCHAR\n_______________________________________________________________________________\n\nDB DBA ADMIN_SESSION SYSTEM TABLE NULL\nDB DBA ADM_OPT_ARRAY_TO_RS_PVIEW SYSTEM TABLE NULL\n[...]\n\n\n---++Resource Usage\n\nVirtuoso is highly configurable: the same executables and packages will service\nanything from a small \"lite-mode\" installation with a database of 10Mb up to a\nhuge multi-user enterprise installation with terabytes of data.\n\nThe defaults with Virtuoso Open-Source give a 160MB process size in memory,\nabout 29MB database and total 237MB footprint on disk; this has 20 threads\nrunning for database and/or web-server use.\n\nThe wiki document\n[[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VOSScale][VOSScale]]\ndescribes how to scale Virtuoso in some detail.\n\n---++Related\n\n * [[VOSUbuntuNotes][Ubuntu]]\n * [[VOSDebianNotes][Debian]]\n * [[VOSFedoraNotes][Fedora]]\n\n" . "2017-06-13T05:36:13Z" . . . . . . . . . "2017-06-13T05:36:13.817763"^^ .