Dynsim 4.2 Getting Started: An Installation and Tutorial … Started with Dynsi… · Steady State vs. Dynamic Simulation ... Dynsim 4.2 Getting Started: An Installation and Tutorial

Dynsim 4.2 Getting Started:

An Installation and Tutorial Guide

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide

The software described in this guide is furnished under a written agreement and may be used only in accordance with the terms and conditions of the license agreement under which you obtained it. The technical documentation is being delivered to you AS IS and Invensys Systems, Inc. makes no warranty as to its accuracy or use. Any use of the technical documentation or the information contained therein is at the risk of the user. Documentation may include technical or other inaccuracies or typographical errors. Invensys Systems, Inc. reserves the right to make changes without prior notice.

Copyright Notice

© 2007 Invensys Systems, Inc. All rights reserved. No part of this publication protected by this copyright may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying, recording, broadcasting, or by any information storage and retrieval system, without the written permission from Invensys Systems, Inc. A limited nonexclusive license to use the Software and Documentation of CalHTMLPane v1.0b; Andrew Moulden of 82A Queens Road, Leicester, United Kingdom is acknowledged. All other brands and their products are trademarks or registered trademarks of their respective holders and should be noted as such.

Trademarks Dynsim and Invensys SIMSCI-ESSCOR are trademarks of Invensys plc, its subsidiaries and affiliates. Visual Fortran is a trademark of Intel Corporation. Windows 98, Windows ME, Windows NT, Windows 2000, Windows XP, Windows 2003 Server, Excel and MS-DOS are trademarks of Microsoft Corporation. Adobe, Acrobat, Exchange, and Reader are trademarks of Adobe Systems, Inc. OLGA 2000 is a trademark of Scandpower Petroleum Technology. All other products may be trademarks of their respective companies. U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND The Software and accompanying written materials are provided with restricted rights. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data And Computer Software clause at DFARS 252.227-7013 or in subparagraphs (c) (1) and (2) of the Commercial Computer Software-Restricted Rights clause at 48 C.F.R. 52.227-19, as applicable. The Contractor/Manufacturer is: Invensys Systems, Inc. (Invensys SIMSCI-ESSCOR) 26561 Rancho Parkway South, Suite 100, Lake Forest, CA 92630, USA. Printed in the United States of America June 2007.

Table of Contents

Introduction .................................................................................... i Steady State vs. Dynamic Simulation.............................................................. ii Who Can Benefit from Dynamic Simulation? ................................................. iii Who Should Read This Manual ...................................................................... iv Conventions Used............................................................................................v How This Manual Is Organized........................................................................v Information Links............................................................................................. vi

Online Documentation.............................................................................. vi Online Help ..................................................................................................... vi Additional Resources...................................................................................... vi

PRO/II Documentation: ............................................................................ vi Dynsim Documentation: .......................................................................... vii

Technical Support .......................................................................................... vii Installation.. ................................................................................... 1

Check Package Contents ................................................................................1 Installation Media ......................................................................................1 Documentation ..........................................................................................1

Prepare to Install..............................................................................................2 Hardware/Software Requirements ..................................................................3 Software Security.............................................................................................4

Local Hardware Security ...........................................................................4 FLEXlm Security........................................................................................5

Dynsim 4.2 Installation.....................................................................................5 Installation Options....................................................................................7 Pre-Install Checklist...................................................................................8 Un-Installing and Re-Installing Dynsim 4.2 .............................................10 Switching Security Types for PC.............................................................14 Note on Dallas Security...........................................................................15 How To Apply A Dynsim Patch ...............................................................16 Starting Dynsim .......................................................................................16

Translation: PRO/II to Dynsim.................................................... 17 Translating PRO/II files into Dynsim..............................................................17

Option I – Exporting a Simulation from PRO/II........................................17 Option II – Importing a Simulation into Dynsim.......................................18

Getting Started Tutorial .............................................................. 20 What You'll Learn In This Tutorial..................................................................20 Starting Dynsim..............................................................................................20


