DYNA4 R5 SP2 Installation Guide DYNA4 R5 SP2 Installation Guide

Table of Contents

1 DYNA4 Installation ...... 4 1.1 Installer package contents...... 4 1.2 Standard Installation...... 4 1.3 Installation with a shared configuration ...... 8 1.4 Automated Installation...... 9 1.5 Install software updates for DYNA4 ...... 9 1.6 Uninstall DYNA4...... 9 2 Licensing ...... 11 2.1 Troubleshooting License Problems ...... 12 2.1.1 DYNA4 Studio license not available...... 12 3 Configuring DYNA4 ...... 13 4 Installing a supported Compiler...... 16 4.1 Supported Compilers...... 16 4.2 Setup C/C++ compiler in MATLAB ...... 16 4.3 Visual Studio 2019 Compiler ...... 17 4.4 2017 Compiler ...... 17 4.4.1 Troubleshooting: Patching Visual Studio 2017 Build Tools to work with MATLAB in case the compiler can not be found...... 18 Determine VS 2017 Build Tools installation folder...... 18 Patch the registry ...... 18 4.5 SDK 7.1 Compiler ...... 19 5 Provide automatic configuration of DYNA4 on startup...... 20 5.1 Overview ...... 20 5.2 Prerequisite: Install DYNA4 on the machine ...... 20 5.3 Step 1: Create a default properties file...... 20 5.4 Step 2: Create a batch-script for preparing and starting the application ...... 21 6 Installing additional 3rd party Eclipse features into DYNA4 ...... 22 6.1 Installing additional features...... 22 6.2 The DYNA4 configuration space...... 25

Copyright © 2020 Vector Informatik GmbH 2020-12-08 2 / 26 DYNA4 R5 SP2 Installation Guide

Prerequisites: Before installing DYNA4 check the following issues: ▪ Make sure you are using a supported . Check the Hardware and Software Compatibility for details. ▪ MATLAB must be installed on your computer. Supported MATLAB versions are listed in the Hardware and Software Compatibility. ▪ In order to compile models for Windows targets, the installation of a C/C++-compiler is required. For details please refer to Installing a supported Compiler. The installation routine consists of the following steps. It is necessary to complete these steps before working with DYNA4. ▪ Installing DYNA4: The required files are extracted to the installation directory by the supplied Setup file. This task needs to be performed once per computer. ▪ Licensing: The license needs to be activated before DYNA4 can be used. ▪ Configuring DYNA4 configures the location of the DYNA4 Simulation Projects and the DYNAdatabase. This task needs to be performed (at least) once for every user after the installation. ▪ For new users: Additionally a DYNAdatabase with example data can be generated. ▪ For users of previous DYNA4 versions (<5.2.0): If you want to migrate your data of a previous DYNA4 version, please consider the information from the Migration Guide in the DYNA4 Help. If you would like to deploy several instances of DYNA4 installations automatically or pre-configure these installations, please have a look at the following sections: ▪ Automation of DYNA4 installations: The installation of DYNA4 can be automated to deploy the software using client management systems. ▪ Provide automatic configuration of DYNA4 on startup: To relieve the user of having to configure DYNA4 manually, you can pre-configure the DYNA4 installation.

Refer to following pages for detailed information:

▪ DYNA4 Installation ▪ Licensing ▪ Configuring DYNA4 ▪ Installing a supported Compiler ▪ Provide automatic configuration of DYNA4 on startup ▪ Installing additional 3rd party Eclipse features into DYNA4

Copyright © 2020 Vector Informatik GmbH 2020-12-08 – 3 / 26 DYNA4 R5 SP2 Installation Guide

1 DYNA4 Installation This chapter describes the steps that are needed to install DYNA4. Several different installation scenarios are supported. In the standard installation scenario, a system administrator executes the DYNA4 installer program to install the DYNA4 product and other required software packages to a specific PC. Multiple non-administrator users then can use the DYNA4 installation without interfering with each other. In addition to the standard installation scenario, there are other installation setups supported as well. This includes sharing the DYNA4 working environment between several different users and automated/unattended installation and configuration scenarios. After a successful DYNA4 installation by the administrator, each separate user must perform a configuration step before they can use the DYNA4 product. Before the DYNA4 features can be used, an activated DYNA4 license must be available.

