<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <head profile="http://internetalchemy.org/2003/02/profile"> <link rel="foaf" type="application/rdf+xml" title="FOAF" href="http://www.openlinksw.com/dataspace/uda/about.rdf" /> <link rel="schema.dc" href="http://purl.org/dc/elements/1.1/" /> <meta name="dc.title" content="2. Installation Guide" /> <meta name="dc.subject" content="2. Installation Guide" /> <meta name="dc.creator" content="OpenLink Software Documentation Team ; " /> <meta name="dc.copyright" content="OpenLink Software, 1999 - 2009" /> <link rel="top" href="index.html" title="OpenLink Virtuoso Universal Server: Documentation" /> <link rel="search" href="/doc/adv_search.vspx" title="Search OpenLink Virtuoso Universal Server: Documentation" /> <link rel="parent" href="installation.html" title="Chapter Contents" /> <link rel="prev" href="linuxinstall.html" title="Virtuoso for Linux (Enterprise Edition)" /> <link rel="next" href="unixpersonainstall.html" title="Virtuoso for Unix (Personal Edition)" /> <link rel="shortcut icon" href="../images/misc/favicon.ico" type="image/x-icon" /> <link rel="stylesheet" type="text/css" href="doc.css" /> <link rel="stylesheet" type="text/css" href="/doc/translation.css" /> <title>2. Installation Guide</title> <meta http-equiv="Content-Type" content="text/xhtml; charset=UTF-8" /> <meta name="author" content="OpenLink Software Documentation Team ; " /> <meta name="copyright" content="OpenLink Software, 1999 - 2009" /> <meta name="keywords" content="" /> <meta name="GENERATOR" content="OpenLink XSLT Team" /> </head> <body> <div id="header"> <a name="unxinstvirt" /> <img src="../images/misc/logo.jpg" alt="" /> <h1>2. Installation Guide</h1> </div> <div id="navbartop"> <div> <a class="link" href="installation.html">Chapter Contents</a> | <a class="link" href="linuxinstall.html" title="Virtuoso for Linux (Enterprise Edition)">Prev</a> | <a class="link" href="unixpersonainstall.html" title="Virtuoso for Unix (Personal Edition)">Next</a> </div> </div> <div id="currenttoc"> <form method="post" action="/doc/adv_search.vspx"> <div class="search">Keyword Search: <br /> <input type="text" name="q" /> <input type="submit" name="go" value="Go" /> </div> </form> <div> <a href="http://www.openlinksw.com/">www.openlinksw.com</a> </div> <div> <a href="http://docs.openlinksw.com/">docs.openlinksw.com</a> </div> <br /> <div> <a href="index.html">Book Home</a> </div> <br /> <div> <a href="contents.html">Contents</a> </div> <div> <a href="preface.html">Preface</a> </div> <br /> <div class="selected"> <a href="installation.html">Installation Guide</a> </div> <br /> <div> <a href="installwin32.html">Virtuoso for Windows</a> </div> <div> <a href="linuxinstall.html">Virtuoso for Linux (Enterprise Edition)</a> </div> <div class="selected"> <a href="unxinstvirt.html">Virtuoso for Unix (Enterprise Edition)</a> <div> <a href="#b4instunx" title="Before You Install">Before You Install</a> <a href="#instprocunx" title="Installation Process">Installation Process</a> <a href="#unxinstvirtinstpost" title="Post Installation">Post Installation</a> <a href="#unxautovirt" title="Starting Virtuoso Automatically on Reboot">Starting Virtuoso Automatically on Reboot</a> <a href="#defpasschgunx" title="Default passwords">Default passwords</a> </div> </div> <div> <a href="unixpersonainstall.html">Virtuoso for Unix (Personal Edition)</a> </div> <div> <a href="installmacosx.html">Virtuoso for Mac OS X</a> </div> <div> <a href="installvsgrid.html">Virtuoso ADO.Net Data Grid Form Application</a> </div> <div> <a href="installvsent.html">Using Visual Studio 2008 to Build an Entity Frameworks based Windows Form Application</a> </div> <div> <a href="installusado.html">Using Visual Studio 2008 to Build an ADO.NET Data Services based Application</a> </div> <div> <a href="installwfas.html">Windows Form Application for accessing Virtuoso RDF data via SPASQL using the Virtuoso ADO.Net Provider</a> </div> <div> <a href="installcrweb.html">Creating a Web Browser Application to Access RDF Data Using The Virtuoso ADO.Net Provider</a> </div> <div> <a href="installsilver.html">Creating a Silverlight Application to consume the service</a> </div> <div> <a href="installnetriadd.html">Creating A Simple .NET RIA Services Application To Display Data From Virtuoso</a> </div> <div> <a href="installnetriavd.html">Creating a .Net RIA Services Application That Will Update Virtuoso Data</a> </div> <div> <a href="clusterstcnf.html">Cluster Installation and Config</a> </div> <br /> </div> <div id="text"> <a name="unxinstvirt" /> <h2>2.3. Virtuoso for Unix (Enterprise Edition)</h2> <a name="b4instunx" /> <h3>2.3.1. Before You Install</h3> <p>To ensure a smooth installation, please review the following checklist before you start the setup program.</p> <a name="unxdldsw" /> <h4>2.3.1.1. Have you downloaded the software?</h4> <p>If you have not already done so, please download your copy of OpenLink Virtuoso from the Virtuoso web site. The URL is <a href="http://www.openlinksw.com/virtuoso/">http://www.openlinksw.com/virtuoso/</a>. When you visit the site, select "Software Download".</p> <br /> <a name="unxreinstvirt" /> <h4>2.3.1.2. Reinstalling Virtuoso?</h4> <p>If you are reinstalling Virtuoso, you must first stop the Database Servers. You can shut these services down with the following command executed from your UNIX shell prompt:</p> <div> <pre class="programlisting">sh virtuoso-stop.sh </pre> </div> <p>or</p> <div> <pre class="programlisting">virtuoso-stop.sh</pre> </div> <p>or</p> <div> <pre class="programlisting">./virtuoso-stop.sh</pre> </div> <br /> <a name="unxfreeports" /> <h4>2.3.1.3. Are ports 1111, 1112, 8889 and 8890 free?</h4> <p>During the installation you will be prompted for an HTTP port number for use by each Virtuoso System Manager. If you are already running a web server or other listener on that port, you will encounter problems, and should choose another free port when you are prompted. </p> <p>By default, the Virtuoso DBMS listens on port 1111. If this port is currently in use by another server then after the installation completes you will need to change the port number in the Local Virtuoso ODBC or UDBC DSN that is created during the installation process, and also in the following file:</p> <div> <pre class="programlisting"> $<Installation Directory>/bin/virtuoso.ini</pre> </div> <p>typically</p> <div> <pre class="programlisting">/usr/home/virtuoso</pre> </div> <p>To check if a port is in use you can use the following command, and review the output:</p> <div> <pre class="programlisting">netstat -an | more </pre> </div> <br /> <a name="unxvirtuser" /> <h4>2.3.1.4. Do you already have a "virtuoso" user account on your UNIX system ?</h4> <p>Please create a UNIX user account called "virtuoso".</p> <br /> <a name="unxiodbcexist" /> <h4>2.3.1.5. Do you already have functional iODBC data sources on your system ?</h4> <p>The OpenLink Virtuoso for UNIX installation presumes the following:</p> <ul> <li>You intend to connect to a Local Virtuoso server using iODBC or OpenLink UDBC</li> <li>You intend to connect to one or more Remote Virtuoso servers on your network using iODBC or UDBC</li> <li>You intend to Attach tables hosted within non-local or Remote Virtuoso database servers, into a Local or Remote Virtuoso Server</li> <li>The existence of functional OpenLink or third-party iODBC drivers for UNIX that connect to the non database servers referred to above.</li> <li>In the absence of iODBC drivers for your non Virtuoso database, that a functional OpenLink or third-party UDBC Drivers exists for these database servers. </li> </ul> <p>If you are using OpenLink Multi-Tier ODBC Drivers for your remote database connections then we highly recommend the use of the Web Assistant for creating iODBC Data Source Names.</p> <br /> <a name="unxiodbcfunc" /> <h4>2.3.1.6. Are your iODBC Data Source Names functional ?</h4> <p>It is a useful sanity-check to ensure that your iODBC or UDBC data sources are functional, OpenLink provides an "odbctest" program for verifying basic usability of iODBC data sources. Both of these programs reside in the "samples" directory situated beneath the directory into which Virtuoso is installed.</p> <br /> <br /> <a name="instprocunx" /> <h3>2.3.2. Installation Process</h3> <p>Once you have downloaded the required tar file from the web or ftp site and have placed the file in a designated installation directory you are ready to commence the Virtuoso installation process. </p> <p>You may want to specify a new user to own the Virtuoso installation and then you can place the installation tar file into that users home directory.</p> <ol> <li> <p>First step is to un-tar the file to obtain the install script and archive file. Use the following command:</p> <div> <pre class="programlisting">tar xvf <tar file>.tar</pre> </div> <p>replacing <tar file> with the relevant name of the file you downloaded.</p> </li> <li> <p>run the install script using the following command:</p> <div> <pre class="programlisting">[virtuoso@myserver virtuoso]$ sh /install.sh</pre> </div> <p>The installation process will now begin and prompt you for required information.</p> </li> <li> <p>The install script will first try and detect running Virtuoso server instances. In cases where an old Virtuoso server is being upgraded you must ensure that the old Virtuoso is first shutdown. It is advisable that you backup up your systems before continuing.</p> <div> <pre class="programlisting"> Checking requested components Checking for existing installations and/or instances of Virtuoso... 7269 ? 00:06:23 virtuoso /proc/net/tcp: Permission denied ** Alert: [running processes; ] ** Warning: You have Virtuoso previously installed on this machine. ** ** To avoid existing data being overwritten or lost, you may press ^C to ** exit this installer, terminate and remove the existing installation, ** or proceed taking care to enter non-conflicting data below, by pressing ** Enter. </pre> </div> </li> <li> <p>If you are upgrading a server then the installer will save copies of old configuration data for later use.</p> <div> <pre class="programlisting"> Preserving any existing configurations... find: db: No such file or directory find: demo: No such file or directory find: bin: No such file or directory 0 blocks </pre> </div> </li> <li> <p>You should have received a license file via email. This file should be copied to the server installation directory prior to installation. The installer will ask you for its location if none is found. If you do not have the license file at this time the installer will still continue.</p> <div> <pre class="programlisting"> Checking licensing... A license file is required for the Virtuoso Server Instance(s) to start. Please enter the full path and name of a valid Virtuoso license file [./virtuoso.lic]: </pre> </div> </li> <li> <p>Now the installer will continue to install files from the package. Every file installed will be echoed to the screen. </p> <div> <pre class="programlisting"> Unpacking enterprise.tar.Z bin/ bin/v27/ bin/v27/bin/ ... ... vsp/releasenotes.css vsp/releasenotes.html vsp/vsp_auth.sql ...done </pre> </div> </li> <li> <p>When the files have been installed from the package the location supplied for the license file will be checked. If one is not found then you will receive the following warning:</p> <div> <pre class="programlisting"> ** ** WARNING: The license file entered is not valid or does not exist. ** You will need to copy a valid license file manually ** to the demo and db directories after the Virtuoso installation completes. </pre> </div> </li> <li> <p>The Virtuoso server installation has a few variations. The next question from the installer asks which one you want to make default. Even though each variation is installed, a convenient symbolic link will be made to <span class="computeroutput">bin/virtuoso</span> from the selected type. Running <span class="computeroutput">ls -l</span> in the bin directory after installation will reveal all.</p> <div> <pre class="programlisting"> Checking for installed optional components... Please choose which Virtuoso server you wish to install: 1) Universal Server 2) Universal Server with iODBC 3) Universal Server with iODBC and support for Java 4) Universal Server with iODBC and support for PHP 5) Universal Server with iODBC and support for Java and PHP 6) Universal Server with iODBC and support for CLR Hosting via Mono 7) Universal Server with iODBC and support for CLR and Java 8) Universal Server with iODBC and support for CLR, Java and PHP4 [8] : </pre> </div> </li> <li> <p>The installer will search for required third-party components depending on which option is selected in the previous step. For example, choosing the Virtuoso with Java support will require a Java runtime. Results of the search are listed as suggestions from which you can confirm or type the actual location.</p> <div> <pre class="programlisting"> Attempting to locate the java runtime library (libjvm.so)... Suggested file locations: /usr/local/lib /usr/local/jdk1.3/jre/lib/i386/classic /usr/local/jdk1.3/jre/lib/i386/server /usr/local/jdk1.3/jre/lib/i386/client /usr/opt/blackdown-jdk-1.3.1/jre/lib/i386/classic /usr/opt/blackdown-jdk-1.3.1/jre/lib/i386/server /usr/opt/blackdown-jdk-1.3.1/jre/lib/i386/client /usr/local/jdk1.3/jre/lib/i386/classic /usr/local/jdk1.3/jre/lib/i386/server /usr/local/jdk1.3/jre/lib/i386/client Please select one of the above locations or press Enter to use the default (/usr/local/jdk1.3/jre/lib/i386/client): </pre> </div> </li> <li> <p>The Virtuoso installer includes a Mono runtime distribution, since Mono is a developing platform you may have your own installation that you can supply the path to here.</p> <div> <pre class="programlisting"> Please enter the full path to the Mono installation directory or Enter to use the default (/home/openlink/virtuoso/mono) </pre> </div> </li> <li> <p>Virtuoso now has enough information to configure its environment and startup scripts.</p> <div> <pre class="programlisting"> Setting up initial values in scripts and config files Setting up file bin/odbc.ini Setting up file bin/odbcinst.ini Setting up file bin/demo-start.sh Setting up file bin/demo-stop.sh Setting up file bin/virtuoso-start.sh Setting up file bin/virtuoso-stop.sh Setting up file db/virtuoso.ini Setting up file demo/demo.ini Setting up file mono/bin/mcs Setting up file virtuoso-enterprise.csh Setting up file virtuoso-enterprise.sh Setting up file initd_startup.template Setting up file initd_startup_demo.template </pre> </div> </li> <li> <p>The installer will now ask a series of questions for configuring the Virtuoso .INI files. First confirm or alter the default database SQL listener port number. This is the port number that this database will be available for ODBC connections and iSQL sessions.</p> <div> <pre class="programlisting"> Configuring port numbers for default and demo databases Please enter a port on which to run the default database SQL listener (default 1111): </pre> </div> </li> <li> <p>Now you must specify the port number of the default database HTTP listener. This is the HTTP port that Virtuoso will listen on by default, you web-based administration interface for Virtuoso will be found here. If you confirm the default of 8889, then your Virtuoso will be available from: <span class="computeroutput">http://server:8889/</span>, changing server to the name of your machine appropriately.</p> <div> <pre class="programlisting"> Please enter a port on which to run the default database HTTP listener (default 8889): </pre> </div> </li> <li> <p>Now you must supply a friendly name that you wish to identify your Virtuoso server by on the network using Zero Configuration. </p> <div class="tip"> <div class="tiptitle">See Also:</div> <p>The <a href="databaseadmsrv.html#rendezvous">Zero Configuration</a> section.</p> </div> <div> <pre class="programlisting"> Please enter a name for default database Zero Configuration (default "Virtuoso Universal Server at myserver:1111"): </pre> </div> </li> <li> <p>The Zero Configuration details need a default username to make the connection with.</p> <div> <pre class="programlisting"> Please enter a user name for default database Zero Configuration (default "dba"): </pre> </div> </li> <li> <p>Now we have all of the above details to supply again for the Demo Virtuoso database. The port number supplied here must be different to those supplied previously.</p> <div> <pre class="programlisting"> Please enter a port on which to run the demo database SQL listener (default 1112): Please enter a port on which to run the demo database HTTP listener (default 8890): Please enter a name for demonstration database Zero Configuration (default Virtuoso Universal Server (demonstration) at myserver:1112): Please enter a user name for demonstration database Zero Configuration (default demo): </pre> </div> </li> <li> <p>The Virtuoso servers have default administrator usernames of "dba". The "dba" accounts have the default password of "dba". It is recommended that you alter this as soon as possibly for security. The installer now provides the opportunity to do this the first time the server is started.</p> <div> <pre class="programlisting"> Changing passwords for the Database Universal Server Please enter a replacement for the Default Database Server's SQL Administrative (dba) account password (twice) : Confirm Password : </pre> </div> </li> <li> <p>The Virtuoso servers have default WebDAV administrator usernames of "dav". The "dav" accounts have the default password of "dav". It is recommended that you alter this as soon as possibly for security. The installer now provides the opportunity to do this the first time the server is started.</p> <div> <pre class="programlisting"> Please enter a replacement for the Default Database's WebDAV administrative (dav) account password (twice) : Confirm Password : Please wait while the passwords are changed: Changing passwords for the Demo Universal Server </pre> </div> </li> <li> <p>Likewise for the Demo server, you can change the default passwords:</p> <div> <pre class="programlisting"> Please enter a replacement for the Demonstration Database Server's SQL Administrative (dba) account password (twice) : Confirm Password : Please enter a replacement for the Demonstration Database Server's WebDAV Administrative (dav) account password (twice) : Confirm Password : Please wait while the passwords are changed: done. </pre> </div> </li> <li> <p>The file owner and group is changed at the end of the installation. You can choose what these shall be set to. By default the current user is selected.</p> <div> <pre class="programlisting"> Please enter the username:group for the user and group who should own files in this installation (default: openlink:openlink) : Setting owners: </pre> </div> </li> <li> <p>Finally the installer can start Virtuoso servers installed for you, but only if a valid license key has been supplied.</p> <div> <pre class="programlisting"> The Virtuoso Installer has not offered to start a database as no license key was found. Evaluation users should receive one via e-mail; in case of difficulties please contact <Technical.Support@openlinksw.com>. </pre> </div> </li> </ol> <br /> <a name="unxinstvirtinstpost" /> <h3>2.3.3. Post Installation</h3> <a name="unxinstvirtpost" /> <h4>2.3.3.1. Post-Installation Sanity Check</h4> <p>A quick way to check that the database is running, is to point a browser to the http port. The following example URLs will show the System Manager for the default, and the demo Virtuoso databases:</p> <div> <pre class="programlisting">http://localhost:8889 http://localhost:8890 http://a_virtuoso_server.org:8890</pre> </div> <br /> <a name="unxinstvirtinstposttrb" /> <h4>2.3.3.2. Troubleshooting DB Startup Failures</h4> <p> <strong>Install failure</strong> </p> <p>Check the .log file in:</p> <div> <pre class="programlisting"> $<Directory where Virtuoso is installed>/bin/virtuoso.log </pre> </div> <p>in order to review the installed files binaries and databases (defaults) for issues if install fails.</p> <p> <strong>.lck existance</strong> </p> <p>Check .log in case of .lck issue</p> <p>Delete the .lck file and repeat the steps from above.</p> <p> <strong>.trx incompatiblity issue</strong> </p> <p>Check .log in case of .trx incompatiblity issue</p> <br /> <br /> <a name="unxautovirt" /> <h3>2.3.4. Starting Virtuoso Automatically on Reboot</h3> <p>Two files, named initd_startup.template and initd_startup_demo.template, are placed in the top level of the Virtuoso installation directory. On systems using SysVinit (most Linux distributions, Solaris) the appropriate one should be copied into /etc/init.d/ and symlinks created in the rcN.d/ directories, e.g.:</p> <div> <pre class="programlisting"> bash# cp initd_startup.template /etc/init.d/virtuoso </pre> </div> <p>Perform some sanity checks here, that the directory it uses exists, etc:</p> <div> <pre class="programlisting"> bash# vi /etc/init.d/virtuoso </pre> </div> <p>Test that it works correctly:</p> <div> <pre class="programlisting"> bash# /etc/init.d/virtuoso stop bash# /etc/init.d/virtuoso start </pre> </div> <p>Finally, create symbolic links in the regular runlevel directories pointing to that script:</p> <div> <pre class="programlisting"> bash# cd /etc/rc2.d ; ln -s ../init.d/virtuoso S99virtuoso bash# cd /etc/rc3.d ; ln -s ../init.d/virtuoso S99virtuoso bash# cd /etc/rc5.d ; ln -s ../init.d/virtuoso S99virtuoso </pre> </div> <p>Virtuoso should now start when the service is restarted.</p> <br /> <a name="defpasschgunx" /> <h3>2.3.5. Default passwords</h3> <p>See the following Quick Start chapter for very important information about <a href="newadminui.html#defpasschange">changing the default passwords</a>.</p> <br /> <table border="0" width="90%" id="navbarbottom"> <tr> <td align="left" width="33%"> <a href="linuxinstall.html" title="Virtuoso for Linux (Enterprise Edition)">Previous</a> <br />Virtuoso for Linux (Enterprise Edition)</td> <td align="center" width="34%"> <a href="installation.html">Chapter Contents</a> </td> <td align="right" width="33%"> <a href="unixpersonainstall.html" title="Virtuoso for Unix (Personal Edition)">Next</a> <br />Virtuoso for Unix (Personal Edition)</td> </tr> </table> </div> <div id="footer"> <div>Copyright© 1999 - 2009 OpenLink Software All rights reserved.</div> <div id="validation"> <a href="http://validator.w3.org/check/referer"> <img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" /> </a> <a href="http://jigsaw.w3.org/css-validator/"> <img src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!" height="31" width="88" /> </a> </div> </div> </body> </html>