Creating a New Simulation ............................................................................21 Data Input Conventions .................................................................................22 Tab Status Indication .....................................................................................22 Setting up a Simulation..................................................................................23

Step 1: Define the Units of Measure (UOM) ..........................................24 Step 2: Select Components and Define Component Slates ..................25 Step 3: Define a Thermodynamic Method..............................................29 Step 4: Lay Down Models ......................................................................30 Step 5: Connect the Flowsheet Objects Using Appropriate Streams ....35 Step 6: Executing the Simulation ...........................................................36

Set-up Dynsim in Distributed Mode........................................... 42 Summary........................................................................................................42 Before you start..............................................................................................42 Steps to Configure Distributed Mode.............................................................43

Troubleshooting .......................................................................... 55 Troubleshooting Guidelines ...........................................................................55

Installation Problems and Solutions ........................................................55 How to Get Dynsim to Work after McAfee Firewall Install ......................57


Introduction

Tools for computer-aided process engineering are extensively utilized in the Chemical Process Industry (CPI) for scale-up and design of grass root 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 chemical 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 CPI 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

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide i

The ability of today’s computers to perform extensive calculations can afford the CPI 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. 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 is not realistic, as these calculations are performed multiple times every second. Dynsim eases this burden by providing helpful aids such as data trending and profiling.

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide ii

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.

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide iii

Who Should Read This Manual Welcome to the Dynsim 4.2 Getting Started: An Installation and Tutorial 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 Translation Reference, which describes the intricate details of this release. In this tutorial, we will introduce you to the Dynsim 4.2 environment and guide you step-by-step on how to use it to accomplish your goals. After becoming familiar with using Dynsim 4.2, you can look at the User Manual or the on-line documentation to provide 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, blending the salient feature of these applications. Here, our discussion will focus on the translation from “Steady State” to “Dynamic” models.

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide iv

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 4.2.

• 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.

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide v

Information Links

The user is strongly encouraged to refer the links suggested here in order to get accustomed to the features and the complexities that may surface during the initial exposure to Dynsim 4.2.

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. 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.

Online Help Dynsim 4.2 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 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 dialogs.

Additional Resources

PRO/II Documentation: 1. Online Documentation V 8.0 2. Release Notes V 8.0 3. Tutorial Guide V 8.0 4. Users Guide V 8.0 5. Installation Guide V 8.0

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide vi

6. Work Book V 5.1 7. Add On Modules User Guide V 5.0 8. Keyword Manual V 7.0 9. Keyword Manual Addendum V 5.5 10. Quick Reference Card V 5.1 11. Application Briefs Manual V 5.1 12. Component and Thermodynamic Data Input Manual, Volume I V 5.5 13. Component and Thermodynamic Data Input Manual, Volume II V 5.5 14. Reference Manual Volume I V 5.1 15. Reference Manual Volume II V 5.1 16. PDTS UAS User’s Guide V 5.5 17. Interface Modules User’s Guide V 5.1 18. PRO/ II Casebooks V 5.1 19. LIBMGR and COMPS User’s Guide V 5.1 20. DATAPREP User’s Guide V 5.1

Dynsim Documentation: 1. Dynamic Simulation Suite Users Guide 2. Dynamic Simulation Suite Reference Manuals 3. Dynsim Application Brief Guide

Technical Support SimSci-Esscor’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-Esscor Technical Support Center from the following address list, or get in touch with your local SimSci-Esscor 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.

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide vii

• 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 4.2 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 4.2 Getting Started: An Installation and Tutorial Guide viii

Authorized SimSci-Esscor Technical Support Centers

Support Center Address Tel/Fax/Internet USA and Canada Invensys Systems, Inc. –

SimSci-Esscor 10900 Equity Drive Houston, TX 77041

Tel: + 1 713 329 8583 Fax: + 1 713 329 1905 E-mail: [email protected]

USA East Coast Invensys Systems, Inc. – SimSci-Esscor Gateway Corporate Centre Third Floor, Suite 304 223 Wilmington, West Chester Pike Chaddsford, PA 19317


