Vcast Install Guide

New editions of this guide incorporate all material added or changed since the previous edition.
Update packages may be used between editions. The manual printing date changes when a
new edition is printed. The contents and format of this manual are subject to change without
notice.
Generated: 7/14/2024, 8:30 PM
Rev: 447e070
Part Number: VectorCAST Installation Guide for VectorCAST 2024
VectorCAST is a trademark of Vector Informatik, GmbH
© Copyright 2024, Vector Informatik, GmbH All rights reserved. No part of the material
protected by this copyright notice may be reproduced or utilized in any form or by any means,
electronic or mechanical, including photocopying, recording, or by any informational storage
and retrieval system, without written permission from the copyright owner.
U.S. Government Restricted Rights
This computer software and related documentation are provided with Restricted Rights. Use,
duplication or disclosure by the Government is subject to restrictions as set forth in the
governing Rights in Technical Data and Computer Software clause of
DFARS 252.227-7015 (June 1995) and DFARS 227.7202-3(b).
Manufacturer is Vector North America, Inc. East Greenwich RI 02818, USA.
Vector Informatik reserves the right to make changes in specifications and other information
contained in this document without prior notice. Contact Vector Informatik to determine
whether such changes have been made.
Third-Party copyright notices are contained in the file: 3rdPartyLicenses.txt, located in the
VectorCAST installation directory.
2
TABLE OF CONTENTS
Introduction 5
Overview 6
Platforms 6
VectorCAST 6
FlexNet Publisher 7
Vector License Client 7
VectorCAST Installer Passwords 8
Decrypting VectorCAST Installers 9

For a Windows Installer 9
For a Linux Installer 9
Installing VectorCAST on Windows 10
Overview 11
Install VectorCAST on Windows 11
Running VectorCAST on Windows 12
Installing FlexNet Publisher (the FLEXlm License Server) on Windows 13
Overview 14
Request a License Key 14
Instructions for Obtaining the Host/Node Name and Host ID 15
Install the License Key 16
Start the License Server 17
Installing the Vector License Client on Windows 20
Overview 21
Install the Vector License Client on Windows 21
Installing VectorCAST on Linux 23
Overview 24
Install VectorCAST on Linux 24
Running VectorCAST on Linux 24
Installing FlexNet Publisher (the FLEXlm License Server) on Linux 26
3
Overview 27
Request a License Key 27
Instructions for Obtaining the Host/Node Name and Host ID 27
Install the License Key 28
Start/Stop the License Server 29
Installing the Vector License Client on Linux 30
Overview 31
Install the Vector License Client on Linux 31
Upgrading VectorCAST 33
Upgrading VectorCAST 34
Legacy Named User Licensing 35
Legacy Named User Licensing 36

Named User License File 36
Additional Notes on Named User Licenses 38
Index 39
4
Introduction
OVERVIEW 6
Overview
The following sections guide you through the process of installing VectorCAST along with the license
management software.
VectorCAST is license managed using one of two systems. You will use either the legacy license
management implemented with FlexNet Publisher (previously known as FLEXlm™) or the New Vector
License Management (NVLM) implemented with the Vector License Client (VLC).
The legacy VectorCAST license management uses FlexNet Publisher (previously known as
FLEXlm™) as the license server. A User Guide for FlexNet Publisher is shipped with VectorCAST and
can be found in the VectorCAST installation directory, under docs/PDF/. It is also available on the
VectorCAST Download page at https://www.vector.com/vectorcast-downloads.
The New Vector License Management uses the Vector License Client (VLC) for license management.
The Help function in the VLC provides information on how to use the VLC to setup your license. This
Installation Guide will guide you to where to find this information and give any steps that are specific to
VectorCAST. Additional information on the VLC is found on the Vector website. This includes
KnowledgeBase articles to help with specific situations.
Please note that all VectorCAST products (for example, VectorCAST/C++ Desktop Edition), are
included in the downloaded installer executable. FlexNet Publisher is also included with the
downloaded installer. The VLC is available from the vector.com Download Center.
If you experience any problems, please contact Technical Support at:

Email: [email protected]
Web: https://support.vector.com
Platforms
VectorCAST
VectorCAST is available for two platforms, 64-bit Windows and 64-bit Linux.
Windows 64-bit
The following Windows platforms are supported (64-bit version only):
> Windows 11
> Windows 10
> Windows Server 2012 R2
> Windows 8.1
> Windows Server 2012
> Windows 8
> Windows Server 2008 R2 Service Pack 1 (SP1)
> Windows 7 SP1
> Windows Server 2008 Service Pack 2 (SP2)
> Windows Vista SP2
Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