Content:

▪ Installer package contents ▪ Standard Installation ▪ Installation with a shared configuration ▪ Automated Installation ▪ Install software updates for DYNA4 ▪ Uninstall DYNA4

1.1 Installer package contents The DYNA4 installer package is usually downloaded as a zip file or an iso image, DYNA4_.zip or DYNA4_.iso (e.g. DYNA4_R5_SP2.zip) by the user. This image contains the following files:

Filename Description

Packages Directory containing additional content required by the DYNA4 installer, Installation_Guide.pdf Installation guide in PDF format. Setup_DYNA4_.exe The main DYNA4 installer executable.

1.2 Standard Installation In this installation mode, every user on the PC has a separate DYNA4 configuration space. This allows every user to perform personal customizations to his DYNA4 instance without making them available to other users. This protects the work of each user if they share a single PC. 1. When using the iso image on , double click the image file to mount it as a virtual drive. When using the zip file or on , extract the zip or iso image using compression tools such as 7zip or burn a DVD. 2. Start the installation by executing the installer executable Setup_DYNA4_.exe.

Administrator rights required!

Executing the DYNA4 setup requires administrator rights. For starting and using DYNA4 later on, no administrator rights are required.

By default, DYNA4 is installed into the Program Files directory, to "C:\Program Files\Vector_DYNA4_". Click Options if you would like to modify the installation target path.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 4 / 26 DYNA4 R5 SP2 Installation Guide

Avoid spaces in the installation file path!

Some simulation targets can not be compiled if the installation path contains spaces. Either make sure that 8.3 file names can be generated for your installation directory or choose an installation path without spaces.

Click the Install button and accept providing administrator rights. The DYNA4 bundle installer will install the following software products on the target PC: ▪ The DYNA4 Studio. ▪ DYNAanimation. ▪ MiKTeX Portable for DYNA4 for the generation of PDF reports. ▪ Vector License Client required by the DYNA4 licensing mechanism. ▪ /C++ 2010/2013 re-distributable packages. On the Custom Setup page, you can select the DYNA4 Studio features that are to be installed. Press Next to start the installation process.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 5 / 26 DYNA4 R5 SP2 Installation Guide

The installer creates a folder in the Windows Start menu (e.g. "Vector DYNA4 R5 SP2") as well as shortcuts on the Windows Desktop and in the Windows Start menu. These shortcuts are available for all users on the PC.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 6 / 26 DYNA4 R5 SP2 Installation Guide

Press Finish to proceed to the installation of additionally required software packages. This does not require any user interaction.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 7 / 26 DYNA4 R5 SP2 Installation Guide

When this process is finished, press Close to complete the installation process. The next step is to start and configure DYNA4. For working with DYNA4, a license is required. See section Licensing for more information.

Info:

If the DYNA4 installation was run via a remote desktop connection, a restart or re-login are required in order to guarantee a proper update of the system path variable.

1.3 Installation with a shared configuration In this installation mode, all users share a single DYNA4 configuration space. Every user can therefore perform customizations and install additional Eclipse plugins into DYNA4 that are then also available to other users on the PC. The shared configuration space is stored in the directory C:\ProgramData\Vector\DYNA4\ \configuration that is accessible by all users on the PC. This installation mode can be activated by using following command line parameter:

Setup_DYNA4_R5_SP2.exe SHARED_CONFIGURATION=true

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 8 / 26 DYNA4 R5 SP2 Installation Guide

Important note:

DYNA4 stores the configured paths to DYNAdatabase and Simulation Project directories in the DYNA4 configuration space. When making use of a shared configuration space, make sure that the configured directories and the shared configuration location (e.g. "C:\ProgramData\Vector\DYNA4\5.2") are accessible by all users. Otherwise the shared configuration cannot be used by other users.

