Sunteți pe pagina 1din 122
SimSci-Esscor ® PRO/II™ 9.1 Getting Started Guide August 1, 2011
SimSci-Esscor ® PRO/II™ 9.1 Getting Started Guide August 1, 2011

SimSci-Esscor ®

PRO/II™ 9.1 Getting Started Guide

August 1, 2011

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 Invensys Systems, Inc. No copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and the author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein.

The information in this documentation is subject to change without notice and does not represent a commitment on the part of Invensys Systems, Inc. The software described in this documentation is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of these agreements.

© 2011 by Invensys Systems, Inc. All rights reserved.

Invensys Systems, Inc.

26561 Rancho Parkway South

Lake Forest, CA 92630 U.S.A.

(949) 727-3200

http://www.simsci-esscor.com/

For comments or suggestions about the product documentation, send an e-mail message to ProductDocumentationComments@invensys.com.

All terms mentioned in this documentation that are known to be trademarks or service marks have been appropriately capitalized. Invensys Systems, Inc. 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.

Invensys, Pro/II, SimSci-Esscor are trademark of Invensys plc, its subsidiaries and affiliates. All other brands may be trademarks of their respective owners.

Contents

Introduction

About this Manual

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

vii

About PRO/II Software

.viii

About

.viii

Where to Find PRO/II Software

.ix

Online Documentation

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.ix

Online Help

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

x

Where to Find Additional

x

Technical Support

.

.

.

.

.

.

. Authorized SimSci-Esscor Technical Support

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.xi

xii

Chapter 1 Installation Requirements

Verifying the Package

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.1-1

Installation Media

.

.

.

.

.

.

.1-1

. Software Requirements

Documentation

.

.

. PRO/II 9.1 Requirements

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.1-1

.1-2

.1-2

SIM4ME® PORTAL

.1-3

Disk Space Requirements

.1-3

Virtual Memory Requirement

.1-3

Security Options

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.1-4

USB

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.1-4

Switching to USB Security

.1-4

. Switching To Any FLEXlm-Based

FLEXlm Security

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

 

.1-4

.1-5

Delayed Reboot of PRO/II When Using FLEXlm Security

.

.1-5

Chapter 2 Installing PRO/II Software

Installing a Local Version of PRO/II Software

.2-2

Directory Structures and Desktop Icons

. PRO/II Installed Directory Structure (Standalone)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.2-5

.2-5

Testing

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.2-6

Reviewing the Results

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.2-6

Generate an Output Report

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.2-6

. Modifying/Repairing/Removing PRO/II Software

Converting Files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.2-6

.2-7

Chapter 3 Installation Troubleshooting

Diagnose TOKEN, TOKENNET and FLEXlm 9.5/FLEXNET 11

Security Problems

. General License Security Questions

.

. Diagnose USB Security Problems

. OLI Chemistry Wizard License Security

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.3-1

.3-12

.3-17

.3-19

Changing the Chemistry Wizard Serial Number

 

.3-19

Chapter 4 Tutorial : Introduction

What can PRO/II Software do?

.

.

.

.

.

.

.

.4-21

Simulation Status Conventions

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.4-21

How is this Tutorial Organized?

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.4-22

. Where to Find Additional Help?

Where to Start?

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.4-22

.4-22

Description of the Problem

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.4-23

How to Proceed?

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.4-24

Chapter 5 Session 1: Separator

Starting PRO/II

.5-2

Building the Flowsheet

.5-2

Process Units.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.5-3

Process Streams Correcting the PFD

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.5-4

.5-5

Defining the Component List (required)

 

.5-5

Defining a Thermodynamic Method Set (required)

.5-8

Specifying Unit Operation and Stream Data (required)

 

5-11

Analyzing the Data

.5-12

. Unit Operations

Stream Data .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.5-12

.5-17

Saving the Simulation

.5-17

Running the Simulation (required)

.5-21

Reviewing the Simulation

 

.5-21

Viewing the Output Report

.5-22

Using the Flash Tool (optional)

.5-23

Chapter 6 Session 2: Complete Expander Plant

 

Building the Flowsheet (required)

 

.6-1

Modifying the Stream Data

.6-8

Specifying the Process Unit Data (required)

.6-8

Heat Exchangers

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.6-8

Compressor

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.6-12

Column

.

.

.

. Running the Simulation (required)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.6-15

.6-25

Reviewing the Simulation

 

.6-25

Modifying the Simulation Defaults

.6-26

Chapter 7 Session 3: Presentation of Output

 

Modifying the Flowsheet Stream Border Style

Creating

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

 

.7-1

Displaying Stream Properties on the PFD

.7-3

Exporting the PFD to the Windows Clipboard

.7-5

Producing a Stream Report in a

.7-6

Creating Pages for Printing the PFD

.

.

.

.

.

.

.

.

.7-7

.7-10

. Displaying Stream Results in HTML

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.7-11

Block Diagrams

 

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.7-13

Index

Introduction

About this Manual

This manual will guide you through the installation of the PRO/II™ family of software products and provides you with three sample sessions on using PRO/II Software.

An outline of this document is provided below.

Chapter 1 Installation Requirements

Chapter 2 Installing PRO/II Software

Chapter 3 Installation Troubleshooting

Chapter 4 Tutorial :

Introduction

Outlines installation and security requirements.

Describes how to install PRO/II 9.1 Software.

Addresses some of the problems you may encounter while installing PRO/II 9.1 Software.

Introduces the user to PRO/II Software capabilities, conventions and finding information.

Chapter 5 Session 1: Separator Step-by-step instructions to enable you to simulate a minimal set of process units in a gas processing application.

Chapter 6

Session 2: Complete Expander Plant

Additonal process units are added to complete an entire demethanizer/ expander plant simulation.

Chapter 7 Session 3:

Introduces tools provided by PRO/II

Presentation of

Software to organize, format and review

Output

results.

About PRO/II Software

PRO/II Software is a comprehensive computer simulation system for process engineers in the chemical, petroleum, natural gas, solids processing, and polymer industries. It combines the data resources of a large chemical component library and extensive thermodynamic property prediction methods with the most advanced and flexible unit operations techniques. It provides the process engineer with the computational facilities to perform all mass and energy balance calculations needed to model most steady- state processes.

The PRO/II Software process simulation program is designed with both the beginner and the expert in mind. It is based on a foundation of comprehensive, reliable, and accurate simulation capabilities. It is easy to use, and the input language is an extension of the universal language of chemical engineering. Expert systems, extensive input processing, and error checking allow even an inexperienced user to be instantly productive. These features have made PRO/II Software an industry standard.

About SimSci-Esscor

For 40 years, SimSci-Esscor has been a leader in the development and deployment of process simulation software, services, and complete solutions for oil and gas production, hydrocarbon and specialty chemical processing and refining, and fossil and nuclear power. Benefit from products that minimize capital requirements, optimize facility performance, maximize ROI, and produce assets for:

Plant engineering design and simulation:

Integrated process engineering (FEED)

Pipeline production analysis, asset model management

Operational analysis, optimization, process control

Dynamic simulation, operator training

Design-Operate-Optimize a safe and profitable plant subject to ever more stringent market and regulatory constraints. SimSci-Esscor software solutions are indispensable tools in solving these three increasingly complex challenges simultaneously. SimSci-Esscor is business unit of Invensys Process Systems, owned by Invensys, plc.

Where to Find PRO/II Software Documentation

Online Documentation

Online documentation is provided in the form of .PDF files that are conveniently viewed using Adobe Acrobat Reader® 7.0.5 or Acrobat Exchange 7.0.5. Adobe Acrobat Reader Software is freeware that can be installed from the Adobe Systems website (www.adobe.com). Adobe Acrobat Reader Software requires seven MB of disk space in addition to the space required to install PRO/II

Software.

The Welcome Screen lists all the online manuals (See below). These online manuals are stored in the SIMSCI\PROII\Manuals directory.

PRO/II 9.1 Welcome Screen

are stored in the SIMSCI\PROII \ Manuals directory. PRO/II 9.1 Welcome Screen PRO/II 9.1 Getting Started

Online Help

PRO/II Software incorporates an online Help system, a comprehensive reference tool that quickly accesses information. Online answers are instantly available while you work. In the Help system, commands, features, and data fields are explained in easy steps. You can access the electronic Contents for the Help system by selecting Help/Contents from the PRO/II menu bar. Context- sensitive help is accessed using the <F1> key or the What’s This? button by placing the cursor in the area in question.

Where to Find Additional Help

If you want to

See

Learn how to install PRO/II Software

Quickly learn how to simulate a simple flowsheet using PRO/II Software

Obtain detailed information on the capabilities and use of PRO/II Software

Obtain basic information on PRO/II keywords

Obtain basic information on PRO/II Software calculation methods

Obtain more detailed information on

PRO/II Software calculation methods

Obtain detailed information of component and thermodynamic properties

See simulation examples

See simulation examples for chemical, solid processing, petrochemical, batch, and electrolyte applications

Demonstrates the use of PRO/II Software with process industry examples

Learn how to create a custom component databank using the LIBMGR utility

Learn about PRO/II batch reactor and distillation, electrolytes, Profimatics or polymers modules

PRO/II Getting Started Guide

PRO/II Getting Started Guide

PRO/II User’s Guide

PRO/II Keyword Manual

Online Help

PRO/II Online Reference Manual

SIMSCI Component and Thermodynamic Data Input Manual

PRO/II Keyword Manual

PRO/II Application Briefs Manual

PRO/II Casebooks

LIBMGR and COMPS User’s Guide

PRO/II Add-on Modules User’s Guide

Where to Find Additional Help (cont.)

If you want to

See

Learn about PRO/II-HTRI ® , PRO/II- HTFS ® or Linnhoff March ColumnTarget Interface modules

Learn about PRO/II User-added Subroutines or the PRO/II Data Transfer System

Learn to write applications (input and calculated) to access data in PRO/II simulation databases

Information on API’s to the PRO/II COM Server with examples

Learn about Ternary Mixture Plots

PRO/II Interface Modules User’s Guide

PRO/II Data Transfer System and User-added Subroutines User’s Guide

COM Server Programmer’s Guide and Tutorial

COM Server Reference Guide

Ternary Mixture Plots Help Manual

Technical Support

SimSci-Esscor and its agents around the world provide technical support and service for PES products. If you have any questions regarding the use of the program or the interpretation of output produced by the program, contact your local SimSci-Esscor representative for advice or consultation.

When calling one of the Technical Support Centers, be prepared to describe your problem or the type of assistance required. Also, to expedite your call, complete the following steps before calling Technical Support:

Have the installation DVD and all the provided documentation available.

Determine the type of computer you are using.

Determine the amount of free disk space available on the disk on which the product is installed.

Both new and experienced users will benefit significantly from attending one of SimSci-Esscor’s regularly scheduled training courses on PES products. If you would like to obtain a list of courses available, or if you have any questions relating to the use of a PES product, its methods, data, or technology, please call your

nearest SimSci-Esscor Technical Support office or visit our website at www.simsci-esscor.com.

Authorized SimSci-Esscor Technical Support Centers

Support

   

Center

 

Address

 

Tel/Fax/Internet

USA

Invensys Process Systems (SimSci- Esscor)

Tel: + 1 800 SIMSCI 1

+

1 713 329 8584

10900

Equity Drive

Fax: + 1 713 329 1700 E-mail: support.simsci@invensys.com

Houston, TX 77041

USA East

Invensys Process Systems (SimSci- Esscor) Gateway Corporate Center, Suite 304, 223 Wilmington-West Chester Pike, Chaddsford, PA 19317

Tel: + 1 800 SIMSCI 1

Coast

+

1 484 840 9407

Fax: + 1 484 480 9499 E-mail: support.simsci@invensys.com

USA West

Invensys SimSci-Esscor,

Tel: ++ 1 800 SIMSCI 1 Fax: + 1949 455 8154 E-mail: support.simsci@invensys.com

Coast

26561

Rancho Parkway South, Suite

100,

Lake Forest, CA 92630

 

Mexico

Invensys Systems Mexico S.A Amargura # 60 Col. Parques de la Herradura, Huixquilucan, Edo.de, 52786

Tel: + 52 55 52 63 01 76 Fax:+ 52 55 52 63 01 60 Email: mexico.simsci@invensys.com

Canada

Invensys SIMSCI-ESSCOR, 7665 - 10th Street NE, Calgary T2E8X2

Tel: + 403-617-6220 (Cell) Fax: + 403-274-8651 E-mail: support.simsci@invensys.com

Argentina

Invensys Systems Argentina Inc. Nunez 4334 Buenos Aires (Argentina) C1430AND

Tel: + 54 11 6345 2100 Fax: + 54 11 6345 2111 E-mail:simsci.latino@invensys.com

Italy

Invensys Systems Italia S.p.A Via Carducci, 126 Sesto San Giovanni (MI) 20100, Italia

Tel: + 39 02 262 9293 Fax: + 39 02 262 9200 E-mail:simsci.eura@invensys.com

Venezuela

Invensys Systems Venezuela Torre Delta Piso 12, Av.Francisco de Miranda Altamira, Caracas 1060

Tel: + 58 212 267 5868 ext. 282 Fax: + 58 212 2670964 E-mail:simscilat@invensys.com

Brazil

Invensys Systems Brasil Ltda. Av. Chibaras, 75 - Moema Sao Paulo, SP O 4076 - 000

Tel:+ 55 11 2844 0201/291 Fax: + 55 11 2844 0341 E-mail:

suporte.simsciesscorbrasil@invensys.c

om

Support

   

Center

Address

Tel/Fax/Internet

Germany

Invensys Systems GmbH & Wonderware GmbH Hermann Klammt Str. 1-3 D- 41460 Neuss

Tel: + 49 (0) 89 /444 19650 E-mail:simsci.eura@invensys.com

Australia and

Invensys Performance Solutions Level 2-4, 810 Elizabeth Street Sydney 2017, Australia

Tel: + 61 2 8396 3626 Fax:+ 61 2 8396 3604 E-mail: simsci.apac@invensys.com

New Zealand

Japan

Invensys Process Systems Japan, Inc. 8th Fl. Suzuebaydium, 1-15-1 Kaigan, Minato-ku, Tokyo 105-0022 Japan

Tel: + 81 3 6450 1095 Fax:+ 81 3 5408 9220 E-mail: ipsjp.support@invensys.com

Middle East

Invensys ME Dubai PO Box 61495 Jebel Ali Free Zone, Dubai

Tel: + 971 4 88 11440 Fax: + 971 4 88 11426 E-mail: simsci.eura@invensys.com

Asia - Pacific

Invensys Software Systems (s) Pte. Ltd. 15, Changi Business Park Central 1 Singapore 486057

Tel: + 65 6829 8643 Fax: + 65 6829 8202 E-mail: simsci.apac@invensys.com

United

Invensys Systems (UK) Limited The Genesis Centre, Birchwood Science Park, Birchwood, Warrington United Kingdom WA3 7BH

Tel: + 44 (0) 1925 811469 Fax: + 44 (0) 1925 838509 E-mail: simsci.eura@invensys.com

Kingdom

China

Invensys Process Systems (China), No. 211, Huancheng Road East, Fengpu Industrial Park, Shanghai 201400

Tel: + 86 21 3718 0000 ext. 5912 Fax: + 86 10 8458 4521 E-mail: simsci.apac@invensys.com

Colombia

Invensys Systems LA Colombia Calle 100 # 36-39 Int. 4-203, Bucaramanga, SDER

Tel: + 57 1 3136360 E-mail: support.co@simsci.com

Korea

Invensys Korea Simsci-Esscor 6F, Dongsung B/D, 17-8, Yeouido- dong, Seoul, 150-874

Tel: + 82-22-090-0822 Fax: + 82-32-542-3778 E-mail: support.kr@invensys.com

Chapter 1 Installation Requirements

This chapter surveys the contents of the PRO/II Software release package.

Verifying the Package Contents

Installation Media

PRO/II Software is distributed on a DVD.

Documentation

A partial list of available PRO/II online documents is:

PRO/II Keyword Manual

SIMSCI Component and Thermodynamic Data Input Manuals

PRO/II User Guide

PRO/II Getting Started Guide (this document)

PRO/II Interface Modules User Guide

PRO/II Data Transfer System User Guide

PRO/II User-Added Subroutines User Guide

Additional documentation is provided for each additional features

as required.

Software Requirements

PRO/II 9.1 Requirements

The minimum software requirements are listed below. PRO/II 9.1 Software functions properly only on the operating systems in the lists.:

Operating

Windows XP SP3, Windows VISTA SP2 (Business /

SP2

System

Enterprise), Windows 7 (Business / Enterprise), Win-

dows 7 Enterprise(64 Bit), or Windows 2008 Server

Proper installation of PRO/II Software under all oper- ating systems requires administrator rights.

Microsoft

Office 2010, Office 2007, Office 2003, Office XP.

Office

Compilers

User-Added Subroutines and PDTS applications require the following programs:

Microsoft Visual Studio Net 2003 (or .NET 2005 or .NET 2007) Intel Visual FORTRAN version 10.x for Win- dows (Standard or Professional Edition). Newer versions (such as version 11.x) are compatible.

UAS and PDTS sample projects shipped with PRO/II 9.1 Soft- ware are built using .NET Framework 2003. Newer versions (.NET 2005 and .NET 2007) may be used, but require the end user to upgrade UAS and PDTS projects themselves. Conver- sion utilities and instructions automatically are invoked when a project needing conversion is opened in Microsoft Visual Studio.NET with Intel Visual Fortran installed.

Note:

User-added subroutines and PDTS applications built under Windows 2000 will run under Windows XP, Windows 2003, and Windows VISTA.

Acrobat

Most PRO/II 9.1 documentation is delivered using

Reader

Portable Document Format (i.e., as .pdf files). A recent version of Acrobat Reader is included on the PRO/II installation DVD. The latest free version also may be downloaded from an Adobe web site. As of this writing one such Adobe web site is:

http://get.adobe.com/reader/

SIM4ME® PORTAL Requirement

The minimum software requirements for SIM4ME PORTAL are:

Operating

Windows VISTA SP2 (Business / Enterprise),

System

Windows 2003 SP2, or Windows XP SP3.

Microsoft

Proper installation of SIM4ME PORTAL under all OS’s requires administrator rights.

Office

Office 2007 (preferred), or Office 2003 Profes- sional with SP2, SP3. Earlier versions of MS Office are incompatible due to format upgrades implemented by Microsoft.

Disk Space Requirements

The computer should have at least one gigabyte (1GB) of available free disk space. This amount is adequate for a complete PRO/II 9.1 installation, storage for many simulations, and ample free space for paging without excessive fragmentation. Periodically running a disk defragmentation program is a recommended part of good maintenance practices.

Virtual Memory Requirement

PRO/II Software requires at least 55 MB of virtual memory to provide sufficient paging area. Newer operating systems (such as Vista) typically allocate a larger paging file size, so the changes discussed here probably will not be required.

To set (or merely verify) virtual memory in Windows XP:

From the Windows Start menu, select Settings/Control Panel.

Click Performance and Maintenance Options.

Open the System item and access the Advanced tab.

Click the Settings button under Performance.

Select the Advance tab.

Click on the Change

If desired, change the size in the “paging file size for selected drive” section; then click the Set button.

To set virtual memory in Windows 2003 Server and Windows VISTA:

From the Vista Start menu, select Settings/Control Panel.

Open the System item and access the Advanced tab.

Click the Settings button under Performance.

Select the Advance tab.

Click the Change

If desired, change the size in the “paging file size for selected drive” section, and click the Set button.

button in the Virtual Memory section.

button in the Virtual Memory section.

Security Options

USB Security

SimSci-Esscor provides USB hardware security, in which you insert key specially coded to allow use of PRO/II Software. During installation, the USB key should not be plugged in. After installation, simply plug the security hardware device directly into one of the computer’s USB ports to start running PRO/II Software.

Switching to USB Security

To switch to USB security:

Open the proii.ini file found in the user directory.

Find the section entitled [wss_Security] and set Type=USB.

Save the file and exit.

This completes the procedure to use USB security.

FLEXlm Security

SimSci-Esscor provides three different FLEXlm security options on the FLEXlm Server Application installation DVD.

FLEXNET 11 Security Single license option

FLEXlm 9.5 Security Single license option

TOKEN Security

Multi-user license sharing option

TOKENNET Security Multi-user license sharing option

The FLEXlm License Manager is a third-party concurrent-user software licensing tool from Macrovision Corporation. It is a client/ server-based tool that has been customized by Invensys Operations Management personnel.