USA West Coast Invensys Systems, Inc. - SimSci-Esscor 26561 Rancho Parkway South Suite 100 Lake Forest, CA 92630


Mexico Invensys Systems Mexico, S.A Av. Ejercito Nacional, 1005 Col. Irrigacion Mexico City 11500

Tel: + 52 55 52 63 01 77 Fax:+ 52 55 55 57 26 20 E-mail: [email protected]

Argentina Invensys Systems Argentina Inc. Nunez 4334 Buenos Aires C1430 Argentina

Tel: + 54 11 6345 2100 ext.262 Fax: + 54 11 6345 2111 E-mail: [email protected]

Italy Invensys Systems Italia S.p.A Via G. Carducci, 125 Sesto San Giovanni (MI) 20099 Italy

Tel: + 39 02 26297328 Fax: + 39 02 26297 200 E-mail: [email protected]

Brazil Invensys Systems Brasil Ltda. Av. Chibaras, 75 - Moema Sao Paulo, SP O4076 - 000 Brazil

Tel: + 55 11 6844 0291 Fax: + 55 11 6844 0341 E-mail: supporte.simsciesscorbrasil@ips. invensys.com

Germany Invensys Systems GmbH Willy- Brandt- Platz, 6 Mannheim 68161

Tel: + 49 (0) 621 15307 21 E-mail:[email protected]

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide ix

mailto:supporte.simsciesscorbrasil@ips

Support Center Address Tel/Fax/Internet Germany

Australia and New Zealand Invensys Software Systems Level 2-4, 810 Elizabeth Street Waterloo, Sydney NSW 2017 Australia

Tel: + 61 2 8396 3626 Fax:+ 61 2 8396 3604 E-mail: [email protected]

Japan Invensys Systems Engineering Harbor One Building, 2nd Floor 2-5-5, Higashi Shinagawa Shinagawa-ku, Tokyo 140-0002 Japan

Tel: + 81 3 5797 4856 Fax:+ 81 3 5793 4855 E-mail: [email protected]

Middle East Invensys Middle East FZE PO Box 61495 Jebel Ali Free Zone Dubai, UAE


Asia - Pacific Invensys Software Systems (S)Pte Ltd15 Changi Business Park Central 1, Level 4 East Singapore 486057

Tel: + 65 6829 8656 Fax: + 65 6829 8401 E-mail: [email protected]

United Kingdom Invensys Systems (UK) Limited High Bank House, Exchange Street Stockport, Cheshire United Kingdom SK3 OET

Tel: + 44 (0) 161 429 4718 Fax: + 44 161 480 9063 E-mail: [email protected]

China Invensys Process Systems (China) 809, Tower B, Eaglerun Plaza No. 26 Xiaoyun Road Chaoyang District, Beijing, 100016 P.R.China

Tel: + 86 10 8458 5757 628 Fax: + 86 10 8458 4521 E-mail: [email protected]

Korea Invensys Systems Korea 551-3 Hyosung-dong, Gyeyang-gu Incheon, 407-040

Tel: + 82-32-540-665 Fax: + 82-32-542-3778 E-mail: [email protected]

Colombia Invensys Systems LA Colombia Calle 100 # 36-39 Torre 4-203, El Girasol, Bucaramanga, SDER

Tel: + 57 1 3136360 Fax: + 57 1 3136360 E-mail: [email protected]

Dynsim 4.2 Getting Started: An Installation and Tutorial Guide x

Chapter 1

Installation

The objective of this chapter is to help you identify the contents of your release package. Also, it will assist you during the process of installing Dynsim 4.2 software products on your system.

Check Package Contents The following materials have been sent in order to install Dynsim 4.2 software.

Installation Media

The Dynsim 4.2 software application is provided on a single CD-ROM.

Documentation

A comprehensive online Help system is an integral part of the Dynsim 4.2 application. A list of Dynamic Simulation Suite documents is furnished below. Kindly note, that with the exception of this guide, Release Notes and FLEXlm Security Guide, all other documents are provided in electronic form on the installation CD.