PLATFORMS 7
For the Windows 64-bit VectorCAST, your machine needs to have the Windows Universal C Runtime
(CRT) installed. Universal CRT Deployment | Microsoft Docs
The version requirements for FlexNet Publisher are listed in "Upgrading VectorCAST" on page 34. Note
that if you are using FlexNet Publisher 11.16.4 or higher, then the Windows Universal C Runtime (CRT)
is required.
Linux 64-bit
For Linux host platforms, the minimum system requirements are:
> Any 64-bit Linux distribution with the GNU C Library (glibc) version 2.5 or later.
> FlexNet Publisher also requires that the LSB package for your Linux platform be installed.
Certain parts of VectorCAST, mainly those related to GUIs driven by Python, rely on the Qt5 toolkit,
which has further system-wide dependencies. VectorCAST functionality relying on Qt5 includes
features such as the RSP Configurator and Requirements Gateway integrations. To run these features,
VectorCAST follows the minimum requirements for Qt5:
> GNU C Library (glibc) version 2.17 or later

> Kernel version of 3.10.0 or later
These dependencies are not mandatory and are only necessary if you wish to run Qt5-driven
functionality.
In addition, the Linux host will require support for X11 if you intend to run the VectorCAST GUI.
FlexNet Publisher
The version requirements for FlexNet Publisher are listed in "Upgrading VectorCAST" on page 33. Note
that if you are using FlexNet Publisher 11.16.4 or higher, then the Windows Universal C Runtime (CRT)
is required.
Vector License Client

The Vector License Client is available for both Windows and Linux. The currently supported operating
systems for VLC can be found in the KnowledgeBase article: "Operating Systems Supported by Vector
Products".

VectorCAST Installer Passwords
DECRYPTING VECTORCAST INSTALLERS 9
Decrypting VectorCAST Installers

VectorCAST provides encrypted (password protected) installers available on the Vector website at
https://www.vector.com/vectorcast-downloads/.
The password for the installers is changed for each major version and kept the same for all service
packs of that major version. For example, the same password will be used for VectorCAST 2023 SP5,
VectorCAST 2023 SP6 and VectorCAST 2023 SP7. A new password is created for VectorCAST 2024
and will continue to be used for all service packs for VectorCAST 2024.
Customers receive the password for the encrypted installers in the e-mail for their VectorCAST
software license key.
You may also contact Technical Support at:

For a Windows Installer

The installers are provided in a .zip file. For example, the file name for the VectorCAST 2024 64-bit
Windows installer is vcast.win64.2024-encrypted.zip. When an unzip utility is used to extract
the .zip file, a password is required. Enter the password and the extraction continues.
For a Linux Installer

The installers are in a TAR.GZ file. For these files, GPG (GNU Privacy Guard) technology is used to
encrypt the installer archive. If you do not have access to the GPG utility on your Linux distribution, then
please request an unencrypted version from Vector Support. The command to decrypt the installer file
is:
echo "[passphrase]" | gpg --no-mdc-warning --batch --passphrase-fd 0 -d

[release tar] | tar -xzvf -
To assist with the decryption of the Linux installers, you may want to create a helper utility. An example
is given below:
unencrypt.sh:
#!/bin/sh
# Usage: unencrypt.sh <passphrase> <release_archive>
echo "$1" | gpg --no-mdc-warning --batch --passphrase-fd 0 -d "$2" | tar -xzvf
-
For more information, see the Vector KnowledgeBase article "VectorCAST Software Installer
Password".

Installing VectorCAST on Windows
OVERVIEW 11
Overview
This section takes you through all the steps necessary to install VectorCAST on a Windows platform.
Note: It has been reported that the Cortex XDR may report an issue when using VectorCAST.
Please consult the user documentation for Cortex XDR for possible workarounds.
Install VectorCAST on Windows

Note: If you have VectorCAST already installed on your computer and the current version is 5.2
or older, before installing you must uninstall the old version by going to the Windows Start menu
and selecting Control Panel => Programs => Uninstall a Program. Locate VectorCAST and
select Uninstall.
To install VectorCAST on a Windows platform, perform the following steps:
1. Unzip the VectorCAST distribution file (vcast.win64.version.zip). If a password is

