SimSci ®

®
DYNSIM 5.3.2
Getting Started with
DYNSIM User Guide

December 2016

DYNSIM Getting Started User Guide i

All terms mentionedin this documentation that are known to be trademarks or service marks have been
appropriately capitalized. Schneider Electric Software, LLC. cannot attest to the accuracy of this information.
Use of a term in this documentation should not be regarded as affecting the validity of any trademark or service
mark
ActiveFactory, ArchestrA, ARPM, AssayCentral, Autonomous, Avantis, Avantis.PRO, Connoisseur,
CrudeManager, CrudeSuite, DATACON, DATAPREP, DT Analyst, DYNSIM, DYNSIM Power, Esscor,
EYESIM, Factelligence, FactorySuite, FactorySuite A², Foxboro, Foxboro Evo, FSIM Plus, HEXTRAN, Hot
Links, I/A Series, IMPACT, IMServ, InBatch, InControl, Industrial Portal, IndustrialSQL Server, InFusion,
INPLANT, InSQL, IntelaTrac, InTouch, IPact, Invensys, Logic Validator, MBM, NETOPT, PIPEPHASE,
PRO/II, PROVISION, QI Analyst, ROMeo, SCADAlarm, SIM4ME, SimCentral, SimSci, SimSci-Esscor,
Skelta, Skelta BPM.NET, Skelta Sharepoint, Skelta Sharepoint Accelerator, Spiral Software, SuiteVoyager,
TACITE, Tactical Batch, The Simulator, TRISIM Plus, VISUAL FLARE, VISUAL FLOW, VISUAL FLOW
SUITE, VISUAL NETWORK, Visual Solutions, VOYAGER, WindowMaker, WindowViewer, Wonderware,
Wonderware InTouch, and ZI ZHI are trademarks of Schneider Electric SE, its subsidiaries and affiliated
companies.
© 2016 by Schneider Electric Software, LLC. All rights reserved.
No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means,
electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Schneider
Electric Software, LLC. No liability is assumed with respect to the use of the information contained herein.
Although precaution has been taken in the preparation of this documentation, Schneider Electric Software, LLC
assumes no responsibility for errors or omissions. The information in this documentation is subject to change
without notice and does not represent a commitment on the part of Schneider Electric Software, LLC. The
software described in this documentation is furnished under a license agreement. This software may be used or
copied only in accordance with the terms of such license agreement.
ArchestrA, Avantis, DYNSIM, EYESIM, Foxboro, Foxboro Evo, I/A Series, InBatch, InduSoft, IntelaTrac,
InTouch, PIPEPHASE, PRO/II, PROVISION, ROMeo, Schneider Electric, SIM4ME, SimCentral, SimSci,
Skelta, SmartGlance, Spiral Software, VISUAL FLARE, WindowMaker, WindowViewer, and Wonderware are
trademarks of Schneider Electric SE, its subsidiaries, and affiliated companies. An extensive listing of Schneider
Electric Software, LLC trademarks can be found at: http://software.schneider-electric.com/legal/trademarks/. All
other brands may be trademarks of their respective owners.
Schneider Electric Software, LLC
26561 Rancho Parkway South
Lake Forest, CA 92630 U.S.A.
(949) 727-3200
http://software.schneider-electric.com/

DYNSIM Getting Started User Guide ii

 Table of Contents
Introduction ................................................................................... 1
Steady State vs. Dynamic Simulation .............................................................. 1
Who Can Benefit from Dynamic Simulation?................................................... 3
Who Should Read This Manual ....................................................................... 3
Conventions Used ............................................................................................ 4
How This Manual is Organized ........................................................................ 4
Information Links .............................................................................................. 4
Online Documentation ............................................................................... 4
Online Help ...................................................................................................... 5
Additional Resources ....................................................................................... 5
DYNSIM Documentation: .......................................................................... 5
Technical Support ............................................................................................ 5
Authorized SimSci Technical Support Centers ......................................... 6
Installation .................................................................................... 8
Check Package Contents ................................................................................ 8
Installation Media ...................................................................................... 8
Documentation .......................................................................................... 8
Prepare to Install .............................................................................................. 9
Hardware/Software Requirements ................................................................... 9
Minimum system requirements are listed below: ............................................. 9
Software Security ........................................................................................... 10
Local Hardware Security ......................................................................... 10
FLEXNet Security .................................................................................... 11
SimExecutive Licensing .......................................................................... 11
DYNSIM software Installation ........................................................................ 11
Installation Options ........................................................................................ 12
Pre-Install Checklist ....................................................................................... 12
Software Co-existence ............................................................................ 15
Control Emulation and I/A Compatibility .................................................. 16
Thermo Data Manager Installation Background...................................... 17
Installing DYNSIM Application ....................................................................... 17
DYNSIM 64-bit Engine Installation ................................................................ 21
Custom OTS Engines Installation .................................................................. 24
DYNSIM / Activation Manager / SCP Software ............................................. 26
Activation Manager Software Installation....................................................... 27
Advanced Installation Options ....................................................................... 29
DSS Host Configuration Editor ................................................................ 30
Systems with Multiple SCP Stations ....................................................... 31
Multiple Network Interface Card Setup ................................................... 33
Setup DYNSIM Infrastructure in Distributed Mode.................................. 33
Running the Simulation Executive or other GUIs On Separate Computers33
Switching Security Types for PC ................................................................... 33
How to Apply a DYNSIM Patch ............................................................... 34
Starting DYNSIM Application .................................................................. 34
Translation: PRO/II to DYNSIM ................................................... 36
Translating PRO/II files into DYNSIM ............................................................ 36
Option I – Exporting a Simulation from PRO/II........................................ 36
Option II – Importing a Simulation into DYNSIM ..................................... 37
Supported PRO/II to DYNSIM Versions ........................................................ 37

DYNSIM Getting Started User Guide iii

 Getting Started Tutorial .............................................................. 38
What You will Learn in this Tutorial ............................................................... 38
Starting DYNSIM Application ......................................................................... 38
Creating a New Simulation ............................................................................ 39
Data Input Conventions ................................................................................. 40
Tab Status Indication ..................................................................................... 40
Setting up a Simulation .................................................................................. 40
Step 1: Define the Units of Measure (UOM) ........................................... 41
Step 2: Select Components and Define Component Slates ................... 41
Step 3: Define a Thermodynamic Method ............................................... 44
Step 4: Lay Down Models ....................................................................... 45
Step 5: Connect the Flowsheet Objects Using Appropriate Streams ..... 49
Step 6: Executing the Simulation ............................................................ 49
Set-up DYNSIM in Distributed Mode .......................................... 54
Summary ........................................................................................................ 54
Before you start .............................................................................................. 54
Steps to Configure Distributed Mode ............................................................. 55
Troubleshooting .......................................................................... 64
Troubleshooting Guidelines ........................................................................... 64
Installation Problems and Solutions ........................................................ 64
How to Get DYNSIM to work after McAfee Firewall Install ..................... 66
Windows 2008 Server R2 performance settings ..................................... 70
Windows Server 2012 R2 installation ..................................................... 71
SimSci Diagnostics Framework ................................................. 72
Introduction .................................................................................................... 72
Using Diagnostics Log ................................................................................... 73
Event Viewer Logs .................................................................................. 73
Database Logs ........................................................................................ 74
Using the Command Line Tool SQLite3 ........................................................ 74
Using the Graphical Tool SQLite Database Browser.exe.............................. 74

DYNSIM Getting Started User Guide iv

Introduction
Tools for computer-aided process engineering are extensively utilized in the Process Industries for
scale-up and design of green field plants and to enhance the operation of existing units. The rapid
development of this field is being driven by the availability of powerful, user-friendly software systems
that run on personal computers (PC) and engineering workstations and employ a familiar Graphical
User Interface (GUI).
Process modeling and computer simulations are extremely crucial engineering tools for the design and
optimization of chemical and refining processes. Computer simulation is currently used for the creation,
synthesis, analysis, design and optimization of industrial processes. Competence in process simulation
requires a sound knowledge of engineering fundamentals, modeling and computational skills and
familiarity with commercial simulators.
A majority of the process industries has identified computer modeling of chemical manufacturing
methods as a strategic technology. The use of computer models enables them to:
• Lower manufacturing costs
• Train plant operating personnel
• Reduce various forms of pollution
• Increase process efficiency
• Enhance plant safety
• Release new products to market quicker
• Improve product quality
The ability of today’s computers to perform extensive calculations can afford the process industries
many benefits. These benefits must be tempered with the realization that:
• If adequate care is not exercised, they are also capable of furnishing incorrect answers to high
degrees of precision
• Subsequent detection of such errors becomes correspondingly more laborious as the extent of
computerized activity develops and the complexity of programs increases

Steady State vs. Dynamic Simulation

The critical difference between steady state and dynamic simulation is that the former assumes equilibrium
results for all unit operations and the latter does not as the actual plant is normally moving either towards or
away from a steady state. This steady state approach disregards transient effects that are detailed in the dynamic
simulation.
One key element that sets dynamic simulation apart from steady state is the amount of information required to
realize a successful, accurate simulation. A more rigorous process description is required. For instance,
dynamics require equipment sizes, metal masses, desired holdups and process control schemes amongst other
pieces of data. Intermediate equipment, such as surge tanks and ones that account for the dead volume in line
must be incorporated to provide an accurate representation of the transient process. This requires more insight
from and data collection on the part of the modeling engineer.

DYNSIM Getting Started User Guide 1

Viewing and interpreting the results can consume more time than steady state simulations due to the dramatic
increase in the amount of data generated. PRO/II® simulations yield reports, which include numerical results for
the energy and mass balances. Viewing data in this fashion within DYNSIM® application is not realistic, as
these calculations are performed multiple times every second. DYNSIM application eases this burden by
providing helpful aids such as data trending and profiling.

DYNSIM Getting Started User Guide 2

Who Can Benefit from Dynamic Simulation?
A wide range of end users apply this tool for different objectives as mentioned below:
Process Engineers find this product an important part of the design process. Dynamic modeling, concurrent
with steady state design can eliminate the requirement for multiple steady state cases. Transition effects can be
visually evaluated, with the ability to interact with the calculations. This type of tool extends leverage to allow
the engineer to reduce capital requirements of any process.

Development Engineers employ this tool to design their pilot plants. More significantly, these tools are
indispensable in planning and designing experiments.
Batch processing can now be more rigorously modeled with dynamic simulation tools. Kinetic studies, batch
distillation and extraction are executed with ease using these new tools.