If at any stage you have difficulty accessing the documentation, please contact a 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.


1

• Dynsim 4.2 Getting Started: An Installation and Tutorial Guide (this document)

• Dynamic Simulation Suite User’s Guide

• Dynsim Reference Manual- Base Equipment Library

• Dynsim Reference Manual – Control’s Library

• Dynsim Reference Manual – Utilities Library

• Dynsim Reference Manual - Electrical Library

• Dynamic Simulation Suite – Translation of PRO/II Models

• SimSci Component and Thermo physical Properties Reference Manual

• Application Briefs

• FLEXlm Security Guide (SimSci-Esscor documentation on 3rd party security)

A complete set of online documentation in PDF format is provided for each product.

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


2

Hardware/Software Requirements Configuration

Client Hardware

• Intel Pentium III/ 650 MHz or faster • 256 MB RAM and above • 500 MB of free space • Minimum: 17” monitor with 800 x 600 resolution • Recommended: 19” monitor with 1024 x 840

resolution Server Hardware

• Intel Pentium III 2.0 GHz or faster • 512 MB RAM or greater • 1 GB free space

Operating System

• Client: Windows 2000 • Server: Windows 2000


3

Software Security SimSci-Esscor’s software warrants the use of a foolproof security for execution of its software applications. The install options available for security are USB, FLEXlm 7, FLEXlm 9 and Token. The options are discussed in detail below:

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

1. Ensure that there is no USB key plug-in to USB port when you install Dynsim 4.2 for the first time. After Dynsim 4.2 installation, the required USB driver should be installed on your system already.

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 4.2 is installed correctly, Windows 2000 OS will auto detect the new USB hardware and use the SafeNet USB drivers. If you do not see this then your USB key is not going to work.

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 then plug in USB key. Again, you should see the auto detect message for this new hardware

If you are using USB security hardware key, DO NOT INSERT the USB key until after Dynsim installation is complete. The Dynsim 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.


4

FLEXlm Security

SimSci-Esscor provides a FLEXlm security option on the FLEXlm Server Application installation CD. The FLEXlm License Manager is a third-party concurrent-user software licensing tool from Macrovision Corporation. SimSci-Esscor has customized this client/server tool.

FLEXlm Server runs on Windows 2000 or Windows XP. The server must have a minimum of 5 MB of available disk space. To install, learn, and troubleshoot FLEXlm security, follow the instructions provided in the FLEXlm Security Guide included in the standard release package.

If you are using FLEXlm security, you will need the name of the FLEXlm security server name or it’s fixed IP address which will be requested during the install. The standard Dynsim FLEXlm 7 install option sets up FLEXlm version 7.2 dlls. If you want to use a FLEXlm 9 server at your site, choose the FLEXlm 9 option during the installation process. FLEXlm 9 install option will set up the version 9.5 dlls for the application. FLEXlm 9.5 supports borrowing of FLEXlm 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 Simulation Suite install. Token licensing will require the FLEXlm server to be of FLEXlm 9.2 or higher version. The chapter “Troubleshooting ” described elsewhere in this document provides answers to common questions and troubleshooting frequent problems. The FLEXlm support page and the FLEXlm End User’s Manual can be found at http://www.macrovision.com/solutions/esd/support/.

Dynsim 4.2 Installation Dynsim 4.2 has an enhanced Thermo Data Manager (TDM) implementation to allow the user to manage pure component data and binary interaction data. The TDM application is supplied as part of the Dynsim installation CD and is accessed only through the Dynsim user interface.

The Dynsim install kit includes all of the engines supplied earlier under the OTS Engines install kit, starting with 4.1 release. The OTS Engines now


5

http://www.macrovision.com/solutions/esd/support/

supplied in the Dynsim install kit are available only on an “as is” basis and may only be used in compliance with a SimSci-Esscor license and/or software maintenance agreement.

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.

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


6

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:

• SafeNet USB - A USB hardware key.