1.4 Automated Installation The DYNA4 installation process can be automated so that no user interaction is required. The DYNA4 bundle installer executable provides command line options that allow automated installation. It is also possible to specify the installation directory and the DYNA4 features that shall be installed via command line options:

Setup_DYNA4_R5_SP2.exe [/quiet|passive] INSTALLDIR="" FEATURES= e.g.: Setup_DYNA4_R5_SP2.exe /quiet INSTALLDIR="C:\Program Files\Vector_DYNA4_R5_SP2" FEATURES=VEHICLE_MODEL_BLOCKSET,ENGINE_MODEL_BLOCKSET

Providing the INSTALLDIR and FEATURES parameters is optional. If omitted, default values are used (INSTALLDIR is set to C:\Program Files\Vector_DYNA4_ and DYNA4 Studio will be installed including DYNA4 Vehicle Model Blockset). Following DYNA4 Features can selectively be installed for DYNA4:

Feature Code DYNA4 Feature

VEHICLE_MODEL_BLOCKSET DYNA4 Studio Vehicle Model Blockset

ENGINE_MODEL_BLOCKSET DYNA4 Studio Engine Model Blockset

Administrator rights required!

Executing the DYNA4 installer in automated mode requires administrator rights.

1.5 Install software updates for DYNA4 In order to update an existing DYNA4 installation to a newer patch version, (e.g. from DYNA4 5.2.0 to DYNA4 5.2.1), simply run the new installer on your PC specifying the same installation directory as before. Then the DYNA4 installation will be updated. During this process the old installation is removed and then the new content is installed. User directories like DYNAdatabase and Simulation Projects are not modified by the installer. In order to obtain new content for DYNAdatabase and Demo Simulation Projects, perform Configure DYNA4 after the update.

1.6 Uninstall DYNA4 To uninstall DYNA4 from the system, following command can be issued from the command line:

Setup_DYNA4_R5_SP2.exe /uninstall Alternatively you can execute the Uninstall command of the DYNA4 Installation Manager in the Apps & Features pane in the Windows Control panel.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 9 / 26 DYNA4 R5 SP2 Installation Guide

Administrator rights rquired!

Uninstalling DYNA4 requires administrator rights.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 DYNA4 Installation – 10 / 26 DYNA4 R5 SP2 Installation Guide

2 Licensing The modular concept of DYNA4 is reflected in the products DYNA4 Studio and DYNA4 Run with several options that are licensed separately and can be combined flexibly. Starting from DYNA4 4.0, licenses are activated using the Vector License Client, also referred to as "New Vector License Model". More information on how to activate your license can be found in this Video Tutorial in the Vector Knowledge Base. If you want to migrate a license from older DYNA4 versions, please contact [email protected]. In case of license problems, please refer to Troubleshooting License Problems.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Licensing – 11 / 26 DYNA4 R5 SP2 Installation Guide

2.1 Troubleshooting License Problems This section provides information on how to deal with licensing problems. An overview over the used license technology can be found in the Vector Knowledge Database. If you need further help, please don't hesitate to contact our support team ([email protected]).

The following sections may also help when licensing problems occur:

▪ DYNA4 Studio license not available

2.1.1 DYNA4 Studio license not available Problem description: When starting DYNA4, an error message pops up saying "DYNA4 Studio license not available":

Figure: DYNA4 Studio license not available Solution: This message indicates that no license for DYNA4 Studio (the DYNA4 base application) is available / activated. Thus the software can not be used. This can be fixed by activating the license correctly in the Vector License Client. Use the button in the error dialog to directly start this tool.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Licensing – 12 / 26 DYNA4 R5 SP2 Installation Guide

3 Configuring DYNA4 It is necessary to configure DYNA4 to a specific MATLAB installation and to define directories for Simulation Projects and DYNAdatabase for the user. The following steps must be carried out: 1. Start DYNA4 by clicking the corresponding shortcuts in the Windows Start Menu or on the Windows Desktop. Alternatively it can be launched by double-clicking the executable DYNA4.exe in the installation folder. The startup procedure opens the graphical user interface.

