<docbook><section><title>VirtuosoInstallWin32</title><para> </para><title> Installing the Virtuoso Universal Server on Windows </title> Installing the Virtuoso Universal Server on Windows 
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> 0 - Prepare to Install </bridgehead>
<para>If you are upgrading an existing Virtuoso installation and want to preserve your existing data and configuration files:</para><orderedlist spacing="compact"><listitem> Shut down your Virtuoso instance as normal. </listitem>
<listitem> Right-click on the existing <emphasis>Virtuoso.app</emphasis> (exact name may vary), and select <emphasis>Show Package Contents</emphasis>.
  </listitem>
<listitem> Drill down to <emphasis>Contents</emphasis> --&gt; <emphasis>virtuoso</emphasis> --&gt; <emphasis>database</emphasis>.
  </listitem>
<listitem> Check the size of the <emphasis>virtuoso.trx</emphasis> file, found in the <emphasis>database</emphasis> folder alongside the virtuoso.db and virtuoso.ini files. <itemizedlist mark="bullet" spacing="compact"><listitem> If zero bytes, proceed to step 6. </listitem>
<listitem> If larger than zero bytes, start the instance from the command line with the extra argument, &quot;<ulink url="http://docs.openlinksw.com/virtuoso/databaseadmsrv.html#COMMANDLINE">+checkpoint-only</ulink>&quot;, and recheck .trx file size -- expecting zero bytes. </listitem>
<listitem> If larger .trx files persist, <ulink url="http://support.openlinksw.com/support/online-support.vsp">contact Technical Support</ulink>. </listitem>
</itemizedlist></listitem>
<listitem> Make a backup of your existing Virtuoso Database and Configuration files (defaults are <emphasis>virtuoso.db</emphasis> and <emphasis>virtuoso.ini</emphasis>) prior to performing the steps that follow.
 <emphasis><emphasis>Note:</emphasis> Virtuoso&#39;s <ulink url="http://docs.openlinksw.com/virtuoso/backup.html#onlinebackups">online backup feature</ulink>, if enabled, should have already generated a backup-set.</emphasis> </listitem>
<listitem> Use the Add/Remove Programs utility to uninstall any previously installed Virtuoso components.
 Data and configuration files will be left behind by this process.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> 1 - Download the Virtuoso Installer Program </bridgehead>
<orderedlist spacing="compact"><listitem> Download the <ulink url="http://opldownload.s3.amazonaws.com/uda%2Fvirtuoso%2F7.2%2Fx86_64-generic-win-64%2Fwavpz2zz.msi#this">Virtuoso 7.2 installer archive (wavpz2zz.msi)</ulink> from the <ulink url="http://virtuoso.openlinksw.com/download/">download site</ulink>.
 <emphasis><emphasis>Note:</emphasis> Virtuoso 7.x is 64-bit only, and requires Vista or Windows Server 2003, or later.</emphasis></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> 2 - Obtain a License File </bridgehead>
<orderedlist spacing="compact"><listitem> If you haven&#39;t already obtained a suitable Virtuoso 7.x license file, return to the  <ulink url="http://virtuoso.openlinksw.com/download/">download site</ulink>, and click the link for <emphasis>Free Eval License</emphasis> (15 day duration, requires only your email address) or <emphasis>Free Pilot License</emphasis> (30 day duration, requires some additional personal and business information).
<ulink url="VirtuosoInstallWin32/win_obtain_license.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_obtain_license.jpg" /></figure></ulink> </listitem>
<listitem> Fill out the relevant form, and download the license file when presented.
 <emphasis><emphasis>Note</emphasis> -- the file must be named <emphasis>virtuoso.lic</emphasis> for use.
 Some browsers may rename the file during download; you can simply rename the file on your machine.</emphasis></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> 3 - Run the Virtuoso Installer </bridgehead>
<orderedlist spacing="compact"><listitem> Double-click the installer archive, wavpz2zz.msi, to start the process with the Installer Program Introduction.
<ulink url="VirtuosoInstallWin32/win_installer_program.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_installer_program.jpg" /></figure></ulink> </listitem>
<listitem> Click <emphasis>Next</emphasis>, and you&#39;ll be presented with the License Agreement: <ulink url="VirtuosoInstallWin32/win_license_agreement.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_license_agreement.jpg" /></figure></ulink> </listitem>
<listitem> Tick the box for <emphasis>I accept</emphasis>, and click <emphasis>Next</emphasis>.
 You&#39;ll be asked to locate your license file: <ulink url="VirtuosoInstallWin32/win_install_folder.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_install_folder.jpg" /></figure></ulink> </listitem>
<listitem> Use the <emphasis>Browse</emphasis> button to locate the license file you obtained earlier, or click the <emphasis>Try and Buy</emphasis> button to obtain a new one now, or tick the box for <emphasis>I don&#39;t want to install a license file now.</emphasis>  Then, click <emphasis>Next</emphasis>.
 You&#39;ll be prompted to select an Installation Type: <ulink url="VirtuosoInstallWin32/win_install_type.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_install_type.jpg" /></figure></ulink> </listitem>
<listitem> Select the desired option <itemizedlist mark="bullet" spacing="compact"><listitem> <emphasis>Typical</emphasis> -- installs to the default filesystem location, may not include all components </listitem>
<listitem> <emphasis>Complete</emphasis> -- installs to the default filesystem location, includes all components </listitem>
<listitem> <emphasis>Custom</emphasis> -- to install to any filesystem location, and select which components will be installed </listitem>
</itemizedlist></listitem>
<listitem> Click <emphasis>Next</emphasis>, and if you chose <emphasis>Typical</emphasis> or <emphasis>Complete</emphasis>, skip this and the next step; if you chose <emphasis>Custom</emphasis>, you&#39;ll be prompted to choose a destination folder: <ulink url="VirtuosoInstallWin32/win_destination_folder.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_destination_folder.jpg" /></figure></ulink> </listitem>
<listitem> Click <emphasis>Next</emphasis>, and if you chose <emphasis>Custom</emphasis>, you&#39;ll be prompted for Feature Selection: <ulink url="VirtuosoInstallWin32/win_feature_selection"><figure><graphic fileref="VirtuosoInstallWin32/win_feature_selection.jpg" /></figure></ulink> </listitem>
<listitem> Click <emphasis>Next</emphasis>, and the installer will indicate it&#39;s ready to begin: <ulink url="VirtuosoInstallWin32/win_file_copystart.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_file_copystart.jpg" /></figure></ulink> </listitem>
<listitem> Click install, and wait for notification of completion.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> 4 - Start the Virtuoso Service Manager, and Locate it in the Task Bar </bridgehead>
<orderedlist spacing="compact"><listitem> Launch the Virtuoso Service Manager from your <emphasis>Start</emphasis> menu.
<ulink url="VirtuosoInstallWin32/win_locate_manager.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_locate_manager.jpg" /></figure></ulink> </listitem>
<listitem> Look for an icon to appear in the Task Bar at the bottom right of your screen.
<ulink url="VirtuosoInstallWin32/win_launch_manager.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_launch_manager.jpg" /></figure></ulink></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> 5 - Start and Administer your Virtuoso Instance </bridgehead>
<orderedlist spacing="compact"><listitem> Right-click on the Virtuoso Service Manager icon in the Task Bar, and click on <emphasis>OpenLink Virtuoso Server - Start</emphasis>.
<ulink url="VirtuosoInstallWin32/win_start_service.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_start_service.jpg" /></figure></ulink> </listitem>
<listitem> Open the <emphasis>Virtuoso Conductor</emphasis>, Virtuoso&#39;s HTTP-based administration tool, by loading this URL in your Web Browser: <emphasis><ulink url="http://localhost:8890/conductor">http://localhost:8890/conductor</ulink></emphasis>. <ulink url="VirtuosoInstallWin32/win_virt_admin.jpg"><figure><graphic fileref="VirtuosoInstallWin32/win_virt_admin.jpg" /></figure></ulink> </listitem>
<listitem> Use the Conductor to configure your Virtuoso instance for future use.
 For example, it is <emphasis><emphasis>strongly</emphasis></emphasis> advised that you change the default passwords for the <emphasis>dba</emphasis> and <emphasis>dav</emphasis> super-user accounts (drill down to <emphasis>System Admin</emphasis> --&gt; <emphasis>User Accounts</emphasis>).</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> 6 - Optional - Restore your old Data and Configuration Files </bridgehead>
<para>If you preserved existing data and configuration files at the start of this process, now is the time to bring them back into play.</para><itemizedlist mark="bullet" spacing="compact"><listitem> If you used Virtuoso&#39;s online backup feature, <ulink url="http://docs.openlinksw.com/virtuoso/backup.html#onlinebackups">the documentation</ulink> will walk you through the restoration process. </listitem>
<listitem> 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. </listitem>
<listitem> If you simply copied the INI and DB files elsewhere, and if they were Virtuoso 6.x or older files, there are <ulink url="UpgradingToVOS610">some extra steps that must be taken</ulink>.</listitem>
</itemizedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> See Also </bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem> <ulink url="VirtuosoInstallMac">Installing the Virtuoso Universal Server on Mac OS X</ulink></listitem>
</itemizedlist><para> </para></section></docbook>