• FLEXlm 7- A software based key that requires installation of the FLEXlm 7 license server and manager. Once you have chosen the FLEXlm 7 security option, you must specify the computer on which the FLEXlm 7 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 FLEXlmSecurityServer.

• FLEXlm 9 – Similar to FLEXlm 7, this option requires the installation of a FLEXlm 9 license server and manager.

• TOKEN Security - This security option allows the use of multiple SimSci-Esscor 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-Esscor 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/Remove→Modify option for the Dynamic Simulation Suite product.


7

Pre-Install Checklist This section lists the most common obstacles encountered by users when installing Dynsim.

Before You Begin a new Dynsim Install

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

2. Dynsim does not support having multiple versions of Dynsim installed

on the same machine. If you want to install a different Dynsim version, you must fully uninstall the existing version of Dynsim and SIM4ME (Note: SIM4ME has changed to Dynamic Simulation Suite in Dynsim 4.1), reboot, and then fully install the new version. When you un-install Dynsim, verify that SIM4ME (Dynamic Simulation Suite) is also un-installed. Newer versions of Dynsim automatically un-install SIM4ME (Dynamic Simulation Suite) but you may need to manually un-install SIM4ME for older versions.

3. Dynsim does NOT support 64 bit operating systems, Windows XP

Home Edition, XP Starter Edition, Windows 98, and ME. Do not try installing Dynsim on these operating systems.

4. Dynsim install and smoke testing has been performed on the following

operating systems:

1. Windows 2000 SP4 and SP5 English (US)

2. Windows XP PRO SP1 & SP2 English (US)

3. Windows 2000 Japanese

4. Windows XP PRO SP1 Italian (beginning version 3.4)

Operating systems not explicitly tested are currently not supported. You may attempt installation and running of Dynsim in a non-supported OS, and as bugs are reported, they may be worked on. However, no commitments are made with respect to supporting any


8

other operating system other than those listed above. The Dynsim development group performs full functional tests of Dynsim only on English (US) OS versions. The Dynsim development group performs only install and smoke tests on non-English OS installs of Dynsim.

5. Do not rename a machine with Dynsim, or any application with Microsoft SQL Server installed. First,

back up your work, un-install Dynsim and (SIM4ME or Dynamic Simulation Suite) reboot machine, rename machine, re-install Dynsim, restore your work

6. Machine names should only include characters (A to Z) and (0 to 9).

We have had issues with special characters in machine names during installs. Avoid use of hyphen (-) in the machine name. 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. NEVER rename a machine with Dynsim, or any application with Microsoft SQL Server installed.

7. If you are using FLEXlm or Token security, you will need the name of

the FLEXlm security server or fixed IP address, which will be requested during the install.

8. If you are using USB security hardware key, DO NOT INSERT the

USB key until after Dynsim installation is complete. The Dynsim 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.

9. If you have a firewall installed, it may interfere with Dynsim

Activation Service Manager. You will need to put the firewall in "learning mode" the first time you start up Dynsim or allow it to start various Dynsim processes with dynamic port addresses.


9

10. Dynsim 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.

Un-Installing and Re-Installing Dynsim 4.2 This section describes steps to fully uninstall Dynsim 4.2 and install a new version. This section is also applicable for the maintenance version of Dynsim, such as Dynsim 4.2.1, which will be a full install kit and require a full re-install.

Normally Steps 1 - 5 followed by step 7 and then steps 8 - 15 should be sufficient. However, if any problem is observed with un-install or re-install, then the manual Dynamic Simulation Suite un-install procedure, listed in Steps 6 should be followed.

1. Use “Control Panel->Add Remove Programs” to bring up the Add / Remove Program Window.

2. Uninstall “Dynsim previous version” first using the above window.

3. Next Uninstall “Dynamic Simulation Suite” using the same window. Dynsim

4.0 and higher will uninstall “Dynamic Simulation Suite” automatically after uninstalling Dynsim.

4. Optional. You may choose to remove all contents in the DSS42 folder. The

path is something like <Install Drive>\SIMSCI\DSS42. This should have no effect on the un-install outcome.

5. Optional. You may choose to remove or rename existing Applibs folder. If