2. When starting DYNA4 for the first time after the installation (or if no MATLAB installation path is set in the preferences at DYNA4 startup), the Configure DYNA4 dialog opens automatically (see figure below). If you want to reconfigure DYNA4 at a later time, you can open this dialog via the DYNA4 tools menu option Tools | Configure DYNA4....

Figure: Configure DYNA4

Migrating data from previous DYNA4 versions:

If you want to migrate Simulation Projects and a DYNAdatabase of a previous DYNA4 version (<5.2.0), please consider the information from the Migration Guide before you continue with the configuration process.

Please specify the following settings: Setting Description Preference Key Data Type

MATLAB Installation Root Directory:

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Configuring DYNA4 – 13 / 26 DYNA4 R5 SP2 Installation Guide

Setting Description Preference Key Data Type

Location Select the MATLAB Installation Root Matlab.installationDirecto string Directory from the drop-down menu ry listing the installed MATLAB versions on your computer. The drop-down will show all MATLAB installations available on your system path that are officially supported by DYNA4 (other MATLAB versions found are left out). You may also check the Compatibility Matrix for supported MATLAB versions. If the desired MATLAB installation is not listed, enter the path manually or press Browse... to select the MATLAB root directory via a folder dialog.

Info:

If a MATLAB installation is selected that is below the minimum supported MATLAB version, an error is shown and the user cannot apply this selection.

Projects Directory:

Location Enter the DYNA4 Projects Directory or n/a n/a press Browse... to select the Simulation Projects directory via a folder dialog. DYNAdatabase: Location Enter the DYNAdatabase Directory or DYNA4Studio.DYNAdata string press Browse... to select the basePath DYNAdatabase directory via a folder dialog.

Generate Activate the check box Generate DYNA4Studio.generateD boolean DYNAdatabase DYNAdatabase to copy the delivered YNAdatabase data file repository to the DYNAdatabase directory.

3. Upon pressing Apply DYNA4 is configured for the specified MATLAB version and the selected working directories. Restart the application by clicking OK in the opening dialog:

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Configuring DYNA4 – 14 / 26 DYNA4 R5 SP2 Installation Guide

Figure: Restart DYNA4 after configuring

4. DYNA4 is restarted and the DYNAdatabase is generated. A dialog opens allowing the selection of Example Simulation Projects to be created.

5. If this is the first time you open DYNA4, the Welcome View will be displayed which provides links to basic pages of the DYNA4 product help. If you want to start working with DYNA4, close the Welcome View and adjust your license settings. After this you can make your first steps in DYNA4 by reading section Getting Started.

Info:

It is possible to automatically configure DYNA4 for certain requirements. A manual how to do this can be found here: Provide automatic configuration of DYNA4 on startup.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Configuring DYNA4 – 15 / 26 DYNA4 R5 SP2 Installation Guide

4 Installing a supported Compiler In order to compile Simulation Models for Windows targets (e.g. Accelerator, Rapid Accelerator, DYNA4 Windows Executable ...), the installation of a C/C++ compiler is required.

Content

▪ Supported Compilers ▪ Setup C/C++ compiler in MATLAB ▪ Microsoft Visual Studio 2019 Compiler ▪ Microsoft Visual Studio 2017 Compiler ▪ Troubleshooting: Patching Visual Studio 2017 Build Tools to work with MATLAB in case the compiler can not be found ▪ Determine VS 2017 Build Tools installation folder ▪ Patch the registry ▪ Microsoft Windows SDK 7.1 Compiler

4.1 Supported Compilers DYNA4 supports the following compilers depending on the used MATLAB version. Please note, that the NI VeriStand target requires the Visual Studio 2010 or Microsoft Windows SDK 7.1 compiler for all MATLAB versions:

MATLAB WinSDK 7.1 Visual Studio Visual Studio Visual Studio Visual Studio Release 2010 2015 2017 2019

MATLAB R2017b

