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:

  1. Shut down your Virtuoso instance as normal.

  2. Right-click on the existing Virtuoso.app (exact name may vary), and select Show Package Contents .

  3. Drill down to Contents -< virtuoso -< database .

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

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

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

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

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

    Figure2.1.Installing the Virtuoso Universal Server on Windows -- Obtain a License File

    Installing the Virtuoso Universal Server on Windows -- Obtain a License File

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

  1. Double-click the installer archive, wavpz2zz.msi , to start the process with the Installer Program Introduction.

    Figure2.2.Installing the Virtuoso Universal Server on Windows -- Run the Virtuoso Installer

    Installing the Virtuoso Universal Server on Windows -- Run the Virtuoso Installer

  2. Click

    Next

    , and you'll be presented with the License Agreement:

    Figure2.3.Installing the Virtuoso Universal Server on Windows -- License Agreement

    Installing the Virtuoso Universal Server on Windows -- License Agreement

  3. Tick the box for

    I accept

    , and click

    Next

    . You'll be asked to locate your license file:

    Figure2.4.Installing the Virtuoso Universal Server on Windows -- License Agreement Accept

    Installing the Virtuoso Universal Server on Windows -- License Agreement Accept

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

    Figure2.5.Installing the Virtuoso Universal Server on Windows -- Choose Installation Type

    Installing the Virtuoso Universal Server on Windows -- Choose Installation Type

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

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

    Figure2.6.Installing the Virtuoso Universal Server on Windows -- Choose Destination Folder

    Installing the Virtuoso Universal Server on Windows -- Choose Destination Folder

  7. Click

    Next

    , and if you chose

    Custom

    , you'll be prompted for Feature Selection:

    Figure2.7.Installing the Virtuoso Universal Server on Windows -- Feature Selection

    Installing the Virtuoso Universal Server on Windows -- Feature Selection

  8. Click

    Next

    , and the installer will indicate it's ready to begin:

    Figure2.8.Installing the Virtuoso Universal Server on Windows -- Read to install

    Installing the Virtuoso Universal Server on Windows -- Read to install

  9. Click install, and wait for notification of completion.

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

  1. Launch the Virtuoso Service Manager from your

    Start

    menu.

    Figure2.9.Installing the Virtuoso Universal Server on Windows -- Launch the Virtuoso Service Manager.

    Installing the Virtuoso Universal Server on Windows -- Launch the Virtuoso Service Manager.

  2. Look for an icon to appear in the Task Bar at the bottom right of your screen.

    Figure2.10.Installing the Virtuoso Universal Server on Windows -- Look for an icon

    Installing the Virtuoso Universal Server on Windows -- Look for an icon

Start and Administer your Virtuoso Instance

  1. Right-click on the Virtuoso Service Manager icon in the Task Bar, and click on

    OpenLink Virtuoso Server - Start

    :

    Figure2.11.Installing the Virtuoso Universal Server on Windows -- Start your Virtuoso Instance

    Installing the Virtuoso Universal Server on Windows -- Start your Virtuoso Instance

  2. Open the

    Virtuoso Conductor

    , Virtuoso's HTTP-based administration tool, by loading this URL in your Web Browser: http://example.com/conductor .

    Figure2.12.Installing the Virtuoso Universal Server on Windows -- Virtuoso Conductor

    Installing the Virtuoso Universal Server on Windows -- Virtuoso Conductor

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

  1. If you used Virtuoso's online backup feature, the documentation will walk you through the restoration process.

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

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