<!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="unixpersonainstall.html" title="Virtuoso for Unix (Personal Edition)" /> <link rel="next" href="installvsgrid.html" title="Virtuoso ADO.Net Data Grid Form Application" /> <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="installmacosx" /> <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="unixpersonainstall.html" title="Virtuoso for Unix (Personal Edition)">Prev</a> | <a class="link" href="installvsgrid.html" title="Virtuoso ADO.Net Data Grid Form Application">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> <a href="unixpersonainstall.html">Virtuoso for Unix (Personal Edition)</a> </div> <div class="selected"> <a href="installmacosx.html">Virtuoso for Mac OS X</a> <div> <a href="#macosxbeforeuinst" title="Before You Install">Before You Install</a> <a href="#macosxinst" title="Installation Process">Installation Process</a> <a href="#macosxconfigur" title="Configuration">Configuration</a> <a href="#macosxinstpost" title="Post Installation">Post Installation</a> <a href="#macosxodbcdsnconf" title="Configuring an ODBC Data Source">Configuring an ODBC Data Source</a> <a href="#macosxodbcdsntest" title="Testing an ODBC Data Source">Testing an ODBC Data Source</a> <a href="#defpasschgmac" title="Default passwords">Default passwords</a> <a href="#installdemomac" title="Demo Database">Demo Database</a> </div> </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="installmacosx" /> <h2>2.5. Virtuoso for Mac OS X</h2> <a name="macosxbeforeuinst" /> <h3>2.5.1. Before You Install</h3> <p>Before installing the Virtuoso software for Mac OS X you must ensure that you have the correct package from the <a href="http://www.openlinksw.com/">OpenLink</a> Web Site.</p> <br /> <a name="macosxinst" /> <h3>2.5.2. Installation Process</h3> <p>Open the Virtuoso Personal Edition Disk Image file ntvpz2zz.dmg by either double clicking on the DMG file in the Finder windows or using the "open" command from a Terminal window, to mount the Disk Image containing the VirtuosoPersonalEdition.mpkg installer. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Mounting the Disk Image" src="../images/mac/v50pe00.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.1. Mounting the Disk Image</td> </tr> </table> <p>The installer will load the Introduction page. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Installer Introduction Page" src="../images/mac/v50pe01.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.2. Installer Introduction Page</td> </tr> </table> <p>Review the Readme page for any important information concerning the product installation. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Important Information" src="../images/mac/v50pe02.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.3. Important Information</td> </tr> </table> <p>Read the license agreement and "agree" to the terms. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Software License Agreement" src="../images/mac/v50pe03.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.4. Software License Agreement</td> </tr> </table> <p>Select the Destination volume the software is to be installed on. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Select Destination" src="../images/mac/v50pe04.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.5. Select Destination</td> </tr> </table> <p>Choose to perform and Easy(default) installation or click on the "customize" button to perform a Custom installation. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Selecting the Type of Installation" src="../images/mac/v50pe05.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.6. Selecting the Type of Installation</td> </tr> </table> <p>If the "Custom" option was selected in the previous step then select the packages to be installed. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Customizing the Installation" src="../images/mac/v50pe06.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.7. Customizing the Installation</td> </tr> </table> <p>The software must be install by a user with Administrative privileges on the machine. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Identifying yourself as Administrator" src="../images/mac/v50pe07.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.8. Identifying yourself as Administrator</td> </tr> </table> <p>The software components will be installed the status of which is indicated by the progress bar. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Preparing ... " src="../images/mac/v50pe08.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.9. Preparing ... </td> </tr> </table> <p>The Virtuoso Server is started at the end of this process and a Web page loaded enabling you to obtain a trial or full license from the company order processing site online. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Admin Assistant" src="../images/mac/v50pe09.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.10. Admin Assistant</td> </tr> </table> <p>Choose to obtain a Trial license for an evaluation or enter the shop site to purchase a full license. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="The Trial license page" src="../images/mac/v50pe10.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.11. The Trial license page</td> </tr> </table> <p>Click on the "Download License" button on the right to obtain the license file immediately. An e-mail will also be sent with details of the license and the location on the ODS account of the registered user where in can be obtained from at a later date. Once a license file is available on the machine use the "Browse" button to locate it and the "Set License" button to initialize the Virtuoso server with this license file. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Download license" src="../images/mac/v50pe11.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.12. Download license</td> </tr> </table> <p>Choose to change the "dba" and "dav" administrative user passwords from their default of "dba" and "dav" respectively to a value of your choice. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Change passwords" src="../images/mac/v50pe12.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.13. Change passwords</td> </tr> </table> <p>The Virtuoso Server Welcome page will now be displayed indicating the server is online. This Web based page can be used for general configuration and usage of the Virtuoso Server. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Welcome" src="../images/mac/v50pe13.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.14. Welcome</td> </tr> </table> <p>The Installation is now complete. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Installation complete" src="../images/mac/v50pe14.png" /> </td> </tr> <tr> <td>Figure: 2.5.2.15. Installation complete</td> </tr> </table> <br /> <a name="macosxconfigur" /> <h3>2.5.3. Configuration</h3> <p>Click on the "Conductor" link in the left frame of the Welcome page to load the Virtuoso Conductor which is the Administration interface for the installation. Enter the "dba" username and password to login. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Configuration" src="../images/mac/v50pe15.png" /> </td> </tr> <tr> <td>Figure: 2.5.3.1. Configuration</td> </tr> </table> <p>Once logged into the conductor click on any of the "Tabs" along the top to Administer the various features of the Virtuoso Universal Server installation. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Various features using Conductor Tabs" src="../images/mac/v50pe16.png" /> </td> </tr> <tr> <td>Figure: 2.5.3.2. Various features using Conductor Tabs</td> </tr> </table> <p>Apple scripts for starting and stopping your Virtuoso Universal Server installation are located in the "/Application/OpenLink Virtuoso" folder of the machine. </p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Location of apple scripts" src="../images/mac/v50pe17.png" /> </td> </tr> <tr> <td>Figure: 2.5.3.3. Location of apple scripts</td> </tr> </table> <br /> <a name="macosxinstpost" /> <h3>2.5.4. Post Installation</h3> <a name="macosxinstpostsan" /> <h4>2.5.4.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="macosxinstposttrb" /> <h4>2.5.4.2. Troubleshooting DB Startup Failures</h4> <p> <strong>Install failure</strong> </p> <p>Check the .log files for the database etc. in order to review the installed files binaries and databases (defaults) for issues if install fails.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="The .log file" src="../images/ui/instmac.png" /> </td> </tr> <tr> <td>Figure: 2.5.4.2.1. The .log file</td> </tr> </table> <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> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="The .log file" src="../images/ui/instmac2.png" /> </td> </tr> <tr> <td>Figure: 2.5.4.2.2. The .log file</td> </tr> </table> <br /> <br /> <a name="macosxodbcdsnconf" /> <h3>2.5.5. Configuring an ODBC Data Source</h3> <p>Launch the iODBC Administrator, assuming that you have the iODBC Administrator installed.</p> <p>On some Mac OS X systems installed on an HFS partition, the icons may not be displayed correctly or at all, due to a Mac OS X bug. In such cases a simple reboot of your system should correct this.</p> <p>Once the iODBC Administrator window has appeared you can press the <strong>Add</strong> button on the either the <strong>User DSN</strong> or the <strong>System DSN</strong> panel to add a new Data Source entry.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="ODBC Administrator" src="../images/mac/config01.jpg" /> </td> </tr> <tr> <td>Figure: 2.5.5.1. ODBC Administrator</td> </tr> </table> <p>Choose the driver that you wish to create a Data Source for, in this case the Virtuoso Driver (3.0).</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="ODBC Administrator - Choose Virtuoso Driver" src="../images/mac/config03.jpg" /> </td> </tr> <tr> <td>Figure: 2.5.5.2. ODBC Administrator - Choose Virtuoso Driver</td> </tr> </table> <p>Provide all required details in the fields provided by the setup panel.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="ODBC Administrator - Configure Virtuoso DSN" src="../images/mac/config04.jpg" /> </td> </tr> <tr> <td>Figure: 2.5.5.3. ODBC Administrator - Configure Virtuoso DSN</td> </tr> </table> <p>The server can be picked from the list of Zero Configuration Datasources that is discovered.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Pick Zero Config" src="../images/mac/osximage23.gif" /> </td> </tr> <tr> <td>Figure: 2.5.5.4. Pick Zero Config</td> </tr> </table> <p>Alternatively a manual selection can be made for the server.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Pick manual mode" src="../images/mac/osximage25.gif" /> </td> </tr> <tr> <td>Figure: 2.5.5.5. Pick manual mode</td> </tr> </table> <p>In this case enter the hostname (or IP) and port number.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Manual Server Entry" src="../images/mac/osximage34.gif" /> </td> </tr> <tr> <td>Figure: 2.5.5.6. Manual Server Entry</td> </tr> </table> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="ODBC Administrator - Configure Virtuoso DSN" src="../images/mac/config05.jpg" /> </td> </tr> <tr> <td>Figure: 2.5.5.7. ODBC Administrator - Configure Virtuoso DSN</td> </tr> </table> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="ODBC Administrator - Configure Virtuoso DSN" src="../images/mac/config06.jpg" /> </td> </tr> <tr> <td>Figure: 2.5.5.8. ODBC Administrator - Configure Virtuoso DSN</td> </tr> </table> <p>Press the <strong>Finish</strong> button to save the Data Source information.</p> <br /> <a name="macosxodbcdsntest" /> <h3>2.5.6. Testing an ODBC Data Source</h3> <p>Select the Data Source from the DSN list, and press the <strong>Test</strong> button.</p> <p>You will be prompted for a username and password to establish a connection with the Data Source.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Login - Identity Tab" src="../images/mac/config07.jpg" /> </td> </tr> <tr> <td>Figure: 2.5.6.1. Login - Identity Tab</td> </tr> </table> <p>The login dialogue also allows you to alter the configuration if required.</p> <p>Under the Connection Tab are the fields for the remote server, and the authentication method. Typically the defaults are used.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Login - Connection Tab" src="../images/mac/osximage30.gif" /> </td> </tr> <tr> <td>Figure: 2.5.6.2. Login - Connection Tab</td> </tr> </table> <p>The Options page has Database, Charset and daylight savings configuration. Typically the defaults are used.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Login - Options Tab" src="../images/mac/osximage31.gif" /> </td> </tr> <tr> <td>Figure: 2.5.6.3. Login - Options Tab</td> </tr> </table> <p>The About page shows the software details.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Login - About" src="../images/mac/osximage32.gif" /> </td> </tr> <tr> <td>Figure: 2.5.6.4. Login - About</td> </tr> </table> <p>The result of the test is shown in a popup window.</p> <table class="figure" border="0" cellpadding="0" cellspacing="0"> <tr> <td> <img alt="Test Result" src="../images/mac/osximage33.gif" /> </td> </tr> <tr> <td>Figure: 2.5.6.5. Test Result</td> </tr> </table> <br /> <a name="defpasschgmac" /> <h3>2.5.7. 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 /> <a name="installdemomac" /> <h3>2.5.8. 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="unixpersonainstall.html" title="Virtuoso for Unix (Personal Edition)">Previous</a> <br />Virtuoso for Unix (Personal Edition)</td> <td align="center" width="34%"> <a href="installation.html">Chapter Contents</a> </td> <td align="right" width="33%"> <a href="installvsgrid.html" title="Virtuoso ADO.Net Data Grid Form Application">Next</a> <br />Virtuoso ADO.Net Data Grid Form Application</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>