MATLAB R2018a

MATLAB R2018b

MATLAB R2019a

MATLAB R2019b

MATLAB R2020a

4.2 Setup C/C++ compiler in MATLAB After installing one of the supported compilers, select the compiler for C and C++ language compilation in MATLAB: Run:

mex -setup c Select the desired compiler. Expected result (e.g. for MSVC 2019):

MEX configured to use 'Microsoft Visual C++ 2019 (C)' for C language compilation. Run:

mex -setup c++ Select the desired compiler. Expected result (e.g. for MSVC 2019):

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing a supported Compiler – 16 / 26 DYNA4 R5 SP2 Installation Guide

MEX configured to use 'Microsoft Visual C++ 2019' for C++ language compilation.

4.3 Microsoft Visual Studio 2019 Compiler MATLAB does not detect the Visual Studio 2019 compiler if just the Visual Studio 2019 Build tools are installed. Therefore, a full installation of Visual Studio 2019 (Professional, Enterprise or Community) is required.

4.4 Microsoft Visual Studio 2017 Compiler To use the Microsoft Visual Studio 2017 Compiler in MATLAB you can either use a full installation of Visual Studio 2017 (Professional, Enterprise or Community) or you can just install the Visual Studio 2017 Build Tools. Please refer to the Microsoft terms of license for licensing information about Visual Studio 2017 Build Tools. Go to https://visualstudio.microsoft.com/downloads/ and scroll down. Expand the field "Tools for VisualStudio" and download "Build Tools for Visual Studio " (if "version" is higher than 2017, the older 2017 build tools can be installed additionally).

Figure: Download Visual Studio build tools Execute the installer. During installation, make sure to select "Visual C++ build tools". If you are installing Visual Studio Build Tools newer than version 2017, please additionally select the 2017 build tools in the list of optional features.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing a supported Compiler – 17 / 26 DYNA4 R5 SP2 Installation Guide

Figure: Select Visual C++ build tools

4.4.1 Troubleshooting: Patching Visual Studio 2017 Build Tools to work with MATLAB in case the compiler can not be found Some versions of the Visual Studio 2017 Build Tools don't set the registry key that MATLAB checks in order to find Visual Studio 2017. If the Visual Studio Build Tools are properly installed, one can patch the registry so MATLAB is able to locate the VS Build Tools. Follow the steps outlined below in order to do so.

Note:

There is also a MATLAB answer regarding this topic: https://de.mathworks.com/matlabcentral/answers/412396- how-to-setup-matlab-compiler-to-use-msvc2017-build-tools

Determine VS 2017 Build Tools installation folder Open a Windows command line and execute the following command:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -products * -version "[15.0, 16.0)" -property installationPath And save the result for later. For the rest of the tutorial, we assume this value: "C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools".

Patch the registry MATLAB is looking for the key "15.0" at any of the following registry paths:

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing a supported Compiler – 18 / 26 DYNA4 R5 SP2 Installation Guide

HKLM\SOFTWARE\Microsoft\VisualStudio\SxS\VS7 HKCU\SOFTWARE\Microsoft\VisualStudio\SxS\VS7 HKLM\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\SxS\VS7 HKCU\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\SxS\VS7 We observed the Visual Studio installer using "HKLM\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\SxS\VS7", so that's what this tutorial will use. Create a new *.reg file (e.g. "AddVSBuildToolsToRegistry.reg") with the following content (modify accordingly if your values differ from the ones in the tutorial and make sure to replace "\" with "\\"):

Content of the *.reg file

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\VisualStudio\SxS\VS7] "15.0"="C:\\Program Files (x86)\\Microsoft Visual Studio\\2017\\BuildTools\\"

Then double click the *.reg file. This should add the correct registry key so MATLAB will be able to find Visual Studio 2017 Build Tools.