you have modified the Applibs provided in the previous install kit, we recommend that you rename your user Applib folder to Applib<Old Version>. Then you will have the latest SimSci-Esscor Applib modifications as well as your Applibs that you previously modified. The path is something like \Documents and Settings\<myusername>\My Documents\SIM4ME41\Applib. If you remove this Applib folder, the Applib folder will be refreshed with SIMSCI provided Applibs the next time you log in to Dynsim environment (provided the same path for User Data files is selected while installing the latest version of Dynsim 4.1).


10

6. Optional: If difficulties are repeatedly encountered when doing an automatic install or uninstall, then at this step in the process, do a manual uninstall of Dynamic Simulation Suite or SIM4ME. Contact SimSci-Esscor Technical Support for instructions on how to do a manual uninstall of SIM4ME/Dynamic Simulation Suite.

7. Reboot the machine.

8. To install a new version of Dynsim 4.2, double-click the Setup.exe icon in the

Dynsim install folder. The installer installs the Dynamic Simulation Suite framework first and then Dynsim 4.2.

9. If TDM 1.0 or 1.1 is installed on your machine, the installer displays the

following dialog box.

Click Yes to continue the installation procedure. The Dynamic Simulation Suite, Dynsim 4.2 and TDM 2.0 are installed. You may keep TDM 1.X installations, but you will need to contact SimSci-Esscor Technical Support for instructions if you intend to continue to use TDM 1.x and Dynsim 4.2. It is important to note here that when TDM 1.0 or 1.1 is being used by other SimSci-Esscor products other than Dynsim, it can co-exist with the latest version of TDM 2.0, which is being used by Dynsim 4.2. If a TDM 1.0 or 1.1 session is started, a message “Missing Family Names CMP file” is displayed. This only limits the user’s choice of choosing the component from family names’ sorting list.


11

If an earlier version of TDM 2.0 is detected during installation of Dynsim 4.2, the installer overwrites the older version with the newer version of TDM 2.0. However, the user libraries created using the older version of TDM 2.0 are retained and are accessible using the latest version of Dynsim 4.2.

10. During the installation of Dynsim 4.2, the user has the option of selecting either

a Typical Installation or Custom OTS Engines Installation. The Typical Installation will contain the standard Dynsim products and the Custom OTS Engines Installation will contain all OTS engines and the user can select the engines of his choice.

The user is required to acknowledge a disclaimer before proceeding with the Custom OTS Engines install.


12

11. During the installation of Dynsim 4.2, the user has the option of saving the User Data files in a destination folder of their choice or in the default location.

12. If TDM 2.0 is already installed on the machine, the Dynsim installer will update TDM 2.0 with any newer TDM 2.0 material in the pre-existing TDM install paths. If TDM 2.0 does not exist on the machine, Dynsim 4.2 Setup will also install TDM 2.0 in the destination folder of your choice or in the default location. If the user does not have Microsoft .Net environment installed, it will be installed via Microsoft’s install process. The user needs to accept the installation.

13. Reboot the machine after installation.

14. Check the Application to ensure that it is working properly or not.

15. If issues are found with licensing or services starting correctly, Use


13

“Start->Programs->SIMSCI-> Dynamic Simulation Suite -> DSS Host Configuration Editor” and click the reset button. An example of a command window from a successful reset is shown below.

16. If issues persist, contact SimSci-Esscor Technical Support group.

Switching Security Types for PC Dynsim 4.2 provides the following security options:

• USB Single User Security • FLEXlm Security

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

1. Use “Control Panel->Change/Remove” option and select the Modify option from the Dynamic Simulation Suite installation program.

2. Click the Next button until the following screen is displayed:


14

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

Note on Dallas Security SimSci-Esscor has discontinued support for Dallas Security starting with version 3.2 of Dynsim. If you use Dallas security, please request a USB key.


15

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.

