VCollab - Named User License

Access to licenses can be controlled with an options file that is configured with the settings you would prefer to use. Use of the options file is optional and isn’t required for normal license operation. This page talks about the the Named User License mechanism that dedicates licenses to predefined users in the organization. The Users must be specified in ‘INCLUDE’ statements in the end-user options file.

Creating an Options File

  • Use any text editor to create the options file

  • Add the required command statements needed to handle the Named User License in the options file

  • Save it as VE3D.opt in the directory where the license file is present.

Setup Named user Licensing

  • Open the license file in the text editor

  • Add the ‘VE3D.opt’ in the VENDOR line of the license file.

  • Save the license file

  • Reread the License file on the Server. On Window Server, Use the Reread the License file option on the Start/Stop/Reread tab in LMTOOLS utility

For example :
VENDOR VE3D VE3D.opt
or
VENDOR VE3D options=C:\VCollab_License\VE3D.opt

Note

Check the log file to be sure that the options file has been read. If it wasn’t, stop and restart the license server.

Allocating License to Specific User

Use the following command to allocate a specific license feature to a user

INCLUDE [license_feature] [USER] [username]

For example :
INCLUDE VCollabPro USER Bob
This statement allocates the ‘VCollabPro’ license feature to the user ‘Bob’

Allocating License to a group of users

Use the following command to create a group

GROUP [groupname] [user1] [user2] [user3]

For example :
GROUP VCOLLABPRO_USERS Bob John Smith

Now Allocate a license feature to a group

INCLUDE [license_feature] [GROUP] [groupname]


For example :
GROUP VCOLLABPRO_USERS Bob John Smith
INCLUDE VCollabPro GROUP VCOLLABPRO_USERS
Here, the VCollabPro license feature is allocated to the users namely Bob, John, and Smith

Note

The user names are case-sensitive

Disable case sensitivity for user names

You can enable/disable case sensitivity for usernames when you use the GROUP commands. By default, user names are case-sensitive.

The GROUPCASEINSENSITIVE statement disables (ON) and enables (OFF) case sensitivity for user names:

GROUPCASEINSENSITIVE ON
GROUPCASEINSENSITIVE OFF

For example,
GROUPCASEINSENSITIVE ON
GROUP VCOLLABPRO_USERS Bob John Smith
INCLUDE VCollabPro GROUP VCOLLABPRO_USERS
Here, the user names are not the case-sensitive

Example

GROUPCASEINSENSITIVE ON
GROUP VCOLLABPRO_USERS Bob John Smith
INCLUDE VCollabPro GROUP VCOLLABPRO_USERS
INCLUDE VCollabPresenter USER John
Here, the ‘VCollabPro’ license feature is allocated to the group of users (Bob, John, and Smith)
and the ‘VCollabPresenter’ license feature is allocated to the user (John)

Troubleshooting

How to troubleshoot if the VCollab application reports the following error

image1

Resolution:

  • Make sure the username is included in the options file

  • Make sure the username is correct. (The username is case-sensitive)