Vectorcast Installation Guide for Vectorcast 2021
Total Page:16
File Type:pdf, Size:1020Kb
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/25/2021, 8:48 PM Rev: 33d0493 Part Number: VectorCAST Installation Guide for VectorCAST 2021 VectorCAST is a trademark of Vector Informatik, GmbH © Copyright 2021, 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 Windows 64-bit 6 Linux 64-bit 7 Python 2 to Python 3 Upgrade 8 VectorCAST Installer Passwords 9 Decrypting VectorCAST Installers 10 For a Windows Installer 10 For a Linux Installer 10 Installing VectorCAST on Windows 11 Overview 12 Install VectorCAST on Windows 12 Existing Installed Instances Detected 14 Installing FlexNet Publisher (the FLEXlm License Server) on Windows 17 Overview 18 Request a License Key 18 Instructions for Obtaining the Host/Node Name and Host ID 19 Install the License Key 20 Start the License Server 21 Installing VectorCAST on Linux 24 Overview 25 Install VectorCAST on Linux 25 Running VectorCAST on Linux Clients 25 Installing FlexNet Publisher (the FLEXlm License Server) on Linux 27 Overview 28 Request a License Key 28 Instructions for Obtaining the Host/Node Name and Host ID 28 Install the License Key 29 3 Start/Stop the License Server 30 Upgrading VectorCAST 32 Upgrading VectorCAST 33 Named User Licensing 34 Named User Licensing 35 Named User License File 35 Additional Notes on Named User Licenses 35 Index 37 4 Introduction OVERVIEW 6 Overview The following sections guide you through the process of installing both VectorCAST and the license server for VectorCAST and FlexNet Publisher™. You will need: > A license key for the version of VectorCAST you are running. This guide also shows you how to request a license key. > The installer executable for your platform. VectorCAST 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/LicensingEndUserGuide.pdf. It is also available on the VectorCAST Download page at https://www.vector.com/vectorcast-downloads. Please note that all VectorCAST products (VectorCAST/QA, VectorCAST/C++, and VectorCAST/Ada), are included in the downloaded installer executable. FlexNet Publisher is also included with the downloaded installer. If you experience any problems, please contact Technical Support at: Email: [email protected] Web: www.vector.com/support Platforms VectorCAST and the FlexNet Publisher distributed with 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 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 For the Windows 64-bit VectorCAST, your machine will need 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 33. Note that if you are using FlexNet Publisher 11.16.4 or higher, then the Windows Universal C Runtime (CRT) is required. Rev: 33d0493 VectorCAST Installation Guide for VectorCAST 2021 PLATFORMS 7 Note: For Windows installs, VectorCAST itself does not require administrator privileges to install. However, the VectorCAST installer, for some versions, will attempt to install redistributable packages from Microsoft if they are missing from your installation. Microsoft may require admin privileges to perform the installation of these packages. If you are able to perform the installation with administrator privileges, then you will avoid any issue that may arise from the possible installation of the Microsoft redistributable packages. 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. Depending on your Linux distribution, the following packages are likely to be required. For SUSE-based distributions (e.g. SLES or OpenSUSE): > libxcb-image0 > libxcb-keysyms1 > libxcb-randr0 > libxcb-render0 > libxcb-render-util0 > libxcb-shape0 > libxcb-shm0 > libxcb1 > libxcb-sync1 > libxcb-util1 > libxcb-xfixes0 > libxcb-xinerama0 > libxcb-xinput0 > libxcb-xkb1 For RedHat-based distributions (e.g., RHEL, CentOS, Oracle Linux): > libxcb > xcb-util > xcb-util-image Rev: 33d0493 VectorCAST Installation Guide for VectorCAST 2021 PYTHON 2 TO PYTHON 3 UPGRADE 8 > xcb-util-keysyms > xcb-util-renderutil For Ubuntu/Debian-based distributions: > libxcb1 > libxcb-image0 > libxcb-keysyms1 > libxcb-randr0 > libxcb-render0 > libxcb-render0-util0 > libxcb-shape0 > libxcb-shm0 > libxcb-sync1 > libxcb-util1 > libxcb-xfixes0 > libxcb-xinerama0 > libxcb-xinput0 > libxcb-xkb1 Python 2 to Python 3 Upgrade Beginning with VectorCAST version 2021, VectorCAST's Python implementation (vpython) is Python 3 compliant. As a result, any existing custom RSPs and custom Python scripts using Python 2.7 will need to be reviewed and upgraded as necessary so as to be Python 3 compliant. For example, where Python 2 allowed for prints like this: print "Hello World" Python 3 requires enclosing the data in parenthesis: Print ("Hello World") Some other common issues are: > bytes to strings conversions > calls to open that use 'wb' or 'rb' > import issues > catching/raising exceptions For detailed instructions and additional information on upgrading to Python 3, see VectorCAST's Application Note AN-ACT-1-001 "Python 2 to Python 3 Upgrade". If you experience any problems, please contact Technical Support at: Email: [email protected] Web: www.vector.com/support Rev: 33d0493 VectorCAST Installation Guide for VectorCAST 2021 VectorCAST Installer Passwords DECRYPTING VECTORCAST INSTALLERS 10 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 2020 SP5, VectorCAST 2020 SP6 and VectorCAST 2020 SP7. A new password is created for VectorCAST 2021 and will continue to be used for all service packs for VectorCAST 2021. 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: Email: [email protected] Web: www.vector.com/support For a Windows Installer The installers are provided in a .zip file. For example, the file name for the VectorCAST 2021 64-bit Windows installer is vcast.win64.2021-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. 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". Rev: 33d0493 VectorCAST Installation Guide for VectorCAST