Professional Documents
Culture Documents
CANape Installation
The information and data given in this user manual can be changed without prior notice. No part of this manual may be reproduced in
any form or by any means without the written permission of the publisher, regardless of which method or which instruments, electronic
or mechanical, are used. All technical information, drafts, etc. are liable to law of copyright protection.
Copyright 2015, Vector Informatik GmbH
All rights reserved.
Administration Manual CANape Installation Introduction
Table of contents
1 Introduction 4
1.1 MSI Setup at a Glance 5
1.2 About this User Manual 5
1.2.1 Access Helps and Conventions 5
1.2.2 Certification 6
1.2.3 Warranty 6
1.2.4 Support 6
1.2.5 Registered Trademarks 7
2 Setup Prerequisites 9
2.1 Overview 10
2.2 Windows Installer 3.1 10
2.3 MSXML 6.0 SP1 10
2.4 Microsoft Visual C++ 2005 SP1 Redistributable 10
2.5 Microsoft Visual C++ 2008 SP1 Redistributable 11
2.6 Microsoft Visual C++ 2010 Redistributable 11
2.7 Microsoft Visual C++ 2010 SP1 x64 Redistributable 11
2.8 Microsoft Visual C++ 2013 Redistributable 11
2.9 .Net Framework 12
2.10 Vector CANdela Persistors 12
2.11 Vector License Manager 12
2.12 Vector ODX Studio 13
2.13 Vector CANdela Studio 13
2.14 Vector AUTOSAR Explorer 13
2.15 Vector FIBEX Explorer 14
2.16 Vector LDF Explorer 14
2.17 Vector vFlash 14
2.18 Feature Prerequisites 15
2.18.1 Vector Function Library (global) 15
2.18.2 Vector MDF Shell Extension 32 15
2.18.3 Vector MDF Shell Extension 64 15
2.18.4 Matlab Integration Package 16
3 Settings 17
3.1 Using Setup.exe 18
3.2 The MSI File 19
3.3 Features 21
4 Further Installations 23
4.1 Silent Installation Example 24
4.2 Service Pack Installation 25
4.2.1 Prerequisites 25
4.2.2 Silent Update 25
4.3 Hardware Installation 25
5 Addresses 27
1 Introduction
Installation guide This document provides an installation guide for IT departments who want to install
Vector CANape silently on target machines using software deployment systems.
It is assumed that the reader is familiar with the Windows Installer technology and the
software deployment system used.
After depicting the necessary Setup Prerequisites (chapter 2), this document explains
how the public properties of the installer can be configured in order to install the
required application components and how embedded transforms can be used to
setup CANape alongside on the same machine (chapter 3).
This document applies to CANape version 14 and up. For an updated version of this
document please always check the documentation that came with your product
before packaging the application as some items mentioned here are version
dependent (e.g. updated installation prerequisites).
To find information The user manual provides you the following access helps:
quickly > At the beginning of each chapter you will find a summary of the contents.
> The header shows in which chapter and paragraph you are.
> The footer shows the version of the manual.
Conventions In the two following charts you will find the conventions used in the user manual
regarding utilized spellings and symbols.
Style Utilization
bold Blocks, surface elements, window- and dialog names of the
software. Accentuation of warnings and advices.
[OK] Push buttons in brackets
File|Save Notation for menus and menu entries
CANape Legally protected proper names and side notes.
Source code File name and source code.
Hyperlink Hyperlinks and references.
<STRG>+<S> Notation for shortcuts.
Symbol Utilization
Here you can obtain supplemental information.
Symbol Utilization
Here you can find additional information.
1.2.2 Certification
1.2.3 Warranty
Restriction of We reserve the right to change the contents of the documentation and the software
warranty without notice. Vector Informatik GmbH assumes no liability for correct contents or
damages which are resulted from the usage of the user manual. We are grateful for
references to mistakes or for suggestions for improvement to be able to offer you
even more efficient products in the future.
1.2.4 Support
You need support? You can get through to our hotline at the phone number
+49 (711) 80670-200
or you send a problem report to canape-support@vector.com.
Registered All trademarks mentioned in this user manual and if necessary third party registered
trademarks are absolutely subject to the conditions of each valid label right and the rights of
particular registered proprietor. All trademarks, trade names or company names are
or can be trademarks or registered trademarks of their particular proprietors. All rights
which are not expressly allowed are reserved. If an explicit label of trademarks, which
are used in this user manual, fails, should not mean that a name is free of third party
rights.
> Outlook, Windows, Windows 8, Windows 7, Windows Vista, Windows XP,
Windows 2000 and Windows NT are trademarks of the Microsoft Corporation.
> CANape is a trademark of Vector Informatik GmbH.
2 Setup Prerequisites
2.1 Overview
Prerequisites Several prerequisites must be met in order to install and/or use CANape. Those
prerequisites will be listed in the following sections.
Please ensure that every client meets these prerequisites before installing CANape.
Setup programs You can find the setup programs for all prerequisites in the setup directory on your
DVD under ISSetupPrerequisites.
Minimum Required Defines the minimum required version of the prerequisite. Useful if another version of
Version the prerequisite is installed.
Prerequisites Windows Installer 3.1 (or later) is needed in order to install CANape. It is assumed,
that this prerequisite is met.
Installation check To check if the correct Microsoft Windows Installer are installed, check if a file called
msi.dll with at least version 3.1.4000.2435 is installed on the target machine under
Systemfolder.
Setup folder {57bcd1d4-2de9-49d9-bc0c-3f4263e9970e}
Prerequisites MSXML 6.0 SP1 or MSXML 6.0 need to be installed to use CANape.
Installation check To check if the correct Microsoft XML Core Services are installed, check if a file called
msxml6.dll with at least version 6.10.1129.0 is installed on the target machine
under Systemfolder.
Installation To install the MSXML 6.0 SP1 Parser and SDK Security Update silently, use the
following command:
msxml6_x86.msi/q
Setup folder MSXML_6_SP1
Installation check To verify that the Microsoft Visual C++ 2005 SP1 Redistributables are installed, check
if the software with the following product code is installed:
{7299052b-02a4-4627-81f2-1818da5d550d}
Installation To install the Microsoft Visual C++ 2005 SP1 Redistributables silently, use the
following command:
vcredist_x86.exe -Q -C:"msiexec /I vcredist.msi /q"
Setup folder VC 2005 SP1 Redist
Installation check To verify that the Microsoft Visual C++ 2008 redistributables are installed, check if the
software with the following product code is installed:
{9A25302D-30C0-39D9-BD6F-21E6EC160475}
Installation To install the Microsoft Visual C++ 2008 redistributables silently, use the following
command:
vcredist_x86.exe /q
Installation check To verify that the Microsoft Visual C++ 2010 redistributables are installed, check if the
software with the following product code is installed:
{F0C3E5D1-1ADE-321E-8167-68EF0DE699A5}
The Microsoft Visual C++ 2010 redistributables package may be installed as part of
Microsoft Visual Studio 2010. Therefore, the following product code should also be
checked:
{5D9ED403-94DE-3BA0-B1D6-71F4BDA412E6}
Installation To install the Microsoft Visual C++ 2010 redistributables silently, use the following
command:
vcredist_x86.exe /q /norestart
Installation check To verify that the Microsoft Visual C++ 2010 redistributables are installed, check if the
software with the following product code is installed:
{1D8E6291-B0D5-35EC-8441-6616F567A0F7}
The Microsoft Visual C++ 2010 redistributables package may be installed as part of
Microsoft Visual Studio 2010. Therefore, the following product code should also be
checked:
{1C7C8AAF-A16D-32E8-89E5-F6D165DE0BCE}
Installation To install the Microsoft Visual C++ 2010 redistributables silently, use the following
command:
vcredist_2010_SP1_x86.exe /q /norestart
Installation check To verify that the Microsoft Visual C++ 2013 redistributables are installed, check if the
software with the following product code is installed:
{F65DB027-AFF3-4070-886A-0D87064AABB1}
Installation To install the Microsoft Visual C++ 2013 redistributables silently, use the following
command:
vcredist_x86.exe /q /norestart
Prerequisites The .NET Framework 4.0 needs to be installed in order to use CANape. Note that
the .NET Framework 4.0 does not include the .NET Framework versions up to 3.5.
Installation check To check if the .NET Framework is installed you can check if the following registry key
is present:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework
Setup\NDP\v4\Full
If this registry key exists, the .NET Framework 4.0 is installed
Installation To install the .NET Framework 4.0 silently, use the following command:
dotNetFx40_Full_x86_x64.exe /q /norestart
Installation check To verify that the Vector CANdela Persistors is installed, check if the software with the
following product code is installed:
{F4DFA512-C383-4A43-802A-ACD4019F17A2}
Version 8.2.00100
Installation The Vector CANdela Persistors is provided as a Windows Installer Package. You can
install it using the package CANdelaPersistors*.msi. Note that if you don’t provide a
target path (e.g. via the INSTALLDIR property), the CANdela converters are installed
to C:\Program Files(x86)\Common Files\CANdelaPersistors. To install
silently, use the following command:
CANdelaPersistors8.2.msi /qn
Setup folder Vector CANdela Persistors
Installation check To verify that the Vector License Manager is installed, check if the software with the
following product code is installed:
{67F96F57-CA1B-4B59-83B2-1993EE300DAC}
Version 1.3.2100.0
Installation The Vector License Manager add-on is provided as a Windows Installer Package.
You can install it using the package VectorLicenseManagerInstaller.msi. To install
the License Manager silently, use the following command:
VectorLicenseManagerInstaller.msi /qn
Installation check To verify that the Vector ODXStudio is installed, check if the software with the
following product code is installed:
{2AC77381-BEE4-49F4-B3FF-2BC39C31241D}
Version 3.2.02100
Installation The Vector ODX Studio is provided as a Windows Installer Package. You can install it
using the package ODXStudio*.msi. To install the License Manager silently, use the
following command:
ODXStudio3.2SP2.msi /qn
Setup folder Vector ODX Studio
Minimum required Vector ODXStudio 3.0 SP1 P2
Version
Installation check To verify that the Vector CANdelaStudio is installed, check if the software with the
following product code is installed:
{21E9E043-6DFC-4E4E-AD51-08E6F06DEE6B}
Version 8.2.100
Installation The Vector CANdelaStudio is provided as a Windows Installer Package. You can
install it using the package CANdelaStudio*.msi. To install the CANdelaStudio
silently, use the following command:
CANdelaStudio8.2.msi /qn
Setup folder Vector CANdelaStudio
Minimum required Vector CandelaStudio 8.0
Version
Installation check To verify that the Vector AUTOSAR Explorer is installed, check if the software with
the following product code is installed:
{52FF171D-0D38-45C0-A441-8D07604F1586}
Version 1.7.14
Installation The Vector AUTOSAR Explorer is provided as a Windows Installer Package. You can
install it using the package AUTOSARExplorer*.msi. To install the AUTOSAR
Explorer silently, use the following command:
AUTOSARExplorer_1.7.14.msi /qn
Setup folder Vector AUTOSAR Explorer
Installation check To verify that the Vector FIBEX Explorer is installed, check if the software with the
following product code is installed:
{30C04A72-90ED-49DD-AAFA-B0E91C921C54}
Version 3.2.48
Installation The Vector FIBEX Explorer is provided as a Windows Installer Package. You can
install it using the package FIBEXExplorer*.msi. To install the FIBEX Explorer
silently, use the following command:
FIBEXExplorer_3.2.48.msi /qn
Setup folder Vector FIBEX Explorer
Minimum required Vector FIBEX Explorer 3.2.26
Version
Installation check To verify that the Vector LDF Explorer is installed, check if the software with the
following product code is installed:
{C50F7323-72EF-4CFD-8905-58250623E318}
Version 1.4.22
Installation The Vector LDF Explorer is provided as a Windows Installer Package. You can install
it using the package LDFExplorer*.msi. To install the LDF Explorer silently, use the
following command:
LDFExplorer_1.4.22.msi /qn
Setup folder Vector LDF Explorer
Minimum required Vector LDF Explorer 1.3.22
Version
Installation check To verify that the Vector vFlash is installed, check if the software with the following
product code is installed:
{00415A0A-E804-4238-9E57-7C975A77FCC8}
Version 2.7.05100.0
Installation The Vector vFlash is provided as a Windows Installer Package. You can install it
using the package vFlash*.msi. To install the vFlash silently, use the following
command:
vFlash2.7SP5.msi /qn
Installation check To verify that the Vector Function Library is installed, check if the software with the
following product code is installed:
{73F1BDB7-11E1-11D5-9DC6-00C04F2FC33B}
Installation The Vector Function Library is provided as a Windows Installer Package. You can
install it using the package Vector Function Library.msi. To install the Vector
Function silently, use the following command:
Vector Function Library.msi /qn
Setup folder Vector Function Library
Feature name FunctionLibraryGlobal
Displaying additional Displays additional information of MDF files in the Windows Explorer.
file information
To display this information within 32 bit applications, it is recommended to install the
32 bit extension on 64 bit operating systems, also.
Installation check To verify that the Vector MDF Shell Extension 32 is installed, check if the software
with the following product code is installed:
{A5C8D1C6-2813-43CF-82AB-E2A7BEE83D00}
Installation The Vector MDF Shell Extension 32 is provided as a Windows Installer Package. You
can install it using the package Vector MDF Shell Extension 32.msi. To install the
Vector Function silently, use the following command:
Vector MDF Shell Extension 32.msi /qn
Setup folder Vector MDF Shell Extension
Feature name MDFShellExtension
Installation check To verify that the Vector MDF Shell Extension 64 is installed, check if the software
with the following product code is installed:
{241D2AC2-DB7A-4F5B-A528-8CD5548559A5}
Installation The Vector MDF Shell Extension 64 is provided as a Windows Installer Package. You
can install it using the package Vector MDF Shell Extension 64.msi. To install the
Vector Function silently, use the following command:
Vector MDF Shell Extension 64.msi /qn
Setup folder Vector MDF Shell Extension
Feature name MDFShellExtension
Installation The Vector Matlab Integration Package is provided as a 32/64 bit Setup executable.
To install the desired version, the Setup must be executed. To install the 64 Bit
Integration Package for a Matlab installation(E:\Matlab\R2013a_win64\)
silently, use the following command:
MATLAB_CANape_Integration_Package_1300_win64.exe /s /v"/qn
INSTALLDIR=\"E:\Matlab\R2013a_win64\" MATLAB_REG_SERVER=1"
3 Settings
Executable The Setup.exe setup launcher serves as a bootstrap application that manages the
prerequisites and tools which are required to run the application. It is recommended
to run the installation always using the setup.exe bootstrapper.
Command line The following table lists the command line parameters and their meaning.
Note: The parameters are only setup.exe related. To configure the msi installation,
pass the public properties and the parameter using the setup.exe parameter /v.
Parameter Description
/s Silent mode
This parameter suppresses the initialization
dialog. To run the installation silently, run the
command line
Setup.exe /s /v/qn
/x Uninstall mode
The option causes Setup.exe to uninstall a
previously installed
/instance=<InstanceId> Lets you specify which instance you want to
install, update, or uninstall. <InstanceId>
represents the value of the InstanceId property
that identifies the instance. Whenever you use this
option and include a valid InstanceId value, the
installation suppresses the instance selection
dialog.
For example, the following sample command line
installs the instance that has 2 as the value of the
InstanceId property:
Setup.exe /instance=2
Use default to identify the instance that is installed
by the base installation package, as in the
following example:
Setup.exe /instance=default
To specify the instance that you want to uninstall,
include the /x option with the
/instance=<InstanceId> option.
CANape support up to 10 instances
Parameter Description
arguments through the /v option as in the
following example:
Setup.exe /v"/l*v c:\test.log
"MYPROPERTY1=value1 /
qb"
/L This option indicates that the installation should
run in the specified language as specified. You
can specify the language ID as either a
hexadecimal or decimal number.
If you specify the hexadecimal number, be sure to
proceed the value with 0x. For example:
l0x0407 or -l1031 indicates that the installation
should be run in German.
Note: If you specify a language ID that is not
supported by the installation or you specify an
invalid language ID, the parameter is ignored.
Also note that if this parameter is specified and it
is valid, the language dialog (if enabled) is
automatically suppressed.
/b Specifies the directory in which to cache the
installation files, as in the following example:
Setup.exe /b"C:\CacheDirectory"
MSI file The MSI is included in the Setup. If the deployment environment requires a MSI
Package, extract the file from the setup.exe.
Ensure that the Prerequisites are properly installed on the target machine before the
msi installation starts. Usually the setup.exe bootstrapper ensure this.
Extracting The MSI file will be cached during the installation process after the prerequisites are
installed to a temporary folder. To extract the MSI, execute the setup.exe. After
preparing the install wizard, the welcome page is displayed. The file CANape.msi is
located in a temporary subfolder of the installing users %TEMP% folder. Copy the
CANape.msi for further actions.
Properties for using The MSI setup was created to ease the deployment of CANape in large IT networks
software deployment via software deployment systems. To support this, the options that can be changed in
systems the user interface setup are represented by public properties. Note, that CANape is a
complex software utility whose correct execution depends on some settings you might
want to change. Only change the settings available through the properties described
in the following table, otherwise, a correct setup execution cannot be guaranteed.
Public properties The following table lists the public properties and their meaning, as well as their
standard or predefined values respectively.
Note: In case one of the following public properties shall be set to a customized
value, the respective property and its value
> have to be either directly provided on the msiexec command line or
> have to be added and/or modified in the "Property" table of the MST when using
your own transform files for deployment.
For an example please see section Silent Installation Example on page 24.
Note: Property names are case sensitive! Public properties using uppercase letters,
only.
Note: Please note, that for correct execution of CANape it is important to keep the
directory structure the same as defined in the installation package. Modifying this
directory structure can lead to erroneous behavior which can lead to wrong simulation
results.
Caution: You MUST NOT change anything else than the public properties specified
in the table above.
Note: Starting with Windows Vista, installing the application and user data in the
system program folder (e.g. C:\Program Files) is not supported. If you install
CANape in the system program directory (e.g. C:\Program Files\Vector
CANape), the data folders are located in a subfolder of the recommended root data
folder.
3.3 Features
Default
Feature Meaning
Value
Examples General Example files Selected
COM Examples: Com Example Not selected
files
CANapeApi CANape API and ASAP3 Selected
applications and examples
CRTProject Extras: CANape Real Time Selected
Target project templates
DriverGenerator Extras: CANape Driver Selected
Generator project templates
Default
Feature Meaning
Value
MatlabIntegrationPackage1 Installation of the MATLAB Not selected
Integration Package (no silent
mode)
FunctionLibraryGlobal Installs/updates global Selected
Vector Function Library
MDFShellExtension Installs/Updates MDF Shell Selected
Extension
USBDongle Installs the Vector USB Not Selected
Keyman driver
Note: Configuring the features using the ADDLOCAL property requires configuring
each feature which should be installed, independent from the default values.
1
It is also available as discrete setup in the ISSetupPrerequisites subfolder.
4 Further Installations
Installation instance 5
Setup.exe /s /instance=5 /v"/qn"
Uninstall
Setup.exe /s /x /v"/qn"
CANape.msi installation
Install and configure license information
CANape.msi /qn
VREGKIND=3
VSETUPKEY_CUSTOMER=\"<customer>\"
VSETUPKEY_SERIALNUMBER=<serialnumber>
VSETUPKEY_LICENSEKEY=<licensekey>
Uninstall
CANape.msi /x /v"/qn"
4.2.1 Prerequisites
Prerequisites A service pack installation can only be executed if a CANape of the same main
version but lower SP level is already installed. Otherwise a full installation has to be
done.
Silent Update For a silent update the following parameters have to be set at the command line:
msiexec /i CANape.msi REINSTALLMODE=vomus REINSTALL=ALL
IS_MINOR_UPGRADE=1 /q
In case multiple instances are installed on the machine you can specify the instance
to be updated by adding the parameter /n {Product-Code}.
Note: The parameter ( /n {Product-Code} ) must not be set, in case you want to
update a CANape installation which was installed using the base product code.
Installation The drivers for Vector hardware interfaces are not installed via the Windows Installer
setup. At the moment there are no Windows Installer installations available for Vector
hardware drivers. You have to ensure that the drivers for the used Vector hardware
are installed on the target machines.
5 Addresses
Addresses on Vector Please find the contacts of Vector Informatik GmbH and all subsidiaries worldwide
homepage via:
http://www.vector.com/vi_addresses_en.html
www.vector.com