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

The following packages are available for download, with their respective disk image filenames:

The Enterprise Edition of Virtuoso using the systems native threading architecture to provide a truly scalable solution for supporting potentially large systems whereas the Lite version uses a customized library developed by OpenLink for good performance on smaller systems. For most evaluation purposes there will not be that much difference.

You will need an ODBC Driver Manager to make use of ODBC Data sources. You can download the iODBC Driver Manager from the iODBC Web Site

The Virtuoso server once installed will attempt to bind to the TCP/IP ports 1111, 1112, 8889, and 8890 by default, so you will have to determine whether these are already in use by other services or you will need to change the default settings during the installation process.


2.4.3. Installation Process

Once the image file has been downloaded and saved to a convenient location you will have to mount the disk image by double-clicking on the file. Once mounted you will need to launch the installer program, which will be one of the following depending on the image downloaded:

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

In order for the system to allow you to install a new package you are required to be identified as an administrator. To do this you have to click the lock icon at the bottom of the Installer dialog box.

Figure: 2.4.3.2. Identifying yourself as Administrator
Identifying yourself as Administrator

Once your authentication is accepted, you will be presented with the Installer introduction page.

Figure: 2.4.3.3. Installer Introduction Page
Installer Introduction Page

Please read the Important Information.

Figure: 2.4.3.4. Important Information
Important Information

Please read the Software License Agreement.

Figure: 2.4.3.5. Software License Agreement
Software License Agreement

You must agree to the terms of the license in order to install.

Figure: 2.4.3.6. Confirm Acceptance
Confirm Acceptance

Continue with the installation by choosing Select Destination and choose the destination drive where you wish to install the OpenLink Virtuoso product.

Figure: 2.4.3.7. Select Destination
Select Destination

You can choose the Installation Type to be either Easy Install, taking the defaults, or Customize your installation to your needs. The following screens assume a custom Install. Click on Customize to proceed.

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

Chose the packages you wish to install.

Figure: 2.4.3.9. Customizing the Installation
Customizing the Installation

Installer prepares for file transfer.

Figure: 2.4.3.10. Preparing files
Preparing files

During the installation you will need to enter your passphrase.

Figure: 2.4.3.11. Enter Passphrase
Enter Passphrase

The installer will continue installing files

Figure: 2.4.3.12. Installing...
Installing...

Select the database to startup at the end of the install.

Figure: 2.4.3.13. Starup choice
Starup choice

A license file is required to use the server. During the download process, a license file is emailed to you.

Figure: 2.4.3.14. License intro
License intro

Choose folder for license file.

Figure: 2.4.3.15. Choose license folder
Choose license folder

Choose license file.

Figure: 2.4.3.16. Choose license folder
Choose license folder

You now have to configure the Virtuoso.

Figure: 2.4.3.17. Main Server
Main Server
Figure: 2.4.3.18. Demo Server
Demo Server
Figure: 2.4.3.19. Account Password
Account Password
Figure: 2.4.3.20. Zero Config
Zero Config
Figure: 2.4.3.21. Server Tab
Server Tab

The installation is now complete.

Figure: 2.4.3.22. Success
Success

If a server was instructed to start at the end of the install, then the web browser is shown on the Administration page for the server.

Figure: 2.4.3.23. Admin Assistant
Admin Assistant

Once the installation has finished it is safe to unmount the disk image directory by dragging and dropping the directory in the trash icon of the dock.


2.4.4. 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.4.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.4.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.4.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.4.4. Pick Zero Config
Pick Zero Config

Alternatively a manual selection can be made for the server.

Figure: 2.4.4.5. Pick manual mode
Pick manual mode

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

Figure: 2.4.4.6. Manual Server Entry
Manual Server Entry
Figure: 2.4.4.7. ODBC Administrator - Configure Virtuoso DSN
ODBC Administrator - Configure Virtuoso DSN
Figure: 2.4.4.8. ODBC Administrator - Configure Virtuoso DSN
ODBC Administrator - Configure Virtuoso DSN

Press the Finish button to save the Data Source information.


2.4.5. 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.5.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.5.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.5.3. Login - Options Tab
Login - Options Tab

The About page shows the software details.

Figure: 2.4.5.4. Login - About
Login - About

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

Figure: 2.4.5.5. Test Result
Test Result

2.4.6. 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.7. Default passwords

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