www.openlinksw.com
docs.openlinksw.com

Book Home

Contents
Preface

Installation Guide

Virtuoso for Windows 95/98/NT/2000/XP
Virtuoso for Linux
Virtuoso for Unix
Virtuoso for Mac OS X
Existing Virtuoso 2.7 Users Before You Install Installation Process Configuration Configuring an ODBC Data Source Testing an ODBC Data Source Post-Installation Sanity Check Default passwords

2.4. Virtuoso for Mac OS X

2.4.1. Existing Virtuoso 2.7 Users

You can migrate your existing Virtuoso servers to 3.0 using the migration utility. The Virtuoso database file structure has been considerably altered between versions. Please consult the Migration of Virtuoso from Version 2.7 to Version 3.0 section for more details.


2.4.2. 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.4.3. 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.

Figure: 2.4.3.1. Mounting the Disk Image
Mounting the Disk Image

The installer will load the Introduction page.

Figure: 2.4.3.2. Installer Introduction Page
Installer Introduction Page

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

Figure: 2.4.3.3. Important Information
Important Information

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

Figure: 2.4.3.4. Software License Agreement
Software License Agreement

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

Figure: 2.4.3.5. Select Destination
Select Destination

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

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

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

Figure: 2.4.3.7. Customizing the Installation
Customizing the Installation

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

Figure: 2.4.3.8. Identifying yourself as Administrator
Identifying yourself as Administrator

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

Figure: 2.4.3.9. Preparing ...
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.

Figure: 2.4.3.10. Admin Assistant
Admin Assistant

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

Figure: 2.4.3.11. The Trial license page
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.

Figure: 2.4.3.12. Download license
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.

Figure: 2.4.3.13. Change passwords
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.

Figure: 2.4.3.14. Welcome
Welcome

The Installation is now complete.

Figure: 2.4.3.15. Installation complete
Installation complete

2.4.4. 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.

Figure: 2.4.4.1. Configuration
Configuration

Once logged into the Condictor click on any of the "Tabs" along the top to Administer the various features ofthe Virtuoso Universal Server installation.

Figure: 2.4.4.2. Various features using Condcutor Tabs
Various features using Condcutor Tabs

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

Figure: 2.4.4.3. Location of apple scripts
Location of apple scripts

2.4.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.

Figure: 2.4.5.1. ODBC Administrator
ODBC Administrator

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

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

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

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

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

Figure: 2.4.5.4. Pick Zero Config
Pick Zero Config

Alternatively a manual selection can be made for the server.

Figure: 2.4.5.5. Pick manual mode
Pick manual mode

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

Figure: 2.4.5.6. Manual Server Entry
Manual Server Entry
Figure: 2.4.5.7. ODBC Administrator - Configure Virtuoso DSN
ODBC Administrator - Configure Virtuoso DSN
Figure: 2.4.5.8. ODBC Administrator - Configure Virtuoso DSN
ODBC Administrator - Configure Virtuoso DSN

Press the Finish button to save the Data Source information.


2.4.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.

Figure: 2.4.6.1. Login - Identity Tab
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.

Figure: 2.4.6.2. Login - Connection Tab
Login - Connection Tab

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

Figure: 2.4.6.3. Login - Options Tab
Login - Options Tab

The About page shows the software details.

Figure: 2.4.6.4. Login - About
Login - About

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

Figure: 2.4.6.5. Test Result
Test Result

2.4.7. 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

See the following Quick Start chapter for further ways to verify the database.


2.4.8. Default passwords

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