www.openlinksw.com
docs.openlinksw.com

Book Home

Contents
Preface

Installation Guide

Virtuoso for Windows
Virtuoso for Linux (Enterprise Edition)
Virtuoso for Unix (Enterprise Edition)
Virtuoso for Unix (Personal Edition)
Virtuoso for Mac OS X
Before You Install Installation Process Configuration Post Installation Configuring an ODBC Data Source Testing an ODBC Data Source Default passwords Demo Database
Virtuoso ADO.Net Data Grid Form Application
Using Visual Studio 2008 to Build an Entity Frameworks based Windows Form Application
Using Visual Studio 2008 to Build an ADO.NET Data Services based Application
Windows Form Application for accessing Virtuoso RDF data via SPASQL using the Virtuoso ADO.Net Provider
Creating a Web Browser Application to Access RDF Data Using The Virtuoso ADO.Net Provider
Creating a Silverlight Application to consume the service
Creating A Simple .NET RIA Services Application To Display Data From Virtuoso
Creating a .Net RIA Services Application That Will Update Virtuoso Data
Cluster Installation and Config

2.5. Virtuoso for Mac OS X

2.5.1. Before You Install

Before installing the Virtuoso software for Mac OS X you must ensure that you have the correct package from the OpenLink Web Site.


2.5.2. Installation Process

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.

Mounting the Disk Image
Figure: 2.5.2.1. Mounting the Disk Image

The installer will load the Introduction page.

Installer Introduction Page
Figure: 2.5.2.2. Installer Introduction Page

Review the Readme page for any important information concerning the product installation.

Important Information
Figure: 2.5.2.3. Important Information

Read the license agreement and "agree" to the terms.

Software License Agreement
Figure: 2.5.2.4. Software License Agreement

Select the Destination volume the software is to be installed on.

Select Destination
Figure: 2.5.2.5. Select Destination

Choose to perform and Easy(default) installation or click on the "customize" button to perform a Custom installation.

Selecting the Type of Installation
Figure: 2.5.2.6. Selecting the Type of Installation

If the "Custom" option was selected in the previous step then select the packages to be installed.

Customizing the Installation
Figure: 2.5.2.7. Customizing the Installation

The software must be install by a user with Administrative privileges on the machine.

Identifying yourself as Administrator
Figure: 2.5.2.8. Identifying yourself as Administrator

The software components will be installed the status of which is indicated by the progress bar.

Preparing ...
Figure: 2.5.2.9. Preparing ...

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.

Admin Assistant
Figure: 2.5.2.10. Admin Assistant

Choose to obtain a Trial license for an evaluation or enter the shop site to purchase a full license.

The Trial license page
Figure: 2.5.2.11. The Trial license page

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.

Download license
Figure: 2.5.2.12. Download license

Choose to change the "dba" and "dav" administrative user passwords from their default of "dba" and "dav" respectively to a value of your choice.

Change passwords
Figure: 2.5.2.13. Change passwords

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.

Welcome
Figure: 2.5.2.14. Welcome

The Installation is now complete.

Installation complete
Figure: 2.5.2.15. Installation complete

2.5.3. Configuration

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.

Configuration
Figure: 2.5.3.1. Configuration

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.

Various features using Conductor Tabs
Figure: 2.5.3.2. Various features using Conductor Tabs

Apple scripts for starting and stopping your Virtuoso Universal Server installation are located in the "/Application/OpenLink Virtuoso" folder of the machine.

Location of apple scripts
Figure: 2.5.3.3. Location of apple scripts

2.5.4. Post Installation

2.5.4.1. Post-Installation Sanity Check

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:

http://localhost:8889
http://localhost:8890
http://a_virtuoso_server.org:8890

2.5.4.2. Troubleshooting DB Startup Failures

Install failure

Check the .log files for the database etc. in order to review the installed files binaries and databases (defaults) for issues if install fails.

The .log file
Figure: 2.5.4.2.1. The .log file

.lck existance

Check .log in case of .lck issue

Delete the .lck file and repeat the steps from above.

.trx incompatiblity issue

Check .log in case of .trx incompatiblity issue

The .log file
Figure: 2.5.4.2.2. The .log file


2.5.5. Configuring an ODBC Data Source

Launch the iODBC Administrator, assuming that you have the iODBC Administrator installed.

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.

Once the iODBC Administrator window has appeared you can press the Add button on the either the User DSN or the System DSN panel to add a new Data Source entry.

ODBC Administrator
Figure: 2.5.5.1. ODBC Administrator

Choose the driver that you wish to create a Data Source for, in this case the Virtuoso Driver (3.0).

ODBC Administrator - Choose Virtuoso Driver
Figure: 2.5.5.2. ODBC Administrator - Choose Virtuoso Driver

Provide all required details in the fields provided by the setup panel.

ODBC Administrator - Configure Virtuoso DSN
Figure: 2.5.5.3. ODBC Administrator - Configure Virtuoso DSN

The server can be picked from the list of Zero Configuration Datasources that is discovered.

Pick Zero Config
Figure: 2.5.5.4. Pick Zero Config

Alternatively a manual selection can be made for the server.

Pick manual mode
Figure: 2.5.5.5. Pick manual mode

In this case enter the hostname (or IP) and port number.

Manual Server Entry
Figure: 2.5.5.6. Manual Server Entry
ODBC Administrator - Configure Virtuoso DSN
Figure: 2.5.5.7. ODBC Administrator - Configure Virtuoso DSN
ODBC Administrator - Configure Virtuoso DSN
Figure: 2.5.5.8. ODBC Administrator - Configure Virtuoso DSN

Press the Finish button to save the Data Source information.


2.5.6. Testing an ODBC Data Source

Select the Data Source from the DSN list, and press the Test button.

You will be prompted for a username and password to establish a connection with the Data Source.

Login - Identity Tab
Figure: 2.5.6.1. Login - Identity Tab

The login dialogue also allows you to alter the configuration if required.

Under the Connection Tab are the fields for the remote server, and the authentication method. Typically the defaults are used.

Login - Connection Tab
Figure: 2.5.6.2. Login - Connection Tab

The Options page has Database, Charset and daylight savings configuration. Typically the defaults are used.

Login - Options Tab
Figure: 2.5.6.3. Login - Options Tab

The About page shows the software details.

Login - About
Figure: 2.5.6.4. Login - About

The result of the test is shown in a popup window.

Test Result
Figure: 2.5.6.5. Test Result

2.5.7. Default passwords

See the following Quick Start chapter for very important information about changing the default passwords.


2.5.8. Demo Database

Installation steps.