Solutions

How to configure Version Manager to use a single license per user when users simultaneously login from multiple workstations



ID:    S140767
Published:    29 September 2014
Updated:    12 July 2021

Operating System(s)

  • All Unix
  • All Windows

Product(s)

  • PVCS Version Manager
 

Description

As of VM 8.6.2, Version Manager defaults to using a single license per user ID, regardless of how many workstation the users logs in from.
 
VM 8.6.1 and older default to using one license per-user per-host, so the same user trying to simultaneously login from two computers (e.g. end-user workstation and test lab computer) requires two licenses.
 
This document shows how to change the default behavior for VM 8.3.0 and newer.
 

Resolution

As of PVCS VM 8.3, Version Manager has an ignore-host feature that allows it to consume only one license per user ID, regardless of how many hosts (workstations) the user logs in from.
 
This feature can be enabled or disabled without problems if Version Manager exclusively uses licenses of type VersionManager and not any of type Professional. The license type(s) you are using can be found on the Products tab of the License Manager GUI (SLM).
 
If you have any Professional licenses and use Version Manager simultaneously with SBM, TeamTrack or Tracker, the following rules apply:
 
  • You have to enable the ignore-host feature in VM when using it SBM 11.5 or newer, as SBM enables the same feature starting with that release.

    Not doing so would cause users to consume two Professional licenses: one for VM and one for SBM.
     
  • You should not enable the ignore-host feature in VM when using it with SBM 11.4 or older, TeamTrack, or Tracker.

    Doing so would cause users to consume two Professional licenses; one for VM and one for SBM/TeamTrack/Tracker.

    As VM 8.6.2 and newer have the ignore-host feature enabled by default, that means it specificifally has to be disabled in this context.
     
To enable the ignore-host feature, create the environment variable SLM_DONOT_USE_HOSTNAME on the machine where PVCS VM is installed and assign it a value of 1.
 
To disable the ignore-host feature, create the environment variable SLM_DONOT_USE_HOSTNAME on the machine where PVCS VM is installed and assign it a value of 0.
 
  • On Windows, the variable can be set permanently using one of the following commands:
     
    • User variable (for Desktop Client users only):

      setx SLM_DONOT_USE_HOSTNAME 1
       
    • System variable (for Desktop Client users and the Serena VM Web Application Server):

      setx /m SLM_DONOT_USE_HOSTNAME 1
     
  • On Linux/UNIX, set the variable as follows:
     
    • For Bourne shell variants (bash, ksh, sh):

      SLM_DONOT_USE_HOSTNAME=1; export SLM_DONOT_USE_HOSTNAME
       
    • For C-shell variants (csh, zcsh):

      setenv SLM_DONOT_USE_HOSTNAME 1
     
    Placing these statements in /etc/profile.d/pvcs.sh and /etc/profile.d/pvcs.csh respectively will make the variable available to all users after they login.
     
  • VM Desktop Client users need to set this variable on every system running the VM desktop client, either as a system variable or user variable (Windows), or an environment variable (UNIX/Linux).

    Restart the client after making this change.
     
  • VM I-Net Web Client users, WebDAV users and VM RIDE users with server-side processing enabled need this variable to be set on the machine running the Version Manager Web Application Server.

    If this server is running as a service on Windows, the variable has to be a system variable.

    Restart the Version Manager Web Application Server service or process after making this change. (If the OS being used is Windows Server 2003, you have to reboot the machine.)
 
You can confirm the feature is enabled by checking the SLM.log or SerenaLicenseSever.log file on the License Server machine. Licenses checked out by Version Manager should show up as:
 
HH:MM:SS (merant) OUT: "VersionManager" Username@nodenotused
or
HH:MM:SS (merant) OUT: "VersionManager_named" Username@nodenotused
 
as opposed to:
 
HH:MM:SS (merant) OUT: "VersionManager" Username@UsersPCName
or
HH:MM:SS (merant) OUT: "VersionManager_named" Username@UsersPCName
 
CAVEATS:
 
  • If there are users running both the VM I-Net web client and the VM desktop client (including IDE integrations), be sure to enable the feature on the server and the client. If you do not, a PC simultaneously running a desktop client and a web client would consume two licenses because the hostname would be reported differently by both.
     
  • The ignore-host feature is enabled by default as of VM 8.6.2.
     
    • If VM 8.6.2 or newer shares Professional licenses with SBM 11.4 or older, TeamTrack, or Tracker, you need to specifically disable the feature on VM 8.6.2+ to avoid double license use.
      Do this by setting SLM_DONOT_USE_HOSTNAME to 0.
       
    • If VM 8.6.2 or newer is not using Professional licenses, but is used simultaneously with clients running:
       
      • VM 8.3 - 8.6.1: you need to specifically enable the feature on the VM 8.3 - 8.6.1 instances to avoid double license use.
        Do this by setting SLM_DONOT_USE_HOSTNAME to 1.
         
      • VM 8.2 or older: you need to specifically disable the feature on instances rurnning VM 8.6.2+ to avoid double license use.
        Do this by setting SLM_DONOT_USE_HOSTNAME to 0.
         
  • If you are using a merant.opt file, please note that you can no longer use hostname restrictions for VersionManager licenses after enabling this feature.

 


Rate this Solution

Find Answers

Type a question or describe what you are looking for below

My Recent Searches

Welcome kb sso

Additional Assistance

  • Submit a Case Online
  • FAQs