Process Control Engineers find this product advantageous in designing control strategies. Actual controllers
can be located within a flowsheet. It provides accurate first principle models of unit operations and allows for
the detection of defects in control strategies before committing capital for the actual instrumentation.
Additionally, one can tune these controllers with the simulator. Process gain (K) and time constants (Ti and Td,
etc.) can be manipulated to find the accurate settings that will extend optimal operational performance. This
exercise saves time and effort (not to mention off-spec product) if one can eliminate the need to do this on-line
with an operating unit. Advanced users can also directly interface their plants’ DCS to the simulation.

Operation Engineers can apply this tool to plan and execute an effective start-up. These scenarios can be
evaluated on the software, before any feed is introduced into operating equipment. A successful plan can be
evolved for transition effects. Dynamic simulation can be used while starting up to aid the engineer and operator
in their decision-making. The operation engineers and control engineers also use dynamic simulation to do a
controls checkout, i.e., to verify the plant controls using the dynamic simulator before bringing the plant controls
on-line.

Operators find this an essential tool in easing their learning curve. This provides the capability to train operators
on both large and small units efficiently. Since a company’s in-house engineering staff can readily construct the
models, the demand for expensive training model consulting services is reduced.

Who Should Read This Manual

Welcome to the Getting Started with DYNSIM User Guide. This manual is written to function as a learning tool
(tutorial section) for both first time users and simulation experts, although the latter group may be more inclined
to refer to the Reference Manuals, which describes the intricate details of the product as well as this release.

In this tutorial, we will introduce you to the DYNSIM environment and guide you step-by-step on how to use it
to accomplish your goals. After becoming familiar with using DYNSIM application, you can look at the User
Manual or the on-line documentation to obtain detailed information. The core topics that will be covered here
will allow users to get an overview of the Dynamic Simulation Suite of products. In addition, the user will see
how PRO/II interfaces with DYNSIM application, blending the salient feature of these applications. Here, our
discussion will focus on the translation from “Steady State” to “Dynamic” models.

DYNSIM Getting Started User Guide 3

Conventions Used
This manual adheres to a set of guidelines for the presentation of material. The font conventions used
are listed below.
Lightface: Normal text.
Bold, italic: Refers to a specific chapter, section, or manual for more information.

Italic: Used to indicate text you will enter at prompts; file names are also italicized.
Boldface: Used primarily to indicate mouse or pointer actions you will perform; may also be
used to emphasize for normal text.

How This Manual is Organized

This manual is focused to describe the following details in a sequential manner:
• Hardware/ Software requirement and installation of DYNSIM.
• Concepts and methodology utilized during the translation from “Steady State” to “Dynamic
Simulation”.
• A tutorial of how to execute an initial simulation run.
• Troubleshooting guidelines to sort out issues confronted by the user.
• Information sources for cross reference.

Information Links
The user is strongly encouraged to explore the links suggested here in order to get accustomed to the
features and the complexities that may surface during the initial exposure to DYNSIM.

Online Documentation
Online documentation is provided in Adobe® Acrobat’s Portable Document Format (.pdf) files that are
viewed using Acrobat Reader 6.0 as well as online help that are accessible through standard help
facilities built into DYNSIM application. Acrobat Reader is a freeware that can be installed from the
DYNSIM distribution CD or from the Adobe Systems website, www.adobe.com.
All associated documentation is stored in the Manuals directory on the CD.

DYNSIM Getting Started User Guide 4

Online Help
DYNSIM integrates with an online Help system for accessing information quickly and simultaneously
while you work.
The Help system comprises of commands, features, and data fields that are explained in a sequential
manner. Selecting Help/Contents from the DYNSIM application menu bar can access the electronic
contents for the Help system. Also, help on specific features is made available through the help button
in the Windows® dialog boxes.

Additional Resources
DYNSIM Documentation:
1. Dynamic Simulation Suite User Guide
2. DYNSIM Reference Manuals
3. DYNSIM Application Briefs Guide
4. Getting Started with DYNSIM(this document)
5. DYNSIM Best Practices Documentation
6. DYNSIM License User Guide

Technical Support
®
SimSci ’s Technical Support Center is committed to providing you with the best overall product
experience. This includes any queries connected with the use of the program or the interpretation of
output data as the case may be. Our time-tested products are designed with superior quality and ease of
use in mind, but we understand that issues do arise from time to time that warrants the backing of our
support resources.
®
If you have any questions, contact the nearest SimSci Technical Support Center from the following
address list, or get in touch with your local SimSci representative.
To expedite your request for assistance, please have the following details available with you when you
call:
• A brief description of the problem encountered.
• The installation CD sent along with this package.
• The configuration of the computer you are using along with the following information:
1. Available free disk space where DYNSIM is installed.
2. Quantity of installed memory.
3. CPU type and frequency.
4. Operating system, version, and any applied patches.
5. List of all Java® virtual machines installed on your computer.
• The corrective actions you were attempting when the problem occurred.
• The list of error messages that appeared on your screen and any other relevant symptoms.
• Access to the installed software.

DYNSIM Getting Started User Guide 5

Authorized SimSci Technical Support Centers

Support Center Telephone/Fax/Email

USA and Canada Tel: +1 800 SIMSCI-1 (+1 800 746 7241)
Email: [email protected]
Argentina, Paraguay, Uruguay, Tel: +54 11 6345 2100
Bolivia Fax: +54 11 6345 2111
Email: [email protected]
Brasil Tel: +55 11 2844 0213 /291
Fax: +55 11 2844 0341
Email: [email protected]
Chile Tel: +56 2 4767616
Fax: +56 2 3783691
Email: [email protected]
Colombia and Ecuador Tel: +57 1 3136363
Fax: +57 1 2550945
Email: [email protected]
Mexico and Central America Tel: 01 800 IOM CALL (01 800 466 2255)
Tel: +52 55 5263 0143
Fax: +52 55 5263 0160
Email: [email protected]
Peru Tel: +51 1 4461258
Fax: +51 1 7120003
Email: [email protected]
Venezuela and Caribbean Tel: +58 212 267 5868 ext. 282
Islands Fax: +58 212 267 0964
E-mail: [email protected]
Europe and Africa Tel: +44 01925 811 469
Email: [email protected]
Middle East Tel: +966 3 801 0382
Email: [email protected]
Australia and New Zealand Email: [email protected]
India Email: [email protected]
Singapore Tel: +65 6829 8599
Email: [email protected]

DYNSIM Getting Started User Guide 6

 Support Center Telephone/Fax/Email
Japan Tel: +81 3 6450 1095 (PES and DYNSIM)
Tel: +81 3 6450 1096 (ROMeo)
Email: [email protected]
Korea Tel: +82 2 2090 0822
Email: [email protected]
P.R. China Tel: +86 21 37180000 ext. 5462
Email: [email protected]
Taiwan Tel: +886 2 87971001 ext. 108
Email: [email protected]

For more detailed contact information, see SimSci Support website:

http://software.schneider-electric.com/support/simsci/

DYNSIM Getting Started User Guide 7

 Chapter 1
Installation
The objective of this chapter is to help you identify the contents of your release package and assist you
with the process of installing the DYNSIM software in your system.

Check Package Contents

The following materials have been sent in order to install DYNSIM.
Installation Media
The DYNSIM software application installation kit has a DYNSIM installation CD.

Documentation
A comprehensive online Help system is an integral part of the DYNSIM application. A list of Dynamic
Simulation Suite documents is furnished below.

Release Notes and FlexNet® Security Guide, and all other documents are provided in electronic
form on the installation CD.
• Getting started with DYNSIM (this document)
• Dynamic Simulation Suite User Guide
• DYNSIM Reference Manual- Base Equipment and Process Equipment Library
• DYNSIM Reference Manual – Control’s Library
• DYNSIM Reference Manual – Utilities Library
• DYNSIM Reference Manual - Electrical Library
• Translation Reference Manual(Translation of PRO/II Models)
• SIM4METM Thermo Component and Thermo physical Properties Reference Manual
• Application Briefs
• SIM4ME_LicenseSecurity_UserGuide (SimSci documentation on 3rd party license security)
A complete set of online documentation in PDF format is provided for each product.
If at any stage you have difficulty accessing the documentation, please contact Technical Support
Center.
A list of addresses and contact information can be found in the “Technical Support” section as
mentioned under “Introduction’’ described elsewhere in this document.

DYNSIM Getting Started User Guide 8

Prepare to Install
Before installing DYNSIM software, ensure that you have the required hardware and software, and
ascertain all necessary materials are in order as per specifications mentioned.

Hardware/Software Requirements

Minimum system requirements are listed below:

Configuration
Server ® ®
• Intel Pentium Processor 2.8 MHz or faster
Hardware
• 2 GB RAM and above
• Minimum: 17” monitor with minimum 800 x 600
resolution
• Recommended: 19” monitor with 1024 x 840
resolution
• Minimum 10 GB of free Hard Disk space

•
®
Windows 7 Enterprise SP1 (complete list of
Operating supported OS provided in next sections)
System

While installing DYNSIM Checkout or utilizing DYNSIM Bulk Configurator for tieback configuration,
user is recommended to install Microsoft® Excel® spreadsheet or Microsoft Office prior to installing DYNSIM
software. Open Microsoft Excel sheet at least once to register the Microsoft Excel product key. This ensures that
DYNSIM software installation installs the appropriate Microsoft Primary Interop Assemblies required for
DYNSIM Checkout and DYNSIM Bulk Configurator.

Lower speed or lesser amounts of RAM will lead to degradation in performance. Windows Classic
desktop theme is preferred over any other theme.

DYNSIM Getting Started User Guide 9

Software Security
SimSci software warrants the use of a foolproof security for execution of its software applications. The
install options available for security are USB, FNP 11.13, FNP 11.11/11.12, Token and TOKENnet.
Starting DYNSIM 5.3.1 a new licensing option; FLEXnet Publisher (FNP) 11.13 is supported. This
licensing option is the default and support for FlexNet11.8 is removed in DYNSIM 5.3.1.
To learn more about FLEXNet security, please refer to the SIM4ME_LicenseSecurity_UserGuide
included in the standard release package. This guide is located in ..\Program Files(x86)\Common
Files\SimSci\ SIMSCICFIxx \VC090x32\bin.

A retrofit program to support FNP 11.13 licensing option is available.

Local Hardware Security

The hardware key is a SafeNet USB Security Key. To use this,

