# 2. Installation Guide

Chapter Contents | Prev | Next
Keyword Search:
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

The installer will load the Introduction page.

Figure: 2.4.3.2. Installer Introduction Page

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

Figure: 2.4.3.3. Important Information

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

Figure: 2.4.3.4. Software License Agreement

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

Figure: 2.4.3.5. 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

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

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

Figure: 2.4.3.8. 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 ...

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

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

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

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

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

The Installation is now complete.

Figure: 2.4.3.15. 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

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

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

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

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

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

Figure: 2.4.5.3. 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

Alternatively a manual selection can be made for the server.

Figure: 2.4.5.5. Pick manual mode

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

Figure: 2.4.5.6. Manual Server Entry

Figure: 2.4.5.7. ODBC Administrator - Configure Virtuoso DSN

Figure: 2.4.5.8. 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

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

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

Figure: 2.4.6.3. Login - Options Tab

The About page shows the software details.

Figure: 2.4.6.4. Login - About

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

Figure: 2.4.6.5. 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.

Previous Virtuoso for Unix | Chapter Contents | Next Contents of Quick Start & Tours