FLEXlm Server can run under Windows XP. The server must have at least 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.

Switching To Any FLEXlm-Based Security

Open the file named PROII.INI located in the user directory of the PRO/II 9.1 installation directory tree.

Find the section titled [wss_Security] and perform only ONE of the following:

To switch to FLEXNET 11 security:

set Type=FLXNET11 or

To switch to FLEXlm 9.5 security:

set Type=FLXLM95 or

To switch to TOKEN security:

set Type=TOKEN

To switch to TOKENNET security:

set Type=TOKENNET or

Save the file and exit.

If running Windows XP, 2003, or VISTA, add the IPASSI_LICENSE_FILE=@{FLEXlm server machine name} system environment variable to your control panel/system/ advanced/environment variables.

Reboot the computer, so the changes to the security environ- ment will be correctly configured.

Delayed Reboot of PRO/II When Using FLEXlm Security

On rare occasions, PRO/II 9.1 may encounter situations in which it cannot continue to function. In such situations, it issues a message and shuts itself down. All unsaved data is lost. This commonly is known as “a crash”. The only recourse available to the user is to

restart PRO/II 9.1 Software and manually attempt to recover as much work as possible.

FLEXlm security is managed by a proprietary client program that interacts with PRO/II 9.1 but executes independently. Security in PRO/II 9.1 is monitored periodically on-demand, not continually. A crash requires a delay of at least three minutes to re-establish communicaction with the FLEXlm security client.

Note: A crash of the PRO/II 9.1 program results in a delay of at least three minutes to re-establish communication with the FLEXlm security client. There is no need to attempt to reconfigure PRO/II 9.1 or the FLEXlm client. However, security will fail if an attempt is made to restart PRO/II Software too soon.

Chapter 2 Installing PRO/II Software

This chapter guides you through the installation of the PRO/II 9.1 Software family of software products:

The main PRO/II application

PRO/II Data Transfer System (PDTS)

PRO/II User-Added Subroutines (UAS)

Chemistry Wizard™ (from OLI)

Thermo Data Manager (TDM). The TDM is a silent install.

SIM4ME Portal/ Reports also is a silent install.

CFI (Common Framework Install) module also is a silent install.

PFE Editor

Notepad ++

NIST REFPROP

To begin the install procedure:

Insert the PRO/II DVD into the DVD drive.

Browse to the root of the DVD and read release notes.

Open PROII91 folder and double-click on the setup.exe to begin the installation. The first screen you will see in the instal- lation process is the prerequisites for the PRO/II installation.

To continue, click Install.

Preparing to Install appears where Windows Installer Configures.

The Welcome to InstallShield Wizard dialog box appears

Click Next > to continue. The License Agreement dialog box appears.

Choose I agree and click Next > to continue. The Destination Folder dialog box appears

This box shows the default destination directory (C:\SIMSCI) of the PRO/II files and for shared SIMSCI components, like CFI, SIM4MEPortal (C:\Program Files/Common Files/ SIMSCI).

To install to these folder, click Next >.

To install to a different folder, click Change > and select another

Note: If you are maintaining an older version of PRO/II Software in the SIMSCI directory, place PRO/II version 9.1 in another directory (e.g., \P2v91) to avoid any conflicts.

Click Next > to continue. The Setup Type dialog box appears. Choose Typical or Custom.

Installing a Local Version of PRO/II Software

To continue the Local PRO/II installation procedure:

Note: Users installing a Local version of PRO/II Software on Windows 2003/XP and Windows VISTA must have system administration privileges for the install to proceed properly.

Select one of the two available local installation options:

Typical

Installs only the PRO/II program, TDM, SIM4ME Portal and Reports, PFE Editor and Notepad++.

Custom

Installs components based on your selection.You can install the Standalone option from this option as well as the individual components including the Translator, PRO/II program, Chemistry Wizard module, UAS, PDTS, PFE Editor, Notepad++, NIST REFPROP and Multi Simulation Manager.

If you are performing a Custom installation:

The Custom Setup dialog box appears to allow you to select the components you want to install. The list box shows all possible components. Click on the components you want to install and note the change in required disk space. Click

Next >.

If you are installing a Standalone option (directly or through the Custom installation), the Security Option dialog box appears. Select one of the four security options:

FLEXlm 9.5

FLEXNET

11

USB

Token

Tokennet

Allows PRO/II Software to go beyond the cur- rent machine to obtain licenses from another machine (FLEXlm 9.5 security server machine) on the network.

Allows PRO/II Software to go beyond the cur-

rent machine to obtain licenses from another machine (FLEXNET 11 security server machine) on the network.

Utilizes a USB hardware key attached to the USB port on the back of the current machine for licensing purposes. Using this type, PRO/II Soft- ware will only search this hardware key for license(s).

Allows PRO/II Software to go beyond the cur- rent machine to obtain licenses from a Token server on the network.

Allows PRO/II Software to go beyond the cur- rent machine to obtain licenses from a Tokennet server on the network.

If you chose FLEXNET 11, FLEXlm 9.5, Token or Token- net, specify the prospective IPASSI FLEXlm server(s) (e.g., @server1; @server2) to guide PRO/II to find the FLEXlm server. Click Next > to continue.