1. Ensure that there is no USB key plugged into a USB port when you install DYNSIM
software for the first time. After DYNSIM software installation, the required USB driver
should be installed on your system.
2. Use Start→Settings→Control Panel→Add/Remove Program to check if "Sentinel
System Driver" is installed.
3. Change the security option in servers\system\product.ini to USB.
4. Plug-in the USB key to USB port. If DYNSIM software is installed correctly, the
Operating System will auto detect the new USB hardware and use the SafeNet USB
drivers. If this feedback does not appear, then your USB key will not function.
5. Use Start→Settings→Control Panel→Administrative Tools→Computer
Management→Device Manager→Universal Serial Bus controllers to check if there is a
USB hardware that is not working properly (mark with a yellow tag). Delete it.
6. Reboot your PC and plug in USB key. Again, the auto detect message for this new
hardware will appear.

If you are using USB security hardware key, DO NOT INSERT the USB key until after
DYNSIM software installation is complete. The DYNSIM software install includes installation of the
SafeNet driver security services and if you install the USB key before the SafeNet driver security
services you will need to perform a manual install of SafeNet services.

DYNSIM Getting Started User Guide 10

FLEXNet Security

SimSci provides a FNP 11.13 FNP 11.11/11.12 security option in the License Server Application
installation CD. The FLEXNet License Manager is a third-party concurrent-user software licensing tool
from Macrovision Corporation. SimSci has customized this client/server tool.
The FlexNet licensing system has two parts. One is the license server manager, which is OS dependent.
The FlexNet license server works on all current OS's (32-bit and 64-bit). The other part is client that
goes with the licensed application, and this part of 11.13/11.12/11..11 is supposed to work on all OS's.
To install, learn, and troubleshoot FLEXNet security, please refer to the
SIM4ME_LicenseSecurity_UserGuide included in the standard release package. This guide is located
in ..\Program Files(x86)\Common Files\SimSci\SIMSCICFIxx\VC090x32\bin.
If you are using a FlexNet security, you will need the name of the FLEXNet security server name or its
fixed IP address, which will be requested during the install. If you want to use a FNP 11.11/11.12/11.13
servers at your site, choose the FNP 11.13, FNP 11.12, FNP 11.11 option during the installation process.
The install option will set up the version 11.11/11.12 dlls for the application. FLEXNet software
supports borrowing of FlexNet licenses by the software application for a fixed period of time.
To run the application using Token licensing, select the Token licensing option during the DYNSIM
installation.

SimExecutive Licensing

Starting from DYNSIM 5.0, a new licensing mechanism has been implemented. The SimExecutive will
launch only if a valid Dynamic Simulation Suite license (any one of DYNSIM, DYNSIM-P, DYNSIM
Runtime, DYNSIM-P Runtime, CheckOut, OTS Engines, SCP®, TRISIM Plus® ) is found. The
SimExecutive checks for a valid license and returns it after finding one. A separate SimExecutive
license is not needed.

If the SimExecutive finds a valid license, the message window will display a message “SimExecutive
has obtained a runtime license”. If the SimExecutive does not find an appropriate license, it will not
launch the message “License check failed for SimExecutive” will be displayed.

The users should not see any other difference in the existing licensing behavior.

DYNSIM software Installation

DYNSIM installation software is bundled along with pre-requisites. No separate pre-requisite

installation is needed. Clicking the Setup.exe in DYNSIM software install kit installs the pre-requisites
if required followed by the installation of DYNSIM software.

The web distribution package does not include a FLEXNet Server security installation, which
must be downloaded separately if you are setting up FLEXNet security for the first time.

DYNSIM Getting Started User Guide 11

Installation Options
You have the option to choose the destination folder for installation. The software will be installed in
multiple folders located in the folder that you specify.
After choosing the installation type, you will be given a choice of security systems. The options are:
• USB - A USB hardware key.
• FNP 11.13 - A software based key that requires installation of the FlexNet 11.13 license server
and manager. Once you have chosen the FlexNet 11.13 security option, you must specify the
computer on which the FlexNet 11.13 security server will reside. The computer name must be
preceded with the @ sign (e.g., @DYNSIM01securityhost). This will add the
IPASSI_LICENSE_FILE environment variable to your system, which in the case of this example;
will be set to FlexNet Security Server.
• FNP 11.11/11.12 - A software based key that requires installation of the FlexNet 11.11/11.12
license server and manager. Once you have chosen the FlexNet 11.11 security option, you must
specify the computer on which the FlexNet 11.11 security server will reside. The computer
name must be preceded with the @ sign (e.g., @DYNSIM01securityhost). This will add the
IPASSI_LICENSE_FILE environment variable to your system, which in the case of this example;
will be set to FlexNet Security Server.
• TOKEN Security - This security option allows the use of multiple SimSci products from a
common license pool of tokens. The terms and availability of this Token license option must
first be established through a separate SimSci contract. Token licensing requires special
arrangements for regional technical and licensing support.

To change the type of security system, use Start→Settings→Control Panel→Add/Remove

Program→ Change→ Change option for the SimSci DYNSIM product.

Pre-Install Checklist

This section lists the most common issues that may be encountered by users when installing DYNSIM Software.

DYNSIM 5.3.2 co-exists with previous, released versions of DYNSIM (5.3.1, 5.3, 5.2, 5.1, 5.0, and 4.5x,). It is
not required to uninstall any existing version. Users do not need to un-install and re-install components or pre-
requisite software that were successfully installed as part of previous full installs such as Microsoft SQL 2008,
.NET 3.5 SP1 or Microsoft Windows Installer 4.5

NOTE: To avoid complications with the DYNSIM Software Bulk Configurator startup, Microsoft Excel or
Microsoft Office (2010 or 2013 or 2016) software must be installed prior to installing DYNSIM Software.
Open an Excel spreadsheet at least once to register the Excel product key

NOTE: When the DYNSIM Software installer is used with SCP Software or TRISIM Plus® Software this
DYNSIM Software install is a subset of the total system install. It is very important to plan the system
configuration and perform system installation in the correct order. When using this installer with SCP
Software please review the SCP Installation Guide prior to beginning system configuration and install. The
DYNSIM Software 5.3.1 installation is a subset of the procedures documented in the SCP Installation Guide.

DYNSIM Getting Started User Guide 12

Similarly for TRISIM Plus software installations, the TRISIM Installation Guide should be reviewed prior to
system configuration and installation.

Before you begin a new DYNSIM Software Install

1. You need local machine administrative rights (Microsoft Windows security) for the
machine on which you will install or un-install DYNSIM Software.

2. DYNSIM Software requires Power User or Local Machine Administrator privileges to stop and
restart its services at runtime. Computers with SCP270 Software (CP Image) require Local
Machine Administrator privilege as Power User is not sufficient for this instance.

3. DYNSIM Software does not support Microsoft Windows 2008, Windows XP, Windows 98, and
ME. Do not try installing DYNSIM Software on these operating systems.

4. As of DYNSIM Software 4.3, DYNSIM Software supports co-existence of multiple full

versions of DYNSIM Software on the same machine. For example, DYNSIM Software 4.3x
may co-exist with DYNSIM Software 4.4x, 4.5x and/or future versions on the same machine.
DYNSIM Software does not support having multiple versions of DYNSIM Software installed
on the same machine for versions prior to DYNSIM Software 4.3. To install an older version of
DYNSIM Software earlier than 4.3 or if currently using an older version and the user wants to
install DYNSIM Software 4.3 or newer version, user must first make sure all engines (including
OTS, SCP engines and TRISIM engines) are shut down and GUI are exited. Fully uninstall the
existing versions of DYNSIM Software and the Dynamic Simulation Suite (DSS) environment
(previously called SIM4ME™ prior to DYNSIM Software 4.1), reboot, and then fully install the
new version. When un-installing DYNSIM Software, verify that DSS/SIM4ME is also un-
installed. Newer versions of DYNSIM Software installers automatically un-install
DSS/SIM4ME if all DSS products (including SCP270 and TRISIM Plus software) are
uninstalled. User is required to manually un-install SIM4ME/DSS Infrastructure for older
versions.

5. DYNSIM Software install testing has been performed on the following 32-bit operating
systems:

 Windows 7 Professional and Enterprise

 Windows 7 Enterprise SP1, Japanese
 Windows 8.1 Enterprise
 Windows 8.1 Enterprise , Japanese
 Windows 10 Enterprise
 Windows 10 Enterprise , Japanese

DYNSIM Software install testing has been performed on the following 64-bit operating
systems:

 Windows 7 Professional and Enterprise

 Windows 7 Enterprise SP1, Japanese
 Windows Server 2008 R2 Enterprise SP1(refer to the Getting Started GuideTrouble
Shooting section for better performance settings)
 Windows Server 2012 R2 Standard Edition
 Windows 8.1 Enterprise
 Windows 8.1 Enterprise , Japanese

DYNSIM Getting Started User Guide 13

  Windows 10 Enterprise
 Windows 10 Enterprise , Japanese

Operating systems not explicitly tested may not operate properly.

6. Do not rename a machine with DYNSIM Software or any application with Microsoft SQL
Server installed. Use the following procedure:
 back up your work,
 un-install DYNSIM Software and (SIM4ME or Dynamic Simulation Suite),
 reboot machine,
 rename machine,
 re-install DYNSIM Software,
 restore your work

7. Machine names should only include characters (A to Z) and (0 to 9). Issues have been reported
for machines with special characters in machine names during installs. Consult your IT
administrators to ensure that host names are fully supported by your DNS Servers. Mixed case
or lower case machine names (a to z) will, on certain occasions, cause issues with the MS SQL
server naming. If you have issues with MS SQL server, start with Microsoft Knowledge Base
Q285100 and Q302409.

8. If you are using FlexNet or TOKEN security, you will need the name of the FlexNet security
server or fixed IP address, which will be requested during the install.

9. If you are using USB security hardware key, DO NOT INSERT the USB key until after the
DYNSIM Software installation is complete. The DYNSIM Software install includes installation
of the SafeNet driver security services and if you install the SafeNet USB key before the
SafeNet driver security services you will need to perform a manual install of SafeNet services.

10. If you have a firewall installed, it may interfere with the DSS Activation Manager and other
DYNSIM services. We recommend turning off firewall for installation. If disabling the
firewall is not allowed, you will need to put the firewall in "learning mode" the first time you
start up DYNSIM applications or allow it to start various DYNSIM processes with dynamic
port addresses.

11. Data Execution Prevention may cause DYNSIM services and installer to be unreliable. The
options may be controlled from System Properties (right click on my computer) Select:
Advanced Tab->Performance Options->Settings -> Data Execution Prevention Tab. The
options are:

 “Turn on DEP for essential Windows programs and services only”

 “Turn on DEP for all programs and services except those I select”

We recommend using the option “Turn on DEP for essential Windows programs and services
only”. Additional information may be found on Microsoft Knowledge Base Article 875352.

12. DYNSIM Software 4.1 and later versions must be installed on NTFS formatted hard drives.
FAT drives are not supported and may cause issues with Thermo Data Manager.

