www.openlinksw.com
docs.openlinksw.com

Book Home

Contents
Preface

Installation Guide

Virtuoso on All platforms Commmon Specifics
Virtuoso for Windows
Virtuoso for Linux (Enterprise Edition)
Virtuoso for Unix (Enterprise Edition)
Virtuoso for Unix (Personal Edition)
Virtuoso for Mac OS X
OpenLink License Management
License Files License Manager Debugging License Problems
Virtuoso ADO.Net Data Grid Form Application
Using Visual Studio 2008 to Build an Entity Frameworks based Windows Form Application
Using Visual Studio 2008 to Build an ADO.NET Data Services based Application
Windows Form Application for accessing Virtuoso RDF data via SPASQL using the Virtuoso ADO.Net Provider
Creating a Web Browser Application to Access RDF Data Using The Virtuoso ADO.Net Provider
Creating a Silverlight Application to consume the service
Creating A Simple .NET RIA Services Application To Display Data From Virtuoso
Creating a .Net RIA Services Application That Will Update Virtuoso Data
Cluster Installation and Config

2.7. OpenLink License Management

2.7.1. License Files

2.7.1.1. License Activation

2.7.1.1.1. Mac OS X
  1. Launch Terminal.app (/Applications/Utilities/)
  2. Execute the command cd "/Library/Application Support/openlink/bin/"
  3. Execute the command oplmgr +stop
  4. Retrieve your new Virtuoso license file from an email or ODS Briefcase.
  5. 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.)
  6. Execute the command oplmgr +start

2.7.1.1.2. Windows
  1. Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
  2. Locate and select the OpenLink License Manager service.
  3. Click the Stop icon.
  4. Retrieve your new Virtuoso license file from an email or ODS Briefcase.
  5. 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.)
  6. Go back to the Services Control Panel.
  7. Locate and select the OpenLink License Manager service.
  8. Click the Start icon.

2.7.1.1.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
  1. Open a Unix terminal.
  2. cd into the root of your Virtuoso installation.
  3. 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
  4. Execute the command: oplmgr +stop
  5. 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.
  6. Place the new license in the bin sub-directory of the Virtuoso installation.
  7. 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
  8. 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.

  1. Click the Login link that appears on the OpenLink Web page.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  2. Click the "Login Here" button that appears in the Registered Users box.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  3. Click the "Check my profile" link that appears in the Welcome box.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  4. Click the ODS Service URL that appears in the lower right hand corner of the My Details dialog.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  5. Allow the My OpenLink Web page to load in a Web browser.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  6. Login to your OpenLink Data Space using your OpenLink login.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  7. Click the Briefcase link that appears in the ODS menu bar at the top of the page.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase
  8. Your license will appear as a Resource Item under the Briefcase Summary.
    ODS Briefcase
    Figure: 2.7.1.1.4.1. ODS Briefcase

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

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
  1. Shutdown your OpenLink License Manager
  2. Click the Search icon.
  3. Type your license name into the search box. For example: virtuoso.lic
  4. Drag the license from the search results onto the trash icon.
  5. Expand the Finder menu.
  6. Click Empty Trash.

2.7.1.3.2. Windows
  1. Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
  2. Locate and select the OpenLink Virtuoso service.
  3. Click the Stop icon.
  4. Locate and select the OpenLink License Manager service.
  5. Click the Stop icon.
  6. Launch the Windows Search utility, from the Start menu.
  7. Search for all files with the name virtuoso.lic.
  8. Drag all found licenses to the Recycle Bin.
  9. Empty the Recycle Bin

2.7.1.3.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
  1. Login to the Unix or Linux operating system.
  2. 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$
    
  3. Use the rm command to remove the license file(s).
    bash-2.03$ rm /usr/virtuoso/bin/virtuoso.lic
    
  4. 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.

  1. Launch the Virtuoso Web interface.
  2. Click the Conductor link.
  3. Login with your Virtuoso dba account.
  4. Click the System Admin tab.
  5. Locate the License section to review the terms of your Virtuoso license.
  6. 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
  1. Launch Terminal.app (/Applications/Utilities/)
  2. Execute the command cd "/Library/Application Support/openlink/bin/"
  3. Execute the command oplmgr +start

2.7.2.2.2. Windows
  1. Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
  2. Locate and select the OpenLink Virtuoso service.
  3. Click the Start icon.

2.7.2.2.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
  1. Open a Unix terminal.
  2. cd into the root of your Virtuoso installation.
  3. 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
  4. 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
  1. Launch Terminal.app (/Applications/Utilities/)
  2. Execute the command cd "/Library/Application Support/openlink/bin/"
  3. Execute the command oplmgr +stop

2.7.2.3.2. Windows
  1. Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
  2. Locate and select the OpenLink License Manager service.
  3. Click the Stop icon.

2.7.2.3.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
  1. Open a Unix terminal.
  2. cd into the root of your Virtuoso installation.
  3. 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
  4. Execute the command: oplmgr +stop


2.7.2.4. Reinitialize the License Manager Process

2.7.2.4.1. Mac OS X
  1. Launch Terminal.app (/Applications/Utilities/)
  2. Execute the command cd "/Library/Application Support/openlink/bin/"
  3. Execute the command oplmgr +reload

2.7.2.4.2. Windows
  1. Launch the Services Control Panel (may be in the Administrative Tools sub-folder).
  2. Locate and select the OpenLink License Manager service.
  3. Click the Restart icon.

2.7.2.4.3. Unix-like OS (AIX, HP-UX, Linux, Solaris, etc.)
  1. Open a Unix terminal.
  2. cd into the root of your Virtuoso installation.
  3. 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
  4. 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:


2.7.3.3. Troubleshooting License Problems

Use the following tips to resolve your licensing tips or supply OpenLink Technical Services with your findings: