Installing the Virtuoso Universal Server on Windows

0 - Prepare to Install

If you are upgrading an existing Virtuoso installation and want to preserve your existing data and configuration files:

1. Shut down your Virtuoso instance as normal.
   
   
   
2. Goto to the database folder of the Virtuoso installation, which is typically in C:\Program Files\OpenLink Software by default.
   
   
   
3. Check the size of the virtuoso.trx file, found in the database folder alongside the virtuoso.db and virtuoso.ini files.
   
   
   
   • If zero bytes, proceed to step 4.
     
     
     
   • If larger than zero bytes, start the instance from the command line with the extra argument, "+checkpoint-only", and recheck .trx file size -- expecting zero bytes.
     
     
     
   • If larger .trx files persist, contact Technical Support.
     
     
     
4. Make a backup of your existing Virtuoso Database and Configuration files (defaults are virtuoso.db and virtuoso.ini) prior to performing the steps that follow. Note: Virtuoso's online backup feature, if enabled, should have already generated a backup-set.
   
   
   
5. Use the Add/Remove Programs utility to uninstall any previously installed Virtuoso components. Data and configuration files will be left behind by this process.

1 - Download the Virtuoso Installer Program

1. Select the Virtuoso release number and Windows operating system required from the download site and click on the Find Downloads button. Note: Virtuoso 7.x and above is 64-bit only, and requires Vista or Windows Server 2003, or later.
   
   
   
   
   
   
2. Download the required Virtuoso Client and/or Client & Server installer archives from the list presented.
   
   
   
   
   

2 - Obtain a License File

1. If you haven't already obtained a suitable Virtuoso license file, return to the download site, select the Virtuoso release number and Windows operating system required and click on the Generate License button.
   
   
   
   
   
   
2. A Free 30 Day Evaluation License will be generated and emailed to the registered user. The license file will also be stored in the registered users OpenLink Data Spaces Briefcase folder. Note -- the file must be named virtuoso.lic for use. Some browsers may rename the file during download; you can simply rename the file on your machine.
   
   
   
   
   

3 - Run the Virtuoso Installer

1. Double-click the installer archive, wavpz2zz, to start the process with the Installer Program Introduction.
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   
2. Click Next, and the License Agreement dialog is presented:
   
   
   
   
   
   
3. Tick the box for I accept, and click Next. The Select Destination Location dialog is presented:
   
   
   
   
   
   
4. Use the Browse button to select the location for the installation or if the default location is acceptable click the Next button.
   
   
   
   
   
   
5. Use the Browse button to locate the license file you obtained earlier then, click Next. The dialog to Select the Components to be installed is presented:
   
   
   
   
   
   
6. Select the of the component types to install:
   
   • Full -- installs both Client and Server components
     
   • Client -- installs the Client components only
     
   • Server -- installs the Server components only
     
7. Click Next and the Select Start Menu Dialog is presented:
   
   
   
   
   
   
8. Click Next and the Select Additional Tasks dialog is presented with option to start the database automatically post installation:
   
   
   
   
   
   
9. Click Next and the Ready to Install dialog is presented:
   
   
   
   
   
   
10. Click Next and the installation will proceed and present a completion dialog when done:
    
    
    
    
    
    
11. The installation is now complete.

4 - Start the Virtuoso Service Manager, and Locate it in the Task Bar

1. Go to the Program Start Menu item created and select the Virtuoso Service Control program
   
   
   
   
   
   
2. The Virtuoso Service Control program will start in the Windows icon tray:
   
   
   
   
   
   
3. Double click on the Virtuoso Service Control icon to load the application, which can then be used to verify that the Virtuoso Windows service and License Manager are running:
   
   
   
   
   

5 - Administer your Virtuoso Instance

1. Go to the Program Start Menu item created and select the Virtuoso Conductor menu item to start the HTTP-based Virtuoso Database Administration interface:
   
   
   
   
   
   
2. Use the Conductor to configure your Virtuoso instance for future use. For example, it is strongly advised that you change the default passwords for the dba and dav super-user accounts (drill down to System Admin --> User Accounts).

6 - Optional - Restore your old Data and Configuration Files

If you preserved existing data and configuration files at the start of this process, now is the time to bring them back into play.

• If you used Virtuoso's online backup feature, the documentation will walk you through the restoration process.
  
  
  
• If you simply copied the INI and DB files elsewhere, and if they were Virtuoso 7.x files, you can just stop the current Virtuoso instance, and replace the newly created INI and DB with the old ones. For best results, we do advise that you compare the content of the old INI with the new, and add any new settings from the new to the old, adjust as may be appropriate to your deployment.
  
  
  
• If you simply copied the INI and DB files elsewhere, and if they were Virtuoso 6.x or older files, there are some extra steps that must be taken.

See Also

• Installing the Virtuoso Universal Server on Mac OS X