<docbook><section><title>MacOSXOplmgrLicenseLocations</title><title> Mac OS X OpenLink License Manager Usage Notes </title> Mac OS X <ulink url="OpenLink">OpenLink</ulink> License Manager Usage Notes 
<para>The default and suggested locations of OpenLink License files varies depending on the operating system in use and License Manager version.</para><bridgehead class="http://www.w3.org/1999/xhtml:h2"> Determining the Installed Version of the License Manager </bridgehead>
<para>The License Manager (oplmgr) version can be determined with the command <computeroutput>oplmgr -? </computeroutput>.</para><programlisting>oplmgr -?
OpenLink License Manager
Version 1.3.6 as of Fri Nov 15 2013 (Release 6.3, g127d4a9)
Compiled for Mac OS X 11.4.2 (x86_64-apple-macosx10.7)
Copyright (C) 1993-2013 OpenLink Software.

Usage:
  oplmgr [-shrdupf] [+start] [+stop] [+reload] [+directory arg] [+user arg]
         [+pidfile arg] [+foreground]
  +start        start the license manager
  +stop         stop the license manager
  +reload       force a configuration reload
  +directory    where to look for licenses (default .)
  +user         run as the specified user
  +pidfile      pid file to use for server operation
  +foreground   run in the foreground
</programlisting><para> Version <computeroutput>1.3.6</computeroutput> or higher uses the new <computeroutput>+directory</computeroutput> parameter option for the <computeroutput>oplmgr</computeroutput> program to specify the location license files should be found.</para><para> </para><programlisting>$ bin/oplmgr -?
OpenLink License Manager
Version 1.3.5 as of Mon Jul 02 2012 (Release 6.3 cvsid 00096).
Compiled for Mac OS X 11.4.2 (x86_64-apple-macosx10.7)
Copyright (C) 1993-2012 OpenLink Software.

Usage:
  oplmgr [-shrutpf] [+start] [+stop] [+reload] [+user arg] [+chroot arg]
         [+pidfile arg] [+foreground]
  +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
  +foreground   run in the foreground
</programlisting><para> Version <computeroutput>1.3.5</computeroutput> and previous used the <computeroutput>OPL_LICENSE_DIR</computeroutput> environment variable to locate the license file directory(ies).</para><para> </para><bridgehead class="http://www.w3.org/1999/xhtml:h2"> Location of License files </bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> License Manager version 1.3.6 and later (UDA Release 6.3 and later) </bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem> Default License Folder: <programlisting>/Library/Application Support/openlink/Licenses/
</programlisting> </listitem>
<listitem> Discovery sequence: <emphasis>only</emphasis> the directory(ies) specified with the <computeroutput>+directory</computeroutput> or <computeroutput>-d</computeroutput> option, <emphasis>or</emphasis> the single default diretory, <computeroutput>.</computeroutput> a/k/a the <computeroutput>oplmgr</computeroutput>&#39;s <computeroutput>pwd</computeroutput>, will be checked.</listitem>
</itemizedlist><para>If you choose to situate your license files in an alternative location, you can restart the license manager using the new <computeroutput>+directory</computeroutput> option which is used to identify the folder into which your license files have been placed.
 <emphasis><emphasis>Note:</emphasis> If you use an alternate location, you will also need to edit the startup script, <computeroutput>/Library/LaunchDaemons/com.openlinksw.oplmgr.plist</computeroutput>, to target the new location.</emphasis></para><para>Unlike previous versions, License Manager (oplmgr) version <computeroutput>1.3.6</computeroutput> and higher will search only the directory(ies) specified with the <computeroutput>+directory</computeroutput> or <computeroutput>-d</computeroutput> option.</para><para>The OpenLink installer places an automatic start-up script on Mac OS X machines, <computeroutput>/Library/LaunchDaemons/com.openlinksw.oplmgr.plist</computeroutput> such that the License Manager is always started on boot.
 The License Manager can also be started and stopped manually using the &quot;<computeroutput>oplmgr +[start | stop]</computeroutput>&quot; Terminal.app commands.</para><para>See the following note on  <ulink url="UnableContactLicenseManager">Special Guidance for Mac OS X</ulink></para><bridgehead class="http://www.w3.org/1999/xhtml:h3"> License Manager version 1.3.5 and earlier (UDA Release 6.3 and earlier) </bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem> Default License Folder: <programlisting>/Library/Application Support/openlink/bin/
</programlisting> </listitem>
<listitem> Discovery sequence: Default Folder and then any folder exposed by <computeroutput>$OPL_LICENSE_DIR</computeroutput> environment variable.</listitem>
</itemizedlist><para>Versions <computeroutput>1.3.5</computeroutput> or lower of the OpenLink License Manager (<computeroutput>oplmgr</computeroutput>) will always search the default <computeroutput>/Library/Application Support/openlink/bin/</computeroutput> folder before any others.</para><para>The OpenLink installer places an automatic start-up script on Mac OS X machines, such that the License Manager is always started on boot.
 The License Manager can also be started and stopped manually using the &quot;<computeroutput>oplmgr +[start | stop]</computeroutput>&quot; Terminal.app commands.</para><para>See the following note on  <ulink url="UnableContactLicenseManager">Special Guidance for Mac OS X</ulink></para><para> </para><bridgehead class="http://www.w3.org/1999/xhtml:h2"> Related Documentation </bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem> <ulink url="MTFirewallConfiguration">Firewall Considerations for Multi-Tier &quot;Enterprise&quot; Edition Data Access Drivers</ulink> </listitem>
<listitem> <ulink url="ConfigureServer-sideFirewallsForMulti-TierConnectivity">Configuring Server-side Firewalls for Multi-Tier Connectivity</ulink> </listitem>
<listitem> <ulink url="OplmgrNetworking">OpenLink License Manager Networking Considerations</ulink> </listitem>
<listitem> <ulink url="ConfigureMulti-TierRequestBrokerForUseOnMachinesWithMultipleNetworkCards">Configure Multi-Tier Request Broker for Use on Machines with Multiple Network Cards</ulink> </listitem>
<listitem> <ulink url="OplmgrStopStart">Start the License Manager Process</ulink> </listitem>
</itemizedlist></section></docbook>