DYNSIM Getting Started User Guide 14

 13. Foxboro® I/A Series® processes MUST be disabled and not be running before
install/uninstalling DYNSIM Software on I/A Series systems. If I/A Series processes are
running, use the Control Panel “Foxboro I/A” control to “Disable I/A Series auto login”, then
reboot I/A Series machine using StartRun-“fox shutdown 1 1 1” command, then install
DYNSIM Software after the I/A Series system reboot.

14. Installing DYNSIM Software with running SCP/TRISIM/DYNSIM processes will cause install
issues. Stop SCP, TRISIM and DYNSIM processes via normal shutdown and reset services via
Host Configuration editor reset. Exit the SCP launcher before installing DYNSIM Software.

15. Install and re-install of DYNSIM Software versions may cause the SIM4ME environment
variable to contain multiple paths. Before installing SCP Software, verify that SIM4ME
environment variable contains a single unique path to the current DYNSIM install root (valid
example is C:\SIMSCI\DSS51) where the proper version of DYNSIM Software resides that will
be used as a prerequisite for the SCPsoftware install.

16. Windows 7 – DYNSIM software startup in Windows 7 requires extra care, especially for multi-
host simulators. Please refer to the DYNSIM Software 5.3.2 Known Issues Document for
Windows 7 specific issues.

17. DYNSIM is not compatible with Windows sleep mode. Ensure that all workstations that host
DYNSIM and any DSS engines have sleep mode turned off.

Software Co-existence

DYNSIM can co-exist with DYNSIM 5.x.x, , 4.5.x, 4.4.x and 4.3.x. Versions prior to DYNSIM 4.3x
and all support software must be uninstalled prior to installing DYNSIM software.

The Host Configuration Editor may not reset services properly when installing DYNSIM in system with
DYNSIM 4.3.x installed causing the 4.3.x AMEditor to fail. The user may resolve the installation issue
by executing the “patchResetSIM4ME.bat” file located in
‘DSS532\Servers\\PatchForDYNSIM4_3\’ directory of the DYNSIM installation kit.

The following SimSci products can co-exist with DYNSIM.

• PRO/II 10.0, 9.4.1, 9.4, 9.3.x

• ROMeo 6.4, 6.3, 6.2
• Hextran™ 9.2x
• PipePhase™ 9.6x
• Visual Flow™ 5.7.1, 5.5x
• InPlant®, 4.5, 4.3
•
®
DATACON 3.2

DYNSIM Getting Started User Guide 15

Control Emulation and I/A Compatibility

DYNSIM at time of release is only compatible with the following:

• SCP 2.1
• TRISIM 3.0
• I/A Series® 9.2 and above, contingent on the SCP version
• Later versions of Control Emulation and I/A Series software may be compatible with DYNSIM,
see Release Notes and Documentation of future releases for updated compatibility. Contact
Global Customer Support: http://support.ips.invensys.com/ for a current compatibility matrix.

Refer to the SCP 2.0 and TRISIM Plus Release Notes for Operating System and product compatibility.

DYNSIM Getting Started User Guide 16

Thermo Data Manager Installation Background

Prior to installing DYNSIM with other products that utilize Thermo Data Manager (TDM), the user
should take in account the following setup TDM installation rules.

• DYNSIM installs Thermo Data Manager (TDM) version 3. 9 which is self-contained in

DYNSIM and is not a shared component. In TDM 3.2 and higher versions, the TDM user
library is registered in the UserCfg.xml. For Windows 7, the UserCfg.xml file exist in.
..\Users\<username>\AppData\Roaming\SimSci\TDM.
• If versions older than TDM 3.2 are installed or un-installed with system environment variable
TDM_ROOT defined, TDM 3.2 and newer versions will install using the older TDM version
method for library databank registration through …\SIMSCI\TDM\CFG\LIB\...\lib.cfg.
• If all previous versions of TDM are un-installed, it is recommended the user delete any existing
system environment variable TDM_ROOT prior to installing TDM 3.2 or higher version.
Eliminating TDM_ROOT will allow the user to take advantage of the updated method of TDM
library registration.
• TDM databank library registration through TDM 3.2 and higher versions are not the same for
all user login by default. For common TDM library registration for all users, copy updated
UserCfg.xml file to …\Documents and Settings\All User\Application Data\SimSci\TDM folder
or updated lib.cfg file to …\SIMSCI\TDM\CFG\LIB\AllUsers folder. For Windows 7 copy the
updated UserCfg.xml file to. ..\ProgramData\SIMSCI\TDM

Installing DYNSIM Application

This section describes steps to install DYNSIM. This section is also applicable for the maintenance version of
DYNSIM application, such as DYNSIM 4.x.x, which will be a full install kit and require a full re-install.
DYNSIM installation on a clean machine involves:

DYNSIM supports co-existence of major releases on the same machine. Ex: DYNSIM 5.2,
DYNSIM 5.1, DYNSIM 5.0, DYNSIM 4.5.x and DYNSIM 4.4.x.. Starting from DYNSIM 5.2.1, co-
existence of patch versions is supported. For installing previous versions of DYNSIM software, refer to
Appendix-1.
1. Install the pre-requisites by executing the Setup.exe in the DYNSIM install package.

2. Reboot the machine.

3. To install DYNSIM, double-click Setup.exe in the DYNSIM install folder. The installer installs SQL
Express 2008 first and then DYNSIM.

4. Users can install DYNSIM software by selecting appropriate installation types.

• Typical Install: DYNSIM Typical installation will install typical DYNSIM features.

DYNSIM Getting Started User Guide 17

 • Custom Install: DYNSIM Custom installation will install other components or features
selected by the user, e.g., DYNSIM-P, DYNSIM-All, DYNSIM-L, DYNSIM-Checkout,
OPCServer and OPC-UA Server.

5. The default path for shared components that include CFI 5.0 installation is C:\Program Files
(x86)\Common Files\SimSci. However, user can modify this path during installation. If the machine
already has a previous or same version of the shared components, then the installation will proceed with
the existing location.

DYNSIM Getting Started User Guide 18

 6. DYNSIM 5.3.2 has been upgraded with the latest Thermo contribution, TH 3.9.

The custom OTS Engines is a separate installer and it is distributed separately.

7. During installation of DYNSIM, the user has the option of saving User Data files in a destination folder
of their choice or in the default location, which is C:\SIMSCI\.

8. Reboot the machine after installation.

9. Check the application to ensure that it is working properly.

10. If issues are found with licensing or services starting correctly, use
11. “Start > Programs > SIMSCI > DSS532> DSS Host Configuration Editor” and click the reset
button. An example of a command window from a successful reset is shown below.

DYNSIM Getting Started User Guide 19

 12. If issues persist, contact SimSci Technical Support group.

DYNSIM Getting Started User Guide 20

DYNSIM 64-bit Engine Installation
The DYNSIM 64-bit engines (such as DYNSIM, DYNSIM-All, DYNSIM-P, DYNSIM-Checkout, and
DYNSIM-Lite) are available as a separate install package and can be installed on the 64-bit computers.
However, the SimExecutive and other components are still 32-bit versions and are installed by the regular
32-bit DYNSIM install.

The regular DYNSIM software is a pre-requisite for installing DYNSIM 64-bit engines.

1. Install the DYNSIM 64-bit engines by executing the Setup.exe in the DYNSIM_x64 install package.

2. Click Next, and Read the License Agreement. If you agree, select the checkbox to accept the agreement
and select Next

DYNSIM Getting Started User Guide 21

 3. The destination of the DYNSIM x64 install is locked with the destination of the regular DYNSIM 32 bit
install and cannot be changed.

4. Click Next, and Users can select the required DYNSIM x64 engine for installation.

DYNSIM Getting Started User Guide 22

 5. After selecting the required DYNSIM x64 engines, click Next and Finish the installation.

DYNSIM Getting Started User Guide 23

Custom OTS Engines Installation
The Custom OTS Engines are available as a separate install package. As a prerequisite, ensure that either the
DYNSIM software or at least the Activation Manager is already installed on your computer.

The latest version of OTS Engines is 1.3.2. OTS Engines 1.3.2 cannot coexist with the earlier version, OTS
Engines 1.3.1/1.3/1.2/1.1/1.0. Uninstall OTS Engines 1.3.1/1.3/1.2/1.1/1.0 before installing OTS Engines 1.3.2.

Complete the following steps while installing Custom OTS Engines:

1. OTS Engines 1.3.2, by default, is installed in C:\SIMSCI\OTSEngine1.3.2\. If required, select a

different destination by clicking Change in the Destination Folder window.

2. Select the required engines by right-clicking the icon in the Custom Setup window.

DYNSIM Getting Started User Guide 24

 3. After selecting the required Custom OTS engines, click Next.

4. Wait while the Installation is in progress and click Finish after the installation is complete.

DYNSIM Getting Started User Guide 25

DYNSIM / Activation Manager / SCP Software
The full DYNSIM infrastructure is no longer required as a prerequisite for installing SCP,or TRISIM Plus
software. You can use the lightweight Activation Manager installer instead of the full DYNSIM install on
computers where only SCP, FAIM, TRISIM or SimSync engines are installed.

Refer to the relevant product installation guide for details.

Note: At least one system must include the full DYNSIM infrastructure to manage the simulation engines and to
access the DYNSIM Graphical User Interface (GUI).

The lightweight Activation Manager installer does not include the DYNSIM user interface. If required, the SCP,
FAIM, TRISIM, and SimSync Engine systems can be installed with the full DYNSIM infrastructure, which
includes Activation Manager as well.

While requesting software via Electronic Software Distribution (ESD) website

http://www2.simsci.com/sim4me/esd/login.asp, select the appropriate software set. Note that the DYNSIM
infrastructure is required.

• DYNSIM and SCP

• DYNSIM and TRISIM Plus

Review the following options while downloading the DYNSIM software:

DYNSIM V5.x Software Installation Program to install DYNSIM 5.x

DYNSIM V5.x Install infrastructure software

Activation Manager 5.x Install Prerequisite install Program for SCP, or TRISIM Plus
software, if the DYNSIM infrastructure is not installed

DYNSIM Getting Started User Guide 26

Where to install the software depends on how it has to be used. Typical configurations are shown below.

Typical OTS Software Installation

Instructor Station Foxboro Systems (Galaxy, Historian,

• DYNSIM Prerequisites Operator Stations, Engineering Stations)
• Excel for BulkConfigurator • Activation Manager
• DYNSIM • SCP
• SCP/TRISIM

Typical DCS Checkout Installation

Standalone Checkout Computer Foxboro Systems (Galaxy, Historian,

• DYNSIM Prerequisites Operator Stations, Engineering Stations)
• Excel for BulkConfigurator • Do not install any SimSci software
• DYNSIM
• SCP/TRISIM

For the DCS checkout, it is assumed that the actual hardware that will be installed in the plant is used. In such
cases, never install SimSci software on the actual DCS hardware suite, as some components cannot be
completely uninstalled. They will invalidate the Foxboro warranty.

Activation Manager Software Installation

Activation Manager (AM) is a subset of the full DYNSIM installation and should be installed on systems where
the full DYNSIM installation is not required. Later, if DYNSIM software is required, it is not necessary to
uninstall AM.

After completing AM installation, reboot and proceed to installation of other software.

Installation Assumptions:
• The user has administrative privileges
• No firewalls or other port blocking software is installed
• Other DYNSIM software has been uninstalled and the system rebooted

To install Activation Manager Software

1. Navigate to the Activation Manager Install directory and double-click on Setup.exe.

DYNSIM Getting Started User Guide 27

 2. In the Activation Manager popup, select Next.

3. Read the License Agreement. If you agree, select the checkbox to accept the agreement and select Next.

4. Review the Instruction and Click Next button.

DYNSIM Getting Started User Guide 28

 5. In the Ready to Install window, select Install.

6. Wait while the Installation is in progress and click Finish after the installation is complete.

Advanced Installation Options

Additional steps are needed to complete DYNSIM software installation for simulator hardware that includes
multiple network interface cards (NICs) and for large Operator Training Simulators (OTS) that distribute
engines over multiple machines. This section details the additional configuration steps to optimize simulator
performance.

DYNSIM Getting Started User Guide 29

DSS Host Configuration Editor

The DSS Host Configuration Editor is a tool to customize simulation infrastructure configuration. Use this
utility to configure Operator Training Simulators (OTS) in a distributed environment where engines or
Graphical User Interface (GUI) instances reside on more than one computer. Refer to the Dynamic Simulation
Suite User Guide for additional details about this utility.

1. Update the DSS Host Configuration Editor for each machine

a. Select Start / Programs / SIMSCI / DSS532 / DSS Host Configuration Editor

b. Change the Name Service Host and Database Server Host to point to the machine running the
Simulation Executive
c. Select the Set Interface button

DYNSIM Getting Started User Guide 30

 d. Choose the appropriate Network Interface and select Set
e. Select Reset when finished
f. Verify the services registered

It may be necessary to disable the Windows Firewall/Internet Connection Sharing (ICS) service on the
computer. Refer to the Disable Windows Firewall section in this document for details.

Systems with Multiple SCP Stations

Multiple AWs and/or SCP Stations should be included in the original commit. For the SCP Stations, the naming
service must point to the SimExec machine.

1. Update the DSS Host Configuration Editor for each machine

a. Select Start / Programs / SIMSCI / DSS5x / DSS Host Configuration Editor

DYNSIM Getting Started User Guide 31

 b. Change the Name Service Host and Database Server Host to point to the machine running the
Simulation Executive
c. Select the Set Interface button

d. Choose the appropriate Network Interface (in this example, the secondary network is
164.168.1.1) and click Set
e. Select Reset when finished
f. Verify the services registered

It may be necessary to disable the Windows Firewall/Internet Connection Sharing (ICS) service on the
SCP Station(s). Refer to the Disable Windows Firewall section in this document for details.

DYNSIM Getting Started User Guide 32

Multiple Network Interface Card Setup

When the Activation Manager or DYNSIM infrastructure is installed on computers having multiple NICs or
Microsoft Loopback adaptor configuration, use the DSS Host Configuration Editor’s Set Interface button to
specify an IP Address that will bind to the TAO Name Service. This step optimizes the DYNSIM infrastructure
to look only at the correct network connection which results in faster networking and configuration
performance.

Setup DYNSIM Infrastructure in Distributed Mode

Additional configuration is needed when running DYNSIM software on computers with more than one network
interface card (NIC) or if the simulator is split between several computers. Configuring DYNSIM engines to run
in a distributed environment on multiple machines involves these steps:
• Configure a network with dedicated NICs and a switch
• Establish an account on each machine with identical (case sensitive) user name and password which is part
of the Administrators group
• Disable firewalls or place in learn mode
• Install either the DYNSIM infrastructure or Activation Manager
• Install specific engines
• On each machine, configure the Name Server Host and Database Server Host to point to the correct machine
and use ‘Set Interface’ to specify the IP associated with the simulator network

Running the Simulation Executive or other GUIs On Separate Computers

The Process Model/Simulation Executive can be run on any computer included in the DYNSIM infrastructure
network. Additional Graphical User Interface (GUI) instances can also be configured. The minimum hardware
requirement is an Intel Pentium® Processor 2.8 MHz with minimum of 2 GB of RAM. Perform the steps listed
under the DSS Host Configuration Editor section above.

Switching Security Types for PC

DYNSIM provides the following security options:

• USB Single User Security

• FLEXNet Security

DYNSIM Getting Started User Guide 33

 • TOKEN
• TOKENnet

The security option used is normally chosen during the install procedure. If you want to switch to a different
security method after installation,

1. Click Control Panel > Add or Remove Programs > Change and select the “Change” option from the
SimSci DYNSIM installation program.

2. Click Next.

3. Select the desired security option and click Next. Your security option is now changed.

How to Apply a DYNSIM Patch

Starting DYNSIM 4.1, patch install kits will no longer be supported. Each maintenance version of DYNSIM,
such as DYNSIM 4.1.1, when available, will include the full install kit and require a full re-install.

Starting DYNSIM Application

After you install the program, a DYNSIM shortcut is displayed on your desktop. You may use this icon to start
the program or follow the steps given below:
1. Start DYNSIM by clicking on Start/ Programs/SIMSCI/DSS53 and selecting the DYNSIM icon.
2. This brings up the DYNSIM login screen. You’ll be prompted for a “Username” and “Password”. Use
simsci for both the username and password and launch the application by clicking on “Login”.

DYNSIM Getting Started User Guide 34

DYNSIM Getting Started User Guide 35
 Chapter 2
Translation: PRO/II to DYNSIM
SimSci’s concerted efforts to blend the concepts of “Steady State” and “Dynamic Simulation” into one
integrated software environment is a reality. The transition has been collective, comprehensive and
constructive in meeting its objective.
The DYNSIM integration with our steady state simulator is specifically geared to PRO/II V 8.0 and
later. It has the inherent capability to provide a seamless import capability from PRO/II to DYNSIM
application.

Translating PRO/II files into DYNSIM

There are currently two options made available to the user to translate files from PRO/II to DYNSIM
application. They are as follows:
Option I – Exporting a Simulation from PRO/II
This option requires a current PRO/II license and DYNSIM license. A typical procedure is:
1. User develops a steady state flowsheet in a typical PRO/II environment.
2. The required data for generating a flowsheet needs to be satisfied in PRO/II Simulation.
3. The user should “Perform Output Calculations” before exporting to DYNSIM software. The
flowsheet has to be Run (i.e., converged) and Saved for retrieval during the exporting stage.
4. Using the Output menu, select the “Send to DYNSIM” option. This allows the user to forward
the current flowsheet to the DYNSIM application.
5. The flowsheet is processed to create a DYNSIM flowsheet.
6. Subsequent to a successful translation, DYNSIM application is started and populated with the
processed flowsheet.

Exporting from PRO/II into DYNSIM application

DYNSIM Getting Started User Guide 36

Option II – Importing a Simulation into DYNSIM
This option requires the PRO/II version installed to match the version of the prz file that is translated. A
current DYNSIM license is required but does not require a PRO/II license.

1. DYNSIM software user can select a previously saved PRO/II flowsheet in a way similar to
selecting a previously saved DYNSIM flowsheet. Within the Open Simulation dialog box, the
user must change the “Files of Type” option from “SIM4ME Files *.s4m” to “PRO/II
Simulation Files *.prz”.
2. On applying the Open command, the flowsheet is processed to generate a DYNSIM flowsheet.
The Open command then proceeds the same way as the native DYNSIM Open command.

Seamless Importing PRO/II Input in DYNSIM application

Users are directed to refer to the Translation Reference Manual wherein

detailed explanation of the “Translation concepts” is furnished.

Supported PRO/II to DYNSIM Versions

The following versions of PRO/II will translate into corresponding DYNSIM versions:

PRO/II 9.1.x  DYNSIM 5.3.1, 5.3, 5.2, 5.1

PRO/II 9.2  DYNSIM 5.3.1, 5.3, 5.2, 5.1
PRO/II 9.3.4 DYNSIM 5.3.2, 5.3.1, 5.3, 5.2
PRO/II 9.4 DYNSIM 5.3.2, 5.3.1

DYNSIM Getting Started User Guide 37

 Chapter 3
Getting Started Tutorial
In this chapter, we will walk you through the basic steps required to simulate process flowsheets within
DYNSIM software.

What You will Learn in this Tutorial

We will show you how to accomplish these tasks as described below:
1. Starting DYNSIM.
2. Creating a New Simulation.
3. Setting up a Simulation.
4. Executing the Simulation.
5. Interpret the results generated during this simulation.

Starting DYNSIM Application

After you install the program, a DYNSIM starter icon is displayed on your desktop. You may use this
icon to start the program or follow the steps given below:
1. Start DYNSIM by clicking on Start/ Programs/SIMSCI/DSS532 and selecting the DYNSIM icon.
2. This brings up the DYNSIM login screen. You’ll be prompted for a “Username” and “Password”.
Use simsci for both the username and password and launch the application by clicking on “Login”.

DYNSIM Getting Started User Guide 38

 DYNSIM “Login Screen”

Creating a New Simulation

Once the user has logged into the DYNSIM session, you now need to create a new simulation. The steps
are as follows:
1. Under the File menu select New and Simulation. The New Simulation dialog box will appear and
prompt the user for a simulation name.

New Simulation Dialog Box

2. Use ReverseFlow as the simulation name and Click OK.

The simulation name must not contain spaces or symbols

3. The simulation will be created in a default user directory (C:\SIMSCI\DSS532\User\ Reverse
Flow.s4m).

DYNSIM Getting Started User Guide 39

Data Input Conventions
The DYNSIM Graphical User Interface distinguishes the input data as follows:

Required The user must enter data in order to run the simulation. Without a valid entry, the input for the
simulation is incomplete and an error message will be displayed if the simulation is executed.
The default color for this type is red.

Default The default value is usually a good estimate and a value that is commonly used for that
parameter. The value may be overridden if desired. The default color for this type is green.

Caution Indicates a value that is not realistic and might produce erroneous results. The default color for
this type is yellow.

Optional Data, which is not explicitly required by DYNSIM software for its execution. A Colorless
cell is used for this type of data.

A Colorless cell also means that the required or default data has been modified.

Tab Status Indication

Any data in the data fields of the DEW of an individual object is validated and the status is indicated for the
individual tabs. The DEW uses the following to indicate the status of input data, as follows:

Valid Data Entry of valid data in all the data fields of an individual tab of a DEW. Any default data
(green data field) or optional data (colorless data field) are also considered as valid and the
status is indicated by .

Invalid Data Any required data (red data field) or data, which is not realistic (yellow data field) in any of
the cells of a DEW, is considered invalid and the status is indicated by .
Setting up a Simulation
The DYNSIM interface has been designed to incorporate many of the features that are built in the
PRO/II GUI. Hence, similar to a PRO/II simulation, the user can follow a series of steps to setup a
simulation.
They are detailed as below:
1. Define the Units of Measure (UOM).
2. Select components and define component slates.
3. Specify a thermodynamic method.
4. Configure the flowsheet objects.
5. Connect the objects through relevant streams.
Once the above steps are accomplished the user will run the simulation and monitor the dynamic
behavior of the process under study; specifically on how to model reverse flow through a valve. This
simple example illustrates the fact that DYNSIM software is well equipped with a state of the art
pressure-flow solver, critical for modeling more complex unit operations such as distillation columns
with precision.

DYNSIM Getting Started User Guide 40

 The steps to fix up the parameters are enumerated below.
Step 1: Define the Units of Measure (UOM)

1. Click on the UOM icon , which will display the Units of Measure dialog box as indicated below.

UOM Dialog Box

2. The user can choose from the predefined UOM slate list.
3. Alternatively, you have also got the flexibility to define a custom UOM slate by clicking on the New
Slate button. Hence, for any specific class the user can define a custom unit of measure or utilize the
default unit available. For this particular example we will be using the SI UOM list. Click OK once
the option has been selected.

Step 2: Select Components and Define Component Slates

In this step you will be defining the specific components to be used in the simulation. There is a
significant change in approach employed in SimSci’s related products like PRO/II and ROMeo
applications. In the PRO/II application, the user selects the components and in doing so defines a single
component slate that is used for all of the process units and streams in the simulation. In the ROMeo
application, the user has the ability to create multiple component slates to be used by individual process
units as applicable. In DYNSIM software employs the more flexible approach to ensure that the
computational problem is defined as efficiently as possible.

1. Bring up the DYNSIM thermodynamic GUI by clicking on the Component icon in the
toolbar. Notice that both components and thermodynamics are displayed in this window.
2. The first tab is titled “Library” and allows the user to add any of the pure or library components.
The user can enter a component by typing the technical name, alias or the chemical formula in
the Add Library Component cell and clicking on Add.

DYNSIM Getting Started User Guide 41

 3. The user can selectively display components based on the Component Full Name, Alias Name or
Formula by clicking on the appropriate sort column and entering characters in the Filter box at
the lower right.

By default, only the most commonly used components are listed. Additional components can
be exhibited by selecting a different Component Family (located above the filter box).

Components & Thermodynamics Slate Dialog Box

Similar to the PRO/II application, if you wish to define a Petro component, a minimum of two physical
properties among the listed parameters below must be defined:
• Boiling Point
• Density
• Molecular Weight

DYNSIM Getting Started User Guide 42

 Defining “Petro Component Properties”

The next stage is to define the component slates. A component slate can consist of a few select
components (e.g. in the case of a cooling water stream there might only be one - water). The primary
objective is that when DYNSIM software performs property or equilibrium calculations, for instance a
drum or separator, it only needs to consider those components defined in the component slate and not all
the components defined for the entire simulation. This will enable faster computational speed, especially
for simulations containing a large number of components.
1. Click on the Slate tab wherein the New Component Slate box appears at the left-hand corner of the
application. The screen appears as shown below.

DYNSIM Getting Started User Guide 43

 Creating up a “Component Slate”
2. Create a new component slate by typing PROCESS in the New Component Slate box and then click
the Add button.
3. Drag and drop Ethane, Ethylene, isoButane and Propane from the Selected Components list to the
Components in Slate list.

4. Users have the flexibility to define as many slates as per their requirements. However, you must
first define a component in the Selected Components list before it can be added to any given slate.

The user may drag and drop multiple components by selecting marginally outside the icon of
one of the selected components.
Step 3: Define a Thermodynamic Method

Once the component slate is defined, the next step is to specify a suitable thermodynamic method. The
sequence of operation is as follows:
1. Click on the Method tab. In the New Method Slate cell, enter SRK and click Add.
2. Now expand the Thermodynamic Data tree against SRK created by you and observe the available
methods for equilibrium, enthalpy, entropy, and density calculations by right-clicking with the
mouse.

DYNSIM Getting Started User Guide 44

 Selection of a Thermodynamic Method
3. Choose the appropriate equation of state method as per the simulation requirements. For this
particular simulation, the components selected are light hydrocarbons and hence an equation of
state method such as Soave-Redlich-Kwong or Peng-Robinson would be suitable. Once the
selection is made, click OK to save and Close the Component and Thermodynamic Data Entry
Window.
Step 4: Lay Down Models

Once the above step has been completed in all aspects the user is now faced with a blank canvas. To
start configuring the flowsheet, the user needs to select the appropriate models. You have the option to
choose from one of two methods for adding objects to the flowsheet.

1. The first method is through selecting the Palette icon . This appears on the main toolbar and
can also be accessed by clicking on the View menu and selecting it there. Upon selection, a
floating Icon Palette similar to the “PFD Palette” found in PRO/II appears. You can now select
streams, equipment models, or other configurations to lay down on the flowsheet.
2. Alternatively, the user can select the Types tree on the bottom left hand corner of the screen.
The Types tree contains a complete list of the entire model Libraries in DYNSIM software
including Primitives, Widgets, References, Connectors, Points, Base Equipment, Controls,
Electrical Grid, and Utilities.

The “Icon Palette” contains only a subset of the most common models present in
DYNSIM software. If a particular unit operation is not listed on the icon palette the user is
instructed to locate the same in the “Types” tree.
3. From the Icon Palette, select a Source and fix it on the flowsheet.

DYNSIM Getting Started User Guide 45

 4. Now Double-click on the source icon or Right-click and select Data Entry . This will exhibit a
Data Entry window through which the user can configure the source.

The default action on a double-click depends on the state of the flowsheet. For example,
when running a simulation, double-clicking on a valve brings up a slider, which allows you to
manipulate the valve position. All options are always available through the right mouse click menu.

Configuring a Flowsheet

Remember that if you select the Edit option, the Object Editor Viewer (OEV) window pops up. This
window contains a comprehensive set of all the parameters associated with this model.

DYNSIM Getting Started User Guide 46

 Normally it is expected that only expert users will configure models using the OEV interface.
Enter the following data: Elevation: 6.096 m
Pressure: 3350 kPa
Temperature: 395 K

Until you select the Thermo tab and select the Process slate, the “Boundary Condition” tab will
display all the components selected for the simulation. After you have selected the “PROCESS” slate
and fixed “SRK” as the thermodynamic method, go back to the “Boundary Condition” tab.
Enter the following data: Ethane: 2 kg-mol
Ethylene: 3 kg-mol
iButane: 2 kg-mol
Propane: 4 kg-mol
Now you will observe that the Process slate composition is displayed. Notice that this data is pertaining
to the composition data and that you are entering values, which will be normalized to determine the
stream composition. The flow is a calculated value, which is dependent on the pressure network.

Process Slate Composition

DYNSIM Getting Started User Guide 47

 5. After clicking OK for the Source, Select a valve and sink and place them on the flowsheet.
6. To increase the canvas area, select the View menu, Click on Change Toolbars and choose
Abbreviated. Notice that in addition to Abbreviated there are four other options under Change
Toolbars. Each of these options refers to a specific user profile.

7. Administrator ensures that all DYNSIM software’s options are displayed. Operator, Instructor and
Engineer configures the toolbar to suit a specific user profile. For example, an engineer might need
to edit and modify a simulation. However, it might not be the case for an operator training on a
particular DYNSIM simulation. These options indicate that DYNSIM software is not limited to
engineering studies alone. Apparently, it’s also utilized for Operator Training Applications (OTS) in
which the operator, the instructor, and the engineer use a single integrated modeling environment.
8. Enter the following information as exhibited in the screen below for the Valve model. As in the case
of the Source, the Thermo method is SRK and the component slate is Process. For the Sink model,
the pressure is fixed at 200 kPa.

Valve Model Configuration

DYNSIM Getting Started User Guide 48

Step 5: Connect the Flowsheet Objects Using Appropriate Streams

The next step in building the simulation is to connect the flowsheet objects using the appropriate
streams. For the purpose of simplicity only the process streams are considered for this example.
However, there are other stream types available in DYNSIM software as indicated in the table below.
These include:

Stream Type Description

Used for connecting unit operations from the base

Process Stream
equipment library. Represents compositional streams.
Used for linking utility exchangers to equipment
models that can have a heat duty associated with
Heat Stream
them.
E.g. Distillation Column, Separator, etc.
Used to associate a motor or expander to a pump or
compressor. It can also link to a motor, expander,
Mechanical Stream
pump, and compressor to a shaft so that all
equipment operates at the same speed.
Used for interconnecting objects from the electrical
Electrical Stream
library.
Used to connect model parameters to each other, e.g.
Connectors a process variable to a controller or a controller
output to a valve open command.
Classification of Streams

In DYNSIM software, as in PRO/II software, valid port locations are highlighted and green (required).

Connecting Flowsheet Objects and Streams

Step 6: Executing the Simulation

Once the selected simulation is complete in all aspects, the user to run the simulation can adopt the
following instructions.

1. Click the Start button, , to initiate the simulation engine. This causes DYNSIM software to
start the simulation and leave it in a frozen state.

2. To run the simulation the user should click on the Run button, .

DYNSIM Getting Started User Guide 49

 Controlling a Simulation
3. Finally with the simulation running the user can begin to examine the dynamic behavior of the
system. For example to monitor the flow rate through the valve, select a Flow Rate Indicator
from the References library on the Types tree. Place this on the canvas just below the valve.
When prompted for a name, enter the stream name that needs to be tracked, in this case S2. A
green arrow denotes a positive flow rate in the direction specified by the stream. A red arrow
denotes reverse flow.

Dynamic Simulation Features