If you have a Dynsim 3.x.y patch; this patch may be applied only on top of any current working Dynsim 3.x version that is earlier than the patch. For example, Dynsim 3.3.x patches will NOT work with Dynsim 3.2 or Dynsim 3.1 versions. Dynsim 3.3.x are intended to be applied on any previous Dynsim 3.3 versions without performing an un-install. It is not necessary to apply patches sequentially. For example, if you have Dynsim 3.3 already installed and a Dynsim 3.3.2 Patch kit in hand; just install the Dynsim 3.3.2 patch kit over Dynsim 3.3. You do NOT need Dynsim 3.3.1 patch kit because Dynsim 3.3.2 patch kit included all patch 1 material. Starting Dynsim 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/Dynamic Simulation Suite and selecting the Dynsim icon.

2. This brings up the Dynsim splash 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”.


16

Chapter 2

Translation: PRO/II to Dynsim

SimSci-Esscor’s concerted efforts to blend the concepts of ‘Steady State” and “Dynamic Simulation” into one integrated software 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 6.0. It has the inherent capability to provide a seamless import capability from PRO/II to Dynsim.

Translating PRO/II files into Dynsim There are currently two options made available to the user to translate files from PRO/II to Dynsim. 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. 3. The user should “Perform Output Calculations” before exporting to

Dynsim. 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.


17

6. Subsequent to a successful translation, Dynsim is started and populated with the processed flowsheet.

Seamless Exporting from PRO/II into Dynsim

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 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.


18

Seamless Importing PRO/II Input in Dynsim

Users are directed to refer to the Translation Reference Manual wherein detailed explanation of the “Translation concepts” are furnished.


19

Chapter 3

Getting Started Tutorial

In this chapter, we will walk you through the basic steps required to simulate process flowsheets within Dynsim.

What You'll 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 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/Dynamic Simulation Suite and selecting the Dynsim icon.


20

2. This brings up the Dynsim splash 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 “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.


21

The simulation name must not contain spaces or symbols

3. The simulation will be created in a default user directory (C:\Documents and Settings\<User Name> \My Documents\SIM4ME40\ Reverse Flow.s4m).

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 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


22

(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 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.

The steps to fix up the parameters are enumerated below.


23

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 has the option to either chose from the predefined UOM list.

3. Alternatively, you have also got the flexibility to define a custom UOM 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.


24

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-Esscor’s related products like PRO/II and ROMeo. In PRO/II, 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 ROMeo, the user has the ability to create multiple component slates to be used by individual process units as applicable. In contrast, Dynsim 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.

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).


25

Components & Thermodynamics Slate Dialog Box

Similar to PRO/II, 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


26

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 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.


27

Creating up a “Component Slate”

2. Create a new component slate by typing PROCESS in the above 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.


28

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.

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 comprise of light hydrocarbons and hence an equation of state method


29

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 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. 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.

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.


30

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.


31

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 dependant on the pressure network.


32

Process Slate Composition

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’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 is not limited to


33

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. Next 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


34

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 as indicated in the table below.

These include:

Stream Type Description

Process Stream Used for connecting unit operations from the base equipment library. Represents compositional streams.

Heat Stream

Used for linking utility exchangers to equipment models that can have a heat duty associated with them. E.g. Distillation Column, Separator, etc.

Mechanical Stream

Used to associate a motor or expander to a pump or compressor. It can also link to a motor, expander, pump, and compressor to a shaft so that all equipment operates at the same speed.

Electrical Stream Used for interconnecting objects from the electrical library.

Connectors Used to connect model parameters to each other, e.g. a process variable to a controller or a controller output to a valve open command.

Classification of Streams

In Dynsim, as in PRO/II, valid port locations are highlighted in red (required) and green (optional).


35

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 to start the simulation and leave it in a frozen state.

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

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.


36

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 dialogue window. Dynsim 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.


37

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


38

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 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 high, that it results in reverse flow.


39

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.


40

Customization of a Flowsheet


41

Chapter 4

Set-up Dynsim in Distributed Mode

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

Before you start a. Establish the exact (case sensitive) account and password on every machine on

which Dynsim 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 in distributed mode.