required, see "VectorCAST Installer Passwords" on page 8 for a Windows Installer.
2. Double-click on the setup.exe application. The VectorCAST software displays a Welcome page.
3. Click Next on the Welcome page. The License Agreement is displayed. Click “I accept the terms
of the license agreement”.
4. Click Next and select the Setup Type:
l Complete: This selection installs all release files.
l (FLEXlm License Server: Select this option if you only wish to install the Legacy
License Server at this time.)
5. Click Next and select an installation directory.
The default directory is (C:\VCAST). The installation directory must not already contain a
VectorCAST install.
Note: The directory path you use must not include spaces, or letters with umlauts or
accents. Allowed characters are A-Z a-z 0-9 [!#$%&'()+-,=@^_`{}~]
Also, the directory path must not contain an instance of VectorCAST. If you wish to reuse
a directory path, VectorCAST must first be removed.
6. Click Next.
The Installer begins to install VectorCAST.
Once this is complete, the Installer will check if the Current VECTORCAST_DIR setting is
different from the New VECTORCAST_DIR setting. If so, the Installer will ask if you want to
modify the current VECTORCAST_DIR to the use the new value. The New value will point to the
directory VectorCAST was just installed to. Select Yes to use the new installation of VectorCAST
or select No to continue to point to the old installation.
The Installer will then check to see if it can find a valid license for VectorCAST. If no valid license
is detected, a window will appear directing you to this guide to find instructions for setting up a
license. Click OK to move past this informational window.
Installation is now complete.
7. Click the Finish button to exit the Installer.

RUNNING VECTORCAST ON W INDOWS 12
Running VectorCAST on Windows

To run VectorCAST on Linux, set the VECTOR_LICENSE_FILE environment variable to use the
correct License Server, and set the VECTORCAST_DIR environment variable to point to the location in
which VectorCAST is installed.
For example, if the VectorCAST installation location is C:\VCAST, set VECTORCAST_ DIR to point to
that directory as follows:
SET VECTORCAST_DIR=C:\VCAST
Then set VECTOR_LICENSE_FILE to use the correct license server.
For FLEXlm, set VECTOR_LICENSE_FILE to port@server, where port is the port number in the
VectorCAST license file (the default port is 27000), and server is the Host Name of the License Server.
SET VECTOR_LICENSE_FILE=27000@HostName
For VLC, unset VECTOR_LICENSE_FILE.
SET “VECTOR_LICENSE_FILE=”

Installing FlexNet Publisher (the FLEXlm
License Server) on Windows
OVERVIEW 14
Overview
This section takes you through all the steps necessary to install FlexNet Publisher (the FLEXlm
License Server) on a Windows platform. The software for the server can be installed either through the
VectorCAST Product Installer or it can also be downloaded directly from the VectorCAST download
page.
These instructions are written using Windows 10. Other Windows versions may be slightly different.
One item to be aware of is what directory FlexNet Publisher will be run from. The default directory can
be different depending on how you have installed FlexNet Publisher. There are three install scenarios:
> Scenario 1 - Install from the VectorCAST Product Installer and select "Complete" as the setup
type.
> Scenario 2 - Install from the VectorCAST Product Installer and select "FLEXlm License Server"
as the setup type.
> Scenario 3 - Install from the standalone FLEXlm distribution installer (e.g. fnp_11_18_0_
win86_64.zip)
For Scenario 1, FLEXlm is installed in the same directory as the VectorCAST under the folder
FLEXlm. By default the location will be C:\VCAST\FLEXlm.
For Scenario 2, FLEXlm is installed in the directory you choose. The default directory will be
C:\VCAST\FLEXlm.
For Scenario 3, FLEXlm is distributed as a zip file and there is no installer. The FLEXlm files will be in
the directory you unzip the archive to.
The Host/Node Name and Host ID are used by FLEXlm to establish "binding elements". If the binding
elements change, the license is no longer valid. This can be challenging in a cloud environment or on
virtual machines where the MAC address and Disk Serial Numbers are not reliably consistent. To
address this issue, a UUID (universally unique ID) can be used as the Host ID. If the license server will
be run in a cloud environment or on a virtual machine, use UUID as the Host ID type. You cannot get a
UUID on a physical machine (error -211). Details on supported virtual or cloud platforms is included in
the FlexNet Publisher License Administration Guide.
Request a License Key

Before filling out the Software License Key Request form, you need to determine the Host/Node Name
and Host ID of the License Server. The Host ID can be supplied in one of three ways:
> MAC address,

> Disk Serial Number, and
> UUID.
The following instructions can be used to find the Host/Node Name and the Host ID.
Note: If you are setting up a three-server redundant triad, special instructions are needed.
Please contact Technical Support at:

REQUEST A LICENSE KEY 15
Instructions for Obtaining the Host/Node Name and Host ID

Go to the directory where you have your FLEXlm files. In this directory, there is a file called
lmutil.exe. Open a command prompt in this directory.
1. Host/Node Name
To get the Host/Node Name, type:
hostname or ipconfig/all
2. Host ID
> To get the Host ID as a MAC address, type:
lmutil.exe lmhostid -n
> To get the Host ID as a Disk Serial Number, type:
lmutil.exe lmhostid -vsn
> To get the Host ID as a UUID, type:
lmutil.exe lmhostid -ptype VM -uuid
>> If you receive an error (-213), then the FlexNet Licensing Service is not installed :
lmhostid: The FlexNet Licensing Service is not

installed. (-213,14703)
>> If the service is not installed, install the service by typing the following in the command
prompt:
installanchorservice.exe vector clicast.exe
>> Then type the following again:
lmutil.exe lmhostid -ptype VM -uuid
3. Use this information to fill out the VectorCAST License Key Request form (available on our
web site at https://www.vector.com/int/en/lp/us/vectorcast-license-key-request/), then
submit the form to Vector.
Note: If you are using a UUID Host ID, be sure the FlexNet Licensing Service that supplies the
UUID is running.

INSTALL THE LICENSE KEY 16
Install the License Key

When you receive a license key from Vector, install your key as follows:
1. Save the license-key file (delivered as an e-mail attachment) to a location on the License Server.

START THE LICENSE SERVER 17
A typical license-key file looks like this:
SERVER hypatia B8CA3AB69B62 27000

DAEMON vector C:\VCAST\flexlm\vector
## Full Evaluation License (Windows /Linux /Solaris) 8 seat Expires 13-Mar-2015
PACKAGE VCAST_PKG_1 vector 6.3 177620FB8280 \
COMPONENTS="VCAST_EVALUATION_KEY_0799 \
VCAST_EVALUATION_KEY_0899 VCAST_EVALUATION_KEY_0299" \
OPTIONS=SUITE
## Full Evaluation License (Windows /Linux /Solaris) 8 seat Expires 13-Mar-2015
(background)
PACKAGE VCAST_PKG_2 vector 6.3 55EE1B85885D \
COMPONENTS="VCAST_EVALUATION_KEY_0700 \
VCAST_EVALUATION_KEY_0800 VCAST_EVALUATION_KEY_0200" \
OPTIONS=SUITE
## 8 seat Expires 13-Mar-2015
FEATURE VCAST_PKG_1 vector 6.3 13-mar-2015 8 E16674379C09 \
VENDOR_STRING="CUST:Eval:Vector Informatik, GmbH:" \
START=14-Jan-2015 TS_OK
## 8 seat Expires 13-Mar-2015(background)
FEATURE VCAST_PKG_2 vector 6.3 13-mar-2015 8 1E91A3C96ADC \
VENDOR_STRING="CUST:Eval:Vector Informatik, GmbH:" \
START=14-Jan-2015 TS_OK
## VectorCAST/Manage (Windows /Linux /Solaris)
PACKAGE VCAST_PKG_3 vector 6.3 2DFA223A6D0A \
COMPONENTS="VCAST_MANAGE_0700 VCAST_MANAGE_0800 \
VCAST_MANAGE_0200" OPTIONS=SUITE
##
In this example, the Host name of the machine that is serving the license is hypatia, the HostID is
B8CA3AB69B62, and the license is being served from port 27000. The path to the vector daemon
is C:\VCAST\flexlm\vector.
2. If necessary, modify the DAEMON line in the license-key file to point to the location of the
vector.exe vendor daemon on the license server. For example:
DAEMON vector c:\VCAST\flexlm\vector
Start the License Server

To start FLEXlm on the License Server:
1. Run the program lmtools found in the installation directory for FLEXlm. (Refer to the
screen shot in Step 2 below).
2. Click the Config Services tab. The following screen appears:

In the Service Name field, enter a new name, such as Vector License Server.
3. Use the Browse button associated with Path to the lmgrd.exe file to enter the full
pathname for lmgrd.exe.
By default, this file is located at C:\vcast\FLEXlm\.
If you installed VectorCAST in a different directory, use that path instead of C:\vcast.
4. Use the Browse button associated with Path to the license file to enter the full path name
for the VectorCAST license key (hostname.lic).
This file is located in the directory in which you stored it in "Install the License Key" on page
16.
5. In the Path to the debug log file field, enter the full pathname for a debug log file.
If this folder does not exist, you must create it first.
6. Check the box preceding Use Services.
7. If you want the license server to start automatically when the server machine is rebooted,
also select Start Server at Power-Up.
8. Click the Save Service button (upper right), and confirm when asked.
9. Select the Start/Stop/Reread tab at the top of the screen:

10. Click Start Server, then click Reread License File.

11. Exit the LMTools utility: Select File => Exit, or click the close icon ( ).

For answers to frequently asked questions, and to access FLEXlm user help (the FlexNet
License Administration Guide), refer to the FlexNet License Adminstration Guide available in
PDF format. The guide is found on the VectorCAST download page
(https://www.vector.com/vectorcast-downloads) or in the VectorCAST distribution under
docs/pdf.

Installing the Vector License Client on
Windows
OVERVIEW 21
Overview
Important: To use VectorCAST with the Vector License Client, the environment variable VECTOR_
LICENSE_FILE MUST be unset. Otherwise, it will use the FLEXlm license server.
The Vector License Client is used not only for VectorCAST but also for many other Vector products. If
you already have the Vector License Client installed, there is no need to re-install it. The licenses for
VectorCAST can be set up with your existing client; however, updating to the latest version of the client
is recommended.
Install the Vector License Client on Windows

The Vector License Client is available from the vector.com download site. You can find the downloads
by going to https://www.vector.com/downloads, and then selecting Vector License Client.
From the downloads listing, select the Vector License Client Windows version.
Once selected you will be redirected to a download information page where you can read additional

INSTALL THE VECTOR LICENSE CLIENT ON W INDOWS 22
information about the download. At the bottom of the page, you will see a button labeled Download
now. Select that button and the download will begin. The downloaded file will be a ZIP archive. Extract
the installer file from the archive and run the installer executable. Depending on your Windows settings,
you may be asked to allow the setup program to make changes to your device. You will then see the
setup wizard for the Vector License Client.
Once Vector License Client is installed, you can find additional help by selecting the Help button at the
top of the application.
From the Start Page, you will see a Getting Started section. It is recommended to begin there with help
to setup your license.


Installing VectorCAST on Linux
OVERVIEW 24
Overview
This section takes you through all the steps necessary to install VectorCAST on a Linux platform.
Install VectorCAST on Linux

1. Become the installation user: either log on as the designated user, or use the su command. . For
the purpose of this example, we assume the username is ‘vector’.
2. Create a directory for the VectorCAST installation.
VectorCAST should be installed in a directory visible to all users with appropriate permissions set.
For the purposes of this example, the installation directory is /home/vector/vcast. You
create this directory by entering:
cd /home/vector
mkdir vcast
Set the default directory to the directory just created:
cd vcast
3. Copy the VectorCAST installer to the directory. If the installer is encrypted, see "Decrypting
VectorCAST Installers" on page 9 for a Linux Installer. Enter:
tar -xzvf vcast.platform.version.tar.gz
Set the VECTORCAST_DIR environment variable:

Using sh, enter:
export VECTORCAST_DIR=/home/vector/vcast
Using csh, enter:
setenv VECTORCAST_DIR /home/vector/vcast
Note: If you created a directory other than /home/vector/vcast as the installation directory,
use that path here.
Running VectorCAST on Linux

To run VectorCAST on Linux, set the VECTOR_LICENSE_FILE environment variable to use the
correct License Server, and set the VECTORCAST_DIR environment variable to point to the location in
which VectorCAST is installed.
For example, if the VectorCAST installation location is /home/vector/vcast, set VECTORCAST_

DIR to point to that directory as follows:
Using sh, enter:
export VECTORCAST_DIR=/home/vector/vcast

RUNNING VECTORCAST ON LINUX 25
Using csh, enter:
setenv VECTORCAST_DIR /home/vector/vcast
Then set VECTOR_LICENSE_FILE to use the correct license server.
For FLEXlm, set VECTOR_LICENSE_FILE to port@server, where port is the port number in the
VectorCAST license file (the default port is 27000), and server is the Host Name of the License Server.
For example:
Using sh, enter:
export VECTOR_LICENSE_FILE=27000@HostName
Using csh, enter:
setenv VECTOR_LICENSE_FILE 27000@HostName
For VLC, unset VECTOR_LICENSE_FILE.
Using sh, enter:
unset VECTOR_LICENSE_FILE
Using csh, enter:
unsetenv VECTOR_LICENSE_FILE

Installing FlexNet Publisher (the FLEXlm
License Server) on Linux
OVERVIEW 27
Overview
This section takes you through all the steps necessary to install FlexNet Publisher (the FLEXlm
License Server) on a Linux platform. The software for the server is included within the VectorCAST
installation tree. It can also be downloaded directly from the VectorCAST download page.
These instructions are written using CentOS 8. Other Linux versions may be different.
The Host/Node Name and Host ID are used by FLEXlm to establish "binding elements". If the binding
elements change, the license is no longer valid. This can be challenging in a cloud environment or on
virtual machines where the MAC address is not reliably consistent. To address this issue, a UUID
(universally unique ID) can be used as the Host ID. If the license server will be run in a cloud
environment or on a virtual machine, use UUID as the Host ID type. You cannot get a UUID on a
physical machine (error -211). Details on supported virtual or cloud platforms is included in the FlexNet
Publisher License Administration Guide.
Request a License Key

Before filling out the Software License Key Request form, you need to determine the Host/Node Name
and Host ID of the License Server. The Host ID can be supplied in one of two ways:
> MAC address, or

> UUID.
The following instructions can be used to find the Host/Node Name and the Host ID.
Note: If you are setting up a three-server redundant triad, special instructions are needed.
Please contact Technical Support at:
Instructions for Obtaining the Host/Node Name and Host ID

Go to the directory where you have your FLEXlm files. In this directory is a file called lmutil.exe.
Open a terminal and 'cd' to this directory.
1. Host/Node Name
To get the Host/Node Name, type:
uname -n
2. Host ID
> To get the Host ID as a MAC address, type:
./lmutil lmhostid -n
> To get the Host ID as a UUID, type:
./lmutil lmhostid -ptype VM -uuid

INSTALL THE LICENSE KEY 28
>> If you receive an error (-213), then the FlexNet Licensing Service is not installed :
lmhostid: The FlexNet Licensing Service is not

installed. (-213,14703)
>> If the service is not installed, install the service (run as root):
cd publisher/
./install_fnp.sh --nolsb \
FNPLicensingService/FNPLicensingService
cd ..
>> Then type the following again:
./lmutil lmhostid -ptype VM -uuid
Note: for more command options for the ./install_fnp.sh utility, type ./install_
fnp.sh --help
3. Use this information to fill out the VectorCAST License Key Request form (available on our
web site at https://www.vector.com/int/en/lp/us/vectorcast-license-key-request/), then
submit the form to Vector.
Note: If you are using a UUID Host ID, be sure the FlexNet Licensing Service that supplies the
UUID is running.
Install the License Key

When you have received a License Key from Vector, install it as follows:
1. Save your license-key file (delivered as an e-mail attachment) to a location on the License Server.
For the purposes of this example, the location is /home/vector/flexlm/vector-

FLEXLM.lic.
For example, a typical license-key file looks like this:
SERVER flexlm 0243AC110003

DAEMON vector /home/vector/flexlm/vector
## VectorCAST/C++ (Windows /Linux) 3 seats
PACKAGE EDITION_C_ENT vector 22 F74A8629AC02 \
COMPONENTS="VCAST_C_ENT_0700 CCAST_0701 CCAST_0788 \
VCAST_CBA_0742 PROBE_POINTS_0700 VCAST_MCDC_0740 \
VCAST_REQ_GATEWAY_0772 VCAST_C_ENT_0800 CCAST_0801 CCAST_0888 \
VCAST_CBA_0842 PROBE_POINTS_0800 VCAST_MCDC_0840 \
VCAST_REQ_GATEWAY_0872" OPTIONS=SUITE
FEATURE EDITION_C_ENT vector 22 31-dec-2022 3 40E8217C14A2 \
VENDOR_STRING=CUST:1: START=18-May-2022 TS_OK
In the example above, the name of the machine that is serving the license is flexlm, the HostID is
0243AC110003, and the port is the default 27000. The path to the vector daemon is

START /STOP THE LICENSE SERVER 29
/home/vector/flexlm/vector.
2. Modify the DAEMON line in the license-key file to point to the location of the vector vendor
daemon on the license server. For example,
DAEMON vector /home/vector/flexlm/vector
Start/Stop the License Server

If you require additional information about FLEXlm, a User Guide for FlexNet Publisher is shipped with
VectorCAST and can be found in the VectorCAST installation directory, under docs/PDF/. It is also
available on the VectorCAST Download page at https://www.vector.com/vectorcast-downloads.
1. To start the license manager (FLEXlm) on the License Server, enter:
./lmgrd -c path_to_license_file
2. To view the status of the license server, enter:
./lmutil lmstat
lmutil - Copyright(c)1989-2018 Flexera. All Rights Reserved.
Flexible License Manager status on Thu 10/15/2015 09:10
License server status: 1234@birch
License file(s) on birch: /home/USERS/licenses/birch.lic:
alder: license server UP (MASTER) v11.16.1.0
Vendor daemon status (on birch):
vector: UP v11.16.1.0
3. To stop the license manager on the license server, enter:
./lmutil lmdown -c path_to_license_file
4. To specify the debug log file, enter:
./lmgrd -c path_to_license_file -l path_to_log_file
Note: If you are already using FLEXlm for VectorCAST and receive a new license, you will need
to replace the previous license with the new one and stop and re-start the license server. Be sure
to update the DAEMON line in the new license file.

Installing the Vector License Client on Linux
OVERVIEW 31
Overview
Important: To use VectorCAST with the Vector License Client, the environment variable VECTOR_
LICENSE_FILE MUST be unset. Otherwise, it will use the FLEXlm license server.
The Vector License Client is used not only for VectorCAST but also for many other Vector products. If
you already have the Vector License Client installed, there is no need to re-install it. The licenses for
VectorCAST can be set up with your existing client; however, updating to the latest version of the client
is recommended.
Install the Vector License Client on Linux

The Vector License Client is available from the vector.com download site. You can find the downloads
by going to https://www.vector.com/downloads, and then selecting Vector License Client.
From the downloads listing, select the Vector License Client Linux version. You will see that the Linux
version is supplied on both a DEB and RPM format. You may use whichever format is appropriate for
your Linux distribution.

INSTALL THE VECTOR LICENSE CLIENT ON LINUX 32
Once selected you will be redirected to a download information page where you can read additional
information about the download. At the bottom of the page, you will see a button labeled Download
now. Select that button and the download will begin.
In the archive you will find the file README.md. That file contains instructions on how to install the
Vector License Client on Linux along with any dependencies. The file also shows how to access the
help files for usage instructions.


Upgrading VectorCAST
UPGRADING VECTORCAST 34
Upgrading VectorCAST
Note: This section only applies to the legacy license manager.
Visit the VectorCAST download page on our web site to see if a new version of VectorCAST has been
released. By request, your organization is notified about new releases of VectorCAST. If you decide to
upgrade your VectorCAST installation, you should first determine if you will need to upgrade the
FLEXnet licensing binaries.
> VectorCAST 5.1a and above requires that FLEXlm version 11.7 or above be used.
> VectorCAST 5.1h and above requires that FLEXlm version 11.9 or above be used.
> VectorCAST 6.4a and above requires that FLEXlm version 11.12 or above be used.
> VectorCAST 2018 and above requires that FLEXlm version 11.14.1 or above be used.
To determine the version of the FLEXlm license manager, enter in a Command Prompt in the
installation directory for FLEXlm:
lmutil lmver lmgrd.exe

lmutil - Copyright (c) 1989-2018 Flexera. All Rights Reserved.
FLEXnet Licensing v11.16.1.0 build 239104 (ipv6) i86_n3 (lmgr.lib), Copyright (c) 1989-
2018 Flexera. All Rights Reserved.
If you do need to upgrade your FLEXlm binaries, follow these steps (run from the installation directory
for FLEXlm):
1. Obtain a new license key from Vector.

2. Stop the license server by entering:
lmutil lmstat
lmutil lmdown -c path_to_old_license_file
3. Follow the instructions for installing FlexNet Publisher found in this document.

Legacy Named User Licensing
LEGACY NAMED USER LICENSING 36
Legacy Named User Licensing

A Legacy VectorCAST Named User license file enables a customer to assign VectorCAST product
licenses to specific human users as identified by their network login user name. This section is intended
as an overview of Legacy Named User licenses.
Note: This section does not apply to NVLM Named User Licenses.
Legacy Named User licenses may not be assigned to anonymous or fictitious users. The Legacy
Named User license is implemented using the same FlexNet Publisher licensing technology as the
VectorCAST floating licenses, but the license file is encoded to only allow usage by a sub-set of users.
The association between licenses and users is controlled by the customer through the use of a FlexNet
Publisher License Options file. For more details about the FlexNet utilities, as well as the license and
options file formats, refer to the FlexNet Publisher License Administration Guide. A User Guide for
FlexNet Publisher is shipped with VectorCAST and can be found in the VectorCAST installation
directory, under docs/PDF/.
Named User License File

Your VectorCAST license was sent in an email. The email will have the words “Delivery Note:” at the
beginning of the subject line. The Delivery Note email will have your license file and a sample options
file attached.
The first two lines of the license file attached to the email will look something like this:
SERVER myserver 101234567890ab
DAEMON vector /home/flexlm/vector.exe
In addition to the changes described in the sections on installing the license server, the DAEMON line

will also need to be edited to provide the path and filename of your options file as shown in the example
below.
A Named User license file is different from a floating license file in two ways:
> The DAEMON line specifies the path to a license options file.
> Each FEATURE or INCREMENT line has a “USER-BASED” attribute.
For example, the following named user license file enables three named users for VectorCAST C++
Enterprise:

Additional Notes on Named User Licenses

1. An INCLUDE line is required for each FEATURE or INCREMENT line from the license file.
- If you omit an INCLUDE line, those FEATURES will not be available.
2. A GROUP line makes options file maintenance easier, since you only need to change the list of
users in a single place, rather than changing each INCLUDE line if a user leaves or joins your
project.
3. The number of users in the option file must be less than or equal to the total number of licenses for
that feature. If you provide too many user IDs for a feature, access to that feature will be denied.
4. If a user who is not listed in the options file tries to start VectorCAST, they will get an error dialog:
5. Every instance of the application uses a license, so if one user who is authorized by the License
Options file starts three instances of VectorCAST, then three licenses are consumed.
6. If you edit the options and do lmreread, user changes will not get enabled for 12 hours.
7. The number of userIDs in the options file must be less than or equal to the maximum licensed
users.
- If you provide too many names, you will get the following fatal error in the debug log on the
server:
“USER_BASED license error for EDITION_C_ENT Number of INCLUDE names
(5) exceeds limit of 3”
- If you provide too few names, you will get the following informational message in the debug log:
“Number of INCLUDED entries for USER_BASED feature VECTORCAST_MANAGE
is 2, maximum is 3"

Index: decrypt installers – windows
Index installation directory 24

overview 24
decrypt installers 9
request a license key 27
environment variables
run VectorCAST 24
VECTORCAST_DIR 24
start stop license server 29
find host id 14, 27
linux installation 24
find host/node name 14, 27
named user license file 36
FLEXlm
named user licensing 36
FLEXlm help 19
supported platforms 6
FLEXlm User's Manual 6
flexnet publisher 7
install 14
linux 64-bit 7
lmutil lmdown 34
vector license client 7
lmutil lmstat 34
windows 64-bit 6
lmutil lmver 34
technical support 6, 19
named user licensing 36
unencrypt installers 9
overview 14
upgrading VectorCAST 34
upgrade binaries 34
uuid 14
installation
as host id 14, 27
FLEXlm 14
definition 14
linux 24
vector license client 21, 31
linux overview 24
download linux 31
passwords 9
download windows 21
install linux 31
VectorCAST on linux 24
install windows 21
vlc on windows 21
license management 6
windows 11
overview 21, 31
windows overview 11
supported operating systems 7
installer passwords 9
VECTORCAST_DIR 24
legacy named user licensing 36
vlc
license management 6
see vector license client 21, 31
FLEXlm 6
windows
legacy 6
install the license key 16
install VectorCAST 11
linux
overview 11
install license key 28
request a license key 14
install vector license client 31
run VectorCAST 12
install VectorCAST 24
39
Index: decrypt installers – linux
start the license server 17
40

Vcast Install Guide

Uploaded by

Copyright:

Available Formats

Vcast Install Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Vcast Install Guide

Uploaded by

Copyright:

Available Formats

New editions of this guide incorporate all material added or changed since the previous edition.

Generated: 7/14/2024, 8:30 PM

Part Number: VectorCAST Installation Guide for VectorCAST 2024

VectorCAST is a trademark of Vector Informatik, GmbH

U.S. Government Restricted Rights

DFARS 252.227-7015 (June 1995) and DFARS 227.7202-3(b).

Manufacturer is Vector North America, Inc. East Greenwich RI 02818, USA.

VectorCAST Installer Passwords 8

Decrypting VectorCAST Installers 9

Installing VectorCAST on Windows 10

Installing FlexNet Publisher (the FLEXlm License Server) on Windows 13

Installing the Vector License Client on Windows 20

Installing VectorCAST on Linux 23

Installing FlexNet Publisher (the FLEXlm License Server) on Linux 26

Installing the Vector License Client on Linux 30

Legacy Named User Licensing 35

Legacy Named User Licensing 36

If you experience any problems, please contact Technical Support at:

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

> GNU C Library (glibc) version 2.17 or later

Vector License Client

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Decrypting VectorCAST Installers

You may also contact Technical Support at:

For a Windows Installer

For a Linux Installer

echo "[passphrase]" | gpg --no-mdc-warning --batch --passphrase-fd 0 -d

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Install VectorCAST on Windows

To install VectorCAST on a Windows platform, perform the following steps:

1. Unzip the VectorCAST distribution file (vcast.win64.version.zip). If a password is

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Running VectorCAST on Windows

Then set VECTOR_LICENSE_FILE to use the correct license server.

For VLC, unset VECTOR_LICENSE_FILE.

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Request a License Key

> MAC address,

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Instructions for Obtaining the Host/Node Name and Host ID

> To get the Host ID as a Disk Serial Number, type:

lmutil.exe lmhostid -vsn

> To get the Host ID as a UUID, type:

lmutil.exe lmhostid -ptype VM -uuid

lmhostid: The FlexNet Licensing Service is not

installanchorservice.exe vector clicast.exe

>> Then type the following again:

lmutil.exe lmhostid -ptype VM -uuid

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Install the License Key

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

A typical license-key file looks like this:

SERVER hypatia B8CA3AB69B62 27000

DAEMON vector c:\VCAST\flexlm\vector

Start the License Server

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

Rev: 447e070 VectorCAST Installation Guide for VectorCAST 2024

10. Click Start Server, then click Reread License File.

If you experience any problems, please contact Technical Support at: