Home

Dymola - Dynamic Modeling Laboratory

1. The first alternative Dymola is the default contents of the Dymola distribution including the development environment and the Modelica standard library This component should always be installed except when only a license server should be installed The Libraries section contains several commercial libraries which require a license option to use Install libraries according to your current options The last section License server makes it possible to install Dymola license server without having to install Dymola Please note that the Dymola component should be unchecked in that case To add remove a component from the installation click on it and select the appropriate alternative in the menu APPENDIX INSTALLATION 9 Installation of Dymola has finished 4 39 Dymola 2016 Beta 3 InstallShield Wizard Custom Setup Select the program features you want installed Click on an icon in the list below to change how a feature is installed mr Feature Description e3 ID E Library of air conditioning Its EE ArConcitioning j uui amp g This feature will be installed on local hard drive amp 9B This feature and all subfeatures will be installed on local hard drive X Thisfeature will not be available Install to Change E InstallShield nee s j m Neto When Dymola is successfully installed the following will appear
2. OOOO OOCC oO 2392 139 2395 2392 39s 2395 395 39 2 391 35 35 35 35 35 36 36 236 36 lmgrd World Wide Web http www globetrotter com lmgrd License file s C DAG dymola lic lmgrd lmgrd tcp port 27000 lmgrd Starting vendor daemons dynasim Server started on x x x x for DymolaStandard dynasim DymolaSampledLib DymolaLiveObjects DymolaRealtime dynasim DymolaSimulink DymolaAnimation DymolaSupport lmgrd Started dynasim pid 124 lmgrd dynasim using TCP port 1042 The license server should now be correctly configured Please start Dymola to verify correct operation The FLEXnet Publisher logfile see above should contain additional lines showing what features were checked out You can also do Perform Status Enquiry to check how many licenses are currently checked out Note The license server by default uses the ports 27000 27009 They can be configured if needed e g if there are issues with firewalls 1 3 3 License borrowing Overview Dymola on Windows can support borrowing the possibility to transfer a license from a license server to laptop for a limited period of time If Dymola is used on a computer that is intermittently disconnected from a license server that license can be issued as a sharable license with borrowing facility Such a license can be borrowed from a license server via a special checkout and used later to run an application on a computer
3. InstallShield Wizard Completed The InstallShield Wizard has successfully installed Dymola 2015 Click Finish to exit the wizard 10 1 1 3 Installing a C compiler To translate models in Dymola you must also install a supported C compiler The C compiler is not distributed with Dymola The C compiler needs to be installed only once even if you install multiple versions of Dymola You can select a Microsoft compiler or a GCC compiler Microsoft compilers Dymola supports Microsoft Visual Studio 2013 both the Professional edition and the Express edition Dymola also supports older Microsoft compilers Visual Studio 2012 Visual Studio 2010 and 2008 Professional edition and Express edition and Visual Studio 2005 Professional edition To download the free Visual Studio 2013 Express edition compiler please visit http www Dymola com compiler where the latest links to Microsoft s website are available Note that you need administrator rights to install the compiler The C compiler can be installed before or after you install the Dymola You can run Dymola and browse models but to translate any model you must install the C compiler Please note that earlier free versions of the Microsoft compiler are not supported the reason is that they do not include a full set of Windows libraries We recommend Visual C 2010 or later see above To get a small improvement of the simulation performance you can activate the global opt
4. Two examples are important e A customer that wants to run Dymola in Japanese on a machine with regional language setting other than Japanese This can be done by starting Dymola with the command C Program Files x86 Dymola 2016 bin64 Dymola exe translation ja given using a 64 bit Dymola from the default location e Acustomer that wants to run Dymola in English on a machine with regional language setting Japanese This can be done by starting Dymola with the command C Program Files x86 Dymola 2016 bin64 Dymola exe translation none given using a 64 bit Dymola from the default location The second way to override the default selection of translation file is to specify what translation file to use this can be done with the command line option 18 Shortcuts start Dymola in the right directory translationfile filename qm when starting Dymola One specific opportunity here is to use a translation file other that the one in the Dymola distribution The file can be located anywhere on the machine since the command line option demands the path of the file to be specified An example could be to start Dymola with the command C Program Files x86 Dymola 2016 bin64 Dymola exe translationfile E Extra NewJapaneseTranslationFile qm given using a 64 bit Dymola from the default location and a translation file NewJapaneseTranslationFile located in E Extra Note that command line options can be inc
5. Cancel In this example the Hydraulics library was opened DymolaStandard indicates borrowing of Dymola without any options Please be careful not to open libraries options that might be needed for others unless you really intend to do so Borrowing an option only available for one user only might not be appreciated by others 6 Finally disconnect from the license server while Dymola is still running This step will create the local license file with the borrowed license After disconnecting Dymola can be stopped Running Dymola During the borrowing period Dymola can be started and stopped as often as needed When license borrowing is used Dymola displays it on the splash screen shown when starting Dymola and when using the command Help gt About Dymola APPENDIX INSTALLATION 37 Borrowing period in About Dymola About dialog Dymola Dynamic Modeling Laboratory Version 7 4 2010 02 03 License number 1 Using a borrowed license Copyright Dassault Syst mes 1992 2010 All rights reserved Most information is given using the command Help License in the Borrow tab Dymola License Setup General Details Borrow Setup Borrow licenses Borrow until Start to Return 2010 02 05 Borrow Early Borrowed options and expiration dates Option Valid until DymolaStandard 22 Feb 10 23 59 DymolaHydraulics 23 Feb 10 00 00 OK Cancel Returning a license before expiration of b
6. Dymola has started with an old license file set DYMOLA_RUNTIME_LICENSE C My Documents dymolaRT lic For information about license requirements in general see section License requirements starting on page 44 For more specific information about export options in particular see the manual Dymola User Manual Volume 1 chapter 6 Other Simulation Environments section Code and Model Export Upgrading from Dymola 6 1 and earlier The license file format of Dymola has been upgraded to include the latest security technology For that reason license files for earlier versions of Dymola are not compatible with Dymola 7 0 and later and license files for Dymola 7 0 and later are not compatible with older versions of Dymola If Dymola 7 0 and later finds an old license file at start up a diagnostic message about incorrect license file format is displayed Dymola will then continue execution in demo mode Dymola License file has incorrect format File e dymola insert dymola lic Dymola will continue in demo mode 1 1 5 Additional setup Language The selection of translation file for Dymola is by default based on the regional language setting Please note that currently only English and Japanese are available in Dymola If the regional language setting should not be used there are two ways of overriding it The first is to use a command line setting of the language translation language
7. Returning a license before expiration of borrowing early return Currently borrowed licenses can be returned early when the computer is connected to the license server again The names of the features that are currently borrowed can be seen using the status command in the previous section When returning any of these names must be used in the return command below In order to do an early return give a return command while Dymola is connected to the server An example returning the license for Pneumatics Library for a 64 bit Dymola 2016 is opt dymola 2016 x86 64 bin lmutil lmborrow return c dynasim dymola lic DymolaPneumaticsLib Whether the return was made can be seen using the status command in previous section A license returned to the license server cannot be checked out again until after approximately 2 minutes If licenses are returned by e g exiting Dymola but Dymola is restarted within approximately 2 minutes the return is never performed 1 5 Utility programs 1 5 1 Obtaining a host id To be able to easy find out the host id of a computer without having Dymola installed a small file hostid exe can be obtained from your Dymola distributor If Dymola demo is installed the host id can also be found using Dymola please see section Obtaining a host id on page 15 Executing this file by double clicking it or opening it the following menu will be displayed WinZip Self Extractor hostid exe WE Dvm
8. e The license file is locked to your computer system which means that you cannot execute Dymola from another computer e The license file format has been changed in Dymola 7 0 and later versions If you also have older versions of Dymola installed please check that you have a new license file as well APPENDIX INSTALLATION 49 Additional information If there is some error in the license file or with the license server Dymola presents a short error message by default A more detailed description including FLEXnet Publisher error codes is produced if Dymola is started with the command line option FLEX1mDiag On Windows start a command DOS window using the command Start gt All Programs gt Accessories gt Command Prompt in Windows and issue the following commands assuming Dymola 2016 64 bit is used on a 64 bit computer cd Program Files x86 Dymola 2016 bin64 dymola exe FLEXlmDiag On Linux the command will be dymola FLEXlmDiag The additional information will in many cases be helpful in correspondence with support License server Correct operation of the license server should be verified with lmtools exe see Installing the license server on page 31 The FLEXnet Publisher logfile provides additional information about the day to day operation of the server Always using the latest version of the FLEXnet Publisher license daemon 1mgrd exe is strongly recommended It is guaranteed to be compatible w
9. Windows installation 6 Modelica 2 compatible libraries 20 MODELICAPATH 21 My Documents amp N node locked license 15 P Program Files 8 R runtime license 17 S sharable licenses 14 Simulink troubleshooting 53 System requirements hardware minimum 42 hardware recommended 42 software Linux 44 software Windows 43 T trobleshooting Dymola on Windows 7 53 troubleshooting compiler 31 language 54 license borrowing 30 license file 49 license server 50 other windows problems 54 58 Simulink 53 U UNC 8 upgrading Dymola 18 W Windows Dymola as 32 bit application 6 Dymola as 64 bit application 6 Dymola license server 31 Windows 7 Dymola on Windows 7 53 working directory Dymola 8 set default for Dymola 19 59
10. see the section about importing a model to Simulink below For other platforms for example Linux but also optionally in Windows you can use the Import mode of the Dymola Simulink interface You can export models to be imported in this mode To do this you must use the ExternalInterfaces library the ExternalInterfaces Export toSimulink function You need the Simulink Interface license to do this Depending on how the model should be used there are additional requirements see section Importing a model to Simulink below Exporting a model for integration with Real Time Workshop dSPACE and xPC You can do this by using the ExternalInterfaces library the ExternalInterfaces Export toSimulink function You need to have both the Simulink Interface license and the Real Time Simulation license to do such an export If you have a Source Code Generation license that one includes Real Time Simulation as well Exporting a model to FMU format See the section Importing an FMU below this section also explains the export Exporting a model to Binary You can export a model to binary This requires the license Binary Model Export The Source Code Generation license includes this functionality as well Such an exported model can be executed on a machine without having any Dymola license Exporting a model to Source Code C code You can export a model to source code This requires the license Source Code Genera
11. 48 lmgrd Detecting other license server manager lmgrd processes 12 30 48 lmgrd Done rereading 12 30 48 lmgrd FLEXnet Licensing v11 4 100 0 build 50818 i86 n3 started on 194 103 53 51 IBM PC 2 11 2008 12 30 48 lmgrd Copyright c 1988 2007 Macrovision Europe Ltd and or Macrovision Corporation All Rights Reserved 12 30 48 lmgrd US Patents 5 390 297 and 5 671 412 12 30 48 lmgrd World Wide Web http www macrovision com 12 30 48 lmgrd License file s C NUlfNDymolaN99 wistrom dynasimab2 lic 12 30 48 lmgrd lmgrd tcp port 27000 12 30 48 l1mgrd Starting vendor daemons 12 30 48 l1mgrd Started dynasim pid 4180 12 30 48 dynasim FLEXnet Licensing version v11 4 100 0 build 50818 i86 n3 12 30 48 dynasim Server started on 194 103 53 51 for DymolaStandard 12 30 48 dynasim DymolaAnimation DymolaModelCalibration DymolaModelManagement 12 30 48 dynasim DymolaOptimization DymolaRealtime DymolaSimulink 12 30 48 dynasim DymolaFlexibleBodiesLib DymolaHydraulicsLib DymolaPowertrainLib 12 30 48 dynasim DymolaSmartElectricDrivesLib 12 30 48 dynasim EXTERNAL FILTERS are OFF 12 30 48 lmgrd dynasim using TCP port 2606 12 30 56 dynasim TCP NODELAY NOT enabled 10 39 20 l1mgrd Detecting other lmgrd processes 10 39 35 lmgrd FLEX1m v7 2c started on x x x x 3 27 2001 10 39 35 l1mgrd FLEXl1m Copyright 1988 2000 Globetrotter Software 10 39 35 lmgrd US Patents 5 390 297 and 5 671 412 34
12. C 11 troubleshooting 51 D daemon license 3 vendor 31 Dymola 32 bit application on Linux 28 32 bit application on Windows 6 64 bit application on Windows 6 Dymola license server on Linux 40 on Windows 31 E environment variables DYMOLA 29 DYMOLA RUNTIME LICENSE 17 DYMOLAPATH 29 DYMOLAWORK 8 29 LM_BORROW 40 MODELICAPATH 21 29 F file extensions cab 19 msi 19 FLEXnet 31 57 license server options file 39 G GCC on Linux 28 GCC on Windows 11 H host id 15 incorrect license file format 18 installation environment variables 29 license daemon 31 license server on Linux 40 license server on Windows 31 Linux 28 remote on Windows 19 troubleshooting 49 windows 6 L language setting 18 library Modelica 2 compatible libraries 20 libraryinfo mos 21 license borrowing general 35 borrowing on Linux 40 borrowing on Windows 35 daemon 31 demands 44 early return on Linux 41 early return on Windows 38 error message 49 expiration settings 23 incorrect file format 18 node locked 15 not found or invalid settings 23 preventing checking out in Linux 30 preventing checking out in Windows 23 requirements 44 runtime 17 server on Linux 40 on Windows 31 server options file 39 sharable 14 Linux Dymola as 32 bit application 28 Dymola license server 40 installation 28 local host id 15 Microsoft Visual C 11
13. Install to If the path should be changed click on the Change button Here the path can be changed a change has to be acknowledged by clicking OK Dymola installation directory Change Current Destination Folder Browse to the destination folder Look in i Dymola 2015 IShield Dymola defines an environment variable DYMOLAWORK which value is the Dymola working directory This is the default location where Dymola starts Dymola by default starts in the directory My Documents NDymola that subdirectory will be created if it doesn t exist Please note that this cannot be an UNC path i e server Selecting components The second choice is to select optional components of the distribution By unselecting com ponents some space can be saved Component selection 4 5 Dymola 2016 Beta 3 InstallShield Wizard Custom Setup Select the program features you want installed Click on an icon in the list below to change how a feature is installed Feature Description a EH qs Ge Librari Dymola application and Modelica T PT Standard Library X AirConditioning E ElectricPower EngineDynamics bs FlexibleBodies This feature requires 510MB on FlightDynamics your hard drive FuelCell HeatExchanger PES RN x x x x x x Install to C Program Files x86 Dymola 2016 Beta 3 InstallShield Se Gee Ge ee Get
14. Modify The rest of the procedure will be the same as when installing Dymola from scratch Please see previous sections To restore files in the Dymola APPENDIX INSTALLATION 27 1 2 This section refers only to the Linux version of Dymola distribution that have been deleted by mistake choose Repair Remove will remove the installation 1 1 7 Removing Dymola Please see previous section Do not delete or rename the Dymola directory Microsoft Windows Installer keeps track of all installed directories and will try to repair if altered The installation will by default use a directory name that reflects the version of Dymola but this can of course be changed during setup Note that files that you have created in the Dymola distribution directory for example by running the demo examples are not deleted when removing Dymola The remaining files and directories if any may be deleted through the Explorer 1 1 8 Installing updates Updated versions of Dymola are either distributed on CD or can be downloaded from a location provided by your sales channel Multiple versions of Dymola can be installed but you cannot install into an existing Dymola directory Configuration settings and the license file are shared by all installed versions of Dymola Installation on Linux This section covers Linux specific parts of the installation For general items e g how to handle the Dymola installation wizard please see corresponding sec
15. Subjects in the corresponding section on Windows are not applicable unless explicitly referenced from here APPENDIX INSTALLATION 29 Compilation of model code Dymola produces C code which must be compiled in order to generate a simulation model On Linux systems we rely on an ANSI ISO C compiler already installed on the computer On Linux systems the compilation of the generated C code is performed by a shell script opt dymola version architecture insert dsbuild sh see above concerning version architecture If necessary this script can be modified to provide special options to the compiler add application specific libraries etc Simulation performance can be improved by tuning the compilations options in this script however note that the compiler time may increase significantly by doing so Dymola supports external C libraries on Linux Classes which contain Library annotations to link with external libraries in C are supported Simulation from the command line The simulator executable dymosim can be executed from the shell To do so the environment variable LD LIBRARY PATH must be set export LD LIBRARY PATH opt dymola version architecture bin lib Security Enhanced Linux SELinux might display the message below example for 64 bit application dymosim error while loading shared libraries opt dymola 2016 x86 64 bin lib libds so cannot restore segment prot after reloc Permission den
16. The sub section Additional setup starting on page 18 treats specific issues as installing Dymola as administrator on a computer that should be used by non administrators and remote installation of Dymola Finally change of setup removal of Dymola and installing updates are described In section 1 2 Installation on Linux starting on page 28 the installation on Linux is described in a similar way as the previous section The sub section Additional setup starting on page 29 describes e g compilation of model code and simulation from the command line In section 1 3 Dymola License Server on Windows starting on page 31 the installation of a license server on Windows is described as is the borrowing of licenses In section 1 4 Dymola License Server on Linux starting on page 40 the installation of a license server on Linux is described as is the borrowing of licenses In section 1 5 Utility programs starting on page 41 a utility program for finding a host id on a computer is described In section 1 6 System requirements starting on page 42 the hardware and software requirements recommendations are listed APPENDIX INSTALLATION 5 In section 1 7 License requirements starting on page 44 the license requirements for various features are listed In section 1 8 Troubleshooting starting on page 49 the solution to various problems are described It might be license file problems compiler problems issues with S
17. check out of the options respecively Advanced EnableRealtimeSim false Advanced EnableCodeExport false Advanced EnableModelManagemant false For more information concerning real time simulation and code export please see the manual Dymola User Manual Volume 2 chapter Other Simulation Environments By modifying the shortcut to Dymola By starting Dymola with a certatin command line option using the Command Prompt in Windows Modifying the shortcut will result in prevention of check out of specified options each time Dymola is started using that shortcut as Starting Dymola using a modified command from the command prompt in Windows will only result in prevention of check out of specified options in that session Since the command for prevention of checking out license options is generic it is very important to use the correct name of the option including correct use of captitals The best way is to look at the checked out options using the command above and mark and copy the name of the option that should not be checked out to insert that name when using any command 24 Modification of the shortcut to Dymola If a new shortcut is needed please look at the section Creating shortcuts to Dymola above To modify the shortcut to prevent checking out a certain option right click the shortcut and modify the Start in by adding lt space gt No lt optionname gt in the end of the command If the
18. chine the license server is then installed as described below The license server consists of two daemon processes e The vendor daemon called dynasim exe dispenses licenses for the requested features of Dymola the ability to run Dymola and various options This program is specific for Dymola e The license daemon called 1mgrd exe sends requests from application programs to the right vendor daemon on the right machine The same license daemon can be used by all applications from all vendors as this daemon processes no requests on its own but forwards these requests to the right vendor daemon If you are already running an application that uses FLEXnet Publisher you most likely already have a running license daemon In this case only the vendor daemon dynasim exe is required Flexera Software recommends that you use the latest version of the FLEXnet Publisher lmgrd exe at all times as it includes bug fixes enhancements and assures the greatest level of compatibility with all of your FLEXnet Publisher licensed applications Flexera Software guarantees that it will work correctly with all earlier versions of FLEXnet Publisher Dymola requires support of FLEXnet Publisher version 11 11 A recent version of lmgrd exe is part of the Dymola distribution If needed the latest available license daemon can be downloaded from the website of Flexera Software when having completed a form http mktg flexerasoftware com mk get lmgrd re
19. described below will be displayed e g when no compiler is selected APPENDIX INSTALLATION 51 r No compiler version selected Please select a version of Visual C or GCC For instructions on how to install a supported C compiler please visit www dymola com compiler See also Installation Troubleshooting in the Dymola manual If no compiler has been selected or installed the corresponding information will also be displayed in the command log in the Translation tab i Translation of Modelica Mechanics Rotational Examples CoupledClutches r The DAE has 106 scalar unknowns and 106 scalar equations i Statistics Selected continuous time states ge Q Compilation of Modelica Mechanics Rotational Examples CoupledClutches failed See Simulation tab for more information Note There were translation errors that might explain the problem ERROR 1 error was found And also in the Simulation tab TE oymoiaMesages a L zs No compiler selected Please select a version of Visual Ctt or GCC For instructions on how to install a supported compiler please visit www dymola com compiler 52 Dymola webpage for compiler issues A web page is available for Dymola compiler issues www Dymola com compiler This page contains the following information e Links to download compilers e Extract from the documentation concerning installation and troubleshooting of compilers A
20. in Model Cx Cancel The selected compiler is stored as a per user setting and for the future kept for new installations of Dymola Switching compiler does not modify Dymola bin Note the importance of the Test compiler button As an example you cannot see from the menu if you have a valid MinGW compiler available you must use the Test compiler button to see if this is the case Classes which contain Library annotations to link with external libraries in C are supported for Microsoft Visual Studio compilers If you link with your own C libraries you have to recompile them as multi threaded The reason is that single threaded compilation is APPENDIX INSTALLATION 13 License server setup phased out in Visual Studio 2005 and multi and single threaded libraries reading from files are not link compatible Thus Dymola only supports linking with multi threaded libraries in Microsoft Visual Studio compilers For GCC compilers see the limitations above For information about possible compiler problems please see the troubleshooting section Compiler problems on page 51 1 1 4 Installing the Dymola license file After installation Dymola will initially start in demo mode While running in demo mode you can continue with installing the license file Setting up a sharable license Sharable licenses are requested by Dymola from a license server The information normally required on the client computer is just th
21. option we advice that you in 64 bit Dymola generate a 64 bit Dymosim exe using the flag Advanced CompileWith64 2 For more information about this flag see chapter Simulating a model section Dynamic Model Simulator Sharable licenses Please note that if a new session is started in Windows by using Log Off gt Switch User the original user is still logged on and any Dymola program occupies a sharable license 1 8 2 Compiler problems Test compiler button and error messages The compiler used to compile the C code generated by Dymola into executable code for simulation is set in the Compiler tab using the command Simulation gt Setup see chapter Simulating a model section Editor command reference Simulation mode sub section Main window Simulation menu command Simulation gt Setup Some potential problems can be found by pressing the Test compiler button in the Compiler tab see above Any warning messages indicate problems that need to be resolved before translating a model Pressing the button performs a number of tests e Validates the DOS environment e Check the Dymola installation for run time libraries e Verifies that the selected compiler directory contains a valid compiler e Validates that the compiler can compile by executing a small test model The compiler is tested for both 32 bit and 64 bit mode Error messages with information how to proceed including a link to the web page
22. that is no longer connected to the license server For license borrowing an end user initiates borrowing and specifies the expiration date a borrowed license is to be returned to the sharable license pool While still connected to the network the application is run from the client computer This writes licensing information locally onto the client computer The client computer can now be disconnected from the network The license server keeps the borrowed license checked out The client application automatically uses the local secured data file to do checkouts during the borrowing period Upon the expiration of the borrowing period or the early return of a borrowed license the local data file no longer authorizes checkouts and the license server returns the borrowed license to the pool of available licenses No synchronization is required between the license server machine and the client machine when the borrowing period expires License borrowing License borrowing and early returns are performed from Dymola In order to borrow do the following APPENDIX INSTALLATION 35 1 While Dymola is connected to the server use the command Help gt License and select the Borrow tab Dymola License Setup General Details Borrow Setup Borrow licenses Borrow until Start to EU 2010 02 05 v Borrow Early Borrowed options and expiration dates Option valid until 2 Select an end date either by changing the dat
23. Category Optional sub categories text Text shown in menu reference Model path or command string isModel If true the text is a model path otherwise a command Description Longer description for example shown in status bar version Version of library does not apply to demos See Important below ModelicaVersion Required version of Modelica Standard Library e g gt 2 The value 2 means gt 2 Pos Position in the menu The menu alternatives are sorted according to this attribute lowest numbered at the top To handle different libraries and groups of libraries and to make sure Dymola has a consistent ordering of Libraries Dassault Syst mes allocates ranges of positions to different library vendors For example 0 to 999 could be reserved for Dassault Systemes 1000 to 1999 for DLR etc Important For libraries the version must be specified in the libraryinfo mos file and in the corresponding library file package mo The latter is done by the version annotation The version specified must be the same in both files Adding a menu separator It is possible to add a separator horizontal line in the menus For example LibraryInfoMenuSeparator category libraries pos 101 22 The arguments have the meaning described in the table above Loading a package with user defined menus and toolbars that should not be deleted by File gt Clear All A package with user defined menus and t
24. Dymola Dynamic Modeling Laboratory Installation Contents Chapter 6 Appendix Installation extracted from the manual Dymola User Manual Volume 1 March 2015 Dymola 2016 The information in this document is subject to change without notice Copyright 1992 2015 by Dassault Systemes AB All rights reserved Dymola is a registered trademark of Dassault Systemes AB Modelica is a registered trademark of the Modelica Association Other product or brand names are trademarks or registered trademarks of their respective holders Dassault Systemes AB Ideon Gateway Scheelev gen 27 Floor 9 SE 223 63 Lund Sweden E mail http www 3ds com support URL http www Dymola com Phone 46 46 270 67 00 Contents 1 Appendix Installation kesscctiscacseoksscacizivcosccsbdesveibiston sexsopeceoasbichaandooseiadoesecesivapisooustontarnssnetial l l nstallationcon WindOwWs reete e e Re Pee e ROUES eo ETE een rS 6 1 1 1 Dymola as 32 bit and 64 bit application essere enne nre enne 6 1 1 2 Installing the Dymola software eene eene emeret tenete ee trennen trennen 6 1 1 3 Installing C compiler 25 ueteri nep Eb MM ERE REO RR RO ed 11 1 1 4 Installing the Dymola license file essere nenne nennen enne neret nennen en nente enne 14 1 1 5 Additional setup x 5 eoe bie t po insere bebo be bo perse obe te e bursts te de ein 18 1 1 6 Changing the setup of Dymola s
25. PPENDIX INSTALLATION 19 INSTALLLEVEL Description unspecified Installs Dymola and standard libraries 201 As above and also installs commercial libraries compatible with Modelica language version 3 301 As above and also installs commercial libraries compatible with Modelica language version 2 2 2 1001 As above and also installs Japanese translations of dialogs and menus Installing Modelica 2 compatible libraries Modelica 2 compatible libraries that might be needed to work with an older Modelica model that has not been converted to the new libraries have to be installed separately However they are included in the Dymola media as extra CompatibilityLibraries exe Running this file will display a message Modelica 2 Compatibility Libraries Installation of Modelica 2 Compatibility Libraries For Dymola Please install in the Dymola installation directory tree e g in dymola Modelica Library or in some other directory on MODELICAPATH Selecting OK will display WinZip Self Extractor CompatibilityLibraries exe To unzip all files in this self extractor file to the specified folder press the Unzip button urn i Run WinZip Unzip to folder IME T UWM LOCALS 1 Temg Close verwrite files without prompting About Help Typically a path to browse to is C Program Files x86 Dymola 2016 Modelica Library Selecting Unzip will unzip the files to this folder 20 Adding librari
26. ab a Select the radio button Configuration using Services b Activate LMTOOLS ignores license file path environment variables LMTOOLS by Macrovision Corporation http www macrovision com File Edit Mode Help Service License File System Settings Utilities Statt Stop Reread Server Status Server Diags Config Services Borrowing Services allow FLEXnet Servers to run in the background Server List Configuration using License File Configuration using Services NM LMTODLS ignores license file path environment variables No FLEXIm Services defined use Configure Services to add services 5 In the Config Services tab please see figure on next page a Enter a new service name e g Dynasim License Server b Enter the path to the license daemon Dymola 2016 bin lmgrd exe c Enter the path to your server license file 32 d Enter the path to a debug log file anywhere you want e Enable Use Services and then Start Server at Power Up f Click on Save Service Click on Yes to confirm Configuration of the li cense server LMTOOLS by Macrovision Corporation http Awww macrovision com File Edit Mode Help Service License File System Settings Utilities Start Stop Reread Server Status Server Diags Config Services Borrowing Configure Service Service Name Dynasim License Manager Y Path to the Imard exe file C Program Files Dymola 7 0 bin Imard exe __ Browse Path
27. activated using Help gt All Programs gt Accessories Command Prompt in Windows To start one session in Dymola where the license option ModelManagement cannot be checked out like in the example above the command in the command prompt will look like C MyExperiments gt C Program Files Dymola 7 3 bin Dymola exe NoMode lManagement 26 Changing Dymola setup 1 1 6 Changing the setup of Dymola Under Windows you can change the setup of Dymola for example to install additional libraries Click on the Start button in the Taskbar select Control Panel and open Add or Remove Programs Select the relevant version of Dymola and click on the Change button G 33 Dymola 2015 InstallShield Wizard M Welcome to the InstallShield Wizard for Dymola 2015 The InstallShield R Wizard will allow you to modify repair or remove Dymola 2015 To continue dick Next Selecting Next gt will display 4 48 Dymola 2015 InstallShield Wizard Program Maintenance Modify repair or remove the program Modify Change which program features are installed This option displays the 138 Custom Selection dialog in which you can change the way features are installed Repair installation errors in the program This option fixes missing or corrupt files shortcuts and registry entries Remove Dymola 2015 from your computer InstallShield To change the setup choose
28. cense for real time simulation In Dymola To be able to enable inline integration needed for real time simulation you must have the Real Time Simulation license The Source Code Generation license includes this functionality as well On dSPACE and xPC Target platforms To be able to use real time simulation on dSPACE or xPC Target platforms you must have e The Simulink Interface license in Dymola to use the Dymola Simulink interface e Any of the licenses Real Time Simulation or Source Code Generation depending on what you want to do o If you only want to use models that use inline integration the Real Time Simulation license is sufficient o If you want to use other models as well you need the Source Code Generation license 1 7 4 Licenses for exporting code The assumption is that the model is to be imported executed on another machine than the one where it was created Exporting a Dymola model to a machine without a Dymola license See the corresponding import section below that also explains the export APPENDIX INSTALLATION 45 Exporting a model to Simulink In Windows you can use the Dymola on Windows mode of the Dymola Simulink interface using DDE communication between Dymola and Simulink In this mode you can export a compiled model and execute it on another Windows computer You don t need any license to export the compiled model but there might be requirements depending on how you want to use it
29. cript which is automatically located by Dymola at program start This script can contain a set of commands that describes the package and builds e g File gt Libraries The script is called libraryinfo mos and stored in subdirectory Scripts Assuming the package is stored in dymola Modelica Library XYZ the script is called dymola Modelica Library XYZ Scripts libraryinfo mos Alternatively the file can be stored in the same directory as the library e g dymola Modelica Library XYZ libraryinfo mos Note that you must yourself create the scripts for your own libraries if you e g want to add them in menus It is wise to look both below and at the already present libraryinfo mos files for libraries already in the File gt Libraries menu when doing this APPENDIX INSTALLATION 21 Building menus There is currently a low level script command to build libraries and demos menus e g LibraryInfoMenuCommand category libraries text Hydraulics reference Hydraulics isModel true description Hydraulics Library 4 1 by Modelon version 4 1 ModelicaVersion gt 3 2 pos 3450 LibraryInfoMenuCommand category demos text My Demo reference MyDemo MyDemoModel isModel true description My demo basic pos 9999 The attributes have the following meaning Attribute Meaning category Primary menu category libraries demos or persistent sub
30. d to generate the DymolaBlock S function The LCC compiler is not supported 1 8 4 Change of language Dymola is available in Japanese Sometimes the user wants to change the language after installation Please see section Language on page 18 on how to do this 1 8 5 Other Windows related problems Starting the installation The installation normally starts automatically when you insert the distribution DVD If auto start has been disabled please start D Nsetup exe assuming your DVD drive is labeled D from Windows Explorer by double clicking on the file or use the Start button in Windows select Run enter D setup exe and click OK 54 Deep directory hierarchies Compilation and simulation of the model may fail in a very deep directory hierarchy if the length of the directory path exceeds 250 characters This is caused by a bug in Microsoft software and we are investigating ways to work around it Writable root directory Due to a bug in some versions of the Microsoft runtime library the root directory C should be writable in order to store temporary files If that is not the case Dymola will create working files in the current directory which are not automatically deleted APPENDIX INSTALLATION 55 56 2 Index A AddModelicaPath 21 borrowing general 35 on Linux 40 on Windows 35 C C compiler 11 compiler 11 GCC on Linux 28 GCC on Windows 11 installation 11 Microsoft Visual
31. ded memory size is 4 GB of RAM for 32 bit architecture and 6 GB of RAM for 64 bit architecture 42 1 6 3 Software requirements Microsoft Windows Dymola versions on Windows and Windows operating systems versions Dymola 2016 is supported as 32 or 64 bit application on Microsoft Windows 7 and Windows 8 1 Since Dymola does not use any features supported only by specific editions of Windows Home Professional Enterprise etc all such editions are thus supported if the main version is supported Compilers Please note that for the Windows platform a Microsoft C C compiler or a GCC compiler must be installed separately The following compilers are supported for Dymola 2016 on Windows Visual Studio Free editions e Visual Studio 2008 Express Edition 9 0 e Visual C 2010 Express 10 0 e Visual Studio 2012 Express Edition 11 0 e Visual Studio 2013 Express Edition 12 0 Visual Studio Professional editions e Visual Studio 2005 8 0 e Visual Studio 2008 9 0 e Visual Studio 2010 10 0 e Visual Studio 2012 11 0 e Visual Studio 2013 12 0 GCC compilers e 32 bit MinGW with a GCC version compatible with 4 8 1 e 64 bit MinGW with a GCC version compatible with 4 9 2 Note the GCC compilers have some limitations and demand for an add ons etc please see section GCC compiler on page 11 Dymola license server For a Dymola license server on Windows all files needed to set up and run a D
32. e in the input field for Last date borrowed or by clicking on the arrow to display a calendar for selection of date Clicking the arrow will display E Dymola License Setup General Details Borrow Setup Borrow licenses Borrow until Return 2010 02 05 Early Sun Mon Tue Wed Thu Fri Sat 1 Fa 3 4 5 6 10 11 12 13 17 18 19 20 24 25 26 3 4 5 a sul ies sh be Here the possible selection of dates is clearly visible Clicking on a date will change the input field to that date 3 Click on Start to Borrow The following message will appear E Dymola License Setup i Borrowing has been initiated Restart Dymola and check out all options you need before disconnecting From the license server 4 Click OK and OK and restart Dymola while still connected to the server now the basic borrowing is performed Borrowing will be indicated in several ways please see next section 5 Open all libraries options that you will need during your borrowing time This will ensure that the appropriate license features are stored locally The list in the lower half of the dialog displays currently borrowed licenses and when they will be automatically returned to the server Dymola License Setup General Details Borrow Setup Borrow licenses Borrow unt Retum 2010 02 05 Borrow Early Borrowed options and expiration dates Option Valid until DymolaStandard 22 Feb 10 23 59 DymolaHydraulics 23 Feb 10 00 00 OK
33. e key the relevant host id of the computer where Dymola should run must be supplied to your Dymola distributor The license that you will receive will contain this information There are two ways finding out this host id depending on whether a Dymola demo is installed before or not The host id can always be fond using the utility program hostid exe Please see section Obtaining a host id on page 41 for more information about this program If the Dymola demo has already been installed Dymola can be used to find the host id Start Dymola and select Help License and then the Details tab Click on Copy to Clipboard to copy the local host id Please note that some laptops present different host id s depending on whether they are connected to a docking station or not In such a case please copy all host id s APPENDIX INSTALLATION 15 Local host id of the computer running Dymola General Details Borrow Setup Dymola License Setup Checked out license options Free Disabling of license options C Disable real time simulation C Disable code export Local host id 0026b98b747F Copy to Clipboard Compose an e mail containing your local host id host id s and send it to your Dymola distributor Installing the node locked license When you have received your license file do save the license somewhere on your computer Start Dymola and select Help gt License select the Setup tab Click o
34. e name or IP number of the license server Start Dymola and select Help gt License and then the Setup tab Enter the name or IP number of the server If so instructed by the system administrator also enter the port number By default leave this field empty Dymola License Setup qa General Details Borrow Setup License server Server name server dymola se Port optional Local license file File name Browse Install license For all users J Install for all users requires administrator rights If you want to use redundant servers you can add three server names IP numbers separated by space Note that one or three servers must be specified You have the option of installing the license file only for the currently logged in user or for all users on this computer The latter requires administrator rights Click on the OK button Dymola will ask for confirmation before overwriting your old license information 14 I Dymola License Setup Do you want to change your license server setup Change Server Settings 3 After changing the license server setup you must restart Dymola to use the new server Dymola License Setup i Dymola license has been updated Please restart Dymola Installing a node locked license Node locked licenses are stored locally on the computer running Dymola and are not shared with other computers Obtaining a host id To order a node locked licens
35. eded to set up and run a Dymola license server on Linux except the license file are available in the Dymola distribution This includes also the license daemon where Dymola presently supports FLEXnet Publisher version 11 11 This version is part of the Dymola distribution 1 7 License requirements 1 7 1 General This description covers the license requirements for different features for description of the features themselves please see relevant documentation in Dymola User Manual Volume 2 chapter Other simulation environments and the documentation for the libraries This description assumes that machines having Dymola installed have the Dymola Standard Configuration license 44 Apart from the Standard Configuration license there are other licenses for different categories of users e Demo license e Licenses for academia Academic Learn Innovate Student Learn Innovate Some limitations may apply to those in particular the demo license is limited Licenses can be node locked to a certain machine or sharable accessible from a license server Note that node locked and sharable licenses cannot be mixed 1 7 2 License for Dymola Simulink interface To use the traditional connection between Dymola and Simulink Dymola on Windows Mode you need a Simulink Interface license in Dymola Note that this mode is not available for Linux For Linux see section Import to Simulink the second part 1 7 3 Li
36. ener l nones me pom DIEI D DIERUM 44 1 7 2 License for Dymola Simulink interface sess en eene trennen 45 1 7 3 License for real time simulation sese nennen rene rennen tenente tree 45 1 7 4 Licenses for exporting code nseri etie erben e reni EEAS Eire peer rere e bep enne 45 1 7 5 Licenses for executing importing using code oo ee eee eeceeecesecesecneceaecseecaeecaeeeaecaeecaeseaeseaeeeeseaeenes 46 1 7 6 Licenses for libraries in the Dymola library menu 0 00 0 eee eee ceeeceeeeesecesecnaeceaecaaecaeeeaeseeeeeeeees 48 1 7 7 Licenses for libraries not in Dymola library menu sss enne 49 ES Troubleshooting nanen cn ih nente cete tete cba rere Rire e RE ER e Re HD e inre ess 49 1 8 1 License hile sehn pev Belt USO bene pem ERE 49 1 8 2 Compiler problems cies eh eS ep een Be epe ERR 51 1 8 3 oni qe cc 53 1 8 4 Change of language tete aat ee ant ede e pete etit elo rte eee 54 1 8 5 Other Windows related problems 0 eee cece cesecsseceeecaeecseeeeeeeeeeseeeeeceseeseessecsaecsaecsaecaaecaaeeaeseneeeaeees 54 lino cR c DF 1 Appendix Installation This chapter describes the installation of Dymola on Windows and Linux and related topics The content is the following In section 1 1 Installation on Windows starting on page 6 the installation on Windows is described including installation of Dymola software C compiler and license sharable or node locked
37. es and demos to the File menu Dymola can automatically recognize different libraries in order to e g build the File gt Libraries and File gt Demos menus It is very easy to add new libraries and to add new versions of existing libraries All information about a library exists in a local file so it is possible to just unzip a subdirectory containing a package and it will automatically be recognized by Dymola No update of a common file is needed hence no need for special installation scripts It also makes it easy to delete libraries just delete the directory Dymola will find libraries by searching all directories in the environment variable MODELICAPATH If not set by the user MODELICAPATH contains dymola Modelica Library It is possible to manage the MODELICAPATH from within Dymola by a built in function AddModelicaPath path erase false The function appends a directory specified by the string variable path to the Modelica path unless erase true An alternative is to use Modelica Utilities System setEnvironmentVariable MODELICAPATH Nr R Notes e The menus File gt Libraries and File gt Demos are rebuilt after a change of MODELICAPATH e To keep the change of Modelica path between sessions this function has to be added in setup mos It is currently not possible to store the change of the Modelica path from GUI Using library information Associated with each package is a Modelica s
38. eserve licenses for specified users e Control how many licenses can be borrowed and for how long The options file shall be called dynasim opt and placed in the same directory as the Dymola license file of the license server An example of an options file that reserves a Dymola Hydraulics library license for the user Bob is RESERVE 1 DymolaStandard USER Bob RESERVE 1 DymolaHydraulics USER Bob Applicable feature and user names can be found in the license server log file The details of the options file are described in Chapter 5 of FLEXnet Licensing End User Guide which is available on request APPENDIX INSTALLATION 39 1 4 This section refers only to the Linux version of Dymola Dymola License Server on Linux This section covers Linux specific parts of the Dymola license server For general items e g background and how to set up the server using 1mtools exe please see corresponding section on Dymola License Server on Windows Note Dymola requires support of FLEXnet Publisher version 11 11 This version is part of the Dymola distribution for Linux The Linux license server for Dymola is located in a separate tar file To start the server the dynasim and the Im files need to be installed for example in usr local bin The server is started with the command imgrd c path to license file l path to logfile gt A check with pg aguxf should show two new processes 1mgrd and dy
39. g 1 3 2 Installing the license server This section describes the simple case where we assume there are no other FLEXnet Publisher license daemons We also assume that the Dymola program itself should not be installed on the server To purchase a license server the relevant host id of the computer where the license server should run must be supplied to your Dymola distributor before purchasing the license The APPENDIX INSTALLATION 31 License server setup license that you will receive will contain this information To find out the host id of that computer the utility program hostid exe can be used Please see section Obtaining a host id on page 41 for more information 1 Before installation of the license server the Dymola license file filename lic may have to be updated with the actual name or IP number of the server if the license file contains a line identifying the server SERVER server name here 000102DE37CD The part server name here must be changed to the name of the actual server before installing the license file It should be noted that the last part the hostid cannot be edited by the user 2 Install only the Dymola software component License server see beginning of this chapter A folder will be created containing all needed files default C Program Files x86 Dymola 2016 bin 3 Start the utility program 1mtools exe one of the above files 4 In the Service License File t
40. ied If this message is displayed the following commands must be executed for this 64 bit example chcon t textrel shlib t opt dymola 2016 x86 64 bin lib libds so chcon t textrel shlib t opt dymola 2016 x86 64 bin lib libGodessMain so Note that running simulations in the Dymola environment do not require these changes Adding libraries and demos to the File menu Please see corresponding section for Windows installation on page 21 Preventing checking out options from a license server In the corresponding section on Windows the alternative of starting Dymola using a modified command is applicable also for Linux with relevant changes for Linux Please see page 26 1 2 3 Removing Dymola Remove the Dymola distribution by using the rpm u command 30 1 3 Dymola License Server on Windows This section refers only to the Windows version of Dymola Old license daemons cannot be used 1 3 1 Background These are instructions for manually installing a FLEXnet Publisher license server for Dymola on Windows They only apply to users with a sharable license For non sharable licenses the common case installation of the license file is automatic All files needed to set up and run a Dymola license server on Windows except the license file are available in the Dymola distribution in Program Files x86 Dymola 2016 bin Dymola is installed on all machines which will run the software On the designated ma
41. imization in the compiler by setting the flag Advanced Define GlobalOptimizations 2 before generating code The default value of the flag is 0 This flag works the same for all Visual Studio compilers Note that although the simulation performance is somewhat improved setting this flag the compilation of the code might take substantially longer time for large models The setting corresponds to the compiler command 0g GCC compiler Dymola 2016 has limited support for the MinGW GCC compilers with GCC versions compatible with the following e 32 bit MinGW GCC 4 8 1 e 64 bit MinGW GCC 4 9 2 To download any of these free compilers please visit http www Dymola com compiler where the latest links to downloading the compilers are available Needed add ons etc are also specified here Note that you need administrator rights to install the compiler APPENDIX INSTALLATION 11 Please note e To be able to use other solvers than Lsodar and Dassl you must also add support for C when installing the GCC compiler Usually you can select this as an add on when installing GCC e There are currently some limitations with GCC o Embedded servers DDE or OPC servers are not supported o Commercial libraries only limited testing has been done o Support for external library resources is implemented but requires that the resources support GCC which is often not the case o No support for run time license o For 32 bit si
42. imulink change of language etc 1 1 Installation on Windows This section refers only to the Windows version of Dymola To install Dymola the following tasks must be performed e Install the Dymola software and libraries e Install a C compiler if it has not been done before e Install the Dymola license file e Install a license server sharable license only Following installation the user may do additional setup The installation of updates and re moval of Dymola is also described below 1 1 1 Dymola as 32 bit and 64 bit application The Dymola program is available both as 32 bit and 64 bit applications Both are installed when installing Dymola on Windows The 64 bit Dymola program and its associated DLLs is located in the folder Program Files x86 Dymola 2016 bin64 after installation 1 1 2 Installing the Dymola software Dymola and appropriate libraries is distributed on a single DVD or downloaded electronically With electronic download the DVD image is provided as two separate zip files Note that both zip files must be extracted to the same location before starting the installation Starting the installation Please note that Administrator privileges are required for this installation When Dymola has been installed any user can run it The installation normally starts when you insert the distribution DVD If autostart has been disabled please start D setup exe assuming your DVD drive is labeled D fr
43. ith all earlier versions of FLEXnet Publisher License borrowing Different versions of Dymola There are limitations regarding license borrowing when borrowing is done in one version of Dymola and using the borrowed license is used in another version of Dymola on the same PC For Windows a license borrowed using Dymola 7 4 FDO1 or older cannot be used by Dymola 2012 or newer without being connected to the license server For Linux a license borrowed using Dymola 2012 FDO1 or older cannot be used by Dymola 2013 or newer without being connected to the license server If access to e g both Dymola 7 4 FDO1 and Dymola 2012 is required on a Windows PC both versions must be used to borrow by the following procedure e Initiate borrowing with any Dymola version e Open Dymola 7 4 FDOI or older and check out the required features e Open Dymola 2012 or newer and check out the required features e Validate by checking that there are two entries of all the required features in the Details tab using the command Help gt License e Disconnect from the network and validate that both versions can be run as expected 50 License borrowing of 32 64 bit Dymola When borrowing license only the license of the Dymola version you run will be borrowed and 64 bit and 32 bit Dymola are seen as different versions For the few cases when you want to e Borrow a license AND e run Dymosim exe outside of Dymola AND e do not have export
44. link to this page is presented when detecting any error using the Find compiler button and in the build log when no compiler is installed selected Dymola on Windows 7 Note that Visual Studio performs parts of its installation the first time it is run This must be performed in order to use Visual Studio with Dymola a step that requires administrator privileges The rights can be elevated by running Dymola as administrator the first time This is done by right clicking the Dymola icon is the Windows Start menu and selecting Run as administrator Open Py Run as administrator Troubleshoot compatibility Open file location T Zip gt Pin to Taskbar Pin to Start Menu Accessi Belgacc Send to gt J CVSNT M Dymole Dymole Copy X Dymol Delete d Dymolz Doc Dyn Properties Dy Tarr Restore previous versions Cut fy Rename To validate this any model e g a demo should be opened and translated in Dymola 1 8 3 Simulink If the Dymola Simulink interface does not work please check the following some of which may sound elementary e You have a Dymola license that supports the Simulink interface Note that Simulink sup port is a separate option APPENDIX INSTALLATION 53 e You have included the three directories Dymola 2016 mfiles Dymola 2016 mfiles traj and Dymola 2016 mfiles dymtools in the Matlab path These have to be included every time you want to use the Dymola Simulink interface and it i
45. luded in shortcuts to Dymola see next section Creating shortcuts to Dymola Sometimes it is convenient to create shortcuts to the Dymola program typically to make Dymola start in the appropriate working directory A shortcut is created as follows 1 Click the right mouse button on the desktop 2 Select New gt Shortcut from the popup menu 3 Browse for the Dymola program Program Files x86 Dymola 2016 bin dymola exe by default for 32 bit Dymola on a 64 bit computer Program Files x86 Dymola 2016 bin64 dymola exe for 64 bit Dymola on a 64 bit computer Enter a suitable name and finish the creation of the shortcut Right click on the newly created shortcut 4 5 6 Select Properties from the popup menu 7 Select the Shortcut tab of the dialog window 8 Specify a working directory in the Start in field 9 If wanted add command line options in the Target field 10 Click OK to create the shortcut Remote installation of Dymola Dymola whether downloaded as a zip file or on CD consists of a number of files msi and cab Remote installation of dymola msi is possible using the appropriate tools such as msiexec For example the following command makes a quiet installation of Dymola and all libraries with Modelica version 3 msiexec i dymola msi INSTALLLEVEL 201 quiet The value of the INSTALLLEVEL property controls which components are installed according to the table A
46. mulation parallelization is only supported with any of the Lsodar Dassl Euler Rkfix2 Rkfix3 or Rkfix4 algorithms Selecting a compiler Selecting compiler is To change the compiler Dymola uses to translate the model use the command Simulation gt required Setup and the Compiler tab see also chapter Simulating a model section Editor command reference Simulation mode sub section Main window Simulation menu command Simulation gt Setup Below is an example of the Compiler tab 12 A amp Simulation Setup General Transition Output Debug Compiler Realtime FMI C compiler Visual Studio 2005 Professional 8 0 Visual Studio 2008 Visual C 2008 Express Edition 9 0 Visual Studio 2010 Visual C 2010 Express Edition 10 0 Visual Studio 2012 Visual C 2012 Express Edition 11 0 Visual Studio 2013 Visual C 2013 Express Edition 12 0 Visual Studio Custom C Program Files x86 Microsoft Visual Studio 12 0 Vc Browse MinGW GCC Embedded server not supported 32 bit C MinGW bin acc exe Browse 64 bit C MinGW64 mingw64 bin gcc exe Browse Embedded server None DDE server OPC server Requires administrator rights Export DLL F Export model as DLL with API Verify compiler setup Test compiler environment and validate the selected VC directory or GCC Test compiler Store
47. n the Browse button and open the license file you saved The path of the license file is shown in the dialog 16 Specifying the license file 3 Dymola License Setup General Details Borrow Setup License server Server name Port optional Local license file File name csjinstallflicenses 99 dymola eval lic Browse Install license For all users C Install for all users requires administrator rights You have the option of installing the license file only for the currently logged in user or for all users on this computer The latter requires administrator rights Click on the OK button Dymola will ask for confirmation before overwriting your old license information Dymola License Setup 3 LJ Change License File Do you want to change your license file After changing the license server setup you must restart Dymola to use the new server You may delete the saved license file Dymola has created a copy Dymola License Setup i Dymola license has been updated Please restart Dymola Run time licenses Models developed by users that lack export options can still be run at other computers using a run time license Dymola run time requires the user of the model to have the option DymolaRuntime The license file containing the run time license should be defined by the environment variable DYMOLA RUNTIME LICENSE for example APPENDIX INSTALLATION 17
48. nasim The server status can be checked with 1mutil l1mstat a In case of problems the log file should be examined To start the license server automatically when the system is rebooted please update e g etc rc d rc local accordingly Note that the license server needs not to run as root Note The license server by default uses the ports 27000 27009 They can be configured if needed e g if there are issues with firewalls Full details of FLEXnet license server installation can be found in the FLEXnet User s Manual which can be downloaded from www flexera com License borrowing on Linux License borrowing is enabled by setting the environment variable LM BORROW The value must specify beginning and end dates of the borrowing period as well as the vendor name dynasim The general format is LM BORROW start date dynasim end date An example using bash which specifies the start date 10 November 2009 and the end date 12 November 2000 is export LM BORROW 10 nov 2009 dynasim 12 nov 2009 After setting the environment variable LM BORROW Dymola must be restarted and the appropriate license options checked out before disconnecting from the license server The status of borrowing can be displayed in the Linux server using a status command An example for a 64 bit Dymola 20106 is opt dymola 2016 x86 64 bin lmutil lmborrow status The command displays the names of borrowed features and the expiration dates 40
49. o the path where the license is located e You can import it in Simulink using the Import mode of the Dymola Simulink interface This requires that the model has been generated by a machine having a Binary Model Export license or Source Code Generation license If you have exported a model using the using the ExternalInterfaces library the ExternalInterfaces Export toSimulink function you can import it using the Import mode of the Dymola Simulink interface Such an imported model can be compiled simulated and also downloaded to real time platforms the last option requires that it has been exported from a machine having the Real Time Simulation license or the Source Code Generation license Importing an FMU You have three cases e The FMU is a Dymola FMU and generated by a machine having a Binary Model Export license or Source Code Generation license in this case you can import it and execute it on a computer without a Dymola license e The FMU is a Dymola FMU and generated by a machine without any of the licenses above in this case you must fulfill two conditions to be able to execute the FMU o The machine you import to must have a Standard Runtime Configuration license o The environment variable DYMOLA RUNTIME LICENSE must be set to the path where the license is located This is needed for the dll of the FMU to find the license file APPENDIX INSTALLATION 47 Important If you have a Dymola license on
50. ola hostid utility Setup EH Cancel About Selecting Setup will display the following APPENDIX INSTALLATION 41 ex C WINDOWS system32 cmd exe Dymola hostid utility Copy the complete stid string and send it by e mail to the Dymola sales organization To copy the string you can click on the icon in the top left corner of this window and select Edit Mark Press any key to continue Clicking in the upper left corner and selecting Edit gt Mark makes it possible to selecting the host id by dragging the cursor over it Once selected Edit Copy will place the host id in the clipboard from where it should be pasted into a mail to your Dymola distributor 1 6 System requirements 1 6 1 Hardware requirements e Atleast 1 GB RAM e At least 400 MB disc space 1 6 2 Hardware recommendations At present it is recommended to have a system with an Intel Core 2 Duo processor or better with at least 2 MB of L2 cache Memory speed and cache size are key parameters to achieve maximum simulation performance A dual processor will be enough if not using multi core support the simulation itself by default uses only one execution thread so there is no need for a quad processor If using multi core support you might want to use more processors cores Memory size may be significant for translating big models and plotting large result files but the simulation itself does not require so much memory Recommen
51. om Win dows Explorer by double clicking on the file or use the Start button in Windows select Run enter D setup exe and click OK Dymola installation setup Welcome to the InstallShield Wizard for Dymola 2015 The InstallShield R Wizard will install Dymola 2015 on your computer To continue click Next WARNING This program is protected by copyright law and international treaties Clicking Next gt will display license conditions that must be accepted in order to proceed Accepting by selecting that alternative and then clicking Next gt will display the following f 39 Dymola 2016 Beta 3 InstallShield Wizard m Custom Setup Select the program features you want installed Click on an icon in the list below to change how a feature is installed F Feature Description Dymola application and Modelica Standard Library This feature requires 510MB on your hard drive Install to C Program Files x86 Dymola 2016 Beta 3 InstallShield Heb Space Bk J We Location of directory The first choice in the installation procedure is the type of installation and the name of the Dymola installation directory The default is APPENDIX INSTALLATION 7 e On 64 bit computers C Program Files x86 Dymola the version number of Dymola e On 32 bit computers C Program Files Dymola the version number of Dymola This path is displayed under
52. oolbars where the menus and toolbars should not be deleted by the command File gt Clear All can be automatically loaded by a libraryinfo mos file with category persistent see also above section LibraryInfoMenuCommand category persistent reference lt Class to preload gt text dummy For more information about creating such menus see the manual Dymola User Manual Volume 2 chapter 7 User defined GUI section Extendable user interface menus toolbars and favorites License expiration settings The default behavior of Dymola is e To start to warn the user that a license is to expire 30 days before expiration e Tocontinue in demo mode if a license has expired or is faulty The behavior can be configured with a command line argument Consider a user wanting to have the first warning 5 days before the license is expiring and wanting to terminate Dymola if the license is not found or invalid Assuming a 32 bit Dymola with default location on MS Widows on a 64 bit computer Dymola could be started with the following command line using the Command Prompt in Windows C Program Files x86 Dymola 2016 bin Dymola exe days 5 The value 5 controls how many days that should be left to expiration when warning and the minus before the value is added if Dymola should terminate if the license is not found or invalid ee 0 can be used instead of the example above will then be C Prog
53. option ModelManagement in the figure above should not be checked out the shortcut should be modified like in the figure below Modified shortcut TREDDE General Shortcut Compatibility m Dymola Target type Application Target location bin Target ola 7 3 bin Dymola exe NoModelM anagement Start in C MyE xperiments Shortcut key None Run Normal window Comment Closing Dymola and starting it again the following information will be found in the license tab APPENDIX INSTALLATION 25 Prevention of checking Dymola License Setup out a license option General Details Borrow Setup Checked out license options Standard OK ModelManagement N A BinaryModelExport OK Disabling of license options C Disable real time simulation C Disable code export Local host id 0026b98b747f Copy to Clipboard Now ModelManagement will not be possible to check out As long as the shortcut is not modified ModelManagement will not be possible to check out from Dymola started by that shortcut To enable check out of ModelManagement Dymola must be closed and then restarted using a shortcut without the command line option for ModelManagement More than one option can be prevented from check out just add more strings like the one used Do not forget the space Starting Dymola using a modified command in Command Prompt of Windows A Windows command prompt can be
54. orrowing early return Currently borrowed licenses can be returned early when the computer is connected to the license server again In order to do an early return do the following While Dymola is connected to the server use the command Help License and select the Borrow tab 38 Dymola License Setup General Details Borrow Setup Borrow licenses Borrow until Start to Return 2010 02 05 Borrow Early Borrowed options and expiration dates Option Valid until DymolaStandard 22 Feb 10 23 59 DymolaHydraulics 23 Feb 10 00 00 Now click on Return Early The license including all listed options is returned o the server Next time Dymola is restarted the license is checked out the usual way Itis a good idea to check e g the splash screen when starting up to convince oneself that the return was successful in that case borrowing will not be mentioned in the splash screen A license returned to the license server cannot be checked out again until after approximately 2 minutes If licenses are returned by e g exiting Dymola but Dymola is restarted within approximately 2 minutes the return is never performed License server options file FLEXnet include tools for the local administrator The options file allows the license administrator to control various operating parameters of the Dymola license server For example it allows the administrator to e Allow or deny the use of options by users e R
55. rInteraction is not supported on Linux More Linux specific notes are available using the command man dymola 1 2 1 Installing Dymola Dymola for Linux is distributed as an RPM package The package is installed using the command rpm i name of distribution rpm Optional libraries are installed through separate RPM files For installation on e g Debian or Kubuntu systems conversion to the deb format is required using the alien command alien k name of distribution rpm Setup and environment variables The shell script usr 1ocal bin dymola version architecture see above concerning lt version gt lt architecture gt contains commands to set environment variables before starting Dymola but will need editing if Dymola is installed in a non standard location then the following environment variables must be defined in order to run Dymola DYMOLA Directory root of the distribution opt dymola lt version gt architecture DYMOLAPATH Search path for additional Dymola libraries and the license file The di rectories of the path may be separated by blanks or colon DYMOLAPATH is optional if the li cense file is in SDYMOLA insert MODELICAPATH Search path for libraries Concerning the use of MODELICAPATH please see section Adding libraries and demos to the File menu on page 21 Dymola defines an environment variable DYMOLAWORK which value is the Dymola working directory 1 2 2 Additional setup
56. ram Files x86 Dymola 2016 bin Dymola exe days 5 1 day is the minimum start time for warning of license expiration the warning cannot be completely disabled Preventing checking out license options from a license server It is possible to prevent Dymola from checking out certain license options from the license server if a sharable license is used It is also possible using a node locked license e g if a user wants to test if a certain model still works without a certain library Using the command Help gt License and then looking in the Details tab reveals license options currently checked out APPENDIX INSTALLATION 23 Example of license options checked out E Dymola License Setup General Details Borrow Setup Checked out license options Standard OK Binar yModelExport OK Disabling of license options E Disable real time simulation E Disable code export 7 Disable model management Local host id 0026b98b747F Copy to Clipboard If the user wants to prevent some option from being checked out it can be done in a number of ways By ticking any of the options in the Disabling of license options group in the menu above The second setting will prevent both BinaryModelExport and SourceCodeGeneration to be checked out These settings will be remembered between Dymola sessions They can also be accoplished using the following flags the below corresponds to prevent
57. s Libraries in the Dymola library menu not listed above always require additional licenses 1 7 7 Licenses for libraries not in Dymola library menu There are a number of libraries not in Dymola library menu for example e Libraries can be downloaded from the homepage of Modelica Association www Modelica org some are free some require license e Third party vendors can use the license handling in Modelica to add license requirements on their libraries 1 8 Troubleshooting This is a common section for both Windows and Linux If a problem only is applicable for e g Linux it is stated Occasionally the installation will not succeed or the program will not operate as intended after installation This section will outline some of the problems that have been detected in the past 1 8 1 License file The license file used is not the one wanted There are a number of standard paths where Dymola searches for a valid license In an old invalid license is stored by mistake in one of those locations that license might be tried instead of the correct one Information about which license is currently in use by Dymola is given using the command Help gt License gt Setup The path to that license is specified by Filename in that tab License file is not authentic The error message License file not authentic indicates either an error in the license file or a mismatch between your computer system and your license file
58. s a good idea to store the included paths in Matlab e You can find the interface in Simulink s browser as Dymola Block DymolaBlock if not you have probably not included the directories mentioned above into the Matlab path e Make sure that you have a Visual Studio C compiler installed on your computer Make sure that the Matlab mex utility has been configured to use that compiler type mex setup in Matlab to configure Finally test by trying to compile and link an example mex file e g nat1abVextern examples mex Vyprime c e You have created external inputs to the Dymola Block and outputs from the Dymola Block in a correct way See also the manual Dymola User Manual Volume 2 chapter Other Simulation Environments section Using the Dymola Simulink interface sub section Graphical interface between Simulink and Dymola e You have compiled all Dymola models used in the model otherwise you will get an error message e If Allow multiple copies of block is unchecked you should not copy the block Un checking it should only be done if you have a dSPACE system Also note that the parameterizations differ between blocks in the Modelica Standard Library and in Simulink For example the frequency of Simulink s Sine block is measured in rad s which is commonly known as angular frequency and should thus be 27 times the frequency in the corresponding source in Modelica Only Visual Studio C compilers are supporte
59. snstinin i ere nennen trennen eren ren eene enne enne enne nenne 27 1 1 7 Removing Dy mo las cocci EE 28 1 1 8 Installing updates tete etek aia ea eect Lae cee ce 28 LZ Installation on LINUX ueterem o dte me E E a E eis ebr b dens 28 1 2 1 Instalhng Dymola reete pte titu te ete EG dett 29 1 2 2 Additional setup eee See at eae ste eb bat ese d rete ine bep er debet 29 1 2 3 Removing Dymol 5e tbt teo RE pter teet bate ate ere ee bear dele 30 1 3 Dymola License Server on Windows eene nennen eene rennen tne tene trennen trennen 31 1 3 1 Backs rounds ete EH Ub ttn te de rte E eb ptr pe eie ehe eet pe dein 31 1 3 2 Installing the license servet 1 tette dette te tette ett tte eese ee tee deci tide beetle 31 1 3 3 License borrowing x ee Ree deter E ett be etie ehe eee ie belg 35 1 4 Dymola License Server on TINUK sesiooni eieren rosd aane KEE OaE EEE EEEE EEE E EE EEE 40 5 Utlity programsz i cete it E taie ea te nte ee E Ee LA Ete RU or ei pneter EEr 41 1 5 1 Obtains 4 Bostid siue ee re sett tussock n tete Pep odd 41 1 65 Systemdgrequirements onere cete p rose eee de eaa cede picea bete pst deve eee nive eee ete dade 42 1 6 1 Hardware requirements iei br rte e eet teste enced petere eps eod 42 1 6 2 Hardware recommendations reet dent n tie pide eck it ue i ede de peo ebay 42 1 6 3 Software requirements reete ote de pere eren ede Here reed 43 Ll dcdacenserequirements 55 55 een pe tre PE UR D AE ER EE 44 1 7 1 G
60. the machine the environment variable must still be set e The FMU is from another vendor For this case please see the documentation for that vendor there are no additional requirements from Dymola 1 7 6 Licenses for libraries in the Dymola library menu A number of libraries in the Dymola library menu can be used in Dymola without any additional licenses a number of libraries require additional licenses when working with more advanced features and a number of libraries always require additional licenses Note e If you want to export code the above requirements for export licenses apply as well Free libraries and packages in the Dymola library menu e Automotive Demos in the menu File gt Demos e DataFiles e Design Experimentation e Design Validation e DymolaCommands e Modelica Reference e Modelica Standard Library e Modelica DeviceDrivers e Modelica LinearSystems2 e Modelica StateGraph2 e Modelica Synchronous e Plot3D e UserInteraction e VehicleInterfaces Libraries in Dymola library menu that require additional licenses when for example running more advanced examples e Design Calibration requires Model Calibration license when running more than one tuner e Design Optimization requires Design Optimization license when running more advanced examples Note that there is a newer library available for optimization 48 Libraries in Dymola library menu always requiring additional license
61. tion Such an exported model can be executed on a machine without having any Dymola license Additional features are available see the chapter Other simulation environments 1 7 5 Licenses for executing importing using code Executing a Dymola model on a machine without a Dymola license There are two cases e The model has been generated by a machine having a Binary Model Export license or Source Code Generation license In this case no Dymola license is required to execute the model 46 e The model has been generated without any of the two licenses above You can execute the model if the machine has a Standard Runtime Configuration license and the environment variable DYMOLA RUNTIME LICENSE is set to the path where the license is located This is needed for the executable model to find the license file Import to Simulink If you have used the Dymola On Windows mode to export a compiled model you can use it in a number of ways e You can execute the model on a Windows computer without Dymola installation in two cases o The model has been generated by a machine having a Binary Model Export license or Source Code Generation license In this case no Dymola license is required to execute the model o The model has been generated without any of the two licenses above You can execute the model if the machine has a Standard Runtime Configuration license and the environment variable DYMOLA RUNTIME LICENSE is set t
62. tion on Windows installation in particular section Installing the Dymola license file on page 14 The default directory for installation on Linux is opt dymola lt version gt lt architecture gt where the architecture is RPM standard i586 for 32 bit and x86_64 for 64 bit application As an example the default directory for installation of 64 bit Dymola 2016 on Linux is opt dymola 2016 x86 64 the package manager on the target system however typically allows choosing another default location Dymola 2016 runs on SUSE Linux Release 11 32 bit and 64 bit with gcc version 4 3 4 and compatible systems In addition to gcc the model C code can also be compiled by clang To change compiler change the variable CC in opt dymola version architecture insert dsbuild sh See above concerning architecture Dymola 2016 is supported as a 32 bit and a 64 bit application on Linux Corresponding support for 32 bit and 64 bit export and import of FMUs is included 28 Notes e For rendering of jpg files libjpg62 must be installed e 32 bit compilation might require explicit installation of 32 bit libc E g on Ubuntu sudo apt get install gt multilib libc 6 dev 386 Please also note that you have to use the Optimization library version 2 x or higher to use multi criteria design optimization on Linux the older Design Optimization package does not support multi criteria design optimization on Linux The library Use
63. to the license file C UIFDymola 99 wistrom dynasimab lic Browse Path to the debug log file C temp flexlm log Browse View Log lo JV Start Server at Power Up IV Use Services 6 In the Start Stop Reread tab a Select the Dynasim license server b Click on Start Server 7 Inthe Server Status tab a Click on Perform Server Enquiry and check the output of the log window You should see lines identifying the server processes and what features are available APPENDIX INSTALLATION 33 Checking the operation of the license server LMTOOLS by Macrovision Corporation http www macrovision com File Edit Mode Help Service License File System Settings Utilities Start Stop Reread Server Status Server Diags Config Services Borrowing Helps to monitor the status of network licensing activities Options Individual Daemon Individual Feature Server Name Perform Status Enquiry Flexible License Manager status on Mon 2 11 2008 11 59 Detecting lmgrd processes License server status 270008194 103 53 51 License file s on 194 103 53 51 C U1f Dymola 99 wistrom dynasimab lic Using License File C UI Dymola 99 wistrom dynasimab lic b Also check the log file to verify that the server has started and that Dymola features can be checked out The following is an example of the FLEXnet Publisher logfile 12 30 48 1mgrd pid 2728 12 30
64. ymola license server on Windows except the license file are available in the Dymola distribution This includes also the license daemon where Dymola presently supports FLEXnet Publisher version 11 11 A recent version is part of the Dymola distribution APPENDIX INSTALLATION 43 Linux Supported Linux versions and compilers Dymola 2016 is supported on SUSE Linux Release 11 32 bit and 64 bit with gcc version 4 3 4 and compatible systems In addition to gcc the model C code can also be compiled by clang To change compiler change the variable cc in opt dymola 2016 architecture insert dsbuild sh architecture is i586 for 32 bit application x86 64 for 64 bit application for example for the 64 bit application the path is opt dymola 2016 x86 64 insert dsbuild sh Dymola 2016 is supported as a 32 bit and 64 bit application on Linux Notes e For rendering of jpg files libjpg62 must be installed e 32 bit compilation might require explicit installation of 32 bit libc E g on Ubuntu sudo apt get install gt multilib libc 6 dev 386 Note on libraries e Please note that you have to use the Optimization library version 2 x or higher to use multi criteria design optimization on Linux the older Design Optimization package does not support multi criteria design optimization on Linux e The library UserInteraction is not supported on Linux Dymola license server For a Dymola license server on Linux all files ne

Dymola - Dynamic Modeling Laboratory

Contents

Download Pdf Manuals

Related Search

Related Contents