b. If the system administrator has established Active Directory Control and a group policy that enforces this, then a workgroup needs to be established,


42

including all users that are allowed Administrative privileges on each of the machines. The system administrator should apply the new policy.

c. 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.

Steps to Configure Distributed Mode Steps 1-5 establish that Dynsim is installed properly on each machine. 1. On each machine use Start Programs SIMSCI SIM4ME 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 XP SP2, verify the Windows Firewall service is stopped and

disabled. See Start Control Panel Administrative Tools Services. 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.


43

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

4. 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. 5. Verify that Dynsim starts up on each machine and a new empty flowsheet can be

created. The following steps focus on setting up the distributed environment. 6. 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 d42xp1, d42xp2, d42xp3 and d42xp4. In order to set up hosts file on another machine, perhaps named d42xp5, 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.

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 d42xp1 d42xp1. <DNS suffix>

10.2.21.148 d42xp2 d42xp2. <DNS suffix> 10.2.21.146 d42xp3 d42xp3. <DNS suffix> 10.2.21.144 d42xp4 d42xp4. <DNS suffix>

7. 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


44

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.

8. 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 d42xp1 ping d42xp1. <DNS suffix> Next find this file <drive>\SIMSCI\DSS42\Servers\Bin>pingns.exe Execute this command: pingns.exe <remote_machine_name> 10151 If it does not pass the ping and pingns test, check network cables, network configurations, and finally consult your IT administrator for help.

9. 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.

10. Optional for debugging: Open and modify <Install

drive>:\\SIMSCI\DSS42\GUI\Bin\runSIM4MEDynsim.bat. 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.

11. All machines must look to a single Name Service Host where the simexec should reside. This is always the same as the Data Base Server Host. The next step is to


45

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).

a. Default Settings (2nd machine)

b. Modified Settings (2nd machine)


46

12. Option for debugging: on each machine, go to Start All Programs SIMSCI

Dynamic Simulation Suite 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.


47

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.


48

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. Contact SIMSCI support to obtain a troubleshooting guide if this is encountered.

13. 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 E3 Applib (on machine CIN05409A)


49

14. The final step is to modify the Login window parameters for 2nd machine and point to the 1st machine (CIN05409A in this case).


50

15. 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.

16. SimExecutive will appear in Naming Service Viewer now, but user must right-click

on Root and refresh to see it. There is only ONE simexec on ONE machine in simulation. This is Dynsim design.

17. 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


51

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 10151 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.

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.


52

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).

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".


53

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.


54

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-Esscor 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, 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.

• Run CHKDSK to verify the drive • Remove the current installation • 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.

• If you are attempting to install on a network, ensure that you have adequate read/write access privileges.

• Ensure that you have adequate disk space in the desired directory.


55

Scenario # 3

The program is installed on a system running on Windows platform. When you run the program, it produces errors relating to security.

• 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 FLEXlm.

• The FLEXlm End User’s Manual and other information can be located at http://www.macrovision.com/solutions/esd/support/.

Scenario # 5

Dynsim services will not start and Dynsim will not launch.

1. Start->Programs->SIMSCI-> SIM4ME 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 XP SP2, verify the Windows Firewall service is

disabled. See Start-> Control Panel-> Administrative Tools -> Services. 3. Check the status of these services. Each should be in “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.


56

http://www.macrovision.com/solutions/esd/support/

Prior to Dynsim 4.1, the DSS Act.. and DSS Utility… was named SIM4ME Act… and SIM4ME Utility…

4. If you have a 3rd party firewall, such as McAfee or similar, ensure that incoming learning mode is enabled.

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 services are not starting up despite using the Host Configuration Editor reset feature several times, then: This procedure shows you how to get Dynsim 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.


57


58

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 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)

a. Protection Level must be Custom. b. Incoming Learn Modes is Enabled (checked). c. Outgoing Learn Modes is Enabled (checked).


59

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 Dynsim TAO, 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 Excel interface example.

7. Run this model.

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


60

8. Export the policy for recovery later if needed.


61

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 still runs.

11. Discuss results with System Administrator.


62