A dialog box appears to select the options of creating a Short- cut on the Desktop and/or the Quick Launch bar. Click Next > to continue.

If you are installing the Standalone option, the Shortcut Options Folder dialog box appears. By default, the setup pro- gram adds PRO/II icons in the SIMSCI program folder. Also select the options of creating a Shortcut on the Desktop and/or the Quick Launch bar. Click Next > to continue.

The Ready to Install Program dialog box appears. If you want to review or change any settings, click < Back. If you are satis- fied with the settings, click Install> to begin copying files.

When your installation is complete, the InstallShield Wizard Complete Installation dialog box appears.

Click Finish to complete the Local installation.

Note: Setup determines if it is necessary to restart the computer. If so, it asks whether you want to restart the system now or later.

You should now test your PRO/II installation. Proceed to the Testing PRO/II section for more information.

Directory Structures and Desktop Icons

PRO/II Installed Directory Structure (Standalone)

The Standalone Installation will setup all PRO/II files under the directories shown below.

C:\SIMSCI\PROII91

C:\SIMSCI\PROII91\USER

C:\SIMSCI\PROII91\BIN

C:\SIMSCI\PROII91\SYSTEM

C:\SIMSCI\PROII91\RESOURCE

C:\SIMSCI\PROII91\Manual

C:\SIMSCI\PROII91\HLP

C:\SIMSCI\OLI_for_PRO_9.x

C:\Program Files\PFE32 C:\Program Files\Notepad++

C:\SIMSCI\PROII91\TDM

C:\Program Files\Common

Files\SIM-

SCI\SIM4MEPortal211

C:\SIMSCI\

MultiSimulationManager10

C:\Program Files\Common Files\SIMSCI\ SIMSCICFI40

[Main PRO/II directory] [PRO/II user’s directory] [Binary files] [System files] [Resource files] [PRO/II Documentation] [Online help files] [Chemistry Wizard] [PFE32 file editor files] Notepad ++ [TDM files]

[SIM4ME Portal files]

[Multi Simulation Manager files]

[SIMSCI Common Framework Files]

A typical installation creates the following icons:

PRO/II 9.1

PRO/II Documentation

PRO/II Re-Initialization Utility (PRU)

LM ColumnTarget Interface

PROII 9.1 PDTS Applications Command Prompt

Ternary Plots

SIM4ME Portal 2.1.1

Other icons may appear depending upon the install options chosen. For example, installing the OLI Chemistry Wizard adds an icon.

Testing PRO/II

As a simple test of your PRO/II system, open PRO/II Software, import the input file G3 and run it. This will let you utilize PRO/II’s flowsheet capability and give you a sense of how PRO/II will run.

To test the PRO/II system:

Click Start and select Programs/SIMSCI/PROII91/PROII 9.1. A Welcome to PRO/II screen appears which provides you with basic information on the user interface.

Note: SIMSCI is the default directory and is used for illustrative purposes in the remainder of the chapter. If you chose another directory (e.g., P2v91), use that directory name in place of SIMSCI.

Click OK to continue.

Select File/Import from the menu bar.

Select G3.INP in the Import Keyword File window and click Open. A window will appear showing the import of problem G3 PRO/II Main Window.

Click the Run button on the toolbar to begin calculations.

Click Run Simulation on the Flowsheet Status dialog box to continue.

Reviewing the Results

When the simulation is complete, a RUN COMPLETED message appears in the G3 Solved window.

Generate an Output Report

To generate an output report for the sample problem:

Click the Output button on the toolbar to generate an output file. The stream and process unit results are shown in a win- dow.

Compare the results to those in the file G3.CHK, located in the

\SIMSCI\PROII91\USER directory.

Converting Files

This version of PRO/II Software automatically detects the file version and runs the PRO/II converter for upgrades. To convert simulation files:

Launch PRO/II Software with PROVISION ®

On the File menu, use the Open item to display the Open dia- log. Enter the name of a file to convert. Click Open.

The designated file will be converted to the new version PRO/II 9.1 Software.

Note: Several processing methods, such as the order of searching component data banks, or methods for characterizing assays, change over time with the release of newer versions of PRO/ II. Running in key word mode usually does not inform the user of such changes. The PROVISION Graphical User Interface traps these changes and displays dialogs. This allows users to choose options that either (a) retain the older options or (b) updates the simulation to use current defaults. These choices of necessity require user interaction with the dialogs.

Modifying/Repairing/Removing PRO/II Software

You can modify/repair/remove PRO/II Software by accessing Add/ Remove Programs located in the Control Panel (on the Start menu of the Windows operating system), or by executing the setup.exe program located in the root directory of the PRO/II DVD. Depending on what version you have installed, the following item will appear in the Control Panel Add/Remove Programs Window:

SimSci-Esscor PRO/II 9.1.

Selecting the option (listed above) and clicking on the Change/ Remove button will give you the opportunity to remove or add components, repair or modify the PRO/II configuration, or even uninstall the whole product.

Note: The order of uninstalling components and/or creating files under the PRO/II tree may cause certain single files to remain on the disk. After uninstalling a component, check the corresponding installation directory for remaining files and delete them manually.

Chapter 3 Installation Troubleshooting

This chapter addresses some of the more common support questions and problems related to TOKEN,TOKENNET and FLEXlm 9.5/ FLEXNET 11, USB, and General License security.

If you are having problems installing this product, review this section. If you are unable to correct the problem, contact Technical Support located at your local SIMSCI Technical Support Center, as listed in Introduction.

Diagnose TOKEN, TOKENNET and FLEXlm 9.5/FLEXNET 11 Security Problems

Step 1 - Ensure that the FLEXlm server is working correctly

When encountering a licensing problem with TOKEN, TOKENNET, FLEXlm 9.5/FLEXNET 11 security, first ensure that the FLEXlm server is running without any errors. The TOKEN license server is actually a FLEXlm 9.x server, and the only difference between these two types of license servers lies in the license files, one being token-based (each product requires a specified number of tokens when used) and the other product- specific. Incidentally, only a 9.x FLEXlm server can manage a SimSci-Esscor TOKEN license file. There are two ways to verify that the FLEXlm server is running correctly.

The first way is to examine the FLEXlm server debug log file ipassi.log. This log file is by default located in the FLEXlm directory (C:\Program Files\IPASSI\Security\FLEXNET 11 for FLEXNET 11 and C:\Program Files\IPASSI\Security\FLEXlm95 for FLEXlm 9.5) The actual location for this log file can be found from the FLEXlm lmtool.exe utility in the “Path to the debug log

file” field on the “Config Services” tab (See figure below). Carefully go through the log file to see if there are any errors recorded in this log file.

Figure 3-1 :

LMTools Configuration Service

in this log file. Figure 3-1 : LMTools Configuration Service Alternatively, after attempting to start the

Alternatively, after attempting to start the FLEXlm server, start the lmtools.exe utility, click on the “Server Status” button on the “Server Status” tab, and then click the “Perform Status Enquiry” button (as shown in the Figure below). Again, carefully go through the output text to find any error messages. Note that if you need to perform the server status enquiry multiple times, you can use “Edit->Clear Window” from the menu bar as this will clear the output text box for easy reading.

Figure 3-2: LMTools Server Status

Figure 3-2: LMTools Server Status If there are any error messages in th e FLEXlm server

If there are any error messages in the FLEXlm server log file or in the lmtool.exe “Server Status” output text window, try and take appropriate action to resolve the problem yourself.

Examples:

Attempting to start the FLEXlm server using a license file not intended for the license server causes an authentication error. In this case, you need to install the correct license (and FLEXlm server) on the machine for which the license was generated. Alternatively, contact your SimSci-Esscor representative to issue a license file for the machine on which the FLEXlm server is installed.

Another issue could be that the licenses themselves have expired. The expiration date can be found by looking at the license file, ipassi.lic, or by clicking the Perform Diagnostics button on the Server Diags tab. If the licenses have expired, then contact your SimSci-Esscor sales representative to renew your licenses.

A further common error is that the FLEXlm server machine name, the second item on the SERVER line in the FLEXlm

license file, is not stated correctly. An example of the server line, from a permanent license, is as follows:

SERVER miawa2ca 000874fe5ea8

Or for a temporary license:

SERVER ukfcra-g6fyq0j ANY

Note for a temporary license, the ANY entry must be retained as the third item on the SERVER line.

If the machine name is correct in the SERVER line but the FLEXlm server is still not starting correctly, then use the IP address of the server machine instead of the machine name.

For errors that you cannot resolve yourself, contact SimSci-Esscor technical support for assistance. When doing so, have the server log file available to send as an aid in troubleshooting the problem.

Step 2 - Ensure that the application is using FLEXlm/TOKEN security

If the FLEXlm server is up and running with the correct license, but there is still a problem launching the application due to a FLEXlm/ TOKEN security error, then the focus should switch to the SimSci-Esscor application side. The second step in troubleshooting FLEXlm/TOKEN security is to verify if FLEXlm/TOKEN is indeed the active license security type. This selection of license security type is made in the main initialization file (*.ini) of the application. These files are usually named after the applications they control, such as PROII.ini, PipePhase.ini, Datacon.ini, etc. The easiest way to locate these ini files is to search the application directory for the *.ini file that contains the string [wss_Security]. Once you identify the ini file, you need to open the file (NotePad will work fine for this) to see what the active security type is. Search for the Type statement in the [wss_Security] section. The active security Type statement is the one that does not have a semi- colon (;) in front of it. If FLEXlm/TOKEN is not the current active security type, you will need to comment out the current active type by placing a semi-colon at the beginning of that line, and uncomment the ;Type=FLEXlm or the ;Type=TOKEN line. For example:

[wss_Security] (if you are using FLEXlm 9.5 for security)

Type=FLXLM95

Type=USB

Type=FLXNET11

Type=TOKEN

Type=TOKENNET

Or

[wss_Security] (if you are using TOKEN for security)

Type= TOKEN

Type=TOKENNET

Type=USB

Type= FLXNET11

Type=FLXLM95

If FLEXlm/TOKEN security was previously not the active security type and has now been made the active security type, the user should test the application to verify that the change has corrected the problem. If the FLEXlm/TOKEN security still does not work, proceed to Step 3 for further diagnosis.

Step 3 - Ensure that the application is using the correct set of security files

