Before installing the Virtuoso software for Mac OS X you must ensure that you have the correct package from the OpenLink Web Site.
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.5.2.1. Mounting the Disk Image |
The installer will load the Introduction page.
![]() |
Figure: 2.5.2.2. Installer Introduction Page |
Review the Readme page for any important information concerning the product installation.
![]() |
Figure: 2.5.2.3. Important Information |
Read the license agreement and "agree" to the terms.
![]() |
Figure: 2.5.2.4. Software License Agreement |
Select the Destination volume the software is to be installed on.
![]() |
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.
![]() |
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.
![]() |
Figure: 2.5.2.7. Customizing the Installation |
The software must be install by a user with Administrative privileges on the machine.
![]() |
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.
![]() |
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.
![]() |
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.
![]() |
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.
![]() |
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.
![]() |
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.
![]() |
Figure: 2.5.2.14. Welcome |
The Installation is now complete.
![]() |
Figure: 2.5.2.15. Installation complete |
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.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.
![]() |
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.
![]() |
Figure: 2.5.3.3. Location of apple scripts |
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
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.
![]() |
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
![]() |
Figure: 2.5.4.2.2. The .log file |
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.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).
![]() |
Figure: 2.5.5.2. ODBC Administrator - Choose Virtuoso Driver |
Provide all required details in the fields provided by the setup panel.
![]() |
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.
![]() |
Figure: 2.5.5.4. Pick Zero Config |
Alternatively a manual selection can be made for the server.
![]() |
Figure: 2.5.5.5. Pick manual mode |
In this case enter the hostname (or IP) and port number.
![]() |
Figure: 2.5.5.6. Manual Server Entry |
![]() |
Figure: 2.5.5.7. 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.
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.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.
![]() |
Figure: 2.5.6.2. Login - Connection Tab |
The Options page has Database, Charset and daylight savings configuration. Typically the defaults are used.
![]() |
Figure: 2.5.6.3. Login - Options Tab |
The About page shows the software details.
![]() |
Figure: 2.5.6.4. Login - About |
The result of the test is shown in a popup window.
![]() |
Figure: 2.5.6.5. Test Result |
See the following Quick Start chapter for very important information about changing the default passwords.
Previous
Virtuoso for Unix (Personal Edition) |
Chapter Contents |
Next
Virtuoso ADO.Net Data Grid Form Application |