4.5 Microsoft Windows SDK 7.1 Compiler If you would like to install the free Microsoft Windows SDK 7.1, please follow the detailed instruction manual with a troubleshooting section at https://de.mathworks.com/matlabcentral/answers/101105-how-do-i-install-microsoft-windows-sdk-7-1 Please note, that you will have to uninstall .NET Framework 4.5 and any higher version prior to the installation.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing a supported Compiler – 19 / 26 DYNA4 R5 SP2 Installation Guide

5 Provide automatic configuration of DYNA4 on startup

Content:

▪ Overview ▪ Prerequisite: Install DYNA4 on the machine ▪ Step 1: Create a default properties file ▪ Step 2: Create a batch-script for preparing and starting the application

5.1 Overview At each first start of DYNA4 by a new user, the user is confronted with the Configure DYNA4 dialogue (see Configuring DYNA4). The user is asked to create the directories Projects and DYNAdatabase and to specify the location of the MATLAB installation. However, in some cases you may want to start DYNA4 right away without manual inputs using default settings. For example, if you are using DYNA4 in tutorial sessions at university and want to provide a ready-to-go setup on the student's computers. This manual will show how to circumvent the configuration dialogue by providing default settings and starting DYNA4 via a simple cmd or bat file. This should usually be done by an administrator.

5.2 Prerequisite: Install DYNA4 on the machine In order to prepare the settings for automatic configuration, DYNA4 has to be installed on a computer before going through the steps in this manual. This will usually be done by the administrator. Refer to Automation Installation for more information on this topic.

Advice:

It is strongly recommended to install DYNA4 to the default directory (e.g. "C:\Program Files\Vector_DYNA4_R5") by the administrator. This way, the DYNA4 installation is protected against accidental modifications by non- administrator users.

5.3 Step 1: Create a default properties file Default settings for DYNA4 configuration data are stored in a file called dynaware_default.properties. The DYNA4 configuration step is skipped if configuration data is already available. If you want all users to share the same DYNAdatabase directory, you will have to generate it once in a central directory, e. g. on a network drive. Another approach could be, to put a database in a SVN or GIT repository. This way you can also provide a set of example Projects ready to use for every user. The dynaware_default.properties file must be placed in the following location of the DYNA4 installation: \configuration\de.tesis.dynaware.common.core\dynaware_default.properties After a fresh DYNA4 installation, this directory location may not yet exist so create it if needed. Create a new dynaware_default.properties file in the corresponding location mentioned above. If a file of this name is existent in the respective configuration directory, DYNA4 will use the settings inside as the default configuration for startup and the Conf igure DYNA4 dialogue is not shown. Open the file in a text editor and edit it according to your requirements. An example is shown below:

dynaware_default.properties file

Matlab.installationDirectory=C\:\\Program Files\\Matlab\\R2020a DYNA4Studio.DYNAdatabasePath=C\:\\CustomDatabaseDirectory\\DYNAdatabase DYNA4Studio.generateDYNAdatabase=false DYNA4Studio.showExampleProjectsWizardOnStartup=false

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Provide automatic configuration of DYNA4 on startup – 20 / 26 DYNA4 R5 SP2 Installation Guide

It is possible to specify the different directories (DYNAdatabase, MATLAB root, etc.) according to your requirements. In the above example, the DYNAdatabase is located on the computers' hard drive. User directories can be addressed by using the appropriate system environment variable (e. g. USERPROFILE for Windows 10). If you want to show the wizard to generate DYNA4 example projects on startup, set DYNA4Studio.showExampleProjectsWizardOnStartup to "true". The default location of the project directory is %USERPROFILE%\DYNA4_5.0\Projects

Info:

▪ Note that the Project directory can not be specified in the dynaware_default.properties file! This has to be done manually in the DYNA4 GUI (see Configuring DYNA4), or by using a command line parameter (see next step). ▪ Environment variables can be used in the dynaware_default.properties file by using the syntax %VARIABLE_NAME%. ▪ When providing a custom DYNAdatabase to users, keep the setting DYNA4Studio.generateDYNAdatabase=false! If set to "true", the DYNAdatabase will be overwritten by the delivered DYNA4 default DYNAdatabase.