4. Double-click on the valve flowsheet icon. The “Operate Valve” window will pop up. This allows
the user to adjust the valve position using a Slider. Set the position to 100% open. Notice that
the Flow Rate Initiator indicates a positive flow rate in the direction of flow specified by the user
(green arrow).
Under ideal conditions, you would wish to have the flexibility to modify the boundary condition
of the sink (i.e. it’s pressure) without having to edit the parameter in the tabbed dialog box.
DYNSIM software allows you to drop a Slider on the canvas and link it to flowsheet parameters
such as a sink pressure. Hence, in this mode you have the option to easily alter the sink pressure
and see how it affects the flow though the valve.

DYNSIM Getting Started User Guide 50

 5. Select a Slider from the Widgets library on the Types tree. Locate it on the canvas. Right-click
with the mouse and select Draw Attributes. For Point Name, select SNK1.PB, which is the name
of the Sink followed by the parameter you opt to control.
The Maximum /Minimum ranges for the slider are set to 5,000 and 500 kPa respectively, and
the orientation is set to vertical.

Modification of Boundary Conditions

6. Before varying this parameter (Sink Pressure Boundary) remotely, the user must first change its
designation from static to dynamic. To do this highlight the Sink, right-click on it and select,
Edit . This exhibits the OEV interface, which allows the user to edit any variable associated
with this model.

Static To Dynamic Condition Changeover

7. The user can now alter the pressure of the Sink by varying the pointer on the slider. To track the
exact value of the pressure at the sink at a specific point of time, the user can select a Point from
the References library on the Types tree. Locating the Point on the canvas next to the Sink, the
user is prompted for a name. Now enter the name as SNK1.PB and observe that the sink

DYNSIM Getting Started User Guide 51

 pressure appears in blue.
8. Alternatively, try to induce reverse flow in the model. Start increasing the pressure at the sink
(SNK1) by adjusting the position of the pointer on the vertical slider on the left hand side of the
flowsheet. Remember you have already linked this slider to set the boundary pressure at the
sink. The higher the pressure at the sink, the smaller the flow rate across the valve. Eventually, a
point is reached where the pressure at the sink is sufficiently high, that it results in reverse flow.

Reverse Flow in a Valve

9. To complete the demo, select a Rectangle from the Primitives library on the Types tree. Draw a
rectangle around the slider, right-click, select Draw Attributes and choose a fill color. To
summarize, the ultimate step illustrates the flexibility available to the users to customize the
flowsheet graphics according to their requirements.

DYNSIM Getting Started User Guide 52

 Customization of a Flowsheet

DYNSIM Getting Started User Guide 53

 Chapter 4
Set-up DYNSIM in Distributed Mode

Summary
This chapter describes the details of setting up DYNSIM® software in a distributed environment for projects.

Before you start

1. Establish the exact (case sensitive) account and password on every machine on which DYNSIM
software is deployed in a distributed environment. The user should be a member of the Administrators
group. With local System Administrator privileges, the user can be added to the Administrators group.
To accomplish this go to Control Panel  Administrative Tools  Computer Management. Then
always use this account while using DYNSIM software in distributed mode.

2. If the system administrator has established Active Directory Control and a group policy that enforces
this, then a workgroup needs to be established, including all users that are allowed Administrative
privileges on each of the machines. The system administrator should apply the new policy.

3. A basic test is to run a \\<remote_machine_name> (see example below) from the windows run
command. If you are queried for user credentials to access \\<remote_machine_name>, then the
DYNSIM services will certainly not be able to start a DYNSIM process on the remote machine. If this
simple test works, also verify that you can create and delete files on the remote machine and manage
user accounts on the remote machine.

DYNSIM Getting Started User Guide 54

Steps to Configure Distributed Mode
Steps 1-5 establish that DYNSIM software is installed properly on each machine.

1. On each machine use Start  Programs  SIMSCI  DSS532  DSS Host Configuration Editor. Use
the Reset button on this application to reset services for the local machine. Verify the various services
are running OK.

2. If you have Windows 7 Enterprise SP1, verify the Windows Firewall service is stopped and disabled.
See Start  Control Panel System and Security.

3. Check the status of these services. Each should be started and automatic mode. If the service is not
started use the Windows services utility to start the service. If the service fails to start, review the
Windows event viewer System Log and Application Log for root cause.

If there is a third party firewall, such as McAfee®, ensure that incoming learning mode is enabled.
SIMSCI Support has an instructions form for McAfee v8 firewall.

4. Verify that DYNSIM application starts up on each machine and a new empty flow sheet can be created.

The following steps focus on setting up the distributed environment.

5. Set up \WINDOWS\system32\drivers\etc\hosts file. The entries should include a standard local host. In
the example below there are four remote machines named d43xp1, d43xp2, d43xp3 and d43xp4. In
order to set up hosts file on another machine, perhaps named d43xp5, include both the simple machine
name and fully qualified machine name separated by tabs. Check every hosts file twice. Spelling errors
and transpositions cause frequent issues. All hosts’ files must be consistent.

DYNSIM Getting Started User Guide 55

 Run an ipconfig /all command from a command prompt.
Examine what is returned for DNS Suffixes are reported.

127.0.0.1 localhost
10.2.21.178 d43xp1 d43xp1. <DNS suffix>
10.2.21.148 d43xp2 d43xp2. <DNS suffix>
10.2.21.146 d43xp3 d43xp3. <DNS suffix>
10.2.21.144 d43xp4 d43xp4. <DNS suffix>

6. All machines should have a consistent Windows login authentication. Specifically, each Windows user
logged in should have local machine administrator privileges on each of the other machines. If there is
an issue with administrative privileges the user will be able to get most of the way through these steps,
but will not be able to actually launch the engine on a machine where windows authentication is not
correct.

7. Execute a ping test from each machine to another to verify network viability. Ping both the machine
name and the fully qualified machine name. Both should return the same IP.

ping d45xp1
ping d45xp1. <DNS suffix>

Next find this file

<drive>\SIMSCI\DSS53\Servers\Bin>pingns.exe

Execute this command:

pingns.exe <remote_machine_name> 10152

If it does not pass the ping and pingns test, check network cables, network configurations, and finally
consult your IT administrator for help.

8. Optional for debugging: Open and modify the Config_file.dat file present under <Install
drive>:\SIMSCI\DSSxx\Servers\System. Set the variable ‘show_windows’ to YES. Save and close the
file. This will launch the engine dos windows (for both Run and Edit) when the application invokes the
engines respectively.

9. Optional for debugging: Open and modify <Install

drive>:\\SIMSCI\DSS532\GUI\Bin\runSIM4ME_DYNSIM532.
Near the end of this file:
Change
PLANA
@echo on
start "DSS" "%_JH%\bin\javaw" -Xms32m etc.
-to-
:PLANA
@echo on
start "DSS" "%_JH%\bin\java" -Xms32m etc.

10. All machines must look to a single Name Service Host where the SimExecutive should reside. This is
always the same as the Data Base Server Host. The next step is to change the Host Configuration Editor
settings in the 2nd machine (CIN05409B) to point to the machine on which SimExecutive is hosted
(CIN05409A in this case).

DYNSIM Getting Started User Guide 56

 a. Default Settings (2nd machine)

b. Modified Settings (2nd machine)

DYNSIM Getting Started User Guide 57

 11. Option for debugging: on each machine, go to StartAll ProgramsSIMSCI DSS52Naming
Viewer. Expand Root to see all of your machines and their primary DYNSIM processes. The
screenshot below shows processes for a multi-machine environment. If multiple machines are
present and working, there will be similar information with the various server names, which match
machine names.

DYNSIM Getting Started User Guide 58

 Verify:
S4MUtilityServer is visible for each machine.
S4MSimStartup is visible for each machine.

Right-click on Folder Managers and Security Serves and examine IP and port bindings.

The following screenshot illustrates an issue encountered on a system with multiple network cards.

The above IOR table shows one issue that may be encountered if multiple network cards are present. On
the machine running the simexec (fsxp09 in this example), use the Naming Viewer to examine the IOR
table for the remote machine, where engine startup or performance is an issue (fsxp41 in this example).
In this example, the 10.2.x.y network is common to fsxp41 and fsxp09 and the DYNSIM Services must
bind on the 10.2.x.y network, but fsxp41 is returning the 151.128.x.y network. Use the DSS Host
Configuration Editor / Set Interface button and point to a specific IP Address to overcome this issue.
Contact SIMSCI support to obtain a troubleshooting guide if this is encountered.

DYNSIM Getting Started User Guide 59

 12. Configure the Engines for the s4m file using the Engine configuration editor to point to the various
machines on which DYNSIM engines are to be launched. The example below shows how to set up a 2-
engine simulation across 2 machines. The 1st Engine (DYNSIM1) is to run on machine CIN05409A
along with Sim Executive, while the 2nd DYNSIM engine (DYNSIM2) will run on Machine
CIN05409B:

Modify the Engine configuration for the simulation (on machine CIN05409A)

13. The final step is to modify the logon window parameters for 2nd machine and point to the first machine
(CI054509A in this case)

DYNSIM Getting Started User Guide 60

 14. Now launch the application on 1st machine (CIN05409A) and load the model. The SimExecutive,
DYNSIM1 Edit, and DYNSIM1 Run engines would get launched on CIN05409A. Similarly
DYNSIM2 Edit and DYNSIM2 Run will get launched on CIN05409B machine. The simulation can
now be executed from any of the two machines.

The GUI on 2nd machine will not launch automatically and will have to be invoked by the user by
clicking on the DYNSIM start icon. However, once launched, the GUI display will get synchronized
automatically.

15. There should be only one SimExecutive (on the SimExec host machine) running for a multi-box setup.
The Naming Service Viewer may be used to confirm this.

16. If the above-mentioned steps are not successful, here are some additional troubleshooting steps.

Check to see if there are multiple network adaptors installed. Ask SIMSCI Support for the DYNSIM
troubleshooting guidelines for multiple networks or private networks. Change the search order for
network adapters and then perform an ipconfig /release and ipconfig /renew to determine if this helps.

Verify naming service port settings are all set correctly. Default port setting should be 10152 and
consistent everywhere. Also verify that there are no collisions from other processes at this port. Use
Host Configuration Editor to change default port settings on each DYNSIM machine if this is necessary.

a. If network settings are modified recently or converted to a new machine with an old network name,
try an ipconfig /flushDNS

b. If step “a” is not successful, perform an ipconfig /all command from a command prompt. Note the
Host Name and the DNS Suffix Search List.

DYNSIM Getting Started User Guide 61

 c. Ping the Host Name and note the IP address that is resolved.

d. Ping the <Host Name>.< DNS Suffix Search List> and verify that the same IP address is resolved.

e. If the IP addresses from steps “c” and “d” are identical then skip to step “h”.

f. If the IP addresses from steps “c” and “d” are different, ask your system administrator to release old
DNS entries in the system DNS table.

