%META:TOPICPARENT{name="UDALicenseApplication"}%

= <nop>OpenLink License Manager Usage Notes =

%TOC%

== Start the License Manager Process ==

=== Mac OS X ===

# Open a Mac Terminal.
# Navigate to this directory:  **{{{/Library/Application Support/openlink/bin}}}**
# Execute this command: **{{{oplmgr +start}}}**

===Unix===

# Open a Unix terminal.
# Navigate to the root of your <nop>OpenLink UDA or Virtuoso installation.
# Use one of the following scripts to set Virtuoso-related environment variables:
#* bash, bourne, korn shells - **{{{openlink.sh}}}**
#* C shells - **{{{openlink.csh}}}**
#* bash, bourne, korn shells - **{{{virtuoso-enterprise.sh}}}**
#* C shells - **{{{virtuoso-enterprise.csh}}}**
# If <nop>OpenLink License Manager version is 1.3.5 or less
#* Set and export an **{{{OPL_LICENSE_DIR}}}** variable that passes the path to the directory that contains your <nop>OpenLink UDA or Virtuoso license.
#* Navigate to the bin sub-directory of the <nop>OpenLink installation.
#* Execute this command: **{{{oplmgr +start}}}**
# If <nop>OpenLink License Manager version is 1.3.6 or greater
#* Navigate to the bin sub-directory of the <nop>OpenLink installation.
#* Execute this command: **{{{oplmgr +start +directory <path to directory containing license>}}}**


Note: <nop>OpenLink recommends that you create an /etc/init.d/ script that runs `oplmgr +start' on boot-up.

===Windows===

# Login to Windows.
# Open the **Services** or **Component Services** utility that resides in the Control Panel or its Administrative Tools sub-folder.
# Locate the <nop>OpenLink License Manager process.
# Highlight the <nop>OpenLink License Manager process.
# Click the Start icon.


==Stop the License Manager Process==

===Mac OS X===

# Open a Mac Terminal.
# Navigate to this directory:  **{{{/Library/Application Support/openlink/bin}}}**
# Execute this command: **{{{oplmgr +stop}}}**

===Unix===

# Open a Unix terminal.
# Navigate to the root of your <nop>OpenLink UDA or Virtuoso installation.
# Use one of the following scripts to set Virtuoso-related environment variables:
#* bash, bourne, korn shells - **{{{openlink.sh}}}**
#* C shells - **{{{openlink.csh}}}**
#* bash, bourne, korn shells - **{{{virtuoso-enterprise.sh}}}**
#* C shells - **{{{virtuoso-enterprise.csh}}}**
# Navigate to the bin sub-directory of the <nop>OpenLink installation.
# Execute this command: **{{{oplmgr +stop}}}**

===Windows===

# Login to Windows.
# Open the **Services** or **Component Services** utility that resides in the Control Panel or its Administrative Tools sub-folder.
# Locate the <nop>OpenLink License Manager process.
# Highlight the <nop>OpenLink License Manager process.
# Click the Stop icon.


==Reinitialize the License Manager Process==

===Mac OS X===

# Open a Mac Terminal.
# Navigate to this directory:  **{{{/Library/Application Support/openlink/bin}}}**
# Execute this command: **{{{oplmgr +reload}}}**

===Unix===

# Open a Unix terminal.
# Navigate to the root of your <nop>OpenLink UDA or Virtuoso installation.
# Use one of the following scripts to set Virtuoso-related environment variables:
#* bash, bourne, korn shells - **{{{openlink.sh}}}**
#* C shells - **{{{openlink.csh}}}**
#* bash, bourne, korn shells - **{{{virtuoso-enterprise.sh}}}**
#* C shells - **{{{virtuoso-enterprise.csh}}}**
# Set and export an **{{{OPL_LICENSE_DIR}}}** variable that passes the path to the directory that contains your <nop>OpenLink UDA or Virtuoso license.
# Navigate to the bin sub-directory of the <nop>OpenLink installation.
# Execute this command: **{{{oplmgr +reload}}}**

===Windows===

# Login to Windows.
# Open the **Services** or **Component Services** utility that resides in the Control Panel or its Administrative Tools sub-folder.
# Locate the <nop>OpenLink License Manager process.
# Highlight the <nop>OpenLink License Manager process.
# Click the Restart icon.


==Additional Usage Notes==

The license manager accepts the command-line options shown below on all platforms. Any unrecognized command-line arguments will produce this output, including "{{{--help}}}" and "{{{-?}}}".

{{{
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
}}}

== Related Documentation ==

* [[MTFirewallConfiguration | Firewall Considerations for Multi-Tier "Enterprise" Edition Data Access Drivers]]
* [[ConfigureServer-sideFirewallsForMulti-TierConnectivity | Configuring Server-side Firewalls for Multi-Tier Connectivity]]
* [[OplmgrNetworking | OpenLink License Manager Networking Considerations]]
* [[ConfigureMulti-TierRequestBrokerForUseOnMachinesWithMultipleNetworkCards | Configure Multi-Tier Request Broker for Use on Machines with Multiple Network Cards]]
* [[OplmgrLicenseLocations | OpenLink License Manager Usage Notes]]