5.4 Step 2: Create a batch-script for preparing and starting the application As setting the initial Projects directory cannot be specified in the dynaware_default.properties file, this configuration has to be done via a DYNA4 command line parameter. The administrator can provide batch/cmd scripts to users that implement starting DYNA4 with this command line parameter. As in this case users should always use the batch-script to start DYNA4, it is recommended to place a shortcut to this file on the user's desktop. DYNA4 can be started as follows by supplying a Projects directory on the command line:

Starting DYNA4 with pre-defined Projects directory

\DYNA4.exe --launcher.appendVmargs -vmargs -Dosgi.instance.area="" i.e.: "C:\Program Files\Vector_DYNA4_R5\DYNA4.exe" --launcher.appendVmargs -vmargs -Dosgi.instance.area="C:\CustomProjectsDirectory\Projects"

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Provide automatic configuration of DYNA4 on startup – 21 / 26 DYNA4 R5 SP2 Installation Guide

6 Installing additional 3rd party Eclipse features into DYNA4 DYNA4 can be enhanced by installing additional 3rd party Eclipse features (e.g. EGit source control software). Theses features are installed into the current DYNA4 configuration space.

6.1 Installing additional features 1. Select the Help Menu option Help | Install New Software.... The Install wizard opens with the Available Software page (see figure Install wizard).

Figure: Install wizard

2. Press Add... to select a site or location. The Add Site dialog opens (see figure Add Site dialog).

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing additional 3rd party Eclipse features into DYNA4 – 22 / 26 DYNA4 R5 SP2 Installation Guide

Figure: Add Site dialog

3. Press Local... and browse to the desired location to install software from a directory.

OR

Press Archive... and browse to the desired location to install software from a jar or zip archive.

Press OK to confirm.

Figure: Available Software page with specified software 4. Activate the check box of the package(s) to be installed from the table and press Next... to confirm. The Install wizard opens with the Install Details page (see figure Install details page).

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing additional 3rd party Eclipse features into DYNA4 – 23 / 26 DYNA4 R5 SP2 Installation Guide

Figure: Install details page

5. Press Next... to confirm. The Install wizard opens with the Review Licenses page (see figure Review Licenses page).

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing additional 3rd party Eclipse features into DYNA4 – 24 / 26 DYNA4 R5 SP2 Installation Guide

Figure: Review Licenses page

6. Select the radio button option I accept the terms of the license agreement and press Finish to confirm. The software update is being installed.

6.2 The DYNA4 configuration space The location of the DYNA4 configuration space depends on the installation mode you chose. 1. Standard Installation In the standard installation mode, which is the default, each user will have his own configuration space. Therefore, additionally installed features will only be available to the user that installed them. The installed features will still be available after a DYNA4 patch has been installed. 2. Installation with a shared configuration If you installed DYNA4 with a shared configuration setup, the configuration space will be shared for all users. Therefore, additionally installed features will be available to all users. The installed features will still be available after a DYNA4 patch has been installed. If you would like to install additional features for all users even in a shared configuration setup, you can install these features into the configuration space that is used by the DYNA4 installer. In this case the installed features will be removed while installing a DYNA4 patch! To be able to update the DYNA4 installation, you have to start DYNA4 in administration mode. This can be done by starting a Windows command shell as administrator and entering following command:

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing additional 3rd party Eclipse features into DYNA4 – 25 / 26 DYNA4 R5 SP2 Installation Guide

Start DYNA4 in administration mode:

\DYNA4.exe --launcher.appendVmargs -vmargs -Dosgi.configuration.area="\configuration" i.e.: "C:\Program Files\Vector_DYNA4_4.0\DYNA4.exe" --launcher.appendVmargs -vmargs -Dosgi.configuration.area="C:\Program Files\Vector_DYNA4_4.0\configuration" After the installation is finished, you should restart DYNA4 to drop the administrative privileges.

Copyright © 2020 Vector Informatik GmbH 2020-12-08 Installing additional 3rd party Eclipse features into DYNA4 – 26 / 26