g. Then stop and start the DNS client on your local machine (on Windows 2000 and later).

DYNSIM Getting Started User Guide 62

 h. Until the DNS issues are resolved on your network, you may modify the advanced TCP/IP settings
to try to work around this issue. See screen capture below.

Verify the box is checked for "Use this connection's DNS suffix in DNS registration".

On the system in this example, the DNS servers are supplied by DHCP server and therefore the
"DNS server addresses, in order of use" is blank. The user may need to provide "DNS server
addresses, in order of use" on your system. To obtain DNS server addresses, consult the system
administrator.

DYNSIM Getting Started User Guide 63

 Chapter 5
Troubleshooting

Troubleshooting Guidelines
Occasionally users encounter problems during installation. Here are some troubleshooting tips that you
can use that may resolve the problem. If you have further questions, please contact your local SimSci
Technical Support Center (see “Technical Support” detailed under the “Introduction” of this guide).
Following are some typical scenarios you may be facing when installing DYNSIM software, along with
suggested tips to overcome them.

Installation Problems and Solutions

Scenario # 1
One or more files appear to be corrupted based on an unusual file size or run-time message.
Solution:
1. Run CHKDSK to verify the drive
2. Remove the current installation
3. Reinstall the programs from the start

Scenario # 2
Access failures due to invalid path: You received messages that files could not be copied and the
installation has been aborted.
Solution:
1. If you are attempting to install on a network, ensure that you have adequate read/write access
privileges.
2. Ensure that you have adequate disk space in the desired directory.

DYNSIM Getting Started User Guide 64

 Scenario # 3
The program is installed on a system running on Windows platform. When you run the program, it
produces errors relating to security.
Solution:
• Ensure that the person who is responsible for installing the program has system administration
rights/privileges.
Scenario # 4
You are unable to find enough information on FlexNet Security.
Solution:
• Information related to FlexNet security can be located at
http://www.flexerasoftware.com/solutions.htm.
Scenario # 5
DYNSIM services will not start and DYNSIM application will not launch.
Solution:
1. Start->Programs->SIMSCI->DSS532 DSS Host Configuration Editor. Use the reset button on
this application to reset services. See SIM4ME_HOST_CONFIG_EDITOR.doc if this is not
clear.
2. If you have Windows 7, verify the Windows Firewall service is disabled. See Start-> Control
Panel-> System and Security
3. Check the status of these services. Each should be in “Started” and “Automatic” mode.
4. If the service is not started, use the Windows services utility to start the service. If the service fails
to start, review the Windows event viewer System Log and Application Log for root cause.

Prior to DYNSIM 4.1, the DSS Activation Manager and DSS Utility Server were named SIM4ME
Activation Manager and SIM4ME Utility Server.

1. If you have a 3rd party firewall, such as McAfee or similar, ensure that incoming learning mode is
enabled.
2. On some 64-bit machines it may be necessary to stop and restart the SIMSCI_Naming_Service.
Using the Windows Services utility stop the SIMSCI_Naming_Service. You may be prompted to
stop other services (Activation Managers and Utility Servers). Click Yes. Once the
SIMSCI_Naming_Service is stopped, restart it. Now restart the Activation Managers and Utility
Servers that were stopped. Alternatively use reset in the DSS Host Configuration Editor to restart
the services.

DYNSIM Getting Started User Guide 65

How to Get DYNSIM to work after McAfee Firewall Install
Purpose

We suggest that you use this procedure to verify that McAfee firewall is the root cause of your current issues
and then discuss a permanent remedy with your system administrator.

Before You Begin

If a McAfee firewall has been installed (often because of a new VPN setup or new security policy) and your
DYNSIM application services are not starting up despite using the Host Configuration Editor reset feature
several times, then:

This procedure shows you how to get DYNSIM software working with the McAfee firewall. The solution
outlined in the next few lines may be temporary if your system administrator has pushed security policies related
to firewall policies on to your system at regular time intervals or at time of login to his network/domain. If
McAfee Agent is used as your policy orchestrator, you may learn more about your security policies at using a
web browser on local host at port 8081.

DYNSIM Getting Started User Guide 66

Steps to Get DYNSIM to Work after McAfee Firewall Install

Double-click the in your system tray to launch the McAfee firewall policy Manager.

1. If someone has already created a policy that allows DYNSIM software to run (IMPORTANT: It is on
your network), use the import policy to apply it to the same policy that they exported. This should be
cleared with your System Administrator first.

2. If item 1 does not apply, start with the policy that exists on your system (just as you find it) and make
notes of the settings for Protection Level and Learn Modes.

3. Place the enabled firewall in Learn Mode (as shown in the screen below)
• Protection Level must be Custom.
• Incoming Learn Modes is Enabled (checked).
• Outgoing Learn Modes is Enabled (checked).

DYNSIM Getting Started User Guide 67

 Important: At each step, some DYNSIM components may fail, but McAfee firewall will learn one
more step. McAfee firewall will ask you to confirm that various DYNSIM processes are legitimate and
you must confirm to progress. Repeat with persistence, until it is clear that no progress is being made.

4. Use the DSS Host Configuration Editor to stop and restart the DYNSIM services. Eventually the
SIMSCI_Naming_Service, Activation, and Utility services will all start successfully and when they do,
go to next step.

5. Start up DYNSIM and log in.

6. Open the Ammonia Reactor App lib – It has the Microsoft Excel interface example.

7. Run this model.

A McAfee firewall policy screen from a machine that has learned to run DYNSIM is listed below.

DYNSIM Getting Started User Guide 68

 8. Export the policy for recovery later if needed.

9. At this point you should place the Firewall back in its original policy mode as you noted in step 2.

10. Reboot and confirm that DYNSIM software still runs.

11. Discuss results with System Administrator.

DYNSIM Getting Started User Guide 69

Windows 2008 Server R2 performance settings

The performance of DYNSIM on a Windows 2008 Server R2 operating system is impacted by the O/S
settings and one can adjust these settings to improve the performance and energy efficiency of the Windows
Server 2008 R2 operating system.

1. The Power Options (Control PanelSystem and Security) should be set to High Performance.

2. In the next step, apply the performance setting for the programs running. This can be done by right-
clicking on Computer->Properties

DYNSIM Getting Started User Guide 70

 3. Processors with better clock speed are likely to perform better. If eking out more performance is
important, pick the system (server or workstation) with the better processor.

Windows Server 2012 R2 installation

In some cases while installing DYNSIM 5.3.2 on a cleanly built Server 2012 R2 machine, prerequisites
installation might get hung up on Microsoft.VSTO2.0.SE (Visual Studio Tools for Office Second Edition
Runtime). It might return an error code that a prerequisite Microsoft .NET Framework 2.0 is missing.

In such scenarios specific configuration setting need to be done to enable Microsoft .NET Framework 3.5.
Following link shows the procedure.

https://blogs.msdn.microsoft.com/sql_shep/2012/08/01/windows-2012-and-net-3-5-feature-install/

DYNSIM Getting Started User Guide 71

 Chapter 6
SimSci Diagnostics Framework

Introduction
This diagnostics framework was developed primarily to help diagnose problems associated with startup of
SimSci applications. It can also be used by these applications to log system or setup problems encountered
during runtime. It is not designed to log diagnostics related to algorithmic failures.

Logging is provided in two forms:

1. System Event Viewer
2. SQL complaint database log files.

Each application decides where to log the messages. In general, more critical messages are logged to the Event
Viewer along with the database and the rest are logged only to the database log. In the rare case where the
application is unable to create a database log (due to permissions etc.), a message indicating the same will be
logged to the Event Viewer.

These diagnostics are designed to help the SimSci technical support staff in identifying the root cause of a
reported problem. These tools can also be used by the end users to possibly find and eliminate startup or setup
problems.

DYNSIM Getting Started User Guide 72

Using Diagnostics Log
Event Viewer Logs
To view messages logged to the event viewer, bring up the System Event Viewer. This can be done in one of
two ways:

• By typing ‘eventvwr’ in the Run dialog box from ‘Windows Start’

• By selecting All Programs  Administrative Tools  Event Viewer.

Within the event viewer, select the ‘SimSci’ folder to view the messages logged by the SimSci products. These
messages will be listed in the right pane. The source column in the right pane will indicate which product logged
the message. The ‘Type’ column indicates whether the message indicates an error, a warning, or is an
informational message.

Double-click on a message to bring up the details, which would be shown in a separate dialog box:

Each message contains three entries. The first entry is the actual message indicating the problem. The second
entry indicates the code location where the error message was initiated and the third entry indicates the
associated error code. The last two entries are written for use by SimSci development personnel and provide no

DYNSIM Getting Started User Guide 73

additional information to the end users. If you are submitting a problem to the technical support, please include
all three entries. This can be done by selecting them in the above dialog box and using copy/paste (Ctrl-C/Ctrl-
V).

Database Logs

Database logs are available as files in the folder SimSci\InstallationDiagnostics under MyDocuments. These files
are created using SQLite database. These files are named as: ProductName_LogYear_LogMonth_LogDate e.g.
DYNSIM_2008_02_23. All the logs belonging to a product for an entire day are stored in the same file. To view
the messages in these log files, you can use either a command line tool SQLite3.exe or a graphical tool
SQLiteDatabaseBrowser.exe.

Using the Command Line Tool SQLite3

To use a command line tool, open a command prompt, change the working folder to
SimSci\InstallationDiagnostics under MyDocuments, and run the command:

>SQLite3 LogFileName

For example,

>SQLite3 DYNSIM_2008_02_23

You will be presented with a SQLite prompt

Sqlite>

The diagnostics database consists of three tables: errorTable, warningTable, and infoTable. You can run any
SQL compliant queries on these tables, e.g. “Select * from errorTable”. Each query must be terminated by a
semicolon (;). The messages meeting the query specification will be displayed in the command window:

Wed Feb 06 13:30:59 2008 >> Image files not found in the Image
Folder|GUI:ImageHandling:LoadImage.java|80023

The table schema contains three columns: Description, ModuleName, and Code. The description contains an
automatic time stamp generated by the diagnostic framework. ModuleName and Code correspond to Code
Location and Message Code as described in the Event Viewer section above.

Using the Graphical Tool SQLite Database Browser.exe

Double-click on SQLite Database Browser.exe to bring up this tool. Use the FileOpendatabase menu option

or the corresponding toolbar open button to open the log file of interest.

Switch the tab to “Browse Data”

Select the Table of interest from errorTable, warningTable, or infoTable. The entries in these tables will be
listed in the pane below.

DYNSIM Getting Started User Guide 74

For more advanced queries, please use the ‘Execute SQL’ folder.

DYNSIM Getting Started User Guide 75