%META:TOPICPARENT{name="VirtuosoLicenseApplication"}%
<h2>License Manager</h2>

%TOC%

===Monitor License Consumption===

<nop>OpenLink'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.

# Launch the Virtuoso Web interface.
# Click the *Conductor* link.
# Login with your Virtuoso <code>dba</code> account.
# Click the *System Admin* tab.
# Locate the *License* section to review the terms of your Virtuoso license.
# Locate the *Clients* section to review open connections that consume Virtuoso license points.


===Start the License Manager Process===
====Mac OS X====

# Launch <code> *Terminal.app* </code> (<b><code><nowiki>/Applications/Utilities/</nowiki></code></b>)
# Execute the command, <code> <b>cd <nowiki>"/Library/Application Support/openlink/bin/"</nowiki></b> </code>
# Execute the command, <code> <b>oplmgr +start</b> </code>

====Windows====

# Launch the *Services* Control Panel (may be in the *Administrative Tools* sub-folder).
# Locate and select the <b><nop>OpenLink License Manager</b> service.
# Click the *Start* icon.

====Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)====

# Open a Unix terminal.
# <code> *cd* </code> into the root of your Virtuoso installation.
# Use one of the following commands to set Virtuoso-related environment variables.  (Note that they do, and must, begin with dot-space-dot-slash.)
* <code> <b>. ./virtuoso-enterprise.sh</b> </code> &mdash; bash, bsh, ksh, and related shells
* <code> <b>. ./virtuoso-enterprise.csh</b> </code> &mdash; csh, tcsh, and related shells
# Set and export an <b><code><nowiki>OPL_LICENSE_DIR</nowiki></code></b> environment variable that passes the path to the directory that contains your Virtuoso license.
# Execute the command, <code> <b>oplmgr +start</b> </code>

*Note*: <nop>OpenLink recommends that you create an <b><code><nowiki>/etc/init.d/</nowiki></code></b> script that sets the environment and runs <b><code><nowiki>oplmgr +start</nowiki></code></b> at boot time. 

===Stop the License Manager Process===

====Mac OS X====

# Launch <code> *Terminal.app* </code> (<b><code><nowiki>/Applications/Utilities/</nowiki></code></b>)
# Execute the command, <code> <b>cd <nowiki>"/Library/Application Support/openlink/bin/"</nowiki></b> </code>
# Execute the command, <code> <b>oplmgr +stop</b> </code>

====Windows====

# Launch the *Services* Control Panel (may be in the *Administrative Tools* sub-folder).
# Locate and select the *<nop>OpenLink License Manager* service.
# Click the *Stop* icon.

====Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)====

# Open a Unix terminal.
# <code> *cd* </code> into the root of your Virtuoso installation.
# Use one of the following commands to set Virtuoso-related environment variables.  (Note that they do, and must, begin with dot-space-dot-slash.)
* <code> <b>. ./virtuoso-enterprise.sh</b> </code> &mdash; bash, bsh, ksh, and related shells
* <code> <b>. ./virtuoso-enterprise.csh</b> </code> &mdash; csh, tcsh, and related shells
# Execute the command, <code> <b>oplmgr +stop</b> </code>

===Reinitialize the License Manager Process===

===Mac OS X===

# Launch <code> *Terminal.app* </code> (<b><code><nowiki>/Applications/Utilities/</nowiki></code></b>)
# Execute the command, <code> <b>cd <nowiki>"/Library/Application Support/openlink/bin/"</nowiki></b> </code>
# Execute the command, <code> <b>oplmgr +reload</b> </code>

====Windows====

# Launch the *Services* Control Panel (may be in the *Administrative Tools* sub-folder).
# Locate and select the <b><nop>OpenLink License Manager</b> service.
# Click the *Restart* icon.

====Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)====

# Open a Unix terminal.
# <code> *cd* </code> into the root of your Virtuoso installation.
# Use one of the following commands to set Virtuoso-related environment variables.  (Note that they do, and must, begin with dot-space-dot-slash.)
* <code> <b>. ./virtuoso-enterprise.sh</b> </code> &mdash; bash, bsh, ksh, and related shells
* <code> <b>. ./virtuoso-enterprise.csh</b> </code> &mdash; csh, tcsh, and related shells
# Set and export an <b><code><nowiki>OPL_LICENSE_DIR</nowiki></code></b> environment variable that passes the path to the directory that contains your Virtuoso license.
# Execute the command, <code> <b>oplmgr +reload</b> </code>
   
===Additional Usage Notes===

The license manager takes several command-line arguments, as revealed by its "usage" output (produced by any unrecognized argument) *mdash;
{{{
      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
}}}