This step involves checking the security files at two levels. At the first level, the user needs to make sure that the application is actually using its own set of security files (scintf.dll, token.dll, tokennet.dll, flxnet11.dll, and flxlm95.dll). Sometimes multiple copies of the security files exist on the machine and the application may be using the file(s) somewhere on the paths specified in the PATH environment variable, not the ones under its own directory. Since this will create significant confusion during security troubleshooting, it is highly recommended that all security files that are not part of any SimSci-Esscor application file systems be deleted, especially the ones on the PATH environment variable. When this is done, the user can be sure exactly which security files the application is using.

The second level is only applicable to the FLEXlm security. The SimSci-Esscor FLEXlm security comes in two versions, 7.2 and 9.5. Because these two versions are not completely compatible with each other, it is critical that the FLEXlm client (the flxlm.dll on the application side), the license file, and the FLEXlm server be of the same FLEXlm version. The symptom of this incompatibility is that the application fails and in the server debug file you see the license is checked out and back in almost at the same time. The FLEXlm server version can be found in the server log file (ipassi.log) and the

license file version can be found in the license file itself. If the version cannot be found in the license file, then the license file should be FLEXlm version 7.2. The version of the flxlm.dll can be found by right-clicking the file, selecting Properties, and then selecting the Version tab. From 2006, we are moving towards using the FLEXlm version in FLEXlm dll file names. For instance, flxlm72.dll means the file is version 7.2 and flxlm95.dll means version 9.5. Moreover, the value of the Type statement in the application ini file also uses flxlm95 and flxlm72 to reflect the FLEXlm version it is using.

Step 4 - Ensure that the FLEXlm communications are function- ing properly

If the FLEXlm server is running correctly and the application's licensing configuration is appropriate, but there is still a FLEXlm/ TOKEN licensing problem, turn the focus to the communications between the application machine and the FLEXlm server machine.

To do this, first ping the FLEXlm server machine from the application machine to see if the communications between them are enabled. If not, the user should contact their IT personnel to resolve this issue first. After the fundamental communications problem is resolved, examine the value of the environment variable IPASSI_LICENSE_FILE on the application machine to see if the value points to the intended FLEXlm server machine. If this value has been set multiple times, examining and editing the value in the registry may be necessary because the old value may be cached in the registry location. Figure 3-3 shows the registry entry for server

@cms4m0ca:

Figure 3-3: Registry Entry for Server @cms4m0ca

@cms4m0ca: Figure 3-3: Registry Entry for Server @cms4m0ca The user can directly delete or edit the

The user can directly delete or edit the value of the IPASSI_LICENSE_FILE from here or run lmpath.exe to accomplish the same result.

Another issue with this environment variable is that sometimes the application machine system has a problem resolving the FLEXlm server machine name into the IP address. In this case, instead of using the FLEXlm server machine name for value of IPASSI_LICENSE_FILE, use the FLEXlm server machine's IP address, such as @123.12.10.100.

If the environment variable is managed correctly and the problem still persists, the user may resolve the problem based on any error messages rendered on the application side. The user should examine the contents of the FLEXlm server log file ipassi.log to see if there are any records about the license request. If there are no records at all in the server log file about this license request, then the communication between the FLEXlm client and FLEXlm server have not been established. In this case, the user needs to examine the firewall on the FLEXlm server machine to ensure that the port numbers used by the FLEXlm server (lmgrd.exe) are enabled for the communication. The port numbers used by the FLEXlm server can be found in the FLEXlm server log file ipassi.log.

Example:

10:21:59 (lmgrd) lmgrd tcp-port 27000 10:22:10 (lmgrd) IPASSI using TCP-port 2601

Another possible FLEXlm communication issue may be encountered accessing FLEXlm licenses over the internet, as it may take longer for the application to connect to the FLEXlm server machine. If this takes too long, the application may prematurely timeout the connection attempt and return an error. To overcome this problem, set the environment variable FLEXLM_TIMEOUT on the application machine. The usage of this variable is as follows:

Set the timeout value of a FLEXlm-licensed application when attempting to connect to a license server port in the range 27000- 27009. Values are in microseconds, within the range 0 through 2147483647. The default setting is 100000 microseconds.

The other thing the user can do to reduce the connection time is to explicitly set the FLEXlm server ports such that the application knows exactly what ports to talk to. Please refer to Table 3-1 for details on setting up explicit FLEXlm server ports.

Table 3-1: FLEXlm License Security-related Problems and Solutions

Problem

Can I have multiple FLEXlm servers installed and run on the same machine?

Fix

Yes, it is allowed to install and simultaneously run multiple FLEXlm servers from different vendors on the same machine. When doing so,

it

is highly recommended that you install the servers to different

locations so that they do not interfere with one another. However,

multiple FLEXlm servers from the same vendor cannot run simultaneously. Only one version can be active at a time. For example, the IPASSI FLEXlm 9.5 can be installed in different

locations on the same machine, but only one of them can be running at

a

time.

Problem

I have multiple IPASSI license files on my FLEXlm server machine. Can I combine them into one?

Fix

If those license files have an identical SERVER line, then they can be combined. Otherwise, the answer is no. After the merge, there should be only one SERVER line and one VENDOR line in the resultant license file.

Problem

How do I instruct my IPASSI FLEXlm server to use multiple license files?