<docbook><section><title>VirtuosoLicenseManager</title><para> </para><bridgehead class="http://www.w3.org/1999/xhtml:h2">License Manager</bridgehead><bridgehead class="http://www.w3.org/1999/xhtml:h3">Monitor License Consumption</bridgehead>
<para>OpenLink&#39;s License Manager technology provides a sophisticated and easy to use License statistics and monitoring facility.
 This page introduces you to that facility and provides alternative techniques for versions of the software that do not contain it.</para><orderedlist spacing="compact"><listitem> Launch the Virtuoso Web interface.
</listitem>
<listitem> Click the *Conductor* link.
</listitem>
<listitem> Login with your Virtuoso dba account.
</listitem>
<listitem> Click the *System Admin* tab.
</listitem>
<listitem> Locate the *License* section to review the terms of your Virtuoso license.
</listitem>
<listitem> Locate the *Clients* section to review open connections that consume Virtuoso license points.</listitem>
</orderedlist><para> </para><bridgehead class="http://www.w3.org/1999/xhtml:h3">Start the License Manager Process</bridgehead>
<para> </para><bridgehead class="http://www.w3.org/1999/xhtml:h4">Mac OS X</bridgehead>
<orderedlist spacing="compact"><listitem> Launch  *Terminal.app*  (<emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki/Applications/Utilities/</span></emphasis>) </listitem>
<listitem> Execute the command,  <emphasis>cd <span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki&quot;/Library/Application Support/openlink/bin/&quot;</span></emphasis>  </listitem>
<listitem> Execute the command,  <emphasis>oplmgr +start</emphasis> </listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Windows</bridgehead>
<orderedlist spacing="compact"><listitem> Launch the *Services* Control Panel (may be in the *Administrative Tools* sub-folder).
</listitem>
<listitem> Locate and select the <emphasis>OpenLink License Manager</emphasis> service.
</listitem>
<listitem> Click the *Start* icon.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)</bridgehead>
<orderedlist spacing="compact"><listitem> Open a Unix terminal.
</listitem>
<listitem>  *cd*  into the root of your Virtuoso installation.
</listitem>
<listitem> Use one of the following commands to set Virtuoso-related environment variables.
 (Note that they do, and must, begin with dot-space-dot-slash.) </listitem>
</orderedlist><itemizedlist mark="bullet" spacing="compact"><listitem>  <emphasis>.
 ./virtuoso-enterprise.sh</emphasis>  — bash, bsh, ksh, and related shells </listitem>
<listitem>  <emphasis>.
 ./virtuoso-enterprise.csh</emphasis>  — csh, tcsh, and related shells </listitem>
</itemizedlist><orderedlist spacing="compact"><listitem> Set and export an <emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowikiOPL_LICENSE_DIR</span></emphasis> environment variable that passes the path to the directory that contains your Virtuoso license.
</listitem>
<listitem> Execute the command,  <emphasis>oplmgr +start</emphasis> </listitem>
</orderedlist><itemizedlist mark="bullet" spacing="compact"><listitem>Note*: OpenLink recommends that you create an <emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki/etc/init.d/</span></emphasis> script that sets the environment and runs <emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowikioplmgr +start</span></emphasis> at boot time.</listitem>
</itemizedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">Stop the License Manager Process</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h4">Mac OS X</bridgehead>
<orderedlist spacing="compact"><listitem> Launch  *Terminal.app*  (<emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki/Applications/Utilities/</span></emphasis>) </listitem>
<listitem> Execute the command,  <emphasis>cd <span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki&quot;/Library/Application Support/openlink/bin/&quot;</span></emphasis>  </listitem>
<listitem> Execute the command,  <emphasis>oplmgr +stop</emphasis> </listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Windows</bridgehead>
<orderedlist spacing="compact"><listitem> Launch the *Services* Control Panel (may be in the *Administrative Tools* sub-folder).
</listitem>
<listitem> Locate and select the *OpenLink License Manager* service.
</listitem>
<listitem> Click the *Stop* icon.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)</bridgehead>
<orderedlist spacing="compact"><listitem> Open a Unix terminal.
</listitem>
<listitem>  *cd*  into the root of your Virtuoso installation.
</listitem>
<listitem> Use one of the following commands to set Virtuoso-related environment variables.
 (Note that they do, and must, begin with dot-space-dot-slash.) </listitem>
</orderedlist><itemizedlist mark="bullet" spacing="compact"><listitem>  <emphasis>.
 ./virtuoso-enterprise.sh</emphasis>  — bash, bsh, ksh, and related shells </listitem>
<listitem>  <emphasis>.
 ./virtuoso-enterprise.csh</emphasis>  — csh, tcsh, and related shells </listitem>
</itemizedlist><orderedlist spacing="compact"><listitem> Execute the command,  <emphasis>oplmgr +stop</emphasis> </listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">Reinitialize the License Manager Process</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3">Mac OS X</bridgehead>
<orderedlist spacing="compact"><listitem> Launch  *Terminal.app*  (<emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki/Applications/Utilities/</span></emphasis>) </listitem>
<listitem> Execute the command,  <emphasis>cd <span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowiki&quot;/Library/Application Support/openlink/bin/&quot;</span></emphasis>  </listitem>
<listitem> Execute the command,  <emphasis>oplmgr +reload</emphasis> </listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Windows</bridgehead>
<orderedlist spacing="compact"><listitem> Launch the *Services* Control Panel (may be in the *Administrative Tools* sub-folder).
</listitem>
<listitem> Locate and select the <emphasis>OpenLink License Manager</emphasis> service.
</listitem>
<listitem> Click the *Restart* icon.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)</bridgehead>
<orderedlist spacing="compact"><listitem> Open a Unix terminal.
</listitem>
<listitem>  *cd*  into the root of your Virtuoso installation.
</listitem>
<listitem> Use one of the following commands to set Virtuoso-related environment variables.
 (Note that they do, and must, begin with dot-space-dot-slash.) </listitem>
</orderedlist><itemizedlist mark="bullet" spacing="compact"><listitem>  <emphasis>.
 ./virtuoso-enterprise.sh</emphasis>  — bash, bsh, ksh, and related shells </listitem>
<listitem>  <emphasis>.
 ./virtuoso-enterprise.csh</emphasis>  — csh, tcsh, and related shells </listitem>
</itemizedlist><orderedlist spacing="compact"><listitem> Set and export an <emphasis><span style="color: red">
      UNKNOWN tag:
      http://www.w3.org/1999/xhtml:nowikiOPL_LICENSE_DIR</span></emphasis> environment variable that passes the path to the directory that contains your Virtuoso license.
</listitem>
<listitem> Execute the command,  <emphasis>oplmgr +reload</emphasis> </listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3">Additional Usage Notes</bridgehead>
<para>The license manager takes several command-line arguments, as revealed by its &quot;usage&quot; output (produced by any unrecognized argument) *mdash; </para><programlisting>      bash$ oplmgr --help
      OpenLink License Manager
      Version 1.2.2 as of Thu Feb 15 2007 (Release 6.0 cvsid 00084).
      Compiled for Linux 2.4.20-46.9.legacysmp (i686-generic-linux-glibc23-32)
      Copyright (C) OpenLink Software.

      Usage:
      oplmgr [-shrutp] [+start] [+stop] [+reload] [+user arg] [+chroot arg]
      [+pidfile arg]
      +start     start the license manager
      +stop      stop the license manager
      +reload    force a configuration reload
      +user      run as the specified user
      +chroot    perform a chroot to the specified directory
      +pidfile   pid file to use for server operation
</programlisting></section></docbook>