<!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="unxinstvirt.html" title="Virtuoso for Unix (Enterprise Edition)" />
<link rel="next" href="installmacosx.html" title="Virtuoso for Mac OS X" />
<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="unixpersonainstall" />
<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="unxinstvirt.html" title="Virtuoso for Unix (Enterprise Edition)">Prev</a> | <a class="link" href="installmacosx.html" title="Virtuoso for Mac OS X">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>
<a href="unxinstvirt.html">Virtuoso for Unix (Enterprise Edition)</a>
</div>
<div class="selected">
<a href="unixpersonainstall.html">Virtuoso for Unix (Personal Edition)</a>
<div>
<a href="#unixpersonainstalldescr" title="Installation">Installation</a>
<a href="#unixpersonainstallinstpost" title="Post Installation">Post Installation</a>
<a href="#unixpersonainstallconfg" title="Configuration">Configuration</a>
<a href="#installdemopersonaledition" title="Demo Database">Demo Database</a>
</div>
</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="unixpersonainstall" />
<h2>2.4. Virtuoso for Unix (Personal Edition)</h2>
<a name="unixpersonainstalldescr" />
<h3>2.4.1. Installation</h3>
<p>Once the required tar file has been downloaded from the web or ftp site and
placed in a designated installation directory the installation process is ready to
commence. Choose or create a suitable user account to own your Virtuoso installation.
</p>
<ul>
<li>The first step is to un-tar the file to obtain the install script and
archive file. Use the following command, replacing with the relevant name of the file
you downloaded:
</li>
<div>
<pre class="programlisting">
tar xvf <tar file>.tar
</pre>
</div>
<li>
If a license file exists place this in the same directory as installation files and it
will be used during installation.
</li>
<li>
If upgrading an existing Virtuoso instance ensure it is shutdown first and a backup of
your database file is made, then run the install script using the following command:
</li>
<div>
<pre class="programlisting">
$ sh ./install.sh
- Extracting Virtuoso Personal Edition v5.0
- Creating default environment settings
- Creating default database settings
Installing new virtuoso.ini in $VIRTUOSO_HOME/database
Installing new php.ini in $VIRTUOSO_HOME/database
Creating symlink to $VIRTUOSO_HOME/bin/virtuoso-iodbc-t
- Registering ODBC drivers
- Registering .NET provider for Mono
- Installing VAD packages in database (this can take some time)
- Checking where license should be stored
- Starting OpenLink License Manager
- Checking for initial Virtuoso license
- Starting Virtuoso server instance
- Finalizing installation
This concludes the first part of the installation.
Please start a browser manually and open the following URL to finalize
the installation process:
http://<hostname>:8890/install/
Installation completed
$
</pre>
</div>
</ul>
<br />
<a name="unixpersonainstallinstpost" />
<h3>2.4.2. Post Installation</h3>
<a name="unixpersonainstallpost" />
<h4>2.4.2.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="unixpersonainstallinstposttrb" />
<h4>2.4.2.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="unixpersonainstallconfg" />
<h3>2.4.3. Configuration</h3>
<ul>
<li>Once the URL above has been loaded a browser the first page can be
used to select a license file for use with the installation if one is not already
in place, otherwise the task can be skipped using the button provided:
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="License file" src="../images/inst/v50-pe-unx-00.png" />
</td>
</tr>
<tr>
<td>Figure: 2.4.3.1. License file</td>
</tr>
</table>
</li>
<li>
It is strongly advised that the standard "dba" and "dav" user account password be
changed using the post installation page provided:
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="DAV/DBA authentication Setting page" src="../images/inst/v50-pe-unx-01.png" />
</td>
</tr>
<tr>
<td>Figure: 2.4.3.1. DAV/DBA authentication Setting page</td>
</tr>
</table>
</li>
<li>The post installation page is now complete and the Virtuoso Welcome
page is presented:
<table class="figure" border="0" cellpadding="0" cellspacing="0">
<tr>
<td>
<img alt="Post installation page" src="../images/inst/v50-pe-unx-02.png" />
</td>
</tr>
<tr>
<td>Figure: 2.4.3.1. Post installation page</td>
</tr>
</table>
</li>
</ul>
<p>The installation is now ready for use.</p>
<br />
<a name="installdemopersonaledition" />
<h3>2.4.4. Demo Database</h3>
<p>
<a href="htmlconductorbar.html#demodbinstallsteps">Installation steps</a>.</p>
<br />
<table border="0" width="90%" id="navbarbottom">
<tr>
<td align="left" width="33%">
<a href="unxinstvirt.html" title="Virtuoso for Unix (Enterprise Edition)">Previous</a>
<br />Virtuoso for Unix (Enterprise Edition)</td>
<td align="center" width="34%">
<a href="installation.html">Chapter Contents</a>
</td>
<td align="right" width="33%">
<a href="installmacosx.html" title="Virtuoso for Mac OS X">Next</a>
<br />Virtuoso for Mac OS X</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>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
71d40963b505df4524269198e237b3e3
>
files
>
906
