2.7. OpenLink License Management
2.7.1. License Files
2.7.1.1. License Activation
2.7.1.1.1. Mac OS X
- Launch Terminal.app (/Applications/Utilities/)
- Execute the command cd "/Library/Application Support/openlink/bin/"
- Execute the command oplmgr +stop
- Retrieve your new Virtuoso license file from an email or ODS Briefcase.
- Replace the old license file with the new license file. (You may delete the old file, or safely retain it in this location by changing the .lic file extension to .lic-old.)
- Execute the command oplmgr +start
2.7.1.1.2. Windows
- Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
- Locate and select the OpenLink License Manager service.
- Click the Stop icon.
- Retrieve your new Virtuoso license file from an email or ODS Briefcase.
- Replace the old license file with the new license file. (You may delete the old file, or safely retain it in this location by changing the .lic file extension to .lic-old.)
- Go back to the Services Control Panel.
- Locate and select the OpenLink License Manager service.
- Click the Start icon.
2.7.1.1.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
- Open a Unix terminal.
-
cd 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.)
-
. ./virtuoso-enterprise.sh - bash, bsh, ksh, and related shells
-
. ./virtuoso-enterprise.csh - csh, tcsh, and related shells
- Execute the command: oplmgr +stop
- Retrieve your new Virtuoso license file from an email or ODS Briefcase. Use binary-mode ftp to transfer the new license to the Unix box, if required.
- Place the new license in the bin sub-directory of the Virtuoso installation.
- Set and export an OPL_LICENSE_DIR environment variable that passes the path to the directory that contains your Virtuoso license file, e.g
-
export OPL_LICENSE_DIR="/opt/virtuoso/bin/"
-
OPL_LICENSE_DIR="/opt/virtuoso/bin/" ; export OPL_LICENSE_DIR
- Execute the command: oplmgr +start
2.7.1.1.4. Retrieve OpenLink Licenses from Your ODS Briefcase
OpenLink's registered users receive an automatic OpenLink Data Spaces (ODS) account on
the My OpenLink home page. This account allows registered users to experience and explore OpenLink's
Virtuoso Universal Cilent applications.It also provides a convenient storage mechanism for OpenLink
commercial and evaluation license keys.
This page shows you how to access licenses that reside in your ODS Briefcase. A second
15 Day evaluation license is automatically copied to the Briefcase, when you download our software and
receive your first 15 Day key. You may access the Briefcase by clicking on the link that appears in the
email that contains the first license. Alternatively, you may identify the ODS url by logging into the
OpenLink site.
The following instructions will allow you to access your ODS Briefcase via the OpenLink
Web site.
- Click the Login link that appears on the OpenLink Web page.
- Click the "Login Here" button that appears in the Registered Users box.
- Click the "Check my profile" link that appears in the Welcome box.
- Click the ODS Service URL that appears in the lower right hand corner of the My Details dialog.
- Allow the My OpenLink Web page to load in a Web browser.
- Login to your OpenLink Data Space using your OpenLink login.
- Click the Briefcase link that appears in the ODS menu bar at the top of the page.
- Your license will appear as a Resource Item under the Briefcase Summary.
Click the license link to download your license. Provide your OpenLink username and
password if prompted for a DAV login.
2.7.1.2. License Preservation
Users may choose to preserve the existing license file when applying a new license file. This facilitates a rollback to the original file, if the replacement file is problematic.
2.7.1.2.1. Mac OS X
- Use StuffIt or a similar utility to store the file in a compressed archive.
- Rename the file, e.g., from virtuoso.lic to virtuoso.lic-old
2.7.1.2.2. Windows
Use WinZip or a similar utility to copy your license file to a .zip archive.
2.7.1.2.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
Use tar or gzip to copy your license file into an archive. For example: tar cvzf virtuoso-lic.tgz virtuoso.lic
2.7.1.3. License Removal
Users may choose to remove expired or deprecated license files altogether to ensure the uptake of a new license file.
2.7.1.3.1. Mac OS X
- Shutdown your OpenLink License Manager
- Click the Search icon.
- Type your license name into the search box. For example: virtuoso.lic
- Drag the license from the search results onto the trash icon.
- Expand the Finder menu.
- Click Empty Trash.
2.7.1.3.2. Windows
- Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
- Locate and select the OpenLink Virtuoso service.
- Click the Stop icon.
- Locate and select the OpenLink License Manager service.
- Click the Stop icon.
- Launch the Windows Search utility, from the Start menu.
- Search for all files with the name virtuoso.lic.
- Drag all found licenses to the Recycle Bin.
- Empty the Recycle Bin
2.7.1.3.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
- Login to the Unix or Linux operating system.
- Use the find command to locate relevant license files, and check their permissions and ownership.
bash-2.03$ find / -name virtuoso.lic -exec ls -l {} \;
-rw-r--r-- 1 virtuoso other 645 Mar 11 08:06 /usr/virtuoso/bin/virtuoso.lic
bash-2.03$
- Use the rm command to remove the license file(s).
bash-2.03$ rm /usr/virtuoso/bin/virtuoso.lic
-
If the file permissions and ownership require, you can use sudo -
bash-2.03$ sudo rm /usr/virtuoso/bin/virtuoso.lic
Password:
bash-2.03$ ls /usr/virtuoso/bin/virtuoso.lic
bash-2.03$
- or su to the appropriate user or group -
bash-2.03$ su virtuoso
Password:
bash-2.03$ rm /usr/virtuoso/bin/virtuoso.lic
bash-2.03$ ls /usr/virtuoso/bin/virtuoso.lic
bash-2.03$
2.7.2. License Manager
2.7.2.1. Monitor License Consumption
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 dba 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.
2.7.2.2. Start the License Manager Process
2.7.2.2.1. Mac OS X
- Launch Terminal.app (/Applications/Utilities/)
- Execute the command cd "/Library/Application Support/openlink/bin/"
- Execute the command oplmgr +start
2.7.2.2.2. Windows
- Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
- Locate and select the OpenLink Virtuoso service.
- Click the Start icon.
2.7.2.2.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
- Open a Unix terminal.
-
cd 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.)
-
. ./virtuoso-enterprise.sh - bash, bsh, ksh, and related shells
-
. ./virtuoso-enterprise.csh - csh, tcsh, and related shells
- Execute the command: oplmgr +start
Note: OpenLink recommends that you create an /etc/init.d/
script that sets the environment and runs oplmgr +start at boot time.
2.7.2.3. Stop the License Manager Process
2.7.2.3.1. Mac OS X
- Launch Terminal.app (/Applications/Utilities/)
- Execute the command cd "/Library/Application Support/openlink/bin/"
- Execute the command oplmgr +stop
2.7.2.3.2. Windows
- Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
- Locate and select the OpenLink License Manager service.
- Click the Stop icon.
2.7.2.3.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
- Open a Unix terminal.
-
cd 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.)
-
. ./virtuoso-enterprise.sh - bash, bsh, ksh, and related shells
-
. ./virtuoso-enterprise.csh - csh, tcsh, and related shells
- Execute the command: oplmgr +stop
2.7.2.4. Reinitialize the License Manager Process
2.7.2.4.1. Mac OS X
- Launch Terminal.app (/Applications/Utilities/)
- Execute the command cd "/Library/Application Support/openlink/bin/"
- Execute the command oplmgr +reload
2.7.2.4.2. Windows
- Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
- Locate and select the OpenLink License Manager service.
- Click the Restart icon.
2.7.2.4.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
- Open a Unix terminal.
-
cd 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.)
-
. ./virtuoso-enterprise.sh - bash, bsh, ksh, and related shells
-
. ./virtuoso-enterprise.csh - csh, tcsh, and related shells
- Execute the command: oplmgr +reload
2.7.2.5. Additional Usage Notes
The license manager takes several command-line arguments, as revealed by its "usage" output (produced by any unrecognized argument) --
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
2.7.3. Debugging License Problems
Virtuoso license problems are easy to debug. The following information provides a
conceptual framework and troubleshooting tips suitable for all licensing problems.
2.7.3.1. Identifying License Problems
License problems occur when users attempt to apply them to products or when they hit a
ceiling associated with concurrent usage. Most license errors are explicit and include text that
states that a license is invalid, expired, or exceeded. Problems associated with performance or
stability problems that do not produce license related errors are not likely to be caused by licenses.
There is no scenario in which use of an evaluation key would contribute to limited functionality.
OpenLink's products are fully functional regardless of the license key applied. The license key simply
dictates the length of time for which a product may be used.
2.7.3.2. Source of License Problems
Licenses problems appear under the following circumstances:
- A license file is ftp'd in ASCII.
- The license covers a different OpenLink product.
- The license covers a different OpenLink release.
- A machine has more physical Processor cores than allotted for by the license.
- The license can not be found.
- The wrong license is being found.
- You did not perform the appropriate steps to register the license.
- The License Manager process needs to be restarted.
- The license is inadequate for your level of concurrent activity
2.7.3.3. Troubleshooting License Problems
Use the following tips to resolve your licensing tips or supply OpenLink Technical Services with your findings:
- FTP all licenses (virtuoso.lic) in binary mode.
- Review the terms of the email that contained the license.
- Ensure that the license that you have received is for Virtuoso Universal Server and not a data access provider or driver.
- Compare the Virtuoso version on your machine with the version covered by the license key.
- Identify the number of physical Processor cores on the box that hosts the license and ensure those cores are covered by the license key.
- Use OpenLink's licensing guidelines to ensure that the license is placed in the appropriate location on the target machine.
- Use the host machine's search utilities to ensure that expired or deprecated license files are removed from the host machine and deleted from the trash.
- Use OpenLink's licensing guidelines to ensure that you have performed the license application procedure using the correct steps in the appropriate order.
- Use the host monitoring utilities to ensure that applicable processes have been restarted as detailed in OpenLink's licensing guidelines.