2.2.3. Installation Steps
Prepare to Install
If you are upgrading an existing Virtuoso installation and want to preserve your existing data and configuration files:
-
Shut down your Virtuoso instance as normal.
-
Right-click on the existing
Virtuoso.app
(exact name may vary), and selectShow Package Contents
. -
Drill down to
Contents
-<virtuoso
-<database
. -
Check the size of the
virtuoso.trx
file, found in thedatabase
folder alongside thevirtuoso.db
andvirtuoso.ini
files.-
If zero bytes, proceed to step 6.
-
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 .
-
-
Make a backup of your existing Virtuoso Database and Configuration files (defaults are
virtuoso.db
andvirtuoso.ini
) prior to performing the steps that follow. Note : Virtuoso's online backup feature , if enabled, should have already generated a backup-set. -
Use the Add/Remove Programs utility to uninstall any previously installed Virtuoso components. Data and configuration files will be left behind by this process.
Download the Virtuoso Installer Program
-
Download the Virtuoso 7.2 installer archive (wavpz2zz.msi) from the download site .
Note
: Virtuoso 7.x is 64-bit only, and requires Vista or Windows Server 2003, or later.
Obtain a License File
-
If you haven't already obtained a suitable Virtuoso 7.x license file, return to the download site , and click the link for Free Eval License (15 day duration, requires only your email address) or Free Pilot License (30 day duration, requires some additional personal and business information).
Figure 2.1. Installing the Virtuoso Universal Server on Windows -- Obtain a License File
-
Fill out the relevant form, and download the license file when presented.
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.
Run the Virtuoso Installer
-
Double-click the installer archive,
wavpz2zz.msi
, to start the process with the Installer Program Introduction.Figure 2.2. Installing the Virtuoso Universal Server on Windows -- Run the Virtuoso Installer
-
Click
Next
, and you'll be presented with the License Agreement:
Figure 2.3. Installing the Virtuoso Universal Server on Windows -- License Agreement
-
Tick the box for
I accept
, and click
Next
. You'll be asked to locate your license file:
Figure 2.4. Installing the Virtuoso Universal Server on Windows -- License Agreement Accept
-
Use the
Browse
button to locate the license file you obtained earlier, or click the
Try and Buy
button to obtain a new one now, or tick the box for
I don't want to install a license file now
. Then, click
Next
. You'll be prompted to select an Installation Type:
Figure 2.5. Installing the Virtuoso Universal Server on Windows -- Choose Installation Type
-
Select the desired option:
-
Typical
-- installs to the default filesystem location, may not include all components
-
Complete
-- installs to the default filesystem location, includes all components
-
Custom
-- to install to any filesystem location, and select which components will be installed
-
-
Click
Next
, and if you chose
Typical
or
Complete
, skip this and the next step; if you chose
Custom, you'll be prompted to choose a destination folder:
Figure 2.6. Installing the Virtuoso Universal Server on Windows -- Choose Destination Folder
-
Click
Next
, and if you chose
Custom
, you'll be prompted for Feature Selection:
Figure 2.7. Installing the Virtuoso Universal Server on Windows -- Feature Selection
-
Click
Next
, and the installer will indicate it's ready to begin:
Figure 2.8. Installing the Virtuoso Universal Server on Windows -- Read to install
-
Click install, and wait for notification of completion.
Start the Virtuoso Service Manager, and Locate it in the Task Bar
-
Launch the Virtuoso Service Manager from your
Start
menu.
Figure 2.9. Installing the Virtuoso Universal Server on Windows -- Launch the Virtuoso Service Manager.
-
Look for an icon to appear in the Task Bar at the bottom right of your screen.
Figure 2.10. Installing the Virtuoso Universal Server on Windows -- Look for an icon
Start and Administer your Virtuoso Instance
-
Right-click on the Virtuoso Service Manager icon in the Task Bar, and click on
OpenLink Virtuoso Server - Start
:
Figure 2.11. Installing the Virtuoso Universal Server on Windows -- Start your Virtuoso Instance
-
Open the
Virtuoso Conductor
, Virtuoso's HTTP-based administration tool, by loading this URL in your Web Browser: http://example.com/conductor .
Figure 2.12. Installing the Virtuoso Universal Server on Windows -- Virtuoso Conductor
-
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
).
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.