AES%20111%20Installation%20Manual

Aspen EngineeringSuite 11.1

Installation Manualfor Windows®

Version Number: 11.1September 2001Copyright (c) 2001 by Aspen Technology, Inc. All rights reserved.

AspenTech®, Aspen Engineering Suite, Aspen Plus®, Aspen Properties, Aspen B-JAC, Aspen CustomModeler®, Aspen Dynamics, Aspen Traflow, Aspen ADSIM, Aspen Chromatography, Aspen Water, AspenUtilities, Aspen Pinch, Aspen Zyqad, Aspen OnLine, Aspen Plus Online, Aspen WebModels, Batch Plus®,Polymers Plus®, Aspen OLI, Aspen PEP Process Library, the aspen leaf logo and Plantelligence are trademarksor registered trademarks of Aspen Technology, Inc., Cambridge, MA.

All other brand and product names are trademarks or registered trademarks of their respective companies.

This manual is intended as a guide to using AspenTech’s software. This documentation contains AspenTechproprietary and confidential information and may not be disclosed, used, or copied without the prior consent ofAspenTech or as set forth in the applicable license agreement. Users are solely responsible for the proper use of thesoftware and the application of the results obtained.

Although AspenTech has tested the software and reviewed the documentation, the sole warranty for the softwaremay be found in the applicable license agreement between AspenTech and the user. ASPENTECH MAKES NOWARRANTY OR REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THISDOCUMENTATION, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR APARTICULAR PURPOSE.

CorporateAspen Technology, Inc.Ten Canal ParkCambridge, MA 02141-2201USAPhone: (617) 949-1000Fax: (617) 949-1030Website:http://www.aspentech.com

DivisionDesign, Simulation and Optimization SystemsAspen Technology, Inc.Ten Canal ParkCambridge, MA 02141-2201USAPhone: (617) 949-1000Fax: (617) 949-1030

Aspen Engineering Suite 11.1 Installation Manual Contents •••• iii

Contents

Introduction 1-1Related Documentation ....................................................................................................1-1Training Services..............................................................................................................1-3Technical Support ............................................................................................................1-4

Online Technical Support Center.........................................................................1-4Phone and e-mail ..................................................................................................1-5

Overview 2-1Overview of the Aspen Engineering Suite Installation....................................................2-1

Installation CDs....................................................................................................2-1Recommended installation sequence ...................................................................2-2Plantelligence & Enterprise Optimization............................................................2-3

AES System Requirements ..............................................................................................2-3Hardware requirements ........................................................................................2-3Software requirements..........................................................................................2-4

AES Product Requirements..............................................................................................2-5Aspen ADSIM......................................................................................................2-5Aspen B-JAC .......................................................................................................2-5Aspen Chromatography........................................................................................2-5Aspen Custom Modeler........................................................................................2-5Aspen Icarus.........................................................................................................2-5Aspen OLI ............................................................................................................2-5Aspen OnLine ......................................................................................................2-6Aspen Plus Online................................................................................................2-6Aspen PEP Process Library..................................................................................2-6Aspen Pinch..........................................................................................................2-6Aspen Plus............................................................................................................2-7Aspen Properties ..................................................................................................2-7Aspen Split ...........................................................................................................2-7Aspen Traflow......................................................................................................2-7Aspen Utilities......................................................................................................2-7Aspen WebModels Author...................................................................................2-8Aspen WebModels Server....................................................................................2-8Aspen Zyqad ........................................................................................................2-9Batch Plus.............................................................................................................2-9Polymers Plus.....................................................................................................2-10

Contents •••• iv Aspen Engineering Suite 11.1 Installation Manual

General Pre-Installation Checklist .................................................................................2-10Checking the Service Pack version ....................................................................2-11Checking virtual memory...................................................................................2-11Checking installation account privileges............................................................2-12Licensing ............................................................................................................2-12

Installation Configuration Options.................................................................................2-14Standard..............................................................................................................2-14Lite Client...........................................................................................................2-14Client-Server ......................................................................................................2-14Valid configuration options for AES products...................................................2-15

Standard Installation 3-1Overview ..........................................................................................................................3-1Before You Begin.............................................................................................................3-2Installing AES Products ...................................................................................................3-2

Aspen Engineering Suite Application / Product CD............................................3-2Software Selection Availability ...........................................................................3-3Computer Configuration Type .............................................................................3-4Choose Destination Location ...............................................................................3-4Select Products / Subcomponents ........................................................................3-5Configure AES product components....................................................................3-8Select Program Folder..........................................................................................3-8Plantelligence & Enterprise Optimization Users .................................................3-8Installation Summary ...........................................................................................3-9Setup Needs Next Disk ........................................................................................3-9Setup Complete ....................................................................................................3-9Aspen License Selector ......................................................................................3-10

Configuring Installed AES Products ..............................................................................3-11Using Plantelligence & Enterprise Optimization Solutions...........................................3-11

Select Aspen Framework Server ........................................................................3-12Plantelligence / Enterprise Optimization Operation...........................................3-14Aspen Framework Server...................................................................................3-15

Selecting or Changing the Licensing Method ................................................................3-15Specifying or Changing the AFW Server ......................................................................3-16Verifying the Installation ...............................................................................................3-17

Lite Client Installation 4-1Overview ..........................................................................................................................4-1Before You Begin.............................................................................................................4-3Lite Client Installation Summary .....................................................................................4-3Installing AES Software on a File Server ........................................................................4-4Installing AES Software on User PCs..............................................................................4-4

Map network drive ...............................................................................................4-4Aspen Engineering Suite Application / Product CD............................................4-4Software Selection Availability ...........................................................................4-6Computer Configuration Type .............................................................................4-7

Aspen Engineering Suite 11.1 Installation Manual Contents •••• v

Choose Destination Location ...............................................................................4-7Select Products / Subcomponents ........................................................................4-8Specifying the File Server location of components ...........................................4-10Select Program Folder........................................................................................4-11Plantelligence & Enterprise Optimization Users ...............................................4-11Installation Summary .........................................................................................4-11Setup Complete ..................................................................................................4-11Aspen License Selector ......................................................................................4-12

Verifying the Installation ...............................................................................................4-13

Client - Server Installation 5-1Overview ..........................................................................................................................5-1Before You Begin.............................................................................................................5-3Client-Server Installation Summary.................................................................................5-4Installing AES Software on a Server................................................................................5-4

Aspen Engineering Suite Application / Product CD............................................5-5Software Selection Availability ...........................................................................5-6Computer Configuration Type .............................................................................5-7Choose Destination Location ...............................................................................5-7Select Products / Subcomponents ........................................................................5-8Configure AES product components..................................................................5-10Select Program Folder........................................................................................5-10Plantelligence & Enterprise Optimization Users ...............................................5-10Installation Summary .........................................................................................5-10Additional setup information for AES products ................................................5-11Setup Complete ..................................................................................................5-11Aspen License Selector ......................................................................................5-12

Configuring a Windows Server as an AES Host............................................................5-13Adding Windows NT Server Accounts..............................................................5-13Adding Windows 2000 Server Accounts ...........................................................5-15Optimizing Network Applications .....................................................................5-16

Configuring Installed AES Products on the Server........................................................5-17Verifying the Server Installation ....................................................................................5-17Installing AES Products on User PCs ............................................................................5-18Configuring Installed AES Products on User PCs .........................................................5-19

Specifying a Remote Server...............................................................................5-19Verifying Client – Server Communication ....................................................................5-25Combining Server and Lite Client Install Options.........................................................5-26

Upgrading AES Products 6-1Overview ..........................................................................................................................6-1Before You Upgrade ........................................................................................................6-2

Product Upgrade Task Summary .........................................................................6-2Upgrading AES Products .................................................................................................6-3

Contents •••• vi Aspen Engineering Suite 11.1 Installation Manual

After You Upgrade...........................................................................................................6-4Batch Plus Project Files........................................................................................6-4Updating Aspen OLI ............................................................................................6-5

Adding or Reinstalling Components 7-1Overview ..........................................................................................................................7-1Before You Add or Reinstall Components ......................................................................7-2Adding or Reinstalling Components ................................................................................7-2After You Add or Reinstall Components.........................................................................7-3Verify the Installation.......................................................................................................7-3

Removing AES Products 8-1Overview ..........................................................................................................................8-1Before You Remove Any AES Product...........................................................................8-2Uninstalling AES Products...............................................................................................8-2

Starting the Uninstaller.........................................................................................8-2Uninstalling the software .....................................................................................8-2

After You Remove AES Products....................................................................................8-3Using Excel after uninstalling Aspen Zyqad........................................................8-3Re-registering CAPE-OPEN components............................................................8-3

Troubleshooting 9-1Common Problems...........................................................................................................9-1

Checking Installation Account Privileges ............................................................9-1Other Troubleshooting Tips .................................................................................9-1Problem Accessing Help ......................................................................................9-2

Error Messages.................................................................................................................9-3Client-Server Installations....................................................................................9-3

Aspen ADSIM 10-1Verifying an Aspen ADSIM Installation .......................................................................10-1Verifying an Aspen ADSIM Installation that Uses Aspen Properties ...........................10-2

Aspen B-JAC 11-1Verifying the Aspen B-JAC Installation ........................................................................11-1

Changing the Licensing Option..........................................................................11-2

Aspen Chromatography 12-1Verifying an Aspen Chromatography Installation .........................................................12-1

Aspen Custom Modeler 13-1Verifying the Aspen Custom Modeler Installation ........................................................13-1

Verifying Aspen Custom Modeler with Aspen Properties.................................13-2

Aspen Engineering Suite 11.1 Installation Manual Contents •••• vii

Aspen Dynamics 14-1Verifying the Aspen Dynamics Installation ...................................................................14-1

Aspen Icarus 15-1Before You Install Aspen Icarus ....................................................................................15-1

Aspen Icarus Project Manager (IPM).................................................................15-1Aspen Icarus Installation Notes......................................................................................15-1

Aspen OLI 16-1Verifying the Aspen OLI Installation.............................................................................16-1

Aspen OnLine and Aspen Plus Online 17-1Aspen OnLine Installation Notes ...................................................................................17-1

Specifying a DCOM user account......................................................................17-2Enabling CIM-IO Server Security......................................................................17-2

Configuring Aspen OnLine............................................................................................17-3Configuring the Aspen OnLine Server...............................................................17-3Configuring the Aspen OnLine Client ...............................................................17-6

Verifying an Aspen OnLine Installation ........................................................................17-7Verifying Plant Data Access ..............................................................................17-7Verifying AES products .....................................................................................17-7Verifying Aspen OnLine....................................................................................17-7

Aspen Plus Online Installation Notes.............................................................................17-9Configuring the apol111serv Service.................................................................17-9Aspen Plus Online Startup ...............................................................................17-10

Aspen PEP Process Library 18-1Verifying the Aspen PEP Process Library Installation ..................................................18-1Troubleshooting Aspen PEP Process Library ................................................................18-2

Aspen Pinch 19-1Verifying the Aspen Pinch Installation ..........................................................................19-1

Aspen Plus 20-1Installation Notes............................................................................................................20-1Verifying the Aspen Plus Installation ............................................................................20-1Configuring a Windows Server as an Aspen Plus Calculation Server...........................20-2

Step 1: Install the Simulation Engine on the server ...........................................20-2Step 2: Verify the Simulation Engine installation on the server ........................20-3Step 3: Set up user access to the calculation server ...........................................20-3Step 4: Create working directories for users ......................................................20-4Step 5: Install Aspen Plus on User PCs..............................................................20-4Step 6: Verify the Calculation Server Installation .............................................20-5

Contents •••• viii Aspen Engineering Suite 11.1 Installation Manual

Aspen Plus Client/Server Communication.....................................................................20-6Displaying and stopping a process .....................................................................20-7Customizing Aspen Plus Communication .........................................................20-7

Using the FORTRAN Compiler with Aspen Plus .........................................................20-8User Workflow...................................................................................................20-8

Installing the FORTRAN Compiler ...............................................................................20-9Client-Server Installations..................................................................................20-9Configuring the TelnetD Server (Windows NT)..............................................20-10Verifying the Installation of the FORTRAN Compiler ...................................20-10

Troubleshooting Aspen Plus ........................................................................................20-12Testing client-server connectivity ....................................................................20-12Client-Server Installation Problems .................................................................20-12Error Messages.................................................................................................20-13

Aspen Properties 21-1Installation Notes............................................................................................................21-1Verifying the Aspen Properties Installation ...................................................................21-1Setting Up Aspen WebProperties...................................................................................21-3

Configuring IIS for Aspen WebProperties.........................................................21-3Setting up WebProperties Userfolders ...............................................................21-6

Running Aspen Properties and Aspen WebProperties on separate machines................21-7Configuring DCOM on the web server ..............................................................21-7Configuring DCOM on the Aspen Properties machine .....................................21-8

Aspen Split 22-1Installation Notes............................................................................................................22-1Verifying the Aspen Split Installation............................................................................22-1

Verifying the Aspen Split Distillation Analysis component..............................22-2Verifying the Stand-Alone Configuration of Aspen Split..................................22-3

Aspen Traflow 23-1Verifying the Aspen Traflow Installation ......................................................................23-1

Aspen Utilities 24-1Verifying the Aspen Utilities Installation ......................................................................24-1

Aspen Water 25-1Verifying the Aspen Water Installation .........................................................................25-1

Aspen WebModels Author 26-1Configuring the Aspen WebModels Author Installation ...............................................26-1

Configuring the AFW Author Role....................................................................26-1Configuring Internet Explorer for WebModels..................................................26-1

Verifying the Aspen WebModels Author Installation ...................................................26-2

Aspen Engineering Suite 11.1 Installation Manual Contents •••• ix

Troubleshooting Aspen WebModels Author .................................................................26-4Error Messages...................................................................................................26-4Problems.............................................................................................................26-5

Aspen WebModels Server 27-1Before You Install Aspen WebModels Server...............................................................27-1Installation Notes............................................................................................................27-2

Creating the Aspen WebModels Server user account........................................27-2Creating the WebModels Database ....................................................................27-2

Configuring the WebModels Server Installation ...........................................................27-4Configuring VSS............................................................................................................27-4

Adding WebModels Author users......................................................................27-4Configuring Aspen Framework......................................................................................27-5

Importing roles and applications into the AFW security component.................27-6Configuring security for the WebModels roles and applications.......................27-6

Configuring the WebModels Server ..............................................................................27-7Using the WebModels Administrator ................................................................27-8Configuring the Application Servers..................................................................27-8Configuring the WebModels Roles..................................................................27-10Configuring Aspen Applications......................................................................27-12Prioritizing Server Resources...........................................................................27-14Configuring E-Mail Addresses.........................................................................27-15

Configuring MTS .........................................................................................................27-16Configuring default security settings under DCOM ........................................27-17Configuring WebModels Server components under DCOM...........................27-17Configuring remote calculation servers under DCOM ....................................27-18Specifying IIS settings .....................................................................................27-18Specifying AFW security settings for Windows 2000.....................................27-18

Verifying the WebModels Server Installation .............................................................27-19Maintaining WebModels Server ..................................................................................27-19

Stopping and Starting the LoadBalancer..........................................................27-19Troubleshooting Aspen WebModels Server ................................................................27-20

Aspen Zyqad 28-1Aspen Zyqad Components .............................................................................................28-1Before You Install Aspen Zyqad....................................................................................28-3Installation Notes............................................................................................................28-4

Specifying the Zyqad Broker connection...........................................................28-4Zyqad Broker confirmation (Windows NT).......................................................28-5Zyqad Server confirmation (Windows NT) .......................................................28-5Specifying Sample Projects users ......................................................................28-6

Configuring the Installed Software ................................................................................28-8Configuring Aspen Zyqad for users ...................................................................28-8Defining the Symbol Library Folder as a Network Share................................28-12

Configuring Aspen Zyqad in a CITRIX Environment.................................................28-13

Contents •••• x Aspen Engineering Suite 11.1 Installation Manual

Verifying the Aspen Zyqad Installation .......................................................................28-14Troubleshooting Aspen Zyqad .....................................................................................28-17

Batch Plus 29-1Standard Installation Notes ............................................................................................29-1

Specifying the Batch Plus server........................................................................29-1Server Installation Notes ................................................................................................29-3

Creating the Batch Plus Server database tables and records ..............................29-3Connecting to a Server after Installation........................................................................29-5

Connecting to the MS SQL Server.....................................................................29-5Connecting to the Oracle Server ........................................................................29-7

Troubleshooting Batch Plus ...........................................................................................29-9

Polymers Plus 30-1Installation Notes............................................................................................................30-1Verifying the Polymers Plus Installation .......................................................................30-1Troubleshooting Polymers Plus .....................................................................................30-2

Appendix A – HASP Key Licensing 31-1Using a single HASP key...............................................................................................31-1Using NetHASP keys .....................................................................................................31-1

NetBIOS .............................................................................................................31-1IPX .....................................................................................................................31-1TCP/IP................................................................................................................31-2

Appendix B – Using the DETHERM Database 32-1

Index 33-1

Installation Manual_Aspen Engineering Suite 11.1 Introduction •••• 1-1

C H A P T E R 1

Introduction

This manual describes how to install the Aspen Engineering® Suiteof products• On an Intel Pentium PC running Microsoft® Windows NT®

4.0, or Windows® 2000.• As an Application Server on an Intel Pentium PC running

Microsoft® Windows NT® 4.0 or Windows® 2000.• On a File Server and configure an Intel Pentium PC running

Microsoft® Windows NT® 4.0 or Windows® 2000 to use thefile server.

Related DocumentationIn addition to this document, a number of other documents areprovided to help users learn and use the applications of the AspenEngineering® Suite. All manuals are available in PDF format.

• What’s New In AES 11.1

• Aspen License Manager Version 3.0 Installation and ReferenceManual for Windows Platforms

• Aspen ADSIM Release Notes• Aspen ADSIM Library Reference Guide• Aspen ADSIM Adsorption Reference Guide

• Aspen B-JAC User Guide

• Aspen Chromatography Release Notes• Aspen Chromatography Library Reference Guide• Aspen Chromatography Reference Guide

AES

Aspen License Manager

Aspen ADSIM

Aspen B-JAC

Aspen Chromatography

1-2 •••• Introduction Installation Manual_Aspen Engineering Suite 11.1

• Aspen Custom Modeler Release Notes• Aspen Custom Modeler Getting Started Guide• Aspen Custom Modeler Examples• Aspen Custom Modeler Modeling Language Reference• Aspen Custom Modeler Library Reference• Aspen Modeler Reference Manual• Using DMCplus® Controllers• Aspen Custom Modeler SPEEDUP® 5 Source Converter

• Aspen Dynamics Release Notes• Aspen Dynamics Getting Started Guide• Aspen Dynamics User Guide• Aspen Dynamics Examples• Aspen Dynamics Reference Guide• Using Aspen Traflow

• Aspen OLI Interface document• Aspen OLI Locator document

• Aspen OnLine User Guide• Aspen OnLine Tutorial

• Aspen PEP Processes Library User Guide

• Aspen Pinch User Guide

• Aspen Plus Getting Started Guides• Aspen Plus User Guide• Aspen Plus Reference Manuals

• Aspen Plus Online User Guide

• Aspen Properties User Guide• Aspen Properties Physical Property Methods and Models• Aspen Properties Physical Property Data• Aspen Properties System Management Guide

• Aspen Split User Guide

Aspen Custom Modeler

Aspen Dynamics

Aspen OLI

Aspen OnLine

Aspen PEP ProcessLibrary

Aspen Pinch

Aspen Plus

Aspen Plus Online

Aspen Properties

Aspen Split


• Aspen Utilities Release Notes• Aspen Utilities Getting Started Guide• Aspen Utilities User Guide

• Aspen Water Release Notes• Aspen Water Getting Started Guide• Aspen Water User Guide

• Aspen WebModels Author User Guide

• Aspen Zyqad Release Notes• Aspen Zyqad Getting Started Guide• Aspen Zyqad User Guide• Aspen Zyqad Administrator Reference Guide

• Batch Plus User Guide

• Polymers Plus User Guide• Polymers Plus Examples & Applications Case book

Training ServicesAspenTech offers a comprehensive training program forAspenTech product users:• Instructor-led, hands-on courses are regularly scheduled at

AspenTech Training Centers throughout the world; they canalso be presented at customer sites.

• Self-paced Computer Based Training packages are availablefor some product ranges.

For the latest worldwide training schedules, pricing and coursedescriptions, recent Training News and contact/registrationinformation, see the AspenTech website:

http://support.aspentech.com/training

Aspen Utilities

Aspen Water

Aspen WebModels

Aspen Zyqad

Batch Plus

Polymers Plus

http://support.aspentech.com/training


Alternatively, please contact:

Phone: 1-888-996-7100 (toll-free from US, Canada, Mexico

1-281-584-4357 (outside North America)

Fax: 1-281-584-1064

E-Mail: [email protected]

Phone: +32-2-701-9552

Fax: +32-2-701-9570


Phone: + 81-3-3262-1743

Fax: + 81-3-3262-1744


Phone: + 65-395-3900

Fax: + 65-395-3950


Technical SupportAspenTech customers with a valid license and softwaremaintenance agreement can register to access the OnlineTechnical Support Center at:

http://support.aspentech.com/

This web support site allows you to:• Access current product documentation• Search for tech tips, solutions and frequently asked questions

(FAQs)• Search for and download application examples• Submit and track technical issues• Send suggestions• Review lists of known limitations

U.S. Training Centers

All European TrainingCenters

Japan

Asia and Australia

Online TechnicalSupport Center

mailto:[email protected]






Registered users can also subscribe to our Technical Supporte-Bulletins. These e-Bulletins are used to proactively alert users toimportant technical support information such as:• Technical advisories• Product updates• Service Pack announcements

Customer support is also available by phone for customers with acurrent support contract for this product. The hours listed are inlocal time.

Hours: 08:00 – 20:00

Phone: 1-888-996-7100 (toll-free from US, Canada, Mexico

1-281-584-4357 (US, Canada)

52-5-536-2809 (Mexico)

Fax: 1-617-949-1724 (Cambridge, MA)1-281-584-1807 (Houston, TX)


Argentina OfficeHours: 09:00 – 17:00

Phone: 0800-333-0125 (toll free to US)

54-11-4361-7220

Fax: 54-11-4361-7220


Brazil OfficeHours: 09:00 – 17:00

Phone: 000-814-550-4084 (toll free to US)

55-11-5012-0321

Fax: 55-11-5012-4442


Phone and e-mail

North America & theCaribbean

South America





Hours: 08:30 – 18:00 (Central European Time)

Phone: 32-2-701-95-55

Country specific toll-free numbers:

Belgium (0800) 40-687

Denmark 8088-3652

Finland (0) (800) 1-19127

France (0805) 11-0054

Ireland (1) (800) 930-024

Netherlands (0800) 023-2511

Norway (800) 13817

Spain (900) 951846

Sweden (0200) 895-284

Switzerland (0800) 111-470

UK (0800) 376-7903

Fax: 32-2-701-94-45


Tokyo OfficeHours: 09:00 – 17:30

Phone: 81-3-3262-1743

Fax: 81-3-3262-1744


Singapore OfficeHours: 09:00 – 17:30

Phone: 65-395-39-00

Fax: 65-395-39-50


Europe, Gulf Region, &Africa

Asia & Pacific Region




Installation Manual_Aspen Engineering Suite 11.1 Overview •••• 2-1

C H A P T E R 2

Overview

This chapter provides an overview of the installation requirementsand installation options.

Overview of the Aspen EngineeringSuite InstallationThe AspenTech software solutions are organized and distributed inthree suites of Applications/Products, and a set of IntegrationProducts software. You may have licensed a single AspenTechproduct, or a full suite of solutions.

The AspenTech Master Install system manages the installation ofeither a single product or an integrated suite of AspenTechsolutions on Microsoft Windows-based platforms.The software system you received may contain one or more of thefollowing CDs:

AspenTech CD CD Color

Integration Products CD:

Aspen License Manager (ALM) Server RedAspen Framework (AFW) Server RedDAIS (CORBA) Server Red

Application/Product CDs:

Aspen Engineering Suite BlueAspen Manufacturing Suite YellowAspen eSupply Chain Suite OrangeBusiness Process Templates (BPT) Green

Installation CDs

2-2 •••• Overview Installation Manual_Aspen Engineering Suite 11.1

Before you begin to install any Aspen Engineering Suite software,we recommend that the Integration Products software, for example,the Aspen License Manager (ALM) Server, is installed,configured, and available. This is typically done by your SystemAdministrator.

Note: Some products cannot be installed unless an ALM serverconfirms that the product is licensed at install time.

Current versions of Integration Products software should have theexisting Integration Products data or contents updated asappropriate (e.g., add license keys for newly licensed products)before installing new Application/Product software or upgradingexisting software.This flowchart shows the overall installation process, includingmajor prerequisites, such as the Aspen License Manager (ALM).

Install theALM Server

Install theAFW Server

Plantelligence &Enterprise

Optimization?

Yes

Install theDAIS Server

Installing anyproducts thatneed DAIS?

No

Yes

Install desiredsoftware from CD X*

Install desiredsoftware from CD Y*

No

Install desiredsoftware from CD Z*

Configure BPE (forPlantelligence and

EnterpriseOptimization) and/or

applications

Done

* Application/Product CDs may be installed in any order.

Key to Installation Process Flowchart:

ALM Aspen License Manager

AFW Aspen Framework Server

DAIS 3rd Party (PeerLogic) CORBA Software

BPE Business Process Explorer

Recommendedinstallation sequence


All AES products are compliant with Plantelligence & EnterpriseOptimization solutions. Plantelligence & Enterprise Optimizationproducts use Aspen Framework.

For information on Aspen Framework, see the Aspen FrameworkDevelopers Guide.

AES System RequirementsThis section provides the hardware and software requirements forthe Aspen Engineering Suite of products. All products within thisversion of the Aspen Engineering Suite are integrated.

Resource Recommended Requirements

CPU A PC with an Intel Pentium III 500 MHz (orfaster) processor.Note: If you are purchasing a new PC, selectthe fastest CPU available.

Monitor A super VGA color monitor with 1024 x 768resolution or higher.

Physical Memory 128-256 MB; 512 MB or higher for largeplant models.

Hard Disk Space Up to 2.0 GB of free disk space, depending onwhich AES products are installed. Thisincludes 150 MB of files installed to yoursystem drive.Note: The Installer displays spacerequirements for the selected products.

Virtual memory 512 MB consisting of physical memory andswap file.Large plant models or multiple openapplications may require additional virtualmemory.

Pointing device A mouse or other pointing device

CD-ROM drive Available on the local PC or through thenetwork during the installation.

Licensing Aspen License Manager (ALM) requires anetwork adapter to connect to a licensemanager server. A network adapter isrecommended if using a License file to get alicense.

Plantelligence &EnterpriseOptimization

Hardwarerequirements


The following recommendations are for AES product installationson server machines.

Resource Recommended Requirements

CPU A PC with an Intel Pentium III 500 MHz (orfaster) processor.Note: If you are purchasing a new PC, selectthe fasted CPU available.

Physical Memory 256 MB; 512 MB – 1 GB for simulation toolsoperating large plant models and databases.Memory requirement increases with the sizeof databases and plant models, and with thenumber of simultaneous users.

Hard Disk Space 500 MB – 2 GB, depending on which AESproducts are installed. Batch Plus may requireup to 10 GB, depending on the number ofprojects.

The following software requirements apply to all AES products.

Operating System Notes

Windows NT® 4.0Windows NT® server 4.0

Service Pack 6a or higher required.

Windows® 2000Windows® 2000 server

Service Pack 2 or higher required.

Component Notes

Aspen License Manager(ALM)

Version 3.0 or higher; required if youare running the License Server

Aspen Framework (AFW) Version 2.2 or higher. Available forall AES products; required for AspenWebModels.

Component Notes

Adobe Acrobat Reader Version 4.0 or higher

Internet Explorer Version 5.0 or higherRequired for BPE component(Plantelligence & EnterpriseOptimization installations).

Server hardwarerequirements

Softwarerequirements

Aspen Products

Other Software


AES Product RequirementsThe following AES products have additional softwarerequirements.

Requirements Notes

Internet Explorer 5.5 orhigher

Requires the option to install WindowsScripting Host.

Requirements Notes

HASP key licensing If supported.

Requirements Notes


Requires the option to install WindowsScripting Host.

Requirements Notes

Digital Visual Fortran(6.0, 6.1, 6.5a)

Required for customer development.

Microsoft Visual C++ (6.0) Required for customer development.

Requirements Notes


Required for certain reports in allAspen Icarus products.

Microsoft Excel 2000 Required for Aspen DecisionAnalyzer and certain reports in allother Aspen Icarus products.

Primavera Project Planner(P3) for Windows 3.0

Required for scheduling componentof Aspen Icarus Project Manager(IPM). P3 must be installed prior toinstalling IPM. For instructions, seeChapter 15, Aspen Icarus.

Requirements Notes

Aspen Plus 11.1 Required to run the product. Aspen Plusmust be installed prior to orsimultaneously with Aspen OLI.

Aspen ADSIM

Aspen B-JAC

AspenChromatography

Aspen CustomModeler

Aspen Icarus

Aspen OLI


Requirements Notes

Aspen Plus 11.1 Required for model developmentoutside of Aspen OnLine.Both the Aspen Plus Simulation Engineand User Interface should be installedon the computer running the AspenOnLine Server.

InfoPlus 21, CIM/21,Setcim, or InfoPlus Xinformation managementsystem orCIM-IO supported DCS orIMS source of plant data

Must be installed on same computer asthe Aspen OnLine Server.

Microsoft Excel 2000 Required by both Aspen OnLine Clientand Server

Aspen Process Explorer Optional (Aspen Manufacturing Suite,Information Management)

Requirements Notes

Aspen Plus 11.1 Aspen Plus Online engine requiresAspen Plus.

Requirements Notes

Aspen Plus 11.1 Required to install and run the product.Aspen Plus must be installed prior to orsimultaneously with Aspen PEP ProcessLibrary.

Polymers Plus 11.1 Required to run some models.Microsoft Office 97 or2000: Excel, Access

Required for product features.

Requirements Notes

Aspen Plus 11.1 Aspen Plus GUI and Simulation engineare required for the Aspen Pinch −Aspen Plus interface.

Aspen B-JAC 11.1 Required for the detailed simulation anddesign of heat exchangers.

Pro/II interface toSimulation (subcomponent)

An interface to Simulation Science’sPro/II simulator. The Pro/II interface isdelivered on a separate CD.

Aspen OnLine

Aspen Plus Online

Aspen PEP ProcessLibrary

Aspen Pinch


Requirements Notes

DETHERM Interface Provides access to thermophysicalproperty data included in the DETHERMdatabase maintained by DECHEMA e.V., Frankfurt, Germany.For more information, see this website:http://www.dechema.de/

Digital Visual Fortran(6.0, 6.1, 6.5a)


PAssMan Required to use assays from the PIMSassay library as components. PAssMan isavailable from the Aspen eSupply ChainSuite CD.

Requirements Notes

DETHERM Interface See Aspen Plus software requirements.

PAssMan Required to use assays from the PIMSassay library as components. PAssMan isavailable from the Aspen eSupply ChainSuite CD.

Requirements Notes

Aspen Plus 11.1 The standard version, which includesthe core Properties System component,the Aspen Plus Simulation Engine andthe Aspen Plus User Interface, must beinstalled and accessible on the computerrunning Aspen Split.


Required to run Aspen Split.

Requirements Notes

Aspen Dynamics 11.1 Required to install and run AspenTraflow. Aspen Dynamics must beinstalled prior to or simultaneously withAspen Traflow.

Requirements Notes

Aspen Plus 11.1 Required to run Aspen Utilities.Digital Visual Fortran(6.0, 6.1, 6.5a)


Microsoft Visual C++ (6.0) Required for customer development.

Aspen Plus

Aspen Properties

Aspen Split

Aspen Traflow

Aspen Utilities

http://www.dechema.de/


Requirements Notes

Aspen Framework 2.2Middle Tier and Clientcomponents

These components should be installedon the same computer as AspenWebModels Author.

Aspen Plus 11.1 (standardversion)

The standard version, which includesthe core Properties System component,the Aspen Plus Simulation Engine andthe Aspen Plus User Interface, shouldbe installed on the same computer asAspen WebModels Author.


Requires security settings for itsActiveX-based components. Forinstructions, see Chapter 26, AspenWebModels Author.

Microsoft VisualSourceSafe (VSS) ClientVersion 6.0 or later, USAversion

This should be installed on the samecomputer as Aspen WebModels Author.Aspen WebModels uses VSS to managethe model files in the WebModelslibrary. User permissions are required toaccess the database containing theAspen WebModels.

Requirements Notes

Windows NT 4.0 OptionPack

Required for WebModels Serverinstallations on Windows NT.

Aspen Framework 2.2Server and Middle Tiercomponents

These components should be installedon the computer running WebModelsServer.

Aspen Plus 11.1 (standardversion)

The standard version, which includesthe core Properties System component,the Aspen Plus Simulation Engine andthe Aspen Plus User Interface should beinstalled on the WebModels Servercomputer and configured before youverify the WebModels Server

Microsoft SQL Server 7.0 Contains the Aspen Framework, theEnterprise Objects, and the WebModelsdatabases.

Microsoft VisualSourceSafe (VSS) ClientVersion 6.0 or later, USAversion

This should be installed on theWebModels Server computer. AspenWebModels uses VSS to manage themodel files in the WebModels library.

Aspen WebModelsAuthor

Aspen WebModelsServer


Requirements Notes


Required for Drawing Applicationcomponent (Aspen Zyqad PFD).

Microsoft Excel 2000 Required for the Excel DatasheetDefiner.

LispWorks for Windows4.1 and LispWorkspatchkit 20

Required for the DevelopmentApplication tool.

Winsock 1.1 compatibleTCP/IP stack

Required for the DevelopmentApplication tool.

Requirements Notes

Aspen Properties 11.1or Aspen Plus 11.1

Required for property estimation.

Aspen Plus 11.1 withBatchFrac

Required to run BatchFrac model.

Aspen Properties 11.1 Required to calculate Henry’s constantsand activity coefficients for MACTvapor emission models.

Aspen Plus 11.1and Aspen Dynamics 11.1

Required to run Kinetic Reactor model.

InfoPlus.21 2.5 andAspenTech Desktop 2.5

Required to import actual plant data.

Microsoft Excel 97 or 2000 Required to view formatted reports andto use Custom Excel/VBA model.Note: Excel must be installed with theData Access option prior to installingBatch Plus.

Microsoft Word 97 or 2000 Required to run Operating Instructionsfeature and to view formattedcomments.

Microsoft Access 97 or2000

Required to open and edit the Step,Equipment, Materials, and Resultsdatabases.

Microsoft Project 98 Required to view Project chartsVisio Technical 5.0c or2000

Required to view Block and Equipmentdiagrams.

ChemDraw 4.5 Required to view Chemist Recipedocument.

Oracle provider forOLEDB 81620 or higher

Required for connection to an Oracledatabase.

Microsoft SQL Server 7.0 orOracle 8i Enterprise Edition

(Server installation) Must be fullyconfigured and operational beforeinstalling the Batch Plus server.

Aspen Zyqad

Batch Plus


Requirements Notes

Aspen Plus 11.1 Required to run the product. Aspen Plusmust be installed prior to orsimultaneously with Polymers Plus.

Aspen Dynamics 11.1 Required to support Polymers PlusDynamics functionality.

Aspen Properties 11.1 Required to support Polymers PlusProperties functionality.

General Pre-Installation ChecklistBefore installing any Aspen Engineering product, review thefollowing checklist to ensure a smooth installation.

Verify that all system requirements are met (see “AESSystem Requirements” on page 2-3).

Run the appropriate scanning and defragmentationprograms to correct any existing disk problems.

Check which service pack (SP) is installed. For instructions,see “Checking the Service Pack” on page 2-11.

Verify that there is enough available disk space for the AESsoftware you are planning to install.

Verify that the virtual memory, including swap space issufficient for running AES products. For instructions, see“Checking virtual memory” on page 2-11.

Verify that all additional required software has beeninstalled.

Verify that the installation account has local Administratorprivileges. For instructions, see “Checking installationaccount privileges on page 2-12.

Verify that Aspen License Manager (ALM) licensing isavailable. For more information, see “Licensing” onpage 2-12.

Disable any anti-virus software running on your PC so thatthe installation program can copy files to the system areaand modify the Windows Registry.

After you complete the installation, enable the anti-virussoftware.

Polymers Plus


To check which Service Pack version is installed on an IntelPentium computer running Windows NT or Windows 2000:

On the desktop, click Start | Programs | Administrative Tools(Common) | Windows NT Diagnostics.

The Version tab of the Windows NT Diagnostics dialog boxdisplays the installed version of Windows NT and any servicepack.

On the desktop, click Start | Settings | Control Panel and double-click System.

The General tab of System Properties dialog box displays theinstalled version of Windows 2000 and any service pack.

The recommended amount of virtual memory, including swapspace, for each AES product is 512 MB. This amount should notexceed two times the amount of physical RAM.

Large plant models or multiple open applications may requireadditional virtual memory

To check or change the virtual memory:1 On the desktop click Start | Settings | Control Panel .2 Double-click System to display the System Properties dialog

box.3 Do the following:Windows NT: Click the Performance tab and click the

Change button in the Virtual Memorysection.

Windows 2000: Click the Advanced tab and click thePerformance Options button. In the VirtualMemory section, click the Change button.

4 Select the drive on which the AES products are being installed.5 Change the values in the Initial Size and Maximum Size fields

of the Paging File Size for the Selected Drive.6 Click Set, and then click OK to close the dialog box.7 Click OK on the System Properties dialog box.8 When prompted, restart your computer.

Checking the ServicePack version

Windows NT

Windows 2000

Checking virtualmemory


When installing AES, you must use an account with localAdministrator privileges.

Note: Do not change the default privileges on the folders that arecreated by the installation process. If you change these privileges,your installation may not work correctly.

To verify Administrator privileges on Windows NT:1 On the desktop, click Start | Programs | Administrative

Tools (Common) | User Manager.The User Manager dialog box appears.

2 Double-click Administrators in the Groups list, which is thebottom list.The Local Group Properties dialog box appears.You must be a member of this group to perform theinstallation.

To verify Administrator privileges on Windows 2000:1 On the desktop, click Start | Control Panel | Users and

Passwords.The Users and Passwords dialog box appears.

2 Click the Advanced tab and click the Advanced button.The console window appears.

3 In the tree pane click groups to display its details.4 In the details pane click Administrators.

The Administrators Properties dialog box appears.You must be a member of this group to perform theinstallation.

Aspen Engineering Suite products are licensed by the AspenLicense Manager, which is based on the FLEXlm licenseManager from GLOBEtrotter Software, Inc. The LicenseManager serves licenses to programs running on a single computeror on a network of computers.

AES products must be able to access the required license. Duringthe installation, you are prompted to specify the location of eitherthe:• Aspen License Server

or• Aspen license file

Checking installationaccount privileges

Windows NT

Windows 2000

Licensing


The Aspen License Manager 3.0 provides two types of licensing:• Floating license• Node-locked licenseThe floating license works in a network configuration where theLicense Server runs on one of the Windows computers in yournetwork and serves licenses to licensed products running on anyPC in the network.

The node-locked license works with AES applications that run on asingle node. There are two types of node-locked licenses:• Counted• UncountedA counted node-locked license requires running the License Serverand the AES application on the same computer.

An uncounted node-locked license can be used with an AESapplication that is licensed for unlimited users and does not requirethe License Server. With this type of licensing, you must point tothe location of the Aspen License file. The license file and the AESapplication must reside on the same machine.

For more information on installing and configuring the LicenseManager at your site, see Aspen License Manager Version 3.0Installation and Reference Manual for Windows Platforms.

Consider the following compatibility issues related to AES productlicensing:• AES 11.1 products are not compatible with Aspen License

Manager (ALM) 2.2 or earlier.To run versions of AES products prior to AES 11.1, you mustuse ALM 2.2 or earlier; to run AES 11.1 products you must useALM 3.0 or higher. Different versions of the Aspen LicenseManager can coexist, each serving licenses to the appropriateproduct versions.

• Superpro dongles supplied with ALM 2.2 or earlier are notcompatible with ALM 3.0.Superpro dongles can not be piggybacked. If you are usingSuperpro dongles for ALM 2.2 or earlier and ALM 3.0 or later,the corresponding License Manager servers must run onseparate machines.

About Aspen LicenseManager

Compatibility


Installation Configuration OptionsAspen Engineering products may be installed in the followingconfigurations:

Installs all files to the local hard drive of a computer. Thecomputer may be a:• Stand-alone or networked user PC with enough space and

power on the local drive to store and run the installed AESproducts.

• File server in a lite-client configuration.• Client PC in a client-server configuration.

You can install any AES product this way.

For detailed installation instructions, see Chapter 3, StandardInstallation.

File Server

User PC/Workstation

Installs almost all files on a file server. When a user runs theapplication, files are copied into memory on the userPC/workstation and the program runs on the client.

For detailed installation instructions, see Chapter 4, Lite ClientInstallation.

Note: Only a system administrator should perform this type ofinstallation.

Server runningWndowsNT orWindows 2000

User PC/Workstation

Although all files reside on the computer where they are used,processing is split between the user PCs (clients) and a centralserver. Products supporting this configuration usually put thecomputing intensive or main data processing activities on theserver machine.

For detailed installation instructions, see Chapter 5, Client -Server Installation.


Standard

Lite Client

Client-Server


The following table summarizes the valid installationconfiguration options for each AES product.

Installation Options

AES ProductStandard

LiteClient

Client-Server

Aspen ADSIM X X XAspen B-JAC X XAspen Chromatography X X XAspen Custom Modeler X X XAspen Dynamics X X XAspen Icarus X XAspen OLI XAspen OnLine X XAspen PEP Process Library XAspen Pinch X XAspen Plus X X XAspen Plus Online X XAspen Properties X X XAspen Split XAspen Traflow X XAspen Utilities X XAspen Water X X XAspen WebModels Author XAspen WebModels Server XAspen Zyqad X X XBatch Plus X XPolymers Plus X X X

Note: Aspen Zyqad is normally installed in a client-serverconfiguration for project deployment.

Valid configurationoptions for AESproducts

Installation Manual_Aspen Engineering Suite 11.1 Standard Installation •••• 3-1

C H A P T E R 3

Standard Installation

This chapter provides instructions for installing this version ofAspen Engineering Suite products for the first time, using theStandard installation option.

Note: If you are upgrading an AES product, see Chapter 6,Upgrading AES Products.

OverviewThe Standard installation option installs all AES productcomponents on a single computer.

The following flowchart summarizes the standard installationprocess:

Complete steps in“Before You Begin.”

Complete steps in“After you Install.”

Review the pre-installation checklist

InsertAspen CDin CD drive

Follow on-screeninstructions

Restart yourcomputer

Install AES Products

Configurelicensing

Verify theproductinstallations

Configureinstalledproducts

Legend denotes substep

3-2 •••• Standard Installation Installation Manual_Aspen Engineering Suite 11.1

Before You BeginReview the General Pre-Installation Checklist on page 2-10 beforeyou begin the installation.If you are installing any of these products, review the installationnotes in their product chapters:

If you are installing See

Aspen Icarus Chapter 15, Aspen Icarus

Aspen OnLine Chapter 17, Aspen OnLine andAspen Plus Online

Aspen Zyqad Chapter 28, Aspen Zyqad

Batch Plus Chapter 29, Batch Plus

Installing AES ProductsThe Aspen Engineering Suite Application/Product Software CDset is self-contained and includes the AspenTech Master Installer.This version of the AES Application Products has two installationCDs:• CD1 contains Core components• CD2 contains Product componentsYou begin the installation with CD1. A setup program promptsyou for information required to install AES products. After thecore components are installed, you are prompted to insert CD2 toinstall the product components.

Note: You must follow the computer restarting instructions at theend of each product installation.

To perform a Standard installation of Aspen Engineering Suiteproducts:1 Insert the Aspen Engineering Suite CD1 (Core CD) into the

CD-ROM Drive.

Note: If the installation does not start automatically, click Start |Run. In the Run dialog box type <drive>:\setup (where<drive> is the drive letter assigned to your CD-ROM drive), andclick OK.

Aspen EngineeringSuite Application /Product CD


2 When the AspenTech screen appears, click ONCE on theAspen Engineering Suite button to start the installation.

The AspenTech Software Setup window appears.3 On the Welcome dialog box, click Next to continue.

4 On the Software Selection Availability dialog box, selectwhether to install licensed products only (default) or allproducts.

If you select Licensed products only, specify the name ofyour license server, or use the Browse button to locate thelicense file.

Software SelectionAvailability


Note: If you select All Products, you could install software thatwill not run until properly licensed. Some products can not beinstalled until proof of licensing is provided by an AspenLicense Manager.

Click Next to continue.5 On the Software License Agreement dialog box, read the

agreement, then click Yes to agree to the terms of the noticeand continue.

6 On the Computer Configuration Type dialog box, click theStandard Install button to install the AES product software ona single computer.

7 On the Choose Destination Location dialog box, specify theroot destination directory under which all AspenTech productsfor this software version will be installed on this computer. Thedefault is:

C:\Program Files\AspenTechTo specify a different AspenTech destination, click the Browsebutton. In the dialog box select or specify the pathname andclick Open. If a dialog box appears prompting you forpermission to create the folder, click Yes.

Note: This dialog box, prompting you for the AspenTech folderlocation only appears the first time you install AspenTech productsfor this version on this computer.

ComputerConfiguration Type

Choose DestinationLocation

Specifying the rootdestination directory forAspen productinstallations


Once the installation of any AspenTech product has beencompleted for this software version on this computer, youcannot change the location of the AspenTech folder.Click Next to continue.

8 On the Choose Destination Location dialog box, specify theWorking Folders location for the AES products. The default is:

C:\Program Files\AspenTech\Working FoldersTo specify a different Working Folders location, click theBrowse button. In the dialog box select or specify thepathname and click Open. If a dialog box appears promptingyou for permission to create the folder, click Yes.Click Next to continue.

9 On the Select Products dialog box, select the AES productsyou want to install on the computer. Then click Next tocontinue.

Note: Aerotran, Hetran (includes Qchex, Props, Metals), andTeams (includes Ensea, Teamsc) are the Aspen B-JAC products.

The options selected on the Software Selection Availabilityand Computer Configuration Type dialog boxes determinethe list of products available on the Select Products dialogbox, as follows:• Licensed products only

Unlicensed products are shaded and are unavailable forinstallation.

Specifying the WorkingFolders location forAspen Products

Select Products /Subcomponents


• All productsRestricted products requiring evidence of licensing from anALM server are shaded.

• Standard, Server, or Lite Client InstallationOnly the products that support the selected installationoption are listed.

Icons provide additional product information:

Icon Description

The key icon indicates that the product or subcomponentis licensed.The lock icon indicates that the product or subcomponentis restricted and can only be installed if an ALM serverprovides evidence of licensing.

The OS icon indicates that the product or subcomponentis not applicable to the operating system of this computerThe drive icon indicates that the product is alreadyinstalled on this computer.

When you select a product, all subcomponents are usuallyselected by default. A gray checkbox indicates that selectedproduct has an optional subcomponent that you must selectexplicitly.

The following table lists the AES products/options that havesubcomponents. An asterisk (*) indicates an optionalsubcomponent.

AES Product/Option Subcomponents

Aspen Pinch • Pro/II Interface*

Aspen Plus • Simulation Engine• User Interface• core Properties System for Aspen

Plus (APrSystem)

Aspen Plus Online • Aspen Plus Online User Interface• Aspen Plus Online Engine Standard

Aspen Properties • Aspen Properties CalculationEngine

• Aspen Properties User Interface• core Properties System for Aspen

Properties (APrSystem)

SelectingSubcomponents


AES Product/Option Subcomponents

Aspen Split • Stand-Alone Configuration• Distillation Analysis Components

Aspen Zyqad • Aspen Zyqad Server• Aspen Zyqad Client• Development Application• Excel Datasheet Definer• Sample Projects Library Source

Files• Datasheet Viewer Installer

Note: Aspen Zyqad has multi-level subcomponents. Fordetails, see Chapter 28, Aspen Zyqad.

Polymers Plus • Polymers Plus Steady State• Polymers Plus Dynamics*• Polymers Plus for Aspen

Properties** Optional subcomponent

To specify the installation of a specific product subcomponent:• Select the product and click Select Subcomponents.• In the Select Subcomponents dialog box, select or clear

the appropriate checkboxes and then click OK to return tothe Select Products dialog box.

When selecting Aspen Zyqad subcomponents, you may need toclick OK more than once to return to the Select Productsdialog box.

As you select the products to install, the space available on thetarget drive and the space required to install the products aredisplayed at the bottom of the dialog box.For a selected product, you can change the default destinationlocation of its product directory. Additionally, you can changethe default destination location of product subcomponents.To change the destination location of a selected AES productor subcomponent, click Change Folders and select the newlocation.

Changing product /subcomponent folders


Note the following product restrictions:Product Restriction

Aspen ADSIMAspen ChromatographyAspen Custom ModelerAspen DynamicsAspen TraflowAspen Water

The product directories for theseapplications must be installedbelow the same root destination.For example: D:\ProgramFiles\AspenTech

Aspen Icarus The Aspen Icarus productdirectory must be installed nodeeper than the third level of thedirectory structure. For example:D:\Program Files\AspenTech\Aspen Icarus 11.1

When finished, click OK to return to the SelectComponents/Subcomponents dialog box.

Depending on the products you are installing, additional dialogboxes appear, prompting you for product-specific information.If you are installing You are prompted for

Aspen OnLine The CIM-IO core security settings.For details, see Chapter 17, AspenOnLine and Aspen Plus Online.

Aspen Zyqad The Broker connection, verificationof the Broker and Server settings,location of optional subcomponentsand the Sample Project users. Fordetails, see Chapter 28, Aspen Zyqad.

Batch Plus The Batch Plus server information.For details, see Chapter 29, BatchPlus.

10 On the Select Program Folder dialog box, select or name aProgram Folder to contain the program icons for the installedproducts, and click Next to continue.

11 If you are a Plantelligence & Enterprise Optimization licensee,you are prompted for additional information. For instructions,see “Using Plantelligence & Enterprise OptimizationSolutions” on page 3-11.

Configure AESproduct components

Select ProgramFolder

Plantelligence &EnterpriseOptimization Users


12 On the Summary dialog box, review your selected installationoptions and do the following:• To modify any selected option, click the Back button to the

appropriate dialog box and make the changes.• To complete the installation, click the Start Installing

button.

Use this option for subsequent installations of AES products toensure that all core components are installed. When this option isunchecked, any existing core components are not reinstalled. Formore information, see Chapter 7, Adding or ReinstallingComponents.

After the common core components are installed, the SetupNeeds the Next Disk dialog box appears, prompting you toinsert CD2, the Product CD for Aspen Engineering Suite.

13 Remove CD1 and insert CD2 into the drive and then click OKon the dialog box.

14 When the Setup Complete dialog box appears, select Yes, Iwant to restart my computer now.

15 Remove the CD from the drive, and then click Finish on thedialog box.

16 On the AspenTech Software Setup dialog box, click OK.The system shuts down and reboots.

Installation Summary

Forcing the installation ofcore components

Setup Needs NextDisk

Setup Complete


17 When the system restarts, the Aspen License Selector basedon FLEXlm dialog box appears.

The Combined section displays the license server or file youspecified on the Software Selection Availability dialog box.

18 Verify or select the license scheme and click OK.

Note: If you selected to have All Products available forinstallation on the Software Selection Availability dialog box,you must specify a license method for installed AspenTechproducts before you can use them. For more information, see“Selecting or Changing the Licensing Method,” on page 3-15.

Aspen LicenseSelector


Configuring Installed AES ProductsAfter installation is complete, the following AES products requireadditional configuration.AES Product Notes

Aspen B-JAC If you are using HASP key licensing, seeAppendix A – HASP Key Licensing.

Aspen PlusAspen Properties

If you are using DETHERM, see AppendixB – Using the DETHERM Database.

Aspen OnLine Configure the Aspen OnLine Server andClient. For instructions, see Chapter 17,Aspen OnLine and Aspen Plus Online.

Aspen WebModelsAuthor

Configure the Aspen Framework Authorrole and enable ActveX-related securitysettings for Internet Explorer. Forinstructions, see Chapter 26, AspenWebModels Author.

Aspen Zyqad Log on as Administrator and configureAspen Zyqad. For instructions, seeChapter 28, Aspen Zyqad.

Batch Plus If you did not select the Batch Plus serverduring the installation, use the BPSync.exetool to configure a connection to the server.For instructions, see Chapter 29, BatchPlus.

Using Plantelligence & EnterpriseOptimization SolutionsAll AES products are Plantelligence & Enterprise Optimizationenabled. Plantelligence & Enterprise Optimization solutionsrequire the Aspen Framework (AFW) server.

During the installation setup, you are prompted for the AspenFramework Server if:• you are a Plantelligence & Enterprise Optimization solutions

licensee, and• you chose the Licensed products only option on the Software

Selection Availability dialog box.


Typically, a single computer is used for the AFW servercomponents. However it is possible to split the components amongas many as three different computers.

Contact your system administrator for the name of the AFW serverand, if necessary, the server location of the Business ProcessExplorer (BPE), Aspen Framework security, and AspenFramework file repository.

The first time you install an AspenTech product on this computer,the Select Aspen Framework Server dialog box appears,prompting to you to choose one of three options.

To use AES products as Plantelligence & Enterprise Optimizationsolutions:1 Specify the name of the Aspen Framework Server.2 Do one of the following:

• If all Aspen Framework components are located on a singleserver, click Next.

• If any Aspen Framework components are located on adifferent server, click the Advanced button and go tostep 3.

3 In the Framework Server Advanced Configuration dialogbox, select Advanced Settings and enter the followinginformation:

BPE Server Name The name of the server on whichBusiness Process Explorer is installed.

Select AspenFramework Server

Specifying the AspenFramework Server


Security ServerName

The name of the server on which AspenFramework (AFW) is installed.

Repository ServerName

The name of the server on which theAspen Framework file repository islocated.

Click OK and then click Next in the Select AspenFramework Server dialog box.

If you select the I will select an Aspen Framework Server lateroption, you will be prompted for the name of the server with thefirst use of a Plantelligence & Enterprise Optimization solution.

To specify the Aspen Framework Server after completing theinstallation, see “Specifying or Changing the AFW Server” onpage 3-16.

If you select the I do not wish to use an Aspen FrameworkServer option, the products will run as they did prior toPlantelligence & Enterprise Optimization.

Note: Select this option if you are installing only one product.

Selecting the AFWServer later

Choosing not to use anAFW Server


If you select the I do not wish to use a Aspen Framework Serveroption, any subsequent installs will detect the non-use ofPlantelligence & Enterprise Optimization capabilities, and displaythe Plantelligence / Enterprise Optimization Operation dialogbox.

Select the desired option and click Next to continue.

If you select Yes, the Select Aspen Framework Server dialogbox appears, prompting you for the name of the AFW server. Forinstructions, see “Select Aspen Framework Server” on page 3-12.

Plantelligence /EnterpriseOptimizationOperation

Running the products asPlantelligence/EnterpriseOptimization solutions


The Aspen Framework Server dialog box appears, displayingthose products that are currently installed as stand-alone products.If you click Next, the listed products will run as Plantelligence &Enterprise Optimization solutions.

Note: You can change the Aspen Framework Server aftercompleting the installation. For instructions, see “Specifying orChanging the AFW Server” on page 3-16.

Selecting or Changing the LicensingMethodIf you did not select a licensing method when prompted during theinstallation setup, you need to select a licensing method before youcan run the installed product.

You can change the licensing method used for any Aspen suiteproduct after you have finished the installation.

For the type and location of the Aspen license manager for yourinstallation, see your system administrator.

For information on Aspen license management, see the AspenLicense Manager Version 3.0 Installation and Reference Manualfor Windows Platforms.

Aspen FrameworkServer


To select or change the licensing method:1 On the desktop click Start | Programs | AspenTech |

Common Utilities | FLEXlm License Management Selector.The Aspen License Selector based on FLEXlm dialog boxappears, for example:

2 Select the license scheme that is valid for your installation ofAspenTech products and specify the required information.For specific information, see your system administrator.

3 Click OK.

Specifying or Changing the AFWServerIf you wish to specify or change the name of the Aspen Frameworkserver after the installation, you must download and install theAspen Framework Switch Utility from the AspenTech SupportWeb site:


For more information about this utility, see the Aspen FrameworkSwitch Utility Readme file posted on the website.



Verifying the InstallationFor instructions on verifying the installation of Aspen EngineeringSuite products, see the individual product chapters.

Installation Manual_Aspen Engineering Suite 11.1 Lite Client Installation •••• 4-1

C H A P T E R 4

Lite Client Installation

This chapter provides instructions for installing Aspen EngineeringSuite products for the first time, using the Lite Client installationoption.


Overview

FileServer

User PC

In a lite-client installation of AES products, most of a product’ssoftware is installed on a file server. When using the product,files are copied into memory on the networked user PC and theprogram runs locally on the PC.

The advantages of this type of installation are:

• The amount of software physically installed on the user PC isreduced.

• When you perform upgrades or any other maintenanceoperations, you need only do this on the file server.

However, this type of installation can result in slower softwareperformance.

Note: Only system administrators should perform this type ofinstallation.

The following AES products support the lite client installationoption:• Aspen ADSIM• Aspen B-JAC• Aspen Chromatography

4-2 •••• Lite Client Installation Installation Manual_Aspen Engineering Suite 11.1

• Aspen Custom Modeler• Aspen Dynamics• Aspen Icarus• Aspen Pinch• Aspen Plus• Aspen Properties• Aspen Split• Aspen Traflow• Aspen Utilities• Aspen Water• Aspen Zyqad• Polymers PlusThe following flowchart summarizes the lite-client installationprocess:




Configurelicensing

Verify theinstallation onfile server anduser PCs

Configureproducts


Set upshareddrive/folder

Insert CD in CDdrive and followinstructions forStandard installoption

Restart thefile server

Install AES Productson file server

Map toshareddrive/folder

Restart userPCInstall AES Products

on User PC

Insert CD in CDdrive and followinstructions forLite Client installoption


Before You BeginBefore you begin the installation process:• Review the General Pre-Installation Checklist on page 2-10.• Identify a shared drive or folder on the file server that will

contain the AES product.• Select a drive letter that will be used for the mapped

connection from each user PC to the file server.• Ensure that the account used for the installation to the file

server has read/write privileges on the server.• If a remote PC is used to install to the file server, make a note

of which PC was used. This same PC must be used whenremoving or updating the file server installation.


Aspen Icarus Chapter 15, Aspen Icarus


Note: Aspen Zyqad is normally installed in a client-serverconfiguration for project deployment.

Lite Client Installation SummaryThe following table summarizes the steps for installing AESproducts in a lite client network configuration.

StepFor details,see

1 On the file server machine, create a shareddrive/folder.

2 Perform a Standard installation of AESproducts on the file server, where the shareddrive/folder is the destination directory for theinstalled software.

page 3-2

3 On each user PC, map the same local driveletter to the shared drive on the file server.

4 Perform a Lite Client installation of the AESproducts on each user PC, to install theminimum files needed to run the software.

page 4-4

5 Verify your installation on the file server andon the user PCs.

page 4-13


Installing AES Software on a FileServerTo install Aspen Engineering Suite products on the file server:1 On the file server, create a shared drive/folder as the root

destination location for the installed AES software.Remember to share the relevant drive or folder so that thesoftware is accessible to the user PCs.

2 Perform a Standard installation on the file server.The following products must be installed below the same rootdestination folder on the shared disk:• Aspen ADSIM• Aspen Chromatography• Aspen Custom Modeler• Aspen Dynamics• Aspen Utilities• Aspen Water

For detailed instructions, see Chapter 3, Standard Installation.

Installing AES Software on User PCsAfter you have completed the standard installation of AESproducts on the file server, you can set up one or more user PCs toaccess this installation and perform a Lite Client installation oneach user PC. The Lite Client installs only the DLLs, sharedlibraries, and Registry entries of the selected AES products on theuser PC.

Note: You must perform the standard installation of an AESproduct on the file server before you perform a lite-clientinstallation of the same product on the user PC.

To perform a lite client installation on user PCs:1 On each user PC, the same drive letter to the shared folder on

the file server that contains the AES installation.

2 Insert the Aspen Engineering Suite Application/ProductSoftware CD into the CD-ROM drive.

Map network drive




3 On the AspenTech screen, click ONCE on the AspenEngineering Suite button to start the installation.




If you select Licensed products only, specify the name ofyour license server, or use the Browse button to locate thelicense file.

Note: If you select All Products, you could be installingunlicensed software that will not run until properly licensed.Some products will not allow their installations until proof oflicensing is provided by an Aspen License Manager.

Click Next to continue.6 When the Software License Agreement dialog box appears,

read the agreement, then click Yes to agree to the terms of thenotice and continue.



7 On the Computer Configuration Type dialog box, click LiteClient Install to install AES product software on a file servermachine.











10 On the Select Products dialog box, select the AES productsyou want to install on the computer.









Icon Description


The OS icon indicates that the product or subcomponent isnot applicable to the operating system of this computer.The drive icon indicates that the product is alreadyinstalled on this computer.

To change the subcomponents installed with a product, selectthe product and click Select Subcomponents. Select or clearthe appropriate checkboxes in the Select Subcomponentsdialog box and then click OK to return to the Select Productsdialog box.

As you select the products to install, the space available on thetarget drive and the space required to install the products aredisplayed at the bottom of the dialog box.Depending on the product selected, you can change either itsWorking Folders directory location or its top-level productdirectory location. Additionally, you may be able to change thedefault location of specific subcomponents.Note the following product restrictions:Product Restriction


These products must be installedbelow the same root destination.

Aspen Icarus The Aspen Icarus directory must beinstalled no deeper than the thirdlevel of the directory structure. Forexample: d:\Program Files\AspenTech\Aspen Icarus 11.1

To change the location of the product installation for a selectedAES product, click Change Folders and select the newlocation. Then click Next to continue.


Changing Product folders


11 Depending on the products you are installing, dialog boxesappear, prompting you for the file server location of theproduct’s components. Specify the location on the mapped fileserver, and then click Next to continue.The following examples assume this mapped location on theuser PC:

K:\AspenTech.

Specify the common root destination directory under whichany if these products must be located. For example: K:\AspenTech\

Specify the location of the product folder, for example: K:\AspenTech\Aspen B-JAC 11.1

Specify the destination directory, for example: K:\AspenTech\Aspen Icarus 11.1

• Specify the location of the user interface, for example: K:\AspenTech\Aspen Plus 11.1\GUI\xeq\apwn.exe• Specify the location of the simulation engine, for example: K:\AspenTech\Aspen Plus 11.1\Engine\xeq\aspen.exe

• Specify the location of the user interface, for example: K:\AspenTech\Aspen Properties 11.1\ xeq\AspenProperties.exe• Specify the location of the calculation engine, for example: K:\AspenTech\Aspen Properties 11.1\ Engine\xeq\Apmain.exe

• Specify the location of the product folder, for example: K:\AspenTech\Aspen Zyqad 11.1• An additional dialog box prompts for the Aspen Zyqad

Broker host and port connection.• (Optional)Specify the location of the ProVision

configuration and schema definition files.

For details, see Chapter 28, Aspen Zyqad.

Specifying the FileServer location ofcomponents


Aspen B-JAC

Aspen Icarus

Aspen Plus

Aspen Properties

Aspen Zyqad



13 If you are a Plantelligence & Enterprise Optimization licensee,you will be prompted for additional information.For instructions, see “Using Plantelligence & EnterpriseOptimization Solutions” on page 3-11.

14 On the Summary dialog box, review the summary of yourselected installation options and do the following:• To modify any selected option, click the Back button to the


button.


The installation takes a few minutes, depending on the speed ofthe machine and the CD drive.

15 When the Setup Complete dialog box appears, select Yes, Iwant to restart my computer now. Then click Finish.






Setup Complete


Verifying the InstallationBefore you verify the AES products installed on the user PCs,ensure that:• The folder containing the AES installation on the network file

server is accessible to the user PCs.• Each user PC maps the same drive letter to the shared root

folder of installed AES products on the file server.

For instructions on verifying the installation of Aspen EngineeringSuite products, see the individual product chapters.

Installation Manual_Aspen Engineering Suite 11.1 Client - Server Installation •••• 5-1

C H A P T E R 5

Client - Server Installation

This chapter provides instructions for installing Aspen EngineeringSuite products in a client-server installation configuration.


Overview

Server runningWndowsNT orWindows 2000

User PC/Workstation

A client-server installation of AES products takes advantage ofusing a powerful server computer to perform calculations andvarious data-processing activities.

The Server installation option enables you to install AESsimulation and calculation engines on a server computer for useby user PCs running AES product software.

A alternate option exists which provides both the performanceadvantages of a client-server installation and the space-savingadvantages of a lite-client installation. For more information see“Combining Server and Lite Client Install Options” on page 5-26.


The following AES products support the Server installation option:• Aspen ADSIM• Aspen Chromatography• Aspen Custom Modeler• Aspen Dynamics• Aspen OnLine

5-2 •••• Client - Server Installation Installation Manual_Aspen Engineering Suite 11.1

• Aspen Plus• Aspen Properties• Aspen Utilities• Aspen Water• Aspen WebModels Server• Aspen Zyqad• Batch Plus• Polymers PlusThe following flowchart summarizes the client-server installationprocess:




Configurelicensing

Verify theinstallation onfile server anduser PCs

Configureproducts


Configureserver foruser PCcalculations

Insert CD in CDdrive and followinstructions forServer installoption

Restart theserver

Install AES Productson application server

ConfigureUser PC touse Server

Restart userPCInstall AES Products

on User PC

Insert CD in CDdrive and followinstructions forStandard installoption


Before You BeginBefore you begin the installation process:• Review the “General Pre-Installation Checklist” on page 2-10.• Because several users may be running a calculation engine on

the server simultaneously, ensure the server machine hasappropriate resources. For guidelines see “AES SystemRequirements” on page 2-3.

• Make sure the server and client machines use TCP/IPcommunication and have the appropriate network access inboth directions.

• Make sure the server and the user PCs have the proper nameresolution present so that the user PCs recognize the servername entered at run time.

• Ensure that the users of AES products have Windows accountsthat are valid on the application server.

If you are installing any of these products, review the installationnotes in their product chapters:



Aspen WebModels Server Chapter 27, Aspen WebModelsServer


Batch Plus Chapter 29, Batch Plus


Client-Server Installation SummaryThe following table summarizes the steps for installing AESproducts for a client-server network configuration.

StepFor details,see

1 On the server machine, perform the Serverinstallation to install AES server components.

page 5-4

2 Configure the server to perform calculationsand data-processing activities for the user PCs.

page 5-12

3 On each user PC, perform a Standardinstallation of AES products.

page 3-2

4 Configure the user PCs to use the remoteserver.

page 5-19

5 Verify communications between the server andthe user PCs.

page 5-25


Installing AES Software on a ServerNote: You must install any of the following products on the sameserver machine and specify the same working folder asAspen Plus:

Aspen ADSIM Aspen Chromatography Aspen Custom Modeler Aspen Dynamics Aspen Water

This ensures that these products can find the .appdf file containingthe physical property configuration, when using Aspen Plus/AspenProperties for physical property calculations.


To install AES server software on the server machine:1 Insert the Aspen Engineering Suite CD1 (Core CD) into the

CD-ROM Drive.


2 When the AspenTech screen appears, click the AspenEngineering Suite button to start the installation.





If you select Licensed products only, specify the name ofyour Aspen License Manager (ALM) license server, or use theBrowse button to locate the ALM license file.

Note: If you select All Products, you could be installing unlicensedsoftware that will not run until properly licensed. Some productswill not allow their installations until proof of licensing is providedby an Aspen License Manager.

Click Next to continue.5 When the Software License Agreement dialog box appears,

read the agreement, then click Yes to agree to the terms of thenotice and continue.



6 On the Computer Configuration Type dialog box, clickServer Install to install the AES product software on theserver machine.











9 On the Select Products dialog box, select the AES productsyou want to install on the computer. Then click Next tocontinue.









Icon Description


The OS icon indicates that the product or subcomponentis not applicable to the operating system of this computerThe drive icon indicates that the product is alreadyinstalled on this computer.

When you select a product, its subcomponents are selected bydefault. The following table lists the AES productsubcomponents that you can install on a server machine.

AES Product Subcomponents

Aspen Properties • Calculation Engine• Core Properties System for Aspen

Properties (APrSystem)

Aspen Plus • Simulation Engine• Core Properties System for Aspen

Plus (APrSystem)

Aspen Zyqad • Server, which has the followingsubcomponents:• Server• Broker• Sample Projects

Polymers Plus • Polymers Plus for Aspen Plus• Polymers Plus for Aspen

Properties

To install a specific subcomponent of a product, select theproduct and click Select Subcomponents.In the Select Subcomponents dialog box, select or clear theappropriate checkboxes and then click OK to return to theSelect Products dialog box.

As you select the products to install, the space available on thetarget drive and the space required to install the products aredisplayed at the bottom of the dialog box.



Changing the destinationlocation of a component


To change the destination location of a selected productcomponent or subcomponent, click Change Folders and selectthe new location.Click Next to continue.

Depending on the products you are installing, additional dialogboxes appear, prompting you for product-specific information.If you are installing You are prompted for

Aspen Zyqad the Broker connection, verification ofthe Broker and Server settings, and theSample Project users. For details, seeChapter 28, Aspen Zyqad.

Batch Plus the Batch Plus server information. Fordetails, see Chapter 29, Batch Plus.

10 Enter the required information and then click Next to continue.


12 If you are a Plantelligence & Enterprise Optimization licensee,you are prompted for additional information. For instructions,see “Using Plantelligence & Enterprise OptimizationSolutions” on page 3-11.

13 On the Summary dialog box, review the summary of yourselected installation options and do the following:• To modify any selected option, click the Back button to the


button.


Configure AESproduct components






After you click the Start Installing button, the following productsdisplay dialog boxes, prompting you for additional setupinformation.AES Product Required Setup Information


The Create SQL Server AspenFramework Database dialog box appears,prompting you for information to create theWebModels database. For detailedinstructions, see Chapter 27, AspenWebModels Server.

Batch Plus The Server Selection dialog box appears,prompting you for information to create theBatch Plus Server database tables andrecords. For detailed instructions, seeChapter 29, Batch Plus.

The installation takes a few minutes, depending on the speed ofthe machine and the CD drive.

14 When the Setup Complete dialog box appears, select Yes, Iwant to restart my computer now. Then click Finish.


Additional setupinformation for AESproducts

Setup Complete


Configuring a Windows Server as anAES HostAfter you complete the installation of the AES server componentson the server machine, you must configure the server as an AEShost.

Each user who will connect to the Windows NT/2000 server mustbelong to one of the following:• A local user account or group on the server• An account or group in the domain to which the server belongs• An account or group in a trusted domain.

Important: Each user account that connects to the server mustalso be granted Log on as a Batch Job access to the server.

The following sections provide detailed instructions forconfiguring user accounts on Windows NT. After you set up theaccounts and privileges, optimize the network applications.

To create local group and user accounts:1 On the desktop click Start | Programs | Administrative Tools

(Common) | User Manager.The User Manager window appears.

2 On the menu bar click User | New Local Group.3 On the New Local Group dialog box, enter a Group Name for

the local group, for example, Local1. Then click OK.4 On the menu bar click User | New User.

The New User dialog box appears.5 Enter the following information:

Username The name of the new user, for example,Local Aspen User.

PasswordConfirm Password

The password based on your localsecurity policy.

Select the Password Never Expires option.6 Click the Groups button.

The Group Memberships dialog box appears:7 In the Not member of list, select the name of the group you

created, for example, Local1, and click Add to add the group tothe Member of list. Then click OK.

8 Click OK to close the New User dialog box

Adding Windows NTServer Accounts

Creating Local Group andUser Accounts


9 Repeat Steps 4 through 8 to create/add more users to the group.10 When you finish adding users to the group, close the User

Manager.

After you have created new local group and user accounts, youmust grant access to the user PCs.

Each user account that connects to the server must be granted Logon as a Batch Job access to the server.

To grant access to the server for local users:1 On the desktop click Start | Programs | Administrative Tools

(Common) | User Manager.2 On the menu bar click Policies | User Rights.

The User Rights Policy dialog box appears.3 Select the Show Advanced User Rights option at the bottom

of the dialog box.4 From the Right list, select Log on as a Batch Job , and click

Add.The Add Users and Groups dialog box appears.

5 For List Names From, select your local NT server.6 In the Names list, select the users and groups you created and

click Add.

Tip: To view all user names for the selected domain, click ShowUsers.

7 Click OK to return to the User Rights Policy dialog box. Thenclick OK to close the dialog box.

8 Close the User Manager, and optimize the throughput for theWindows NT server.For instructions, see Optimizing Network Applications on page5-16.

To grant access to the Windows NT server for domain users ortrusted domain users:1 On the desktop click Start | Programs | Administrative Tools

(Common) | User Manager.2 On the menu bar click Policies | User Rights.

The User Rights Policy dialog box appears.3 Select the Show Advanced User Rights option at the bottom

of the dialog box.

Setting user rights

Granting server accessfor domain/trusteddomain users


4 From the Right list, select Log on as a Batch Job, and clickAdd.The Add Users and Groups dialog box appears.

5 For List Names From, select your domain or trusted domain.6 In the Names list, select the users and groups and click Add to

add users and groups to the primary domain controller.7 Click OK to return to the User Rights Policy dialog box. Then

click OK to close the dialog box.8 Close the User Manager, and optimize the throughput for the

Windows NT server.For instructions, see “Optimizing Network Applications” onpage 5-16.

The following sections provide detailed instructions forconfiguring user accounts on Windows 2000, using sample groups,accounts, and domains.

To create local group and user accounts:1 On the desktop click Start | Settings |Control Panel |

Administrative Tools | Computer Management.The Computer Management console appears.

2 In the console tree expand System Tools | Local users &Groups and click Groups.

3 On the Action menu click New Group.The New Group dialog box appears.

4 Enter a Group Name for the local group, for example, Local1.Then click Create.

5 In the console tree, select Users and on the Action menu, clickNew User.The New User dialog box appears.

6 Enter the following information:

Username The name of the new user.

PasswordConfirm Password

The password based on your localsecurity policy.

Select the Password Never Expires option.7 Click Create and close the dialog box.8 Double-click the new user you just created and in its

Properties dialog box and click the Members of tab.9 Click the Add button.

Adding Windows2000 Server Accounts

Creating Local Group andUser Accounts


10 Select the name of the group you created, for example, Local1,and click Add to add the group to the Member of list. Thenclick OK.

11 Click OK to close the Properties dialog box.12 Repeat Steps 4 through 11 to create/add more users to the

group.13 When you finish adding users to the group, close the Computer

Management console.

After you have created new local group and user accounts, youmust grant access to the user PCs.

Each user account that connects to the server must be granted Logon as a Batch Job access to the server.

To grant access to the server for local users:1 On the desktop click Start | Settings | Control Panel.2 Double-click Administrative Tools, and then double-click

Local Security Policy.3 Double-click Security Settings, double-click Local Policies,

and then double-click User Rights Assignment.4 Double-click the user right Logon as a Batch Job.5 Click Add, and then click the accounts to which you want to

assign the right.6 Click OK and then click OK again.7 Confirm that the changes have taken effect locally by closing

the Local Security Policy window and then re-opening it.

The newly assigned rights should appear under the EffectiveSettings columns.

Note: The procedure in this section applies only to Windows NTServer machines.

The throughput of your server can be optimized for networkapplications, such as the simulation engine, or for use as a fileserver. File server is the default configuration.

To optimize the throughput of your server:1 Click Start | Settings | Control Panel, and double-click

Network.2 In the Network dialog box, click the Services tab, and double-

click Server.

Setting user rights

Optimizing NetworkApplications


3 In the Server dialog box, select one of the following options:• Maximize Throughput for Network Applications to

optimize throughput for network applications.• Balance to balance the throughput for network applications

and for file services.4 Click OK.5 Restart your computer.You can now proceed with the installation on the user PCs.

Configuring Installed AES Productson the ServerWhen the installation process is complete, the following AESproducts require additional configuration:

If you installed See


Aspen WebModels Server Chapter 27, Aspen WebModelsServer


Verifying the Server InstallationAfter you have installed and configured the simulation serversoftware on the server for any Aspen Modeler System product,ensure that the installation is working correctly.

To verify the server installation:1 On the desktop of the server computer click Start | Run.2 Enter the following command:

pathname\sim_server.exeWhere pathname is the directory location of the productexecutable file.For example:“C:\Program Files\Common Files\AspenTech\AMSystem 11.1\bin\sim_server.exe”

Note: If your path contains spaces, as in the default path, enclosethe command in quotes, as in the example.

Aspen ADSIMAspen ChromatographyAspen Custom ModelerAspen DynamicsAspen UtilitiesAspen Water


3 Click OK:A message similar to the following indicates a successfulverification:sim_server.exe (Version 11.1) built on Apr 182001 at 17:40:23

If you encounter any other messages, see Chapter 9,Troubleshooting.

If you are performing a server installation, you do not need torestart the computer. However, you need to check that the AspenZyqad Broker and Server services have started.

To check the Broker and Server services:1 On the desktop,

Windows NT: Click Start | Settings | Control Panel. Double click theServices to display the Services dialog box.

Windows 2000: Click Start | Programs | Administrative Tools | Services.

2 Locate the Broker and Server services in the list.The defaults are Zyqad111Broker and Zyqad111Server.For both services:• Status should be Started• Startup set to Automatic

3 Click Close.

Installing AES Products on User PCsThe following table summarizes the steps for installing AESproducts on user PCs in a client-server network configuration.

StepFor details,see

1 On each user PC, perform a Standardinstallation of AES products..

page 3-2

2 Configure the user PCs to use the remoteserver.

page 5-19

Aspen Zyqad


Configuring Installed AES Productson User PCsBefore you can run AES simulation/calculation software installedon the server machine, you must specify the name of the server thefirst time you run the product from the user PC.

The following sections contain detailed instructions on specifyingthe remote server for AES products.

To specify a remote server from a user PC running AspenProperties:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Properties 11.1 | AspenProperties User Interface.

2 From the Aspen Properties menu bar click Tools | Options.3 On the Options dialog box, select the Run tab.

Specifying a RemoteServer

Aspen Properties


4 In the Remote server section, enter the following information:• Server type

Select Windows NT or 2000 server from the list.• Server name

Specify the name of the server running the calculationengine.

Note: Ensure the accuracy of both case and spelling of theserver name. The name is used to resolve the network addressof the computer and must be in a form recognizable to yourDomain Name Server.

• UsernameSpecify the user name of the user under whom thesimulation server software will run on the remote server.You must supply a name.

• Working directorySpecify the pathname of the root folder on the remotemachine where the run-time data, such as property data(.aprpdf), history, report and other files, will be stored. Forexample,

\My Simulations\UserName5 Click OK.

You are notified that you will have to restart Aspen Propertiesfor the changes you have made to take effect.

After restarting Aspen Properties, you can perform propertycalculations from your PC on the remote server you specified.

To specify a remote server from a user PC running Aspen Plus:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Plus 11.1 | Aspen Plus Interface.

Note: The Connect to Engine dialog box may appearautomatically.

2 On the Aspen Plus menu bar click Run | Connect to Engine.The Connect to Engine dialog box appears.

Aspen Plus


3 Change the Server Type to Windows NT or 2000 server.

4 Enter the following user information:• Node name of the server running the simulation engine• User name• User’s password• Appropriate working directory

Note: If you are using domain accounts, the Domain Name mustprecede the username. For example, MAGIC\potterh would be avalid login for the MAGIC domain.

5 Click OK to connect to the calculation server.If everything is configured correctly, the status bar should displayConnection Established.

To specify a remote server from a user PC running any of theAspen Modeler System products:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | AES product 11.1 | AES product.2 On the menu bar click Tools | Server Configuration.3 In the Server Configurations dialog box, click Add.



The Servers dialog box appears:

4 Specify a Current Configuration Name.This name can be the name of the computer where thesimulation server software will run, or it can be a name withmeaning to you only.

5 Click Add Host.The Host Properties dialog box appears.

6 Enter the following information:• Host Name

Specify the name of the server where the simulation serversoftware is installed.

Note: Ensure the accuracy of both case and spelling of theserver name. The name is used to resolve the network addressof the computer and must be in a form recognizable to yourDomain Name Server.

• Debugger NameIf you intend to debug the server process of the simulator,enter the command used to invoke the debugger.

• User NameSpecify the user name of the user under whom thesimulation server software will run on the remote server.You must supply a name.


• PasswordEnter the password for the user.If you prefer not to have the password stored by the system,you can leave this blank.

For example:

7 Click OK.8 In the Servers dialog box, select the name of the server you

just added as the Host Computer.For example:

Name of hostyou added


9 In the Configuration Properties section, specify thefollowing:• Working Folder

The pathname of the root folder on the remote machine,where run-time data, such as simulation snapshots and plotdata, will be stored. For example,C:\Program Files\AspenTech\Working Folders\AES ProductNote: Snapshots and plot data will be stored in folders ofthis working folder on the remote server machine.

• Executable FolderThe pathname of the folder where the simulator executablesare installed on the remote machine. For example:C:\Program Files\AspenTech\AMSystem 11.1\Bin

Optionally, select:• Prompt for Password, if you want the system to prompt

for the remote password rather than use the stored oneassociated with the host.

• Debug, if you have your own code linked into the serverand want to debug it. This is an advanced option and is notfor normal use.

10 Click OK to accept your changes and close the Servers dialogbox.

11 In the Server Configurations dialog box, click OK.You are notified that you will have to restart the AES productfor the changes you have made to take effect.

After you have restarted the AES product, you can run simulationsand/or calculations from your PC on the remote server youspecified.

To quickly verify that an installed product is using the remoteconfiguration you specified, look for the configuration name on thestatus bar, for example:

Name of remoteconfiguration

Checking the Status bar


Verifying Client – ServerCommunicationTo verify that the installation on the user PC is successfullycommunicating with the server running the AES simulation andcalculation server software:1 Ensure that you have successfully installed and configured the

software on both the server and on the user PC.2 If you have not already done so, restart the user PC.3 Verify the client-server communication for the installed AES

products, as described in this section.4 Verify the installation of AES products on the user PCs, using

verification procedures in the appropriate product tabs.

If you encounter any problems running any of these AES products,you can ensure that REXEC is working correctly on the user PC.To do this:

At the command prompt on the user PC, type:rexec MachineName pathname\sim_server.exeName (DomainName:UserName): UserNamePassword (DomainName:UserName):

For example, where the:• Machine name is Blue,• Path is C:\Program Files\AspenTech\AMSystem 11.1\bin,• Domain is aspen.com• UserName is Fredyou would type:rexec Blue C:\Program Files\AspenTech\AMSystem11.1\bin\sim_server.exeName(aspen.com:Fred): FredPassword (Blue:Fred):

A message similar to the following example indicates a successfulverification:sim_server.exe (Version 11.1) built on Apr 182001 at 17:40:23

If you encounter any other messages, see Chapter 9,Troubleshooting.



Combining Server and Lite ClientInstall OptionsTo provide both performance and space-saving advantages foryour AES products, you can combine the server-client installationdescribed in this chapter with the lite client-file server installationdescribed in Chapter 4.


To perform a combination lite-client and client-server installationof AES products:1 Do one of the following:

• Perform a Standard Installation on a server machine thatwill act as both application server and file server.

-or-• Perform a Standard Installation on a file server

andPerform a Server Installation on a separate applicationserver.

2 Configure the server to perform calculations for the user PCs.For instructions, see “Configuring a Windows Server as anAES Host,” on page 5-13.

3 On each user PC, map the same local drive letter to a shareddrive on the file server machine.

4 On each user PC, perform a Lite Client installation.5 Configure the user PCs to use the server.

For instructions, see “Configuring Installed AES Products onUser PCs” on page 5-19.

6 Verify your installation on the application/file servers and onthe user PCs.


The following table summarizes this procedure:

Machine Install Option Special Instructions

User PC Lite Client Configure the PC to use the AESserver components, as describedin “Configuring Installed AESProducts on User PCs” onpage 5-19.

File /ApplicationServer

Standard Create a shared drive for thelocation of the installed AESproducts, as described in“Installing AES Software on aFile Server” on page 4-4.

Configure the server to act asAES host, as described onpage 5-13.

File Server Standard None

ApplicationServer

Server Configure the server to act asAES host, as described onpage 5-13.

For example, if you are installing Aspen Plus on the user PCs in aclient-server configuration, you could decide to install only theuser interface subcomponent. After the installation is complete,start the Aspen Plus user interface on the user PC and specify theserver location of the Aspen Plus simulation engine.

To provide the user the option of running the simulation engineeither locally or remotely, install the simulation engine on the userPC, along with the user interface.

Installation Manual_Aspen Engineering Suite 11.1 Upgrading AES Products •••• 6-1

C H A P T E R 6

Upgrading AES Products

This chapter describes the procedures you should follow if you areupgrading previously installed Aspen Engineering Suite products.

OverviewThe following flowchart summarizes the process of upgradingAES products:

Complete steps inBefore You Upgrade

Save files in portableformats and in safelocations

Complete steps inAfter you Upgrade

Load/convert files fromprevious softwareversions

Remove anyremaining oldsoftware versions


Follow install instructionsfor appropriate siteconfiguration

Restart theserver

Install AES Products

If desired ornecessary, uninstallold version

6-2 •••• Upgrading AES Products Installation Manual_Aspen Engineering Suite 11.1

Before You UpgradeBefore you upgrade any existing AES product:• Create forward-compatible backups of your current projects

and store them in a safe location. Binary files are notcompatible across different versions of AES products.

• Create backups of any customizations you wish to retain andstore them in a safe location.

Note: When you remove the old version of the AES product, theproduct folder and all of its contents will be deleted.

Occasionally, a manual change is made to an application file to fixa specific problem. Such a change is referred to as a “hot fix.” If a“hot fix” has been made to any currently installed AES application,you must uninstall the application before installing any servicepack or upgrade.

The following table summarizes the tasks you should perform toprepare for an Aspen software upgrade. An asterisk (*) indicatesthe recommendation that you keep the previous version on yourmachine until you are satisfied with the installation of the newversion, if there is sufficient disk space.

Before youupgrade Do this

Aspen Properties Create backup (.aprbkp) file versions for forwardcompatibility and store them in a safe location.

Aspen OLI* Save copies of project files to a safe location.You must convert any databanks created beforeOLI Version 6.0 to the new format.For instructions, see “Updating Aspen OLI” onpage 6-5.

Aspen Plus Create backup (.bkp and .apmbd) file versions forforward compatibility and store them in a safelocation.

Aspen CustomModeler*

Create language (.acmf) file versions for forwardcompatibility and store them in a safe location.

Aspen Dynamics* Create language (.dynf) file versions for forwardcompatibility and store them in a safe location.

Product UpgradeTask Summary


Before youupgrade Do this

Aspen OnLine Remove the older version of Aspen OnLinebefore you install the new version.


Remove the older version of WebModels Serverbefore you install the new version.

Aspen B-JAC* Save copies of project files to a safe location.

Aspen Pinch Save copies of project files to a safe location.

Aspen Water* Create language (.awf ) file versions for forwardcompatibility and store them in a safe location.

Aspen ADSIM* Create language (.ada) file versions for forwardcompatibility and store them in a safe location.

AspenChromatography*

Create language (.cra) file versions for forwardcompatibility and store them in a safe location.

Batch Plus* Create a backup of project files and store them ina safe location. After you install the latestversion, update the existing project files. Forinstructions, see “Batch Plus Project Files” onpage 6-4.

Upgrading AES ProductsTo upgrade any AES product:1 If desired or necessary (due to disk space or compatibility

limitations), remove old versions of AES products.

Note: You must remove the old version of Aspen OnLine beforeyou install the new version.

For instructions, see Chapter 8, Removing AES Products.2 Install new products.

Depending on your site configuration, see the followingchapters for instructions:• Chapter 3, Standard Installation• Chapter 4, Lite Client Installation• Chapter 5, Client- Server Installation


3 On the Summary dialog box select the Force the installationof all core components checkbox to ensure that all AspenTechcore components are installed on the target computer.

4 Verify the new product installations.For instructions, see the appropriate AES product tab.

After You UpgradeStart the new version of the installed AES product and open thesaved files to make sure they work properly in the new version.If you are upgrading See

Batch Plus “Batch Plus Project Files” on page 6-4

Aspen OLI “Updating Aspen OLI” on page 6-5

After you are satisfied that the new version of the AES product isworking correctly, uninstall the old version, if necessary. Forinstructions, see Chapter 8, Removing AES Products.

Batch Plus automatically updates previously created projects to aformat compatible with new versions.

To convert existing projects to a format compatible with the newversion of Batch Plus:1 After you install the new version of Batch Plus, start Batch

Plus.2 Open an existing project.

A message box should appear indicating that the project isbeing converted to the new version.The conversion process may take some time. Please be patient.

3 When the conversion is complete, verify that your projectshave been successfully converted and that your simulationresults are accurate.

4 Now you can uninstall the previous version of Batch Plus andremove your project backup files.

Batch Plus ProjectFiles


You must convert any databanks created before Aspen OLIVersion 6.0 to the new format.

Note: The conversion does not make a copy of your olddatabank. If you would like a backup copy, save a copy to aseparate folder prior to the conversion.

To convert Aspen OLI databanks to the new format:1 In Aspen OLI, highlight the databank of interest on the

Opening Which Databook dialog box.2 Click Utility Action and select Convert DOS database to

Windows database.3 Verify that your databank projects have been successfully

converted and that your results are accurate.4 After all databank projects have been successfully converted,

uninstall the previous version of Aspen OLI.

Updating Aspen OLI

Installation Manual_Aspen Engineering Suite 11.1 Adding or Reinstalling Components •••• 7-1

C H A P T E R 7

Adding or ReinstallingComponents

This chapter provides instructions for adding or reinstallingcomponents to AES product installations. To remove products, seeChapter 8, Removing AES Products

OverviewThe following flowchart summarizes the process ofadding/reinstalling AES products:

Complete steps inBefore You

Add/Reinstall AESComponents

Review the pre-installationrequirements

Complete steps inAfter youAdd/Reinstall AESComponents

Configure installedproducts

Verify productinstallation


Insert CD in CD driveand clickInstall/Reinstall

Restart thecomputer

Add/Reinstall AESComponents

Back upcustomizations

7-2 •••• Adding or Reinstalling Components Installation Manual_Aspen Engineering Suite 11.1

Before You Add or ReinstallComponentsReview the General Pre-Installation Checklist on page 2-10 beforeyou begin the installation.

Depending on your site configuration, see the appropriate BeforeYou Begin section in the chapter of the corresponding installationconfiguration:

• Chapter 3, Standard Installation• Chapter 4, Lite Client Installation• Chapter 5, Client - Server InstallationIf you are reinstalling components, be sure to back up anycustomizations you want to retain.

Adding or Reinstalling ComponentsBy default the master installer does not reinstall existing corecomponents. There is an option on the Summary dialog box,which when selected, forces the re-installation of all corecomponents.

In summary, to add or reinstall AES components:• Insert the AES Application/Product CD in the CD-ROM drive

and click the Aspen Engineering Suite button on theAspenTech screen.

• On the Add/Remove Software dialog box, click theInstall/Reinstall/Upgrade AspenTech Software button.

• On the Select Products and Select Subcomponents dialogboxes, select only the products or subcomponents you want toadd or reinstall.

• On the Summary dialog box select the Force the installationof all core components checkbox to reinstall all AspenTechcore components on the target computer.

Note: If this option is not selected and the installer detects anyexisting core components, those core components are notreinstalled.

Installation Manual_Aspen Engineering Suite 11.1 Adding or Reinstalling Components •••• 7-3

Depending on your site configuration, see the following chaptersfor complete instructions:• Chapter 3, Standard Installation• Chapter 4, Lite Client Installation• Chapter 5, Client- Server Installation

After You Add or ReinstallComponentsDepending on your site configuration, see the appropriateConfiguring the Installed AES Products sections in the chaptercorresponding to the installation type:

• Chapter 3, Standard Installation• Chapter 4, Lite Client Installation• Chapter 5, Client - Server Installation

Verify the InstallationFor instructions on verifying the installation of specific AESproducts, see the appropriate product tab.

7-4 •••• Adding or Reinstalling Components Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Removing AES Products •••• 8-1

C H A P T E R 8

Removing AES Products

This chapter describes how to uninstall any Aspen EngineeringSuite product.

OverviewThe following flowchart summarizes the process of removing AESproducts:

Complete steps inBefore You remove

AES products

In preparation for upgrade, savefiles/customizations in portableformats and in safe location

Complete steps inAfter you RemoveAES Products

Verify that the AES productfiles have been removed


Use the Uninstaller and selectAES products to remove

Remove AESproducts

8-2 •••• Removing AES Products Installation Manual_Aspen Engineering Suite 11.1

Before You Remove Any AESProductIf you are removing products in preparation for an upgrade, savefiles and customizations in portable formats and in safe locations.For more information, see Chapter 6, Upgrading AES Products.

Uninstalling AES ProductsNote: You cannot remove individual subcomponents from anyAES product without removing the product itself.

Use the AspenTech uninstaller to remove AES products.

You can also use the Add/Remove utility in the MicrosoftWindows Control Panel to uninstall any AES product.

Note: You cannot remove Polymers Plus without removing AspenPlus.

To use the uninstaller, do one of the following:• On the desktop click Start | Programs | AspenTech |

Uninstall AspenTech Software.• Insert the Aspen Engineering Suite Application/Product CD

in the CD-ROM drive. When the Add/Remove Softwaredialog box appears ,click the Uninstall AspenTech Softwarebutton.

To remove the software:1 On the AspenTech Uninstaller - Select Products dialog box,

select the AES products you want to remove, and click theUninstall button.The uninstall process begins. The AspenTech Uninstallerproceeds to remove the selected AES products and displays theprogress in the Uninstall Progress dialog box.

2 When the uninstall is complete, click Close.The Uninstaller prompts you to remove common components:

3 Click Yes to remove common components.As the Uninstaller removes the common components, theUninstall Progress dialog box displays its progress.

4 When the uninstall is complete, click Close.

Starting theUninstaller

Uninstalling thesoftware

Installation Manual_Aspen Engineering Suite 11.1 Removing AES Products •••• 8-3

The AspenTech Uninstaller dialog box prompts you to rebootyour computer.

5 Click Yes to reboot your computer now.

After You Remove AES ProductsGo to the AspenTech or AES product directory on the machine toverify that the files have been removed. If necessary, delete anyremaining folders manually.

If you are using HASP licensing and you will no longer be usingthis licensing method on this computer, remove the HASP keydriver. For more information, see Appendix A – HASP KeyLicensing.

If you attempt to use Excel after uninstalling Aspen Zyqad, youmay encounter an error. The error may report that it cannot findAspen Zyqad.

If this problem occurs, do the following:1 Start the MS Excel application.2 Click Tools ¦ Add-In.3 Clear the Aspen Zyqad option.

Note: You must do this for each network user PC when AspenZyqad is uninstalled.

If you install both Aspen Plus and Aspen Properties on the samecomputer, the second program installed registers the location ofCAPE-OPEN Thermo components.

If you uninstall the second program, the remaining program maynot be able to access these components.

If this is the case, run the CAPE-OPEN Registry Fixup Utility tore-register the CAPE-OPEN components so that the remainingprogram can access them.

To re-register the CAPE-OPEN components:1 Click Start | Programs | AspenTech | Aspen Engineering

Suite | (remaining product) | CAPE-OPEN Registry FixupUtility.A dialog box appears, displaying the location of the remainingproduct’s Engine.

2 Click OK to continue.

Using Excel afteruninstalling AspenZyqad

Re-registering CAPE-OPEN components

8-4 •••• Removing AES Products Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Troubleshooting •••• 9-1

C H A P T E R 9

Troubleshooting

This chapter contains:• Information that may help you if you have problems installing

Aspen Engineering products.• Some typical error messages.

Common ProblemsThe following information may be useful to you if youencountered problems installing.

This section contains information about installation accountprivileges.• You must be logged on as a local administrator to install

software on the PC• Your path must include the Windows NT directory (\WINNT)

and the Windows system32 directory (\WINNT\system32).• You must have the TEMP and TMP environment variables set

to valid directories.• Before installation, your Winnt\System32 folder must have

Full privileges.• After installation, do not change the privileges on your working

folder. This is the place where your work files are stored andtherefore people must have Full or Change privileges for thislocation.

If your installation does not appear to work correctly:• Ensure you have completed installation of all the required

components.• Ensure you have restarted your server and/or user PC(s).

Checking InstallationAccount Privileges

OtherTroubleshooting Tips

9-2 •••• Troubleshooting Installation Manual_Aspen Engineering Suite 11.1

• If you are using License Manager, verify that you have LicenseManager 3.0.

• If you are using a file server installation, check you have sharedthe relevant drive or folder so that the software is accessible bythe user PCs.

• If you are installing on a file server, remember that wheneveryou map from the user PC to the file server, you must use thesame drive letter.

• If you are using a server installation on a server, you must haveappropriate network access between server and client machinesin both directions.

Lite-Client installations may encounter the following problem:Problem Lite Client users cannot access online Help or

cannot access the Search tab of the online Help.Cause This occurs when Windows Help finds index files

in the installed Help directory that containincorrect paths. These files (*.gid, *.fts, *.ftg) aregenerated when the first time a Help file is run orthe Search function is used. The files contain filepaths that include the drive letter. If users accessthe help from file shares assigned to different driveletters, these paths can be incorrect for some users.

Solutions 1 Delete all *.gid, *.fts, and *.ftg files from theHelp directories.

2 Do one of the following:• Ensure that all users have read-only access

to the file server. In this case, WindowsHelp will write the index files to adirectory on the local computer, such asWINNT\Help under Windows NT 4.0.or

• Ensure that all lite-client machines use thesame drive letter for the shared drive on thefile server. This may require lite-clientreconfiguration, or reinstallation ofapplications if they were installed to usedifferent drive letters on differentcomputers.

Problem AccessingHelp

Installation Manual_Aspen Engineering Suite 11.1 Troubleshooting •••• 9-3

Error MessagesThis section lists error messages that you may encounter wheninstalling the AES products in a client-server configuration.

The following error messages may appear if a server verificationfails.

Message Failed to connect to remote host viarexec. Probable cause bad password,bad hostname, or network notinstalled.

Cause Either the remote or local host cannot resolve theremote or local host name into an address. Eachoperating system and network protocol resolvesnames differently.

Solution Check to make sure that you have a valid DNS orWINS server on the network and that the client isproperly configured to access it.

Message The name specified is not recognizedas an internal or external command,operable program or batch file.

Cause The sim_server.exe program is not at the locationyou specified.

Solution Repeat the verification, specifying the correctlocation for the sim_server.exe program.

Message The dynamic link library filename.dllcould not be found in the specifiedpath.

Cause A DLL required to run the sim_server.exe programis missing from your system. This is probablycaused by a failure during installation.

Solution Note the name of the DLL and then use the Find toolto search your system for the missing DLL.

Message Process simserver failed to start. Ifyou want to see more detail, press theDetails button.

Cause The User Rights Policy that allows the user to log onas a batch job has not been granted to the user shownin the error message.

Solution See “Configuring a Windows Server as an AESHost,” on page 5-13.

Client-ServerInstallations


9-4 •••• Troubleshooting Installation Manual_Aspen Engineering Suite 11.1

You might see these error messages on a user PC that is unable toconnect to a server:

Message CreateProcessAsUser: The system cannotfind the file specified.(2)

Cause The program specified does not exist.Solution Check that the server code is installed at the location

specified, for example, C:\Program Files\CommonFiles\AspenTechShared\AMSystem\11.1\bin\sim_server.exe

Installation Manual_Aspen Engineering Suite 11.1 Aspen ADSIM •••• 10-1

C H A P T E R 10

Aspen ADSIM

This chapter contains the following sections:• Verifying an Aspen ADSIM Installation• Verifying an Aspen ADSIM Installation that Uses Aspen

Properties

Verifying an Aspen ADSIMInstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify the installation of Aspen ADSIM on a user PC:1 On the desktop, click Start | Programs/AspenTech/Aspen

Engineering Suite | Aspen ADSIM 11.1/Aspen ADSIM.2 On the menu bar click File | Demonstrations.

The Demonstration Organizer window opens.3 In the top window, select Nitrogen Production (Single Bed

approach) and Open.A dialog box appears, indicating where the demonstration willbe copied to before automatically opening.

4 Click OK.5 In the top pane of the Exploring – Simulation window, select

flowsheet.6 In the lower pane double-click on the item labeled

Product_Comp.A plot opens.

7 On the menu bar click Run | Run.After a few moments the dynamic run completes.

10-2 •••• Aspen ADSIM Installation Manual_Aspen Engineering Suite 11.1

8 On the Run Complete Confirmation dialog box, click OK.The plot should display a result.

9 On the menu bar click Tools | Report | Global Balance.Additional messages should appear in the simulation messagewindow.

10 On the menu bar click File | Exit.A dialog box appears, displaying the message,This will stop the current simulation.

11 Click OK, and then click No when prompted to save changes.Aspen ADSIM closes.

You have now successfully verified your installation. You candelete the test folder.

Verifying an Aspen ADSIMInstallation that Uses AspenPropertiesNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify an Aspen ADSIM installation that uses AspenProperties:1 On the desktop, click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen ADSIM 11.1 |Aspen ADSIM.2 From menu bar, click File | Demonstrations.

The Demonstration Organizer window opens.3 In the top window select Nitrogen Production (Single Bed

approach) and click Open.A dialog box appears, indicating where the demonstration willbe copied to before automatically opening.

4 Click OK.5 In the top pane of the Exploring – Simulation window, right

click on Component Lists and click Properties from theshortcut menu.

6 In the Component Properties Settings dialog box, for theDefinition file enter N2PSA and click OK.

7 In the top pane of the Exploring – Simulation window, rightclick on the component list default and click Convert and thenclick Yes in the confirmation dialog.

Installation Manual_Aspen Engineering Suite 11.1 Aspen ADSIM •••• 10-3

The component list will now be converted for use with AspenProperties .

8 Double click on the component list Default.9 In the dialog box that appears, ensure the two components

Nitrogen and Oxygen are present in the right-hand list. Thenclick Cancel.

10 To reconfigure the flowsheet for use with Aspen Properties,double click on any block on the flowsheet (for example F1).

11 In the top pane of the Exploring – Simulation window, selectflowsheet.

12 In the lower pane double-click on the item labeledProduct_Comp.A plot opens.

13 On the menu bar click Run | Run.After a few moments the dynamic run completes.

14 On the Run Complete Confirmation dialog box, click OK.The plot should display a result.

15 On the menu bar click Tools | Report | Global MaterialBalance.Additional messages should appear in the simulation messagewindow.

16 On the menu bar click File | Exit. Then click No whenprompted to save changes.Aspen ADSIM closes.

You have now successfully verified your installation with AspenProperties. You can delete the test folder created during step 3.

10-4 •••• Aspen ADSIM Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen B-JAC •••• 11-1

C H A P T E R 11

Aspen B-JAC

This chapter contains the instructions for verifying the installationof Aspen B-JAC on user PCs.

Verifying the Aspen B-JACInstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify the installation of any of the Aspen B-JAC design systemproducts (Hetran, Teams, Aerotran) on a user PC:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen B-JAC 11.1 | Aspen B-JAC Design System.This starts the User Interface.

2 Open any of the test files located in the folder:x:\Program Files\AspenTech\B-JAC 11.1\XMP

where x is the local drive where Aspen B-JAC is installed onyour PC or the local mapped drive to the file server whereAspen B-JAC is installed.

3 On the menu bar click Run | Run.The program should open the status window and show you thecalculation progress.

You are now finished with the verification of the Aspen B-JACinstallation.

11-2 •••• Aspen B-JAC Installation Manual_Aspen Engineering Suite 11.1

You can change the selected licensing option after you haveinstalled Aspen B-JAC Hetran, Teams or Aerotran products.

To change licensing:In the Aspen B-JAC user interface click Tools | Security |Settings on the menu bar.

Changing theLicensing Option

Installation Manual_Aspen Engineering Suite 11.1 Aspen Chromatography •••• 12-1

C H A P T E R 12

Aspen Chromatography

This chapter contains the instructions for verifying the installationof Aspen Chromatography on user PCs.

Verifying an Aspen ChromatographyInstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify an Aspen Chromatography installation:1 On the desktop, click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Chromatography 11.1/AspenChromatography.

2 On the menu bar click File | Demonstrations.The Demonstration Organizer window opens.

3 In the top window, select Separation of D- & L- ThreonineEnantiomers and click Open.A dialog box appears, indicating where the demonstration willbe copied to before automatically opening.

4 Click OK.5 In the top pane of the Exploring – Simulation window, select

flowsheet.6 In the lower pane double-click on the item labeled conc.

A plot opens.7 On the menu bar click Run | Run.

After a few moments the dynamic run completes.8 On the Run Complete Confirmation dialog box, click OK.

The plot should display a result.

12-2 •••• Aspen Chromatography Installation Manual_Aspen Engineering Suite 11.1

9 Double-click on the flowsheet icon labeled B1.10 In the dialog box that appears, click the Reporting tab and

then Click the Report button.A chromatography report dialog box appears.

11 On the menu bar click File | Exit. When prompted to savechanges, click No.Aspen Chromatography closes.

You have now successfully verified your installation. You candelete the test folder created during step 3.

Installation Manual_Aspen Engineering Suite 11.1 Aspen Custom Modeler •••• 13-1

C H A P T E R 13

Aspen Custom Modeler

This chapter contains the instructions for verifying the installationof Aspen Custom Modeler on user PCs.

Verifying the Aspen Custom ModelerInstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify an installation of Aspen Custom Modeler on a user PC:1 Create an empty test folder and copy the FiveTank.acmf file

into it.The default location of this file is:C:\Program Files\AspenTech\Aspen Custom Modeler11.1\Examples\5Tank

2 On the desktop click Start | Programs | AspenTech | AspenEngineering Suite | Aspen Custom Modeler 11.1 | AspenCustom Modeler.

3 On the menu bar click File | Open.4 Navigate to your test folder and select the Fivetank.acmf file,

then click Open to load the simulation.5 On the menu bar click Run | Mode | Dynamic.6 On the menu bar click Run | Run.

After a few moments the dynamic simulation starts to run.7 Ensure that the time displayed in the status bar at the bottom of

the window is advancing. The time appears after the wordsDynamic at.

8 On the menu bar click File | Exit.

13-2 •••• Aspen Custom Modeler Installation Manual_Aspen Engineering Suite 11.1

A dialog box appears, displaying the message,This will stop the current simulation.

9 Click OK, and then click No when prompted to save changes.Aspen Custom Modeler closes.

You have successfully verified your installation, and you candelete your test folder and its contents.

To verify an Aspen Custom Modeler installation that uses AspenProperties:1 In Aspen Plus create an Aspen Plus document (.apw) file in a

test folder.2 In Aspen Custom Modeler run the InitializeSimulation

script. This script:• Fixes the feed compositions, flows, temperatures, and

pressures in each of the feed streams. Notice also that weuse a stream model.

• Initializes the temperature, liquid and vapor flows in theabsorber. The specabsorber script fixes the pressure andtemperature in the absorber, and frees the duty for eachstage.

• Runs the simulation. A steady-state run at this point is at afixed temperature of 50°C. This simulation converges veryquickly, and shows the power of using simplified propertiesand initialization.

• Switches the simulation to rigorous properties and anadiabatic duty for each tray.

• Runs a steady-state simulation again.• Switches the specifications of the absorber to dynamic

specifications, where tray coefficients are used to calculatethe pressure, and the vapor and liquid product flows arefixed.

To create the Aspen Plus document file:1 If you have not already done so, restart Windows to activate

the changes made to your configuration during the installation.2 Create an empty test folder and copy into it the files from the

Absorber folder. The default location of this folder is:C:\Program Files\AspenTech\Aspen Custom Modeler11.1\Examples\Absorber

Verifying AspenCustom Modeler withAspen Properties

Creating the Aspen Plusfile

Installation Manual_Aspen Engineering Suite 11.1 Aspen Custom Modeler •••• 13-3

3 On the desktop click Start | Programs | AspenTech | AspenEngineering Suite | Aspen Plus 11.1 | Aspen Plus UserInterface.

4 In the Aspen Plus Startup dialog box, open the Absorber.bkpfile in your test folder.

Note: There is no flowsheet because this is a properties only inputfile.

5 On the Aspen Plus menu bar click Run | Run.6 After the run completes, click File | Save As on the menu bar

and save the simulation in your test folder as an Aspen Plusdocument (.apw) file.

7 Exit Aspen Plus.

1 On the desktop click Start | Programs | AspenTech | AspenEngineering Suite | Aspen Custom Modeler 11.1 | AspenCustom Modeler.

2 On the menu bar click File | Open. Locate your test folder andselect the absorber.acmf file. Then click Open.

3 In the All Items pane of the Simulation Explorer, clickFlowsheet to select it.

4 In the Contents of Simulation pane, double-click theFeedDisturbance task to activate it.

5 In the Contents of Simulation pane, double-click theTempProfile item to display the temperature profile plot.

6 In the Contents of Simulation pane, double-click theInitializeSimulation script to run it.When the script completes, the temperature profile plotdisplays the result.

7 On the menu bar click File | Exit. Click No when prompted tosave changes.

You have now successfully verified your installation. You can nowdelete your test folder and its contents.

Running theInitializeSimulation script

13-4 •••• Aspen Custom Modeler Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen Dynamics •••• 14-1

C H A P T E R 14

Aspen Dynamics

This chapter contains the instructions for verifying the installationof Aspen Dynamics on user PCs.

Verifying the Aspen DynamicsInstallationTo verify an installation of Aspen Dynamics on a user PC:1 Create an empty test folder and copy into it the file

DyEster.bkp.The default directory location of the file is:C:\Program Files\AspenTech\Aspen Dynamics 11.1\Examples

2 On the desktop click Start | Programs | AspenTech | AspenEngineering Suite | Aspen Plus 11.1 | Aspen Plus UserInterface.

3 Open DyEster.bkp, located in your test folder.

Note: If you are running remotely, on the menu bar click Run | Connect to Engine and make sure you are properlyconnected to the remote server.

4 On the menu bar click Run | Run.5 When the run completes, on the menu bar click File | Export.6 Navigate to your test folder and for the Save as Type, select

Flow Driven Dyn Simulation.7 Click Save to export the dynamic simulation.8 On the menu bar click Send To | Aspen Dynamics Flow

Driven.Aspen Dynamics starts automatically, with the DyEstersimulation open.

14-2 •••• Aspen Dynamics Installation Manual_Aspen Engineering Suite 11.1

9 On the menu bar click Run | Run.After a few moments, the dynamic simulation starts to run.

10 Make sure that the time shown in the status bar at the bottom ofthe window is advancing. The time appears after the wordsDynamic at.

11 On the menu bar click File | Exit.A dialog box displays the message This will stop the currentsimulation.

12 Click OK, and then click No when prompted to save changes.Aspen Dynamics closes.

You have now successfully verified your installation. You candelete your test folder and its contents.

Installation Manual_Aspen Engineering Suite 11.1 Aspen Icarus •••• 15-1

C H A P T E R 15

Aspen Icarus

This chapter contains the following sections:• Before You Install Aspen Icarus• Aspen Icarus Installation Notes

Before You Install Aspen IcarusBefore you can install Aspen Icarus Project Manager (IPM) youmust install Primavera Project Planner for Windows (P3).

For instructions on setting up P3, see the Primavera ProjectPlanner for Windows Reference (version 3.0), pages xxii-xxxiii,“Setting up P3.”

After installing P3, you must install the SP3 update to make itcompatible with IPM. You must install this update before youinstall Aspen Icarus Project Manager.

The SP3 update is located on AES CD1 under the Aspen Icarusdirectory. The name of the patch file is P3srvpk3.exe.

Aspen Icarus Installation NotesWhen installing this version of Aspen Icarus, the Aspen Icarus11.1 product directory must be installed no deeper than the thirdlevel of the directory structure. For example:

D:\Program Files \AspenTech\Aspen Icarus 11.1

Due to read/write access issues for certain Windows 2000configurations, we recommend installing Aspen Icarus products ina directory other than Program Files.

Aspen Icarus ProjectManager (IPM)

Windows 2000

15-2 •••• Aspen Icarus Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen OLI •••• 16-1

C H A P T E R 16

Aspen OLI

This chapter contains the instructions for verifying the installationof Aspen OLI on user PCs.

Verifying the Aspen OLI InstallationNote: To use Aspen OLI, Aspen Plus must be installed prior to orsimultaneously with Aspen OLI.

To verify an installation of Aspen OLI on a user PC:1 If you have not already done so, restart Windows to include

changes made to your configuration during the installation.2 Click Start | Programs | AspenTech | Aspen OLI 11.1 |

Aspen OLI Interface.The Aspen OLI Interface window opens.

16-2 •••• Aspen OLI Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen OnLine and Aspen Plus Online •••• 17-1

C H A P T E R 17

Aspen OnLine and Aspen PlusOnline

This chapter contains the following sections:• Aspen OnLine Installation Notes• Configuring Aspen OnLine• Verifying an Aspen OnLine Installation• Aspen Plus Online Installation Notes• Aspen Plus Online Startup

Aspen OnLine Installation NotesAspen OnLine consists of:• Aspen OnLine Server, which communicates with CIM-IO to

retrieve plant data and with Aspen Plus to run models.• Aspen OnLine Client, which is the graphical user interface for

Aspen OnLine.

The Aspen OnLine Client is required, as a local client, on thecomputer where Aspen Online Server is installed.

On server installations, CIM-IO Server Security allows you tocontrol which clients can connect to the CIM-IO Server. You canenable this feature during the installation of Aspen OnLine.

During the installation setup, you are prompted for the followinginformation after you select Aspen OnLine on the Select Productsand Select Subcomponents dialog boxes:• DCOM user account• CIM-IO Core Security Settings

17-2 •••• Aspen OnLine and Aspen Plus Online Installation Manual_Aspen Engineering Suite 11.1

The DCOM associated with Aspen OnLine runs as a user. Youmust specify the DCOM user account.

When the following dialog box appears, enter theDomain\Username and password for the account. This accountmust have administrative privileges.

After you select the Aspen OnLine on the Select Products dialogbox, you are prompted to enable CIM-IO Server security.

To enable the CIM-IO server security feature:1 When the CIM-IO Core Security Settings dialog box

appears, select the Enable Security checkbox and click Next.

The Windows NT Service Configuration screen appears.

Specifying a DCOMuser account

Enabling CIM-IOServer Security


2 Enter the Domain\Username and password for the accountwhich will run the security service. This account must havelocal administrator access.

Click Next to continue the installation.

Configuring Aspen OnLine

The Aspen OnLine server requires the configuration of:• CIM-IO to properly communicate with the plant data server• CIM-IO services in Windows NT• Windows DCOM (distributed COM) function

The CIM-IO component for Aspen OnLine must be configured tocommunicate with the source of plant data.

Note: If another AspenTech application on this computer is usingCIM-IO to communicate with the same devices, Aspen OnLinewill use the same CIM-IO connection, and you do not need toperform this configuration.

The following instructions assume the plant data server is IP.21.For complete CIM-IO configuration instructions for IP.21 and forall other plant data server devices, see the CIM-IO manual.

Configuring theAspen OnLine Server

Configuring CIM-IO forAspen OnLine


To add services to the Windows NT server computer:1 In Windows Notepad (or other text editor), open the services

file. The default location is:C:\winnt\system32\drivers\etc\services

2 Insert the following two lines so that all services are innumerical order:If necessary, replace 5801 and 5802 with unused servicenumbers greater than 1023 that are identical to those in thecorresponding file in the IP.21 server computer.

CIMIOSETCIM_200 5801/tcp #CIMIO for IP.21CIMIOSETCIMH_200 5802/tcp #CIMIO for IP.21 historical

3 Save the file and Exit the text editor.

To specify the Logical Devices used by CIM-IO in its logicaldevice definition file:1 Double click the CIM-IO Device Configuration icon in the

CIM-IO windows group. orOn the desktop click Start | Programs | AspenTech | AspenManufacturing Suite - Information Mgmt | Cim-io | LogicalDevices.The header line reads:

Logical Device Name Node Name DLGP Service Name

2 Insert the following line as the last line in the file:

IOSETCIM200 NodeName CIMIOSETCIM_200 CIMIOSETCIMH_200

Where NodeName is the server name of the computer whereIP.21 resides.

Note: These instructions assume the plant data server is IP.21. Foryour specific device or plant data server, see the CIM-IO manual.

Adding Services

Specifying LogicalDevices


The Aspen OnLine 11.1 installation program should performDCOM configuration for the user. However, if for some reasonDCOM is not configured completely, or if the password for theDCOM user account changes, follow these instructions.

To configure DCOM:1 On the desktop click the Start | Run. In the Run dialog box,

Enter DCOMCNFG and click OK.The Distributed COM Configuration Properties windowappears.

2 On the Applications tab select APOServer.TheAPOServerand click the Properties button.The APOServer.TheAPOServerProperties dialog boxappears.

3 On General tab, select None for Authentication Level.4 Display the Location tab and ensure that only Run

Application on this Computer is selected.5 Display the Security tab. Make sure Use Custom Access

Permissions is selected and click its Edit button.These names should be granted Allow Access type of access:• Everyone• Interactive• SystemWhen finished, click OK.

6 On the Security tab make sure Use Custom LaunchPermissions is checked and click its Edit button.The System account should be granted Allow Launch type ofaccessWhen finished, click OK.

7 On the Security tab make sure Use Custom ConfigurePermissions is checked and click its Edit button.<Computer name>\administrators should be granted FullControl type of access.When finished, click OK.

8 Display the Identity tab. Select This user and enter theDomain\UserName and password of an account withadministrative privilege.

Note: when this account has a new password, update the newpassword here.

Configuring DCOM


9 Click Apply and then click OK to close theAPOServer.TheAPOServer Properties dialog box.

10 On the Distributed COM Configuration Properties dialogbox, display the Default Properties tab, and select thefollowing options:• Enable Distributed COM on this computer• Impersonate for the Default Impersonation Level

Note: Aspen OnLine does not use the “Provide additional securityfor reference tracking” option.

11 Click Apply and then click OK to close the dialog box.

An Aspen OnLine client in client-only machines requires DCOMconfiguration. The local client residing in an Aspen OnLine serverdoes not require these configuration steps.

The Aspen OnLine 11.1 installation program should performDCOM configuration for the user. The procedures for manuallyconfiguring DCOM are provided for reference.

CAUTION: Failure to properly configure the Aspen OnLine clientcomputer DCOM can cause failures in the Aspen OnLine server.

To configure DCOM for the Aspen OnLine client:1 On the desktop click Start | Run.2 In the Run dialog box, enter dcomcnfg and click OK.

The Distributed COM Configuration Properties dialog boxappears.

3 Display the Default Properties tab and select the followingoptions:• Enable Distributed COM on this computer• Impersonate for the Default Impersonation Level

Note: Aspen OnLine does not use the “Provide additional securityfor reference tracking” option.

Configuring theAspen OnLine Client

Configuring DCOM


Verifying an Aspen OnLineInstallationPerform the following steps to verify that Aspen OnLine isinstalled and functional.1 Verify plant data access on the server machine.2 Verify relevant AES products on the server machine3 Verify Aspen OnLine on the server and client machines.

To verify plant data access on the server machine, follow theinstructions in “The CIM-IO Test Utility” section of the AspenOnLine User Guide.

Aspen OnLine 11.1 can drive Aspen Plus models and models fromAspen Custom Modeler and related products such as AspenUtilities.• If Aspen OnLine 11.1 is used to drive Aspen Plus models,

verify that Aspen Plus 11.1 has been correctly installed on theserver machine.

• If Aspen OnLine 11.1 is used to drive Aspen Custom Modelerand related product models, verify that version 11.1 of thecorresponding Aspen Custom Modeler products have beeninstalled properly.

To verify Aspen Online on the server machine:1 Go to the installed Aspen OnLine 11.1 product folder and copy

the subfolder, AOLSample, to a location under one of the localdrives on the server machine.

2 On the desktop click Start | Programs | AspenTech | AspenEngineering Suite | Aspen OnLine 11.1 | Project Manager.The Aspen OnLine Project Manager window appears.

3 For Computer enter the name of the server machine. orUse the Browse button to locate the server machine name.

4 Click Register.5 On the dialog box enter the path to the AOLSample folder

(step 1). For example: D:\AspenTech\AspenOnLine\AOLSample

Verifying Plant DataAccess

Verifying AESproducts

Verifying AspenOnLine

Server machine


The new project name appears in the list in the Aspen OnLineProject Manager window.

6 Click OK to register the sample project and close the dialogbox.

7 Click Close exit the Project Manager.8 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen OnLine 11.1 | Project ClientGUI.The Aspen OnLine window appears.

9 On the Aspen OnLine Startup dialog box,• Specify the Server name (step 3)• Select AOLSample as project name.Click OK.

10 In the Steady-state detection frame click Load. After theprogram is loaded, click Start.In the frame on the right, do the same to start the AspenOnLine engine.Aspen OnLine is running.

To verify Aspen OnLine on the client machine:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen OnLine 11.1 | Client GUI.The Aspen OnLine window appears.

2 On the Aspen OnLine Startup dialog box, specify the servername and project name. The click OK.Make sure that Aspen OnLine is running on the servermachine.

3 On the Aspen OnLine menu bar click Data | Data Browser.The Data Browser window appears.The information displayed in the Data Browser should reflectthe project information for the specified project on thespecified server machine.

Client machine


Aspen Plus Online Installation NotesAspen Plus Online has two subcomponents:• Aspen Plus Online User Interface• Aspen Plus Online Engine StandardThe Aspen Plus Online Engine requires the Aspen Plus 11.1Simulation Engine.

Aspen Plus Online supports a client-server configuration.

The apol111serv service must be defined on both the host servermachine and on the client PC before the Aspen Plus Online GUIcan communicate with the host problem. The installation of AspenPlus Online provides a default setup for this service, using portnumber 11008.

To change the default setup for the apol111serv service:1 Select a TCT/IP port number for Aspen Plus Online.2 Define the apol111serv service on the client PC.3 Define the apol111serv service on the Host computer.

The Aspen Plus Online GUI requires a dedicated TCP/IP portnumber to communicate with the Host machine. Both the clientand Host use the same port. This port number can not be used forany other service.1 On the client PC, locate the services file.

The default location is:Windows NT C:\WINNT\system32\drivers\etcWindows 2000 C:\system32\drivers\etc

2 Select a port number for the Aspen Plus Online GUI, forexample 60003.

3 Check the services file to make sure that the selected portnumber is not being used.

4 On the Host machine, locate its services file and verify that theselected port number is not being used.

Configuring theapol111serv Service

Determining the TCP/IPport number


To define the apol111serv service for the Aspen Plus Online GUIon the client PC and the Host machine:1 Locate the services file.2 Add the following line to the file:

apol111serv portnm/tcp #APOL GUI service

where:portnm is the selected port number, for example

apol111serv 60003/tcp #APOL GUI service

Note: Make sure the last line of the services file is a blank line.

3 Save your updates to the services file.

When Aspen Plus Online is installed on Windows NT or Windows2000, it creates a new service, called “Aspen Plus Online 11.1,”which performs all startup activities.

By default this service is set up for automatic startup. To changethe Aspen Plus Online service, open Services in the Control Panel.To disable the automatic start up, change the service to manualstartup.

Defining the apol111servservice

Aspen Plus OnlineStartup

Installation Manual_Aspen Engineering Suite 11.1 Aspen PEP Process Library •••• 18-1

C H A P T E R 18

Aspen PEP Process Library

This chapter contains the following sections:• Verifying the Aspen PEP Process Library Installation• Troubleshooting Aspen PEP Process Library

Verifying the Aspen PEP ProcessLibrary InstallationTo verify an installation of Aspen PEP Process Library on a userPC:1 If you have not already done so, restart Windows to include

changes made to your configuration during the installation.2 Click Start | Programs | AspenTech | Aspen Engineering

Suite | Aspen PEP 11.1 | Aspen PEP Process Library.3 In the Select a Process dialog box, select Moonshine and click

the Load button.4 On the menu bar click Tools | Run.5 Confirm that the demo model is loaded and running properly.

18-2 •••• Aspen PEP Process Library Installation Manual_Aspen Engineering Suite 11.1

Troubleshooting Aspen PEP ProcessLibraryWhen running Aspen PEP Process Library, you many encounterthe following problem.

Problem When loading a model, the system locks and awarning message appears.

Cause You may have clicked the mouse on other objectswhile the system was trying to establish aconnection.

Solution During this model loading process, do not click onany objects until the “Connection Established”message has appeared.

If the system locks, open the Windows TaskManager and end the task.

Installation Manual_Aspen Engineering Suite 11.1 Aspen Pinch •••• 19-1

C H A P T E R 19

Aspen Pinch

This chapter contains the instructions for verifying the installationof Aspen Pinch on user PCs.

Verifying the Aspen Pinch InstallationTo verify an installation of Aspen Pinch on a user PC:1 On the desktop click Start | Programs | AspenTech | Aspen

Pinch 11.1.2 Select the Sample Problems folder in the Aspen Pinch

installation.• If this is the first Aspen Pinch run, you will be prompted to

set the base directory.• If Aspen Pinch starts and the Case Manager appears, you

can change the base directory by choosing File | New |Base Directory.

In either case, the Choose Base Directory dialog box appears.

3 In the Choose Base Directory dialog box, select Set BaseDirectory and click OK.

19-2 •••• Aspen Pinch Installation Manual_Aspen Engineering Suite 11.1

4 In the Set Base Directory dialog box, select the SampleProblems folder .If necessary, select the appropriate drive from the Drives list.

5 When Aspen Pinch starts, open the Crude Unit B case in theCase Manager window.

6 On the menu bar click Tools | Targeting.– or –

On the toolbar click (Targeting).

Installation Manual_Aspen Engineering Suite 11.1 Aspen Pinch •••• 19-3

A Composite Curve window appears.

7 From the Targets menu, click Report | Targeting:You should see a report with these numbers:

8 Verify that these numbers are the same for your installation.

19-4 •••• Aspen Pinch Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen Plus •••• 20-1

C H A P T E R 20

Aspen Plus

This chapter contains the following sections:• Installation Notes• Verifying the Aspen Plus Installation• Configuring a Windows Server as an Aspen Plus Calculation

Server• Aspen Plus Client/Server Communication• Using the FORTRAN Compiler with Aspen Plus• Installing the FORTRAN Compiler• Troubleshooting Aspen Plus

Installation NotesAll installations of this version of Aspen Plus require the coreProperties System for Aspen Plus (APrSystem) subcomponent.When you install Aspen Plus, the separately licensed Aspen PlusOptimizer is installed automatically.

Verifying the Aspen Plus InstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify an installation of Aspen Plus on a user PC:1 On the desktop click Start | Programs | AspenTech

| Aspen Plus 11.1 | Aspen Plus User Interface.2 In the Aspen Startup dialog box, open the existing simulation

test file, pfdtut.bkp The default location is:C:\Program Files\AspenTech\Aspen Plus 11.1 \GUI\XMP

20-2 •••• Aspen Plus Installation Manual_Aspen Engineering Suite 11.1

3 On the menu bar click View | Control Panel.4 On the menu bar click Run | Run.

Simulation diagnostic messages appear in the Control Panel.The installation test should finish with no errors or warnings.The following message indicates a successful verification:

->Simulation calculations completed ...

5 On the menu bar click Data | Results Summary | ResultsStatus.The Results Summary window appears, showing the runcompletion status.

You are now finished with the verification of the Aspen Plusinstallation.

Configuring a Windows Server as anAspen Plus Calculation ServerThis section explains how to configure a Windows server as anAspen Plus engine host. This configuration allows the user tosubmit Aspen Plus runs by connecting to a remote host.


These are the steps for installing and configuring an Aspen Pluscalculation server:1 On the server machine, perform a Server installation of the

Aspen Plus Simulation Engine.2 Verify the Simulation Engine installation.3 Set up user access to the calculation server.4 Create working directories for users on the server machine.5 On each user PC, perform a Standard installation of

Aspen Plus.6 Configure and verify the Aspen Plus installation.The rest of this section describes each step in detail.

To install the Aspen Plus simulation engine on a Windows server:1 On the server machine, perform a Server installation of Aspen

Plus, following the instructions in Chapter 5, Client-ServerInstallation.

2 When the Select Products dialog box appears, select AspenPlus 11.1 and click the Select Subcomponents button.

Step 1: Install theSimulation Engine onthe server


3 On the Select Subcomponents dialog box select thesecomponents:• Aspen Plus Simulation Engine• Core Properties System for Aspen Plus (required)

4 Click Next and continue the Aspen Plus installation setup onthe server machine.

After you install the Aspen Plus Simulation Engine on the server,verify the installation.

To verify the installation of the Aspen Plus Simulation Engine:1 On the server machine open Windows Explorer and go to the

following Aspen Plus directory:..\AspenTech\Aspen Plus 11.1\Engine\XEQ

2 Copy the file INSTPROB.INP to this directory:..\AspenTech\Working Folders\Aspen Plus 11.1.

3 On the desktop click Start | Programs | AspenTech | AspenEngineering Suite | Aspen Plus 11.1 | Aspen Plus SimulationEngine.This launches a DOS window and sets up the user environmentto run the Simulation Engine.

4 At the command prompt, type the following and press Enter:aspen simple /getridof

This command runs the problem and deletes the working files.Any errors are reported in the simple.out file, located in..\AspenTech\Working Folders/Aspen Plus 11.1.If there are problems running the simulation, see“Troubleshooting Aspen Plus” on page 20-12.

After you complete the installation of the AES server componentson the server machine, you must configure the server as an AEShost. Each user who will connect to the Windows NT/2000 servermust belong to one of the following:• A local user account or group on the server• An account or group in the domain to which the server belongs• An account or group in a trusted domain.

Important: Each user account that connects to the server mustalso be granted Log on as a Batch Job access to the server.

For detailed instructions, see “Configuring a Windows Server as anAES Host ” on page 5-13.

Step 2: Verify theSimulation Engineinstallation on theserver

Step 3: Set up useraccess to thecalculation server


Allowing each user to have a dedicated directory prevents workingfiles from overlapping. The Permissions you can set for theworking directories depend on the format of the disk partitionwhere the working directory resides.Format Permissions

NTFS Folder and sharingFAT Sharing only

Note: If you do not define working directories, the default is thesystem32 directory of the server. Do NOT allow users to run jobsin this directory.

To create working directories for users:1 Log on to the NT server as the Administrator.2 Create a directory for each user who will access the calculation

server.3 Share each of these directories, allowing the user Full Control

and other members of Aspen Plus user community Add and/orChange permissions. This allows users to transfer Fortransource files to each other’s working directories.

To install Aspen Plus on a user PC:1 On the User PC, perform a Standard installation of Aspen

Plus, following the instructions in Chapter 3, StandardInstallation.

2 When the Select Products dialog box appears, select AspenPlus 11.1 and click the Select Subcomponents button.

3 On the Select Subcomponents dialog box select thesecomponents:• Aspen Plus User Interface• Core Properties System for Aspen Plus (required)

4 (Optional) Clear the checkbox for the Aspen Plus SimulationEngine component.

5 Click Next to continue the Aspen Plus installation setup on theuser PC.

Step 4: Createworking directoriesfor users

Step 5: Install AspenPlus on User PCs


After you perform Steps 1-5, verify client access to the calculationserver.

To verify the installation:1 On the desktop of the user PC, click Start | Programs |

AspenTech | Aspen Engineering Suite | Aspen Plus 11.1 |Aspen Plus Interface.

2 Open the test file PFDTUT.BKP. The default location is: C:\Program Files\AspenTech\Aspen Plus 11.1\GUI\XMP

3 On the Aspen Plus menu bar click Run | Connect to Engine.The Connect to Engine dialog box appears.

Note: The Connect to Engine dialog box may appearautomatically.


5 Enter the following user information:• Node name of the server running the simulation engine• User name• User’s password• Appropriate Working directory


6 Click OK to connect to the calculation server.If everything is configured correctly, the status bar shoulddisplay Connection Established.

Step 6: Verify theCalculation ServerInstallation


7 On the Aspen Plus menu bar click View | Control Panel.The Control Panel window appears.

8 In the Control Panel window click the Run button .When the simulation completes, the Control Panel displayshould look similar to this.

Aspen Plus Client/ServerCommunicationThe Aspen Plus User Interface communicates with the SimulationEngine using several TCP/IP and DCOM protocols. Theseprotocols allow users to log on to Aspen Plus and executeprograms on the Simulation Engine when the engine is running ona remote host.

The operating system and communication protocol determine thebehavior of processes on the remote host running the Aspen PlusSimulation Engine.

When the User Interface connects to a remote host, two processesstart on the remote host:• Xcserver• Apmain


You can always verify the existence of dangling processes and stopthem manually, if necessary, before they terminate themselves.

To stop an Aspen Plus process manually:1 On the desktop right-click the Task Bar and click Task

Manager on the menu.2 In the Task Manager window display the Processes tab.3 Select the process you want to stop and click End Process.

The mm.ini file determines how the User Interface communicateswith the Simulation Engine. This file contains a numberCOMMSECT sections, each containing a set of parameters for adifferent remote connection type.

You can use the mm.ini file to customize communication for theUser Interface. The default location is:

C:\Program Files\AspenTech\Aspen Plus 11.1\GUI\xeq

You can adjust the following variables, contained in each sectionof the mm.ini file, to maximize performance in a slow network.The table below shows each variable and its purpose. Normally,you would increase these until performance is acceptable, asfollows:Variablename How long to wait

Defaultvalue

connect_timeout During the login process for thexcserver.exe process to connect to theclient again

90 seconds

rcmnd_timeout For a response from the xcserver.exeprocess

90 seconds

inter_timeout For a response from the apmain.exeprocess

90 seconds

You can use the mm.ini file to debug communication problemsbetween the User Interface and Simulation Engine, even if bothprograms reside on the same host. By default, the mm.ini fileresides on the host running the User Interface in..\AspenTech\Aspen Plus 11.1\GUI\xeq.

The mm.ini file contains this line:

debug OFF

Displaying andstopping a process

Customizing AspenPlus Communication

Changing timeoutvariables

Troubleshootingcommunication problems


When debug is set to ON, processing and debugging statusmessages appear in the Control Panel of the Aspen Plus UserInterface window. For example:

Using the FORTRAN Compiler withAspen PlusRunning an Aspen Plus simulation requires a FORTRAN compilerif the model:• Requires compiling and linking user FORTRAN subroutines• Contains non-interpretable inline FORTRAN in the problem

definition

You can compile and pre-build external user FORTRANsubroutines into a shared library (DLL). This library can bedistributed to Aspen Plus users who do not have an installedFORTRAN compiler.

1 The user writes the external FORTRAN subroutine, using hischoice of editor.

2 The user copies the file to his/her working directory on theserver machine, by dragging and dropping the file to the shareddirectory or mapping a local drive to the shared directory.

3 The user telnets into his account on the server machine, usinghis choice of Telnet client software. The built-in Telnet clientsoftware shipped with Windows NT works fine.

4 The FORTRAN source file can be compiled using theASPCOMP command. The user can exit from the Telnetsession and return to the Aspen Plus User Interface.

5 The user connects to the calculation server machine from theAspen Plus User Interface and runs the simulation in his/herworking directory. The compiled FORTRAN object file will beused during the simulation run.

User Workflow


Installing the FORTRAN CompilerA user needs to access a FORTRAN compiler on the calculationserver if a simulation either:• Refers to external FORTRAN subroutines• Contains non-interpretable FORTRANUsers running external FORTRAN subroutines must copy theFORTRAN files to the server and compile them in their workingdirectory on the server. These compiled object files are used duringthe simulation run initiated by the client PC.

When installing the FORTRAN compiler, we recommend that youchange the installation directory to C:\MDS.

After file copying is completed, the installer program asks if youwant to configure the Environment Variables for Windows NT.Click Yes to ensure that every user has access to the FORTRANcompiler. On the next prompt, to install the Array Virtualizer,click No.

The original release of the Digital Visual Fortran Compiler,Version 6.0, requires a patch to run with Aspen Plus. The latestpatch is distributed by Compaq Corporation, which you candownload from this website:

http://www.digital.com/fortran/downloads.html

If you try to run a simulation without installing the patch, thefollowing errors appear in the Simulation Engine window:

forrtl: severe (157): Program Exception - access violationImage PC Routine Line SourceATDMS.DLL 1001B15B Unknown Unknown UnknownATDMS.DLL 10006EE3 Unknown Unknown UnknownZEITEXEC.DLL 010D10B1 Unknown Unknown UnknownZEAPEXEC.DLL 004E1230 Unknown Unknown UnknownZEAPEXEC.DLL 0059D78F Unknown Unknown UnknownAPMAIN.EXE 004010F2 Unknown Unknown UnknownAPMAIN.EXE 004013C9 Unknown Unknown UnknownAPMAIN.EXE 004012AF Unknown Unknown UnknownKERNEL32.DLL BFF8B537 Unknown Unknown UnknownKERNEL32.DLL BFF8B3E9 Unknown Unknown UnknownKERNEL32.DLL BFF89DAC Unknown Unknown Unknown

Client-ServerInstallations

Installing the patch forDigital Visual Fortran6.0

http://www.digital.com/fortran/downloads.html


To enable users to compile FORTRAN subroutines on theWindows NT calculation server, you must load and configure aTelnetD server. The following table lists commercially availableTelnetD packages, along with any known conflicts with existingAspenTech software. All of the vendors listed offer trial versionsof their software, available at their websites.Vendor Product Contact Information

Ataman* TCP Remote Logon http:\\www.ataman.comGeorgiaSoftworks

Telnet Server http:\www.georgiasoftworks.com

PragmaSystems*

InterAccess TelnetdServer Version 4

http:\www.pragmasys.com

Seattle Labs SLNet http://www.seattlelab.com/

* Loads a REXECD service that conflicts with the AspenTechREXECD. See the vendor documentation to disable this service.

After you install the FORTRAN compiler and TelnetD Server onthe server, you need to verify that they are operating properly. Theverification uses two example files: DRSEX14.BKP andDRUSR0.F.

To verify the installation of the FORTRAN Compiler:1 Copy the file DRUSR0.F, located in the ..\Aspen Plus

11.1\GUI\XMP directory, to the working directory of a useraccount on the Calculation Server.

2 Open the Windows Telnet program. Log into the CalculationServer with a valid account and password.

3 Go to the correct working directory and compile theFORTRAN file using the command:

aspcomp drusr0.f

4 On the desktop of the client machine, click Start | Programs |AspenTech | Aspen Engineering Suite | Aspen Plus 11.1 |Aspen Plus Interface.

5 Open the file DRSEX14.BKP, located in the ..\Aspen Plus11.1\GUI\XMP directory.The Connect to Engine dialog box appears.

Configuring theTelnetD Server(Windows NT)

Verifying theInstallation of theFORTRAN Compiler

http://www.ataman.com/

http://www.georgiasoftworks.com/

http://www.pragmasys.com/

http://www.seattlelab.com/



7 Enter the following user information:• Node name of the server running the simulation engine• User name• User’s password• Appropriate working directory


8 Click OK to connect to the calculation server.If everything is configured correctly, the status bar shoulddisplay Connection Established.

9 On the Aspen Plus menu bar click View | Control Panel.The Control Panel window appears.

10 On the Control Panel toolbar, click the Run button .11 When the Data Regression Run Selection screen appears,

click OK to start the run.


When the data regression completes, the Control Panel displayshould look like this:

Troubleshooting Aspen PlusTo test connectivity in client-server installations of Aspen Plus,verify whether the Windows client can resolve its own name andthe name of the remote host running the Simulation Engine intotheir respective TCP/IP addresses.1 In the MS-DOS Command Prompt window, type:

ping localhost

where localhost is the nodename of the local host.If ping does not succeed, add the PC name and address to thedomain name server (if configured), or to the local LMHOSTSfile.

2 In the MS-DOS Command Prompt window, type:ping remotehost

where remotehost is the nodename of the remote host.If ping does not succeed, add the remote host name and addressto the domain name server (if configured), of the localLMHOSTS file.

Problem Client installations to a Novell file server fail whenyou try to run calculations on a local PC.

Cause The Novell file server is truncating long directorynames.

Solution Move simulation engine directories to a location thatdoes not contain any directory names with more than 8characters or any special characters.

Testing client-serverconnectivity

Client-ServerInstallation Problems


Problem On Windows NT hosts connected to a Novell FileServer, using Novell Client 32: When a user executesthe shortcut for the Aspen Plus Simulation EngineWindow, the environment does not set up properly.

Cause The Novell Client32 software prevents the SimulationEngine icon from modifying the system path.

Solution You can verify this problem by typing SET at theDOS prompt in the Simulation Engine Window andchecking whether the %ASPTOP%\xeq has beenadded to the beginning of the user’s path.

To resolve this problem, the user needs to add theclient32.bat file to the path_line of the Aspen PlusSimulation Engine shortcut icon.To do this:1 In Windows Explorer navigate to this directory:

\Start Menu\Programs\Aspen EngineeringSuite\AspenTech\Aspen Plus 11.1

2 Right-click the Aspen Plus Simulation Engineshortcut icon and click Properties on the menu.

3 Display the Program tab and add the location ofthe client32.bat file to the Batch file line. Thedefault location of this file is:\Program Files\AspenTech\APRSYSTEM 11.1\GUI\xeqEnclose the pathname in double quotes.

You should now be able to start the Aspen PlusSimulation Engine with the shortcut you just modifiedand the environment will be setup correctly.

You might see these error messages on a user PC that is unable toconnect to a server:

Message rexec:connect:Connection refusedrexec: can't establish connection

Cause The REXECD service on the server running thesimulation server software is not installed or started.

Solution On the server computer, click the Start | Settings |Control Panel. Double-click Services, make sure thatREXECD is running and that Automatic startup isselected.

Error Messages


Message Logon Failure: unknown user name or badpassword. (1326)rexec: can't establish connection

Cause You have not provided a valid user name or passwordfor the remote machine.

Solution Remember that unless you specify the DOMAIN namebefore your user name, REXEC will try to use anaccount defined locally on the remote machine.

You may encounter error messages when starting the Aspen PlusUser Interface or when attempting to run a simulation:

Message When starting the Aspen Plus User Interface thismessage appears:Aspen Plus Version 11.1 could not open theData Browser menu database. Data entry andresults forms will not be available.

Cause The installation did not correctly build the DataBrowser and Forms database file, ApwnMenu. Thisfile, located by default in C:\Program Files\AspenTech\Aspen Plus 11.1, should always be largerthan 1 MB.

Solution 1 In a Command Prompt (DOS) window, run theApwnSetup.exe utility. The default location is:C:\Program Files\AspenTech\Aspen Plus11.1\GUI\xeq.

2 On the Update System Registry dialog box clickNext.

3 On the Register Forms dialog box accept alldefaults and click Next.

4 On the Register PlotWizard dialog box accept alldefaults and click Finish.

Aspen Plus UserInterface


Message The Windows NT client running the user interfacecannot connect to the Windows NT simulation enginehost. The Control Panel of the Aspen Plus UserInterface displays the following message:

Failed to connect to remote host, probable causebad password, bad hostname or network notinstalled. Socket level message is: 3000 - UserA533LX\r10: Logon failure: the user has not beengranted the requested logon type at thiscomputer. (1385) Command to start xcserver was:%3:0 xcserver.exe

Cause The User Rights Policy to allow “Log on as a batchjob” has not been granted to the user specified in theerror message.

Solution See “Configuring a Windows Server as an AES Host”on page 5-13.

Installation Manual_Aspen Engineering Suite 11.1 Aspen Properties •••• 21-1

C H A P T E R 21

Aspen Properties

This chapter contains the following sections:• Installation Notes• Verifying the Aspen Properties Installation• Setting Up Aspen WebProperties• Running Aspen Properties and Aspen WebProperties on

separate machines

Installation NotesAll installations of this version of Aspen Properties require thecore Properties System for Aspen Properties (APrSystem)subcomponent.

Verifying the Aspen PropertiesInstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify the installation of Aspen Properties on a user PC:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Properties | Aspen PropertiesUser Interface.

2 In the Aspen Properties Startup dialog box, select Template,then click OK.

3 Select General with English Units, then click OK.The Components Specifications Selection sheet appears.

21-2 •••• Aspen Properties Installation Manual_Aspen Engineering Suite 11.1

4 Define these components:waterethanol

5 Go to the Databanks sheet and verify that the followingdatabanks are listed in the Selected databanks column:

PURE11AQUEOUSSOLIDSINORGANIC.

6 Return to the Components Specifications Selection sheet, andpress F1 to display Help on Components Selection.

7 Click the Review button.The Properties Parameters Pure-Component Review-1 formappears. Parameters such as API, CHARGE, DGFORM, etc forthe components should be displayed.

8 Click Next to display the Properties Specifications Globalsheet and specify:Property Method = NRTL (Top right corner field, select fromthe list)

9 Click Next to display the Properties/Parameters/BinaryInteraction/NRTL-1/Input sheet.Parameters should already be filled in for water and ethanol

10 On the menu bar click Tools | Analysis | Property | Binary.The Binary Analysis dialog box appears.

11 For Analysis type, select Txy.Components water and ethanol are already specified forComponent 1 and Component 2.

12 Click Go to perform the analysis.When complete, the Binary Analysis Results dialog box andthe Txy plot should appear.

13 In the Binary Analysis Results dialog box, click on PlotWizard.

14 In the Plot Wizard Step 1 dialog box, click Next.15 On Step 2 of the Plot Wizard, select KVL, then Next and

Finish.The KVL plot should appear.

You have now successfully verified your installation.


Setting Up Aspen WebPropertiesAspen WebProperties, a component of Aspen Properties 11.1, is aWeb-browser interface that enables users to quickly look upphysical property information or to perform property calculations.

These are the system requirements for Aspen WebProperties:• Microsoft Internet Information Server (IIS) must be installed a

Windows NT Server machine• Aspen Properties 11.1 must be installed on the machine

running the NT web server.

Note: Only a system administrator should setup and configureAspen WebProperties.

To set up Aspen WebProperties for deployment:1 On your Windows NT web server machine, install the Aspen

Properties 11.1, using the Standard install option.For instructions see Chapter 3, Standard Installation.

2 Configure ISS for Aspen WebProperties.For instructions, see “Configuring IIS for AspenWebProperties,” on page 21-3.

3 Set up WebProperties user folders to store problem files on theweb server.For instructions, see “Setting up WebProperties Userfolders,”on page 21-6.

After you install Aspen Properties on the web server, you mustconfigure the Internet Information Server (IIS) for WebProperties.

To configure IIS for Aspen WebProperties:1 On your desktop click Start | Programs | Windows NT 4.0

Option Pack | Microsoft Internet Information Server |Internet Service Manager.

2 In the console tree expand Internet Information Server |<your_IIS_server_name>

3 Right click Default Web Site and click New | VirtualDirectory on the menu.

Configuring IIS forAspen WebProperties


4 In the New Virtual Directory Wizard dialog box enterAspenTech as the Alias to be used to access the virtualdirectory.

Click Next to continue.5 Click Browse and locate the physical path to the

WebProperties directory. For example:D:\Program Files\AspenTech\Aspen Properties11.1\WebProperties

Click Next to continue.6 For the Access permissions, select:

• Allow Read Access• Allow Script Access• Allow Execute Access (Includes Script Access)Then click Finish.AspenTech appears under the Default WebSite in the consoletree.

7 Copy all files from ..\AspenTech\Aspen Properties11.1\WebProperties\InstallRoot to the wwwroot directory ofyour IIS installation.

8 Enable the use of out-of-process components.For instructions, see “Enabling the use of Out-of-Processcomponents” on page 21-5.

9 Set up access security for valid users of Aspen WebProperties.For instructions, see “Setting up directory security” on page21-5.


To use WebProperties, you must configure your IIS installation toallow out-of-process components. The IIS metabase stores the IISconfiguration settings.

Note: You must have adequate permission to modify the IISmetabase.

For more information on out-of-process components, see theEnabling the Use of Out.doc file in the WebProperties productdirectory.

To enable the use of out-of-process components:1 Open your browser and enter the following Address:

http://localhost/oopcomp.asp.You should see your Windows NT user account displayed atthe bottom of the page.

Note: If you do not see an account name, you are accessing thepage anonymously and may not be able to modify IIS metabaseproperties.

2 Click the Set button.A message should appear, confirming that the metabase hasbeen updated.

3 In the console tree of the Internet Service Manager, right-clickthe AspenTech Default Web Site and select Properties fromthe menu.

4 Display the Virtual Directory tab and select the Run inseparate memory space option. Then click OK.

5 Restart the Web Server service.

To set up access security for Aspen WebProperties:1 In the console tree of the Internet Service Manager, right-click

the AspenTech Default Web Site and select Properties fromthe menu.

2 Grant the access rights to valid users of Aspen WebPropertiesat your site.

Enabling the use of Out-of-Process components

Setting up directorysecurity


For example, to display the NT user log in box when a user wantsto access Aspen Properties:1 On the AspenTech Properties dialog box, display the

Directory Security tab and click the Edit button forAnonymous Access and Authentication Control.

2 In the Authentication Methods dialog box:• Select the Windows NT Challenge/Response checkbox.• Clear the checkboxes of the other options.

3 Click OK and then click OK again to close the dialog box.

Users of WebProperties need a place to store their problem files onthe web server. You must create the WebProperties userfolderdirectory and specify the location in these WebProperties files:• Userfolder.inc• Userfolder.jsBoth files are located in the ..\AspenTech\Aspen Properties11.1\WebProperties\Custom directory.

To set up the storage directory for WebProperties user files on theweb server:1 Create a directory under which WebProperties users can store

problem files.For example: E:\WebPropsUsers

2 In this directory, create a folder for each WebProperties user.For example: E:\WebPropsUsers\username1

3 Edit Userfolder.inc in the ..\AspenTech\Aspen Properties11.1\WebProperties\Custom directory and specify theUserFolder on your web server.For example:

<%Dim UserFolderUserFolder = "E:\WebPropsUsers"%>

Use quotation marks to enclose the pathname.4 Edit Userfolder.js in the ..\AspenTech\Aspen Properties

11.1\WebProperties\Custom directory and specifytop.userFolder on your web server.For example:

top.userFolder = "E:\\WebPropsUsers";

Use quotation marks to enclose the pathname.Use \\ to delimit subdirectories.

Setting upWebPropertiesUserfolders


Running Aspen Properties andAspen WebProperties on separatemachinesIf you want to run Aspen Properties and Aspen WebProperties onseparate machines, follow the instructions in this section to set upAspen WebProperties for deployment.

To run Aspen Properties and Aspen WebProperties on separatemachines:1 Install Aspen Properties 11.1 User Interface subcomponent,

which contains Aspen WebProperties, on the web servermachine.

2 Configure IIS for WebProperties.For instructions, see “Configuring IIS for AspenWebProperties” on page 21-3.

3 Install Aspen Properties 11.1 (standard) on a separatecomputer.

4 Configure DCOM for Aspen WebProperties on the web server.For instructions, see “Configuring DCOM on the web server”on page 21-7

5 Configure DCOM for Aspen WebProperties on the machinerunning Aspen Properties.For instructions, see “Configuring DCOM on the AspenProperties machine” on page 21-8.

To configure DCOM on the web server for Aspen WebProperties:1 On the web server machine locate the

SetupWebPropDCOM.reg file in the ..\Aspen Properties11.1\WebProperties\InstallRoot directory.

2 Double click on SetupWebPropDCOM.reg to register AspenProperties 11.1 as a remote server on the machine runningAspen WebProperties.

3 On the desktop of the web server machine, click Start |Run. Inthe dialog box enter dcomcnfg and click OK.The Distributed COM Configuration Properties dialog boxappears.

4 On the Applications tab select Aspen Properties Documentin the list and click Properties.

Configuring DCOM onthe web server


5 On the Aspen Properties Document Properties dialog boxdisplay the Location tab and do the following:• Select the Run application on the following computer

checkbox and enter the name of the computer that will runAspen Properties 11.1.

• Clear the Run application on this computer checkbox.6 Display the General tab and select the appropriate

Authentication level for your location.7 When finished, click OK.

Note: You can specify additional security and setup options on theDistributed COM Configuration Properties dialog box, usingthe Default Properties and Default Security tabs.

Setting the correct permission levels on the machine runningAspen Properties 11.1 is necessary for DCOM to work properly. Ifa user is not authorized to use the system, there will be servererrors when Aspen Properties 11.1 is accessed via DCOM. TheDCOM specifications are specific to your location and authorizedusers.

To configure DCOM on the machine running Aspen Properties:1 On the desktop of the Aspen Properties machine click Start

|Run. In the dialog box enter dcomcnfg and click OK.The Distributed COM Configuration Properties dialog boxappears.

2 On the Applications tab select Aspen Properties Documentin the list and click Properties to set any custom security forthis application (Security tab of the Properties dialog box).

3 Display the Default Properties tab and do the following:• Select the Enable distributed COM on this computer

checkbox.• Select the appropriate Default Authentication Level.

4 Display the Default Security tab and edit the Default AccessPermissions and Default Launch Permissions to givepermission to all the users of the application.

Note: If a user is not authorized at this level, then the user will notbe able to use Aspen WebProperties.

5 When finished, click OK.

Configuring DCOM onthe Aspen Propertiesmachine

Installation Manual_Aspen Engineering Suite 11.1 Aspen Split •••• 22-1

C H A P T E R 22

Aspen Split

This chapter contains the following sections:• Installation Notes• Verifying the Aspen Split Installation

Installation NotesWhen you install Aspen Split 11.1:• Ensure that standard version of Aspen Plus 11.1, which

includes the core Properties System component, the Aspen PlusSimulation Engine, and the Aspen Plus User Interface, isinstalled and accessible.

or• Install Aspen Plus simultaneously with Aspen Split.Aspen Split includes two subcomponents:Subcomponent Description

Distillation AnalysisComponents

Adds azeotrope search andresidue curve mapfunctionality to Aspen Plus.

Stand-Alone Configuration Installs Aspen Split as a stand-alone application.

By default both subcomponents are installed. However, you canchoose to install one or the other of these subcomponents.

Verifying the Aspen Split InstallationUse the following procedures to verify an installation of AspenSplit on a user PC.

22-2 •••• Aspen Split Installation Manual_Aspen Engineering Suite 11.1

Since the Aspen Split Distillation Analysis component runs underAspen Plus, first verify the installation of Aspen Plus. For moreinformation see Chapter 20, Aspen Plus.

To verify the installation of the Distillation Analysis component:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Plus 11.1 | Aspen Plus UserInterface.

2 In the Aspen Plus Startup dialog box select Open anExisting Simulation. Then select More Files and click OK.

3 In the Open dialog box click the Look in Favorites foldericon. Then open Applications and select 3phase.bkp and clickOpen.

4 In the Connect to Engine dialog box, select Local PC for theServer type and click OK.

5 On the Aspen Plus menu bar, click Tools | Aspen Split |Ternary Maps to start the Distillation Analysis component.The Ternary Maps window appears within the Aspen PlusWindow, for example:

6 For Comp 3 select MCACET from the list of components.7 In the Explorer tree click Ternary Plot to start the calculations

for generating the ternary map.

Verifying the AspenSplit DistillationAnalysis component


When the calculations are complete the ternary map that isgenerated should look like this:

To verify the stand-alone Aspen Split installation:1 If you have not already done so, restart Windows to activate

the changes made to your configuration during the installation.2 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Split 11.1 | Aspen Split 11.1.3 On the Choose Base Directory dialog box, select Set Base

Directory and click OK.

4 On the Set Base Directory dialog box, locate and select theSample Problems folder in the Aspen Split installation. Thenclick OK.If necessary, select the appropriate drive from the Drives list.The Aspen Split window appears and displays the CaseManager window.

Verifying the Stand-Alone Configurationof Aspen Split


5 In the tree of the Case Manager expand the Sample Problemsfolder and click the Property Analysis folder to display itscontents.For example:

6 Do one of the following:Menu bar: Click Analysis | Ternary Diagram.

Toolbar: Click the Draw Ternary Diagram button .7 When prompted to select an Aspen Plus problem definition file

(.appdf), select example.appdf in the Sample Problemsfolder.At this time Aspen Split begins a property packageinitialization. The example.appdf file is large, so theinitialization may take a minute or two.


When the initialization is complete, a Ternary Diagramwindow appears.

Use the set of tabs at the bottom of the window to enter data.8 Click the Components tab and select All Components. Ensure

that these are the components:• Comp1 = METHANOL• Comp2 = ACETONE• Comp3 = CHLF

9 Click the Properties tab and select these Physical PropertyModels:• VLE property model = WILSON• LLE property model = UNIFACThe number of phases for the model is 2.

10 Click the Ternary Diagram tab to calculate and display theternary diagram with residue curves.


The diagram should look like this:

For more information about residue curves in ternary diagrams,see the “Analysis of Mixture Properties, Ternary Diagrams”section in Chapter 3 of the Aspen Split User Guide.

Installation Manual_Aspen Engineering Suite 11.1 Aspen Traflow •••• 23-1

C H A P T E R 23

Aspen Traflow

This chapter contains the instructions for verifying the installationof Aspen Traflow on user PCs.

Verifying the Aspen TraflowInstallationAspen Traflow is a layered product of Aspen Dynamics. To verifythe installation of Aspen Traflow, see Chapter 14, AspenDynamics.

23-2 •••• Aspen Traflow Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen Utilities •••• 24-1

C H A P T E R 24

Aspen Utilities

This chapter contains the instructions for verifying the installationof Aspen Utilities on user PCs.

Verifying the Aspen UtilitiesInstallationUse the following procedure to verify an installation of AspenUtilities on a user PC:

Note: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify an Aspen Utilities installation:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Utilities 11.1 | Aspen Utilities.2 Open the demo.auf file in the Aspen Utilities working folder.

The default location is:C:\Program Files\AspenTech\Working Folders\AspenUtilities 11.1

3 On the menu bar click Run | Run.Aspen Utilities takes a few seconds to run the simulation. Thesimulation should run with no errors.

To set up the Microsoft Excel interface to Aspen Utilities:1 Start Microsoft Excel.2 Open demo.xls located in the Aspen Utilities working folder.

The default location is:C:\Program Files\AspenTech\Working Folders\AspenUtilities 11.1

Aspen Utilities

Microsoft ExcelInterface

24-2 •••• Aspen Utilities Installation Manual_Aspen Engineering Suite 11.1

3 On the menu bar click Tools | Add-Ins.4 On the Add-Ins dialog box click Browse and navigate to the

Aspen Utilities bin folder.The default location is: C:\Program Files\AspenTech\Aspen Utilities 11.1\bin

5 Select Utilities.xla and click OK. Then Click OK on the Add-Ins dialog box.

6 When the confirmation dialog box appears, click OK.7 On the menu bar click Aspen Utilities | Open Aspen Utilities

File.8 Navigate to the Aspen Utilities working folder and open

demo.auf.The default location is:C:\Program Files\AspenTech\Working Folders\AspenUtilities 11.1When the Aspen Utilities window appears, the CloseDocument dialog appears.

9 On the Close Document dialog, click Cancel.10 Return to Microsoft Excel.

You should see a File Open completed message. Click OK.11 On the menu bar click Aspen Utilities | Optimize Flowsheet.

The optimization should complete with no errors.12 Close Aspen Utilities and Microsoft Excel.You have now successfully verified your installation.

Installation Manual_Aspen Engineering Suite 11.1 Aspen Water •••• 25-1

C H A P T E R 25

Aspen Water

This chapter contains the instructions for verifying the installationof Aspen Water on user PCs.

Verifying the Aspen WaterInstallationNote: If you have not already done so, restart Windows to activatethe changes made to your configuration during the installation.

To verify the installation of Aspen Water on a user PC:1 Create an empty test folder and copy into it the file,

Flowsheet1.awfThe default location of this file is:C:\Program Files\AspenTech\Water 11.1\Examples\

2 In Windows Explorer, open your test directory and double-click the Flowsheet1.awf file to start Aspen Water and load thesimulation.

4 On the menu bar click Run | Run.Aspen Water will take a few moments to run the simulation.

5 On the menu bar click File | Exit, and then click No whenprompted to save changes.

You have now successfully verified your installation. You can nowdelete your test folder and its contents.

25-2 •••• Aspen Water Installation Manual_Aspen Engineering Suite 11.1

Installation Manual_Aspen Engineering Suite 11.1 Aspen WebModels Author •••• 26-1

C H A P T E R 26

Aspen WebModels Author

This chapter contains the following sections:• Configuring the Aspen WebModels Author Installation• Verifying the Aspen WebModels Author Installation• Troubleshooting Aspen WebModels Author

Configuring the Aspen WebModelsAuthor InstallationUsers who run Aspen WebModels Author must be members of theAuthor role. Additionally, to test a WebModel associated with aparticular role, users must also be members of that role.

For more information on assigning users to roles, see the:• Aspen Framework Installation Manual• Business Process Explorer Help SystemBefore you can view an Aspen WebModels model in yourbrowser, you must enable the following ActveX-related securitysettings for Internet Explorer:• Download signed ActiveX controls• Run ActiveX controls and plug-ins• Script ActiveX controls marked safe for scripting

Configuring the AFWAuthor Role

Configuring InternetExplorer forWebModels

26-2 •••• Aspen WebModels Author Installation Manual_Aspen Engineering Suite 11.1

Verifying the Aspen WebModelsAuthor InstallationWebModels Author users require access to the WebModels filerepository for storing the WebModels.

WebModels Author will not run until it validates communicationswith the Aspen Framework server and the File Repository.

To start Aspen WebModels Author:1 From the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | WebModels 11.1 | WebModels Author.The Registry Settings dialog box appears, for example:

Note: This dialog only appears if AspenWebModels Author cannotlocate the AspenFrameWork server or the File Repository.


File Repository The Visual SourceSafe (VSS) INI file thatcontains the user access permissions to thefile repository of the WebModels.

Server Name The name of the Aspen Frameworkserver.


3 Specify email related options for sending email notificationswhen a WebModel is published.

NoMail Services When selected, no email notifications aresent.

Use MAPI Use MAPI protocols to send emailnotifications.

Use SMTP Use SMTP protocols to send emailnotifications.

Mail Server The name of the SMTP email server.

Port Number The port on which the email server isrunning. The default is 25.

4 Click OK.If all connection tests pass, the Aspen WebModel Author windowappears, for example:

This concludes the verification of your Aspen WebModels Authorinstallation.


Troubleshooting Aspen WebModelsAuthorYou may encounter the following error messages:

message File Repository Server is unavailable.

When you start Aspen WebModels Author, theFile Repository Connection Failure dialog appears.

Causes The dialog box displays the possible causes:1 You are not a valid VSS user.2 Your registry settings for VSS access are

incorrect.3 Your computer is not properly connected to the

network.4 You do not have the appropriate rights to

access the File Repository Server.

Solutions 1 Check the Visual SourceSafe (VSS) INI filefor valid users, and update if necessary.

2 Check the computer's registry settings for VSSaccess, and update if necessary.

3 Check the computer's network connections,and map the proper connections if necessary.

4 Check the computer's access rights to the FileRepository server, and update if necessary.

message Aspen Framework database connection failure

When you start Aspen WebModels Author, theAspen Framework Database Connection Failuredialog appears.

Causes The dialog box displays the possible causes:1 You registry settings for database access are

incorrect.2 Your computer is not properly connected to the

network.

Solutions 1 Check the computer's registry settings forAFW database access, and update if necessary.

2 Check the computer's network connections,and map the proper connections if necessary.

Error Messages


You may encounter the following problems:Problem Cannot publish a WebModel

The WebModel is properly configured andcontains all required components, but when youclick File | Publish Model, you get an errormessage.

Solution One or more of the WebModels dynamic linklibrary (.dll) files in Aspen Framework’s BusinessProcess Explorer (BPE) may not be properlyregistered. In particular, you should ensure thatPFWSecurityAPI.dll is registered.

Aspen WebModels Author provides a BAT file,which when run, registers the Business ProcessExplorer (BPE) dynamic link library (.dll) files.

To register the Business Process Explorer DLLs:1 In the WebModels Author home directory,

locate this file:BPEREG.BAT

2 Copy the BPEREG.BAT file into theAspentech\BPE directory, which is typicallylocated under the Program Files directory ofyour computer.

3 Open the BPE folder to display its contents.4 Double-click the BPEREG.BAT.

This action registers the DLLs in the BPE folderand should remedy your publishing problem.

Problems

Installation Manual_Aspen Engineering Suite 11.1 Aspen WebModels Server •••• 27-1

C H A P T E R 27

Aspen WebModels Server

This chapter contains the following sections:• Before You Install Aspen WebModels Server• Installation Notes• Configuring the WebModels Server Installation• Verifying the WebModels Server Installation• Troubleshooting Aspen WebModels Server

Before You Install Aspen WebModelsServerThe following software must be installed on the same computer asAspen WebModels Server:• Windows NT 4.0 Option Pack

Required if you plan to install WebModels Server onWindows NT.

• Microsoft SQL Server 7.0• Microsoft Visual SourceSafe (VSS) Client Version 6.0 or later,

USA versionAspen WebModels uses VSS to manage the model files in theWebModels library.

• Aspen Framework (AFW) Server V2.2• Aspen Framework Middle Tier Component V2.2• Aspen Plus 11.1 Standard Version

This version includes the core Properties System component,the Aspen Plus Simulation Engine and the Aspen Plus UserInterface.

27-2 •••• Aspen WebModels Server Installation Manual_Aspen Engineering Suite 11.1

Installation NotesTo install the WebModels Server:1 Create a WebModels Server user account with administrative

privileges.For guidelines see “Creating the Aspen WebModels Serveruser account” on page 27-2.

2 Install WebModels Server, using the Server install option.For instructions see Chapter 5, Client - Server Installation.

3 Create the WebModels database.For instructions see “Creating the WebModels Database” onpage 27-2.

Before you insert the AES Application/Product Software CD intothe CD-ROM drive of the server machine, you must create aWebModels Server user account. This account• Must be the same user account on your web server and all

calculation servers.• Will be used only by the Aspen WebModels system.This user account must have administrative privileges on thesecomputers and cannot be a local account. The user accountprivileges are critical for the various Aspen WebModelscomponents to function correctly.

After you click the Start Installing button on the Summarydialog box, the Create SQL Server Aspen FrameworkDatabase dialog box appears.To create the WebModels database:

1 On the Create SQL Server Aspen Framework Databasedialog box, enter the login and database details for theWebModels database as follows:

LoginDetails

• If you have administrator privileges, selectWindows NT.

• If you select the SQL Server authentication,enter the Administrator Login ID andpassword.

DatabaseDetails

1 Select the Database Name from the list.2 Specify the Database File Location.3 Specify the Log File Location.

Creating the AspenWebModels Serveruser account

Creating theWebModels Database


For example:

2 Click the Create Database button to create the WebModelsdatabase.

3 When the Setup Complete dialog box appears, select theoption, Yes, I want to restart my computer now, and clickFinish to complete the installation process.


Configuring the WebModels ServerInstallationWhen the Aspen WebModels Server installation is complete,perform the following tasks:Task For details, see

1 Configure VSS to work with WebModels. Page 27-4

2 Configure Aspen Framework (AFW) forWebModels.

Page 27-5

3 Configure WebModels Server. Page 27-7

4 Configure Microsoft Transaction Server. Page 27-16

5 Set default security permissions underDCOM.

Page 27-17

6 Configure WebModels Servercomponents under DCOM.

Page 27-17

7 Configure remote Calculation Serversunder DCOM.

Page 27-18

8 Specify Internet Information Server (IIS)settings.

Page 27-18

9 Specify AFW security settings forWindows 2000 under IIS

Page 27-18

10 Verify the WebModels Server installation. Page 27-19

Configuring VSSAfter the Aspen WebModels Server is installed:• Ensure that the account whose identity is to be used for the

MTS packages and DCOM identities is set up with VSS.• Add WebModels Author users.

The users of WebModels Author create, maintain, and publish theweb models. These users require access permissions to theWebModels library through VSS.

Note: When you add a user to the VSS database, leave thepassword field blank.

Adding WebModelsAuthor users


To add WebModel Author users to VSS:1 From the desktop click Start | Programs | Microsoft Visual

Studio 6.0 | Microsoft Visual SourceSafe | Microsoft VisualSourceSafe 6.0 Administration.

2 In the Visual SourceSafe Login dialog box, enter theAdministrator password and the name of the VSS Database.The Visual SourceSafe Administrator dialog box appears, forexample:

3 Click Users | Add on the menu bar.4 In the Add User dialog box, enter a WebModels Author user

name.

Important: Do not enter a password for the user.

5 Click OK.6 Repeat steps 3 through 5 for each user you want to add.

Configuring Aspen FrameworkIn Aspen Framework (AFW), security is role-based, where a role isa logical grouping of users. Permissions are assigned to roles andindividual users are made members of roles.

Aspen WebModels makes full use of this role-based security byproviding two default Aspen Framework roles:• Administrator, which is required to build the WebModels

library.• Author, which role is required to create and publish a

WebModels model


To import the WebModels roles and applications into the AFWsecurity component:1 Copy the files AESWebModelsAPPL.XML and

AESWebModelsROLE.XML from ...\ProgramFiles\AspenTech\WebModels 11.1\bin to...\ProgramFiles\AspenTech\Bpe.

2 Run the AFWTools.exe program located in theAspenTech\Bpe directory.

3 In the AFW Tools window, click the TransferAFWDBDatatab.

4 Specify the name of the AFW Server computer.5 Uncheck Transfer PROFILES.6 To import the default AFW roles for WebModels, select

Transfer ROLES and rename PFWROLE.XML toAESWEBMODELSROLE.XML.

Important: Do not select Transfer ROLES if you have alreadycreated an Administrator or Author role by directly using the AFWSecurity Manager.

7 To import the applications, select Transfer APPLICATIONSand rename PFWAPPL.XML toAESWEBMODELSAPPL.XML.

8 Click the Import button.9 Exit AFW Tools.

To configure security for the WebModels roles and applications:1 On the desktop click Start | Programs | AspenTech | AFW

Security Manager.2 In the console tree expand AFW Security Manager and click

Applications.3 In the details pane right-click WebModels and click

Properties on the menu.4 Under Application Properties, give Read, Write, and

Execute permissions to both the Author and Administratorroles.

5 In the console tree, expand AFW Security Manager |Applications and click WebModels.

6 In the details pane right-click AspenPlus and click Propertieson the menu.

7 Under Application Properties, give Read, Write and Executepermissions to both the Author and Administrator roles.

Importing roles andapplications into theAFW securitycomponent

Configuring securityfor the WebModelsroles andapplications


8 In the console tree, expand AFW Security Manager and clickRoles.

9 In the details pane right-click Author and click Properties onthe menu.

10 Click the Members tab and add all users that are designatedWebModels authors. These users should be the same as thoseconfigured as VSS users earlier.

11 Click OK when done.12 In the details pane right-click Administrator and click

Properties on the menu.13 Click the Members tab and add all users that are designated

WebModels administrators.

Important: Ensure that the WebModels Server system account is amember of the Administrator role.

14 When finished, click OK and exit the AFW Security Manager.

You may create as many roles as your site requires. For example,you may wish to create a role specifically for those users who willbe running a designated collection of models.

For more information creating AFW roles, see the:• Aspen Framework Installation Manual• Business Process Explorer Help File

Note: You must configure security for each addition role that youcreate.

Configuring the WebModels ServerYou must perform these tasks to configure the installedWebModels server:Task For details, see

1 Configure the application servers. Page 27-82 Configure the AFW roles. Page 27-103 Configure the Aspen applications. Page 27-12

Additionally, you can:• Prioritize server resources for an application.• Configure E-Mail addresses for WebModels-related

notifications.

Creating additionalroles


Use the Aspen WebModels Administrator to configure theWebModels server.

To use the WebModels Administrator:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | WebModels 11.1 | Aspen WebModelsAdministrator.

2 In the console tree expand Aspen WebModels Administrator.3 Expand the Server icon of the machine on which the

WebModels Server is installed to display the items.For example:

The Server displays information related to the application serversused with WebModels. Use the Server to:• Add a new application server to the WebModels configuration.• Edit a server’s information.• Delete an application server from the WebModels

configuration

To add an application server to the WebModels configuration:1 In the console tree click the Server folder to display its details.2 Right-click anywhere in the details pane and click New Server

on the shortcut menu.

Using the WebModelsAdministrator

Configuring theApplication Servers

Adding an ApplicationServer


The Add a New Server dialog box appears, for example:

3 Enter the following information:Property Value

Name The application server machine name as itappears on the network.

Upper CPUThreshold

The point at which the system will notlaunch any more calculators for this server(expressed as a percentage of CPUutilization).

The default is 45 (percent).

MaxApplications

The maximum number of applications forthis server.• For large or complex models, set the

value to one application per server.• For smaller models, set the value to two

applications per server (default).

Sim RootDirectory

The root directory Aspen WebModelssimulators use for temporary files on thisserver. Depending on how the server isconfigured, it could be:• The Windows default TEMP directory• A directory of your own choosing• The default simulator working directory.

The default is c:\temp.


Property Value

Sim RootDirectoryShare Name

The share name for the temporary simulatorfiles directory.

The default is temp.

Normalization The default is 1.

This value attempts to compare the listedserver to a 500 MHz Pentium processor.Aspen Plus uses this value to balance highpriority requests and complex models withthe fastest available resources in the serverfarm.

4 Select the AFW roles to be linked with this server.For example, the default WebModels roles are Author andOperator.

5 Select the applications to be linked with this server.The default is APlus.


To update information for an Application Server in theWebModels configuration or to delete the server from theconfiguration:1 Display the Server folder details.2 Right-click the Server name and do one of the following:To Do this

Update serverinformation

Click Edit on the shortcut menu to display theEdit Server dialog box.

Make the desired updates and click OK.

Delete theserver

Click Delete on the shortcut menu and clickYes on the Delete Record confirmation dialogbox.

The Role displays information related to the Aspen Framework(AFW) roles used with Aspen WebModels. The WebModels rolesthat you set up in “Configuring Aspen Framework” on page 27-5must be added here.

To add a role to the WebModels configuration:1 In the console tree click the Role folder to display its details.

Modifying ServerInformation

Configuring theWebModels Roles

Adding a Role


2 Right-click anywhere in the details pane and click New Roleon the shortcut menu.The Add a New Role dialog box appears:


Property Value

Role Name Select the name from the list of availableroles.

Queue Jump Select this checkmark box to enable queuejumping.


Property Value

Set Lock Select this checkmark box if it would beinefficient for work to be swapped out foranother process (requiring a timely reload).

For example, it would be best to set the lockfor users who run lengthy simulations oneafter another so that when one simulationfinished, the session would remain active forthe user to alter a variable and rerun thesimulation. In such cases, reloading thesimulation each time would be quite time-consuming and undesirable.

Server Mask Select the application servers on which therole can work.


To update or delete a WebModels Role:1 Display the Role details.2 Right-click the Role name and do one of the following:

To Do this

Update roleinformation

Click Edit on the shortcut menu to display theEdit Role dialog box.


Delete Click Delete on the shortcut menu and clickYes on the Delete Record confirmation dialogbox.

The Application displays information related to the Aspenapplications used with WebModels. Use the Application to:• Add a new application to the WebModels configuration.• Edit an application’s information.• Delete an application from the WebModels configuration.

Modifying RoleInformation

Configuring AspenApplications


To add an Aspen application to the WebModels configuration:1 In the console tree click the Application folder to display its

details.2 Right-click anywhere in the details pane and click New

Application on the shortcut menu.The Add a New Application dialog box appears, for example:


Property Value

ApplicationName

APlus is the only valid application for thecurrent version of WebModels.

Program ID APWN.DOCUMENT

Freeboard The number of idle calculators based on thecapacity of site, calculator launch latency,and the frequency of hits per period of time.

The default is 1.

For example, if the FreeBoard is set to “2”,there will always be two calculators in anidle state waiting for commands to run asimulation. When one of these calculators isloaded with a simulation, another calculatorwill be loaded and idled to keep the numberof idle calculators at “2.”

Time OutInterval

The default is 30000 milliseconds.

Adding an Application


Property Value

Session Lock This field is checked by default, to enablesession lock.

Can BeReused

Leave this field unchecked for Aspen Plusapplications.

Server Name The name of the server machine on whichthe Aspen application is running.


To update information for an application in the WebModelsconfiguration or to delete an application from the configuration:1 Display the Application details.2 Right-click the Application name and do one of the following:To Do this

Update applicationinformation

Click Edit on the shortcut menu to displaythe Edit Application dialog box.


Delete anapplication

Click Delete on the shortcut menu andclick Yes on the Delete Recordconfirmation dialog box.

The Server Order enables you to specify the order in which theWebModels Server prioritizes server resources for a selectedapplication.

For example, if “Server_1” is faster than “Server_2,” you mightwant to put “Server_1” at the top of the list. WebModels willattempt to use this server first, when using the associatedapplication to try to run a simulation. Should that server beunavailable, WebModels will attempt to use the next server in thelist until it succeeds in securing resources to run the requestedsimulation.

To prioritize server resources for a given application:1 In the console tree click the Server Order folder to display its

details.2 In the details pane select the application in the left column.3 Select the server in the right column and click the Up and

Down arrows to move the server to the desired priority for theselected application.

Modifying ApplicationInformation

Prioritizing ServerResources


Every model in the public WebModels library is associated with anAFW role. When the WebModels Author publishes a WebModelsmodel, an e-mail notification is sent to all members of theassociated AFW role. The User E-Mail Addresses enables you toadd, update, and delete e-mail information for WebModels users.

To add a user e-mail address to the WebModels configuration:1 In the console tree click the User E-Mail Addresses folder to

display its details.2 Right-click anywhere in the details pane and click New User

on the shortcut menu.The Add User Information dialog box appears, for example:


Property Value

Username Name of the WebModels user.Email Address The complete email address of the user.Role Name The AFW role of which the user is a

member.4 When finished, click OK.

To update or delete a WebModels user e-mail address:1 Display the User E-Mail Addresses details.2 Right-click the User Name and do one of the following:

To Do this

Update usere-mailinformation

Click Edit on the shortcut menu to display theEdit User Information dialog box.


Delete usere-mail address

Click Delete on the shortcut menu and clickYes on the Delete Record confirmation dialogbox.

Use the LoadBalancer Configuration to specify theadministrator’s e-mail address for the WebModels Server. Theother LoadBalancer properties are set to their recommendeddefaults.

Configuring E-MailAddresses

Adding an E-MailAddress

Modifying user e-mailaddresses

Updating theAdministrator E-Mail ID


To update the Administrator e-mail ID:1 In the console tree click the LoadBalancer Configuration to

display the details.For example:

2 Right-click the AdminEMailID property value and click Editon the shortcut menu to display the Edit Property dialog box.

3 Update the e-mail address and click OK.

Configuring MTSTo specify the identity of middle-tier in-process components:1 On the desktop,

Windows NT: Click Start | Programs | Windows NT 4.0 Option Pack |Microsoft Transaction Server | Transaction ServerExplorer .

Windows 2000: Click Start | Programs | Administrative Tools | ComponentServices.

2 In the console tree,Windows NT: Expand Microsoft Transaction Server | Computers | My

Computer | Packages Installed .

Windows 2000: Expand Component Services | Computers | My Computer |Packages Installed .

3 Right-click the eObject package and click Properties on theshortcut menu.

4 In the eObject Properties dialog box, click the Identity taband select This user.

Note: If the Identity tab is disabled, click the Activation tab, selectServer Package and then click the Identity tab again.


5 Enter the WebModels Server system account and password forthe identity of the middle tier components.

6 Select the Activation tab and select Library Package.7 Click OK and exit the program.

To set the default security settings under DCOM:1 On the desktop click Start | Run, enter dcomcnfg, and click

OK to run the DCOM configuration utility.2 Click the Default Security tab.3 In the Default Access Permissions section click Edit Default.4 Give the WebModels Server system account access

permissions. Also consider giving Everyone accesspermissions. When finished, click OK.

5 In the Default Launch Permissions section click EditDefault.

6 Give the WebModels Server system account launchpermissions. Also consider giving Everyone launchpermissions. When finished, click OK.

7 In the Default Configuration Permissions section click EditDefault.

8 Give the WebModels Server system account full configurationcontrol. Also consider giving Everyone full control. Whenfinished, click OK.

9 Click OK to exit the DCOM configuration utility.

To configure the WebModels Server components under DCOM:1 Run dcomcnfg.2 In the Applications list, select LB_QM.lb_entry and click the

Properties button.3 Click the Identity tab. Select This user and specify the

WebModels Server system account as the account under whichthis application is to run.

4 Click OK. It may take several seconds for the dialog to returnto the default DCOMCNFG view.

5 Repeat steps 2-4 for LBAssist1.CUtil and WMAP.AP.6 When finished, click OK to exit the DCOM configuration

utility.

Configuring defaultsecurity settingsunder DCOM

ConfiguringWebModels Servercomponents underDCOM


To configure the remote calculation servers under DCOM:1 Copy ..\InetPub\wwwRoot\AspenTech\WebModels111\bin

from the WebModels Server computer to a directory forWebModels on the calculation server computer. Register allthe DLLs and EXEs in this directory.

2 Run dcomcnfg.3 In the Applications list, select

AppLoader1.CleanupWorkFolder and click the Propertiesbutton.

4 Click the Identity tab. Select This user and specify theWebModels Server system account as the account under whichthis application is to run.

5 Click OK. It may take several seconds for the dialog to returnto the default DCOMCNFG view.

6 Repeat steps 3-5 for WatchDog.IWatchDogNotify.7 When finished, click OK to exit the DCOM configuration

utility.

Use Internet Information Manager (Windows NT) or InternetInformation Services (Windows 2000) to fix IIS settings:1 In the console tree, expand Internet Information Server |

your-WebModels-server | Default Web Site2 Right-click the WebModels folder and click Properties on the

menu.3 Click the Virtual Directory tab and click the Remove button.

The button changes to a Create button.4 Click the Create button.5 Click OK to exit the dialog.

Use Internet Information Services to fix Internet InformationServices (IIS) settings for Windows 2000 systems.

To specify Windows 2000 AFW security settings for ISS:1 In the console tree, expand Internet Information Services |

your-WebModels-server | Default Web Site | AspenTech |AFW.

2 Right-click Security and click Properties on the menu.3 Click the Directory Security tab.4 In the Anonymous Access and Authentication Control

section, click the Edit button.5 Select Anonymous access.

Configuring remotecalculation serversunder DCOM

Specifying IISsettings

Specifying AFWsecurity settings forWindows 2000


6 Exit IIS.

Verifying the WebModels ServerInstallationTo verify the WebModels Server installation:1 Open a Command Prompt window, and go to the directory

containing apdummy.exe:\Inetpub\wwwroot\AspenTech\WebModels11.1\Bin\TestApp

2 At the prompt, enter:apdummy /regserver

3 Change to the WebModels11.1\Bin\TestApp directory andrun the following executables in order:• CheckApplloader.exe• CheckWDog.exe• LBCheck.exe

4 Change to the AspenTech\AFW\EnterpriseObjects directoryand run:

POTreeViewTest.exe.Double-click Database. You should see the APPO_v09Enterprise Objects library.

Maintaining WebModels ServerThe following table lists tasks that should be performedperiodically to maintain the Aspen WebModels Server.Task Schedule

Reboot the Web Server 1x/week

Run defrag on the Web Server 1x/week

Delete log (*.log) files 1x/week

The Load Balancer Operations enables you to start and stop theLoadBalancer, as well as to view the status of the currently loadedcalculators.

Stopping and Startingthe LoadBalancer


Important: From a server resource perspective, this is a high-costview. Leaving this view open for extended periods can interferewith the operation of the LoadBalancer.

It is strongly recommended that you do NOT leave this view open.Use it only to start or stop LoadBalancer operations or to view thecurrent status of running calculators. You should close the view assoon as possible.

To stop or start the LoadBalancer:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | WebModels 11.1 | Aspen WebModelsAdministrator.

2 In the console tree expand Aspen WebModels Administrator,and expand the Server icon of the machine on which theWebModels Server is installed.

3 Click the Load Balancer Operations folder.The details panel displays the current status of runningcalculators.

4 In the details panel click on the toggle link below the statusreport.

5 Close the Load Balancer Operations details view.To restart the LoadBalancer, redisplay the Load BalancerOperations details view and click the toggle link. Close the detailsview as soon as possible.

Troubleshooting Aspen WebModelsServerIf you encounter problems running the WebModels Server, checkthe following, in order:1 Verify the location of Mutex and Pdh DLLs.2 Ensure that DLLs and EXEs are properly registered.3 Confirm the WebModels authentication.4 Verify the WebModels Virtual Directory .5 Check the WebModels registry.6 Check the WebModels SQL database.7 Check MTS for WebModels.8 Check the DCOM settings for the WebModels Server

components.


9 Check the DCOM settings for the calculation servers.

The WebModels LoadBalancer and the Enterprise Objects must beable to locate these files:• Mutex.dll

• Pdh.dll

Verify that these files are either located in the SYSTEM32directory or the location is specified in the Path system variable.

This is the default location of the Aspen WebModels DLL andEXE files:

…\wwwroot\AspenTech\WebModels\Bin

To register the WebModels server DLL and EXE files, run theregister.bat file located in the WebModels\Bin\Setupdirectory.

Use Internet Information Manager (Windows NT) or InternetInformation Services (Windows 2000) to confirm the WebModelsauthentication.

To confirm the WebModels authentication:1 In the console tree expand Internet Information Server |

your-WebModels-server | Default Web Site.2 Right-click the WebModels folder and click Properties on the

menu.3 In the WebModels Properties dialog box, click the Directory

Security tab.4 In the Anonymous Access and Authentication Control section,

click the Edit button.5 In the Authentication Methods dialog box, ensure that this is

the only checkbox selected:Windows NT: Windows NT Challenge/Response

Windows 2000: Integrated Windows authentication

All other checkboxes should remain unchecked.6 Click OK to close the Authentication Methods dialog box.7 Click OK to close the WebModels Properties dialog box.

Use Internet Information Manager (Windows NT) or InternetInformation Services (Windows 2000) to confirm the WebModelsauthentication by verifying that:• default.asp is the enabled WebModels default document.

Verify the location ofMutex and Pdh DLLs

Ensure that DLLs andEXEs are properlyregistered

Confirm the WebModelsauthentication

Verify the WebModelsVirtual Directory


• Expires: 0 is the WebModels custom HTTP header setting.

To verify the WebModels Server virtual directory configuration:1 In the console tree expand Internet Information Server |

your-WebModels-server | Default Web Site2 Right-click the WebModels folder and click Properties on the

shortcut menu.3 In the WebModels Properties dialog box, click the

Documents tab and ensure that:• Enable Default Document is selected• Default.asp is listed

4 Make any necessary changes and click OK to close the dialogbox.In the console tree, expand WebModels | Content | ProblemData.

5 Right-click the Problem Data folder and click Properties onthe shortcut menu.

6 In the Problem Data Properties dialog box, click the HTTPHeaders tab and ensure that the setting is:

Expires: 07 Make any necessary changes and click OK to close the dialog

box.

Use the Registry Editor to ensure that the WebModels registrykeys are set up correctly.

To check the WebModels registry:1 Run Regedit.2 Expand the Registry Editor tree as follows:

HKEY_LOCAL_MACHINE | SOFTWARE | AspenTech |WebModels

3 Ensure that these keys are listed with the correct values:Key Value

(Default) (value not set)

Database “WebModels”

FileRepository “Location of VSS srcsafe.ini forWebModels”

Example: “K:\vss\srcsafe.ini”

MailServer “Name of mail server machine“

PortNumber “25”

Check the WebModelsregistry


PvtModelTable “LibraryModel”4 Make any necessary changes and exit the Registry Editor.

Use the SQL Enterprise Manager to ensure that the SQL databaseand tables for WebModels are set up correctly.

To check the SQL database and tables for WebModels:1 In the console tree expand Microsoft SQL Servers | SQL

Server Group | your-WebModels-server | Databases |WebModels.

2 Click Tables to display the details.3 Ensure that the WebModels database contains these required

User tables:ApplicationDeletedItemsLibraryModelPropertiesRolesServerUserInfo

4 If the tables are missing, run webmodels_tables.sql, located inthe …\wwwroot\Aspentech\WebModels\Bin\Setupdirectory.

Use MTS Explorer (Windows NT) or Component Services(Windows 2000) to ensure that the eObject package identity forAspen WebModels is correct and to verify that these componentsexist:• AspenWebModelsASP.LibraryManager• AspenTech.AFW.POManagerTo check the eObject package for Aspen WebModels:1 In the console tree,

Windows NT: Expand Microsoft Transaction Server | Computers | MyComputer | Packages Installed .

Windows 2000: Expand Component Services | Computers | My Computer |Packages Installed .

2 Right-click the eObject package and click Properties on theshortcut menu.

3 In the eObject Properties dialog box, click the Identity taband check the Account information to ensure that the identityis correct; and if necessary, change it.

Check the WebModelsSQL database

Check MTS forWebModels


4 In the console tree expand eObject and Components.5 Ensure that these components are there:

• AspenWebModelsASP.LibraryManager• AspenTech.AFW.POManagerIf necessary, add the components.

These items must have the correct WebModels identity:• LB_QM.lb_entry• LBAssist1.CUtil• WMAP.APTo check and, if necessary, change the identity on these items, rundcomcnfg. For instructions see “Configuring WebModels Servercomponents under DCOM” on page 27-17

These items must have the correct WebModels identity:• Apploader1.CleanupWorkFolder• WatchDog.IWatchDogNotifyTo check and, if necessary, change the identity on these items, rundcomcnfg. For instructions, see “Configuring remote calculationservers under DCOM” on page 27-18.

Check the DCOMsettings for theWebModels Servercomponents

Check the DCOMsettings for thecalculation servers

Installation Manual_Aspen Engineering Suite 11.1 Aspen Zyqad •••• 28-1

C H A P T E R 28

Aspen Zyqad

This chapter contains the following sections:• Aspen Zyqad Components• Before You Install Aspen Zyqad• Configuring the Installed Software• Verifying the Aspen Zyqad Installation• Troubleshooting Aspen Zyqad

Aspen Zyqad ComponentsAspen Zyqad includes the following components and associatedsubcomponents:

Component/Subcomponent Description

Aspen Zyqad ServerServer Core server component incorporating

data management, knowledge baserules.

Broker Client/server communications.

Sample Projects Sample workgroup and libraries used toconfirm the installation of all AspenZyqad components.

28-2 •••• Aspen Zyqad Installation Manual_Aspen Engineering Suite 11.1

Component/Subcomponent Description

Aspen Zyqad ClientWorkbench Client program that can connect to

server and display datasheets; the mainworking window within Aspen Zyqad.

Drawing Application Client program (Aspen Zyqad PFD)used for creating process flow diagrams.

Graphic Definer A symbol and label editor utility for thedrawing application.

Simulator Interface- Aspen Plus- Hysys- ProII

Client program that allows the retrievalof information generated from externalsimulation programs, such as AspenPlus (v11.1), Hysys (v2.2.2) andProVision (v5.11.1, 5.5) .

UOEquipment (Unit Operations) Client program thatallows the user to control informationtransfer between unit operation andequipment items within the AspenZyqad system.

Design Programs- Hetran- HTRI- TASC

Client program that provides a two-wayinterface between the Aspen Zyqadserver and heat exchanger designprograms, such as Aspen B-JACHetran (v11.1), HTRI IST (v2.0),HTIR XIST (v1.0), HTFS TASC (v4.1).

Cost Estimation An interface between Aspen Zyqad andthe Aspen Kbase costing tool.

Development Application Server tool that facilitates some of thecustomization available with AspenZyqad (e.g., developing workgroups).

Excel Datasheet Definer An add-in for Excel that formatsspreadsheets and allows them to be readby Aspen Zyqad.

Sample Projects LibrarySource Files

Source files for the Sample Projectsubcomponent of Aspen Zyqad Server,including data model, datasheets andknowledge bases.

Datasheet Viewer Installer Distributable installer for the ZyqadDatasheet Viewer.


Before You Install Aspen ZyqadBefore installing Aspen Zyqad, review this special checklist inaddition to the standard checklist:

Action Item ��

1 Decide which Product Components of Aspen Zyqadare required.• Client-Server Installations: Not all components are

required for each user. Decide where to install theAspen Zyqad NT Server and Aspen Zyqad Clientcomponents (recommended on at least one machine onthe network), and decide which other machines willhost the Aspen Zyqad Client applications.

• The Sample Projects subcomponent requires theinstallation of the Server subcomponent.

• If the Development Application component isrequired, a licensed copy of Harlequin LispWorksversion 4.1 and LispWorks patchkit 20 must beinstalled before you install Aspen Zyqad.

• The Sample Projects Library Source Files componentrequires the installation of the DevelopmentApplication component.

• Customizing requires the installation of theDevelopment Application and the Excel DatasheetDefiner components

• If the Excel Datasheet Definer component is required,a licensed copy of MS Excel 2000, must be installedbefore you install Aspen Zyqad.

2 Confirm that System Requirements are met.Ensure that the machine has adequate space for the applicationinstallation. See “AES System Requirements” on page 2-3.

3 Confirm the installation accounts privileges.Windows 2000: Must have the System Administrator privilege,“Act as part of the operating system.”

4 Confirm license.Aspen Zyqad must be installed in accordance with your licenseagreement. This version of Aspen Zyqad supports ALM 3.0.

� Use this column to check off each action item.


Installation NotesWhen you install Aspen Zyqad:• Select subcomponents according to your needs.• Provide the appropriate broker and server information when

prompted.• Provide the appropriate third party software information when

prompted.

During a standard installation, the Aspen Zyqad StandardInstallation dialog box appears and prompts you for theBroker connection:• Host, which is the name of the computer containing the

Aspen Zyqad server software that the clients will access.• Port, which is the identity of the port on which the Host is

listening.For example:

Then click Next.

Specifying the ZyqadBroker connection


If you are installing Aspen Zyqad on a Windows NT machine,the Aspen Zyqad Installation dialog box appears, displayingthe Aspen Zyqad Broker settings. For example:

Review the Aspen Zyqad broker information and click Next.

If you are installing Aspen Zyqad on a Windows NT machine,the Aspen Zyqad Installation dialog box displays the AspenZyqad Server settings. For example:

Review the Aspen Zyqad broker information and click Next.

Zyqad Brokerconfirmation(Windows NT)

Zyqad Serverconfirmation(Windows NT)


If you select the Sample Projects subcomponent of the AspenZyqad Server, the Aspen Zyqad Installation dialog boxprompts you for the list of users that are allowed access to theSample Projects.Enter the list of usernames, using a space to separate thenames. For example:

When finished, click Next.

Note: If you are working in a domain environment you must editthe net.cfg file. For more information, see “Editing the net.cfg file”on page 28-8.

Specifying SampleProjects users


If you select the ProII Simulator Interface subcomponent, TheAspen Zyqad Installation dialog box prompts you for thelocation of its configuration and schema definition files.Specify the location of the ProVision files, for example:

When finished, click Next.

If you select the Development Application subcomponent, theAspen Zyqad Installation dialog box prompts you for thelocation of the installed Harlequin LispWorks executable.

Note: Harlequin LispWorks must be installed before you install theDevelopment Application component.

Specifying the location ofProVision files

Specifying the location ofLispWorks executable


Specify the location of the LispWorks executable file or acceptthe default location. For example:

When finished, click Next.At this time, the installation proceeds normally.

Configuring the Installed SoftwareThe Aspen Zyqad server configuration is controlled by thenet.cfg file. The Zyqad broker and Zyqad server use this file toestablish such things as domain access for users, time that aworkgroup can remain without any users connected, and for otherfunctions such as switching password protection on or off.

For more information, see “Editing the net.cfg file” on page 28-8.

The net.cfg file defines the configuration information requiredby both the Aspen Zyqad broker and Aspen Zyqad server. Thename of this file is specified as a command line option to thebroker and the server.

Configuring AspenZyqad for users

Editing the net.cfg file


The following table describes some of the settings you may need tomodify.Configuration Variable Description

ROOTDIR The root directory under which thesoftware has been installed. Other pathsare taken relative to this directory,unless specified as absolute pathnames.

Default = C:\Program Files\AspenTech\Aspen Zyqad11.1\server

DEBUG_LEVEL The level of debugging that is recordedin the log files. The default value isspecified on the command line (-d) or 0if no value has been specified (range 0 -10). This parameter is shared by thebroker and the server.

Default = 3.

WORKGROUPS_FILE The name of the workgroups file. Bydefault the broker will look for this fileas ROOTDIR\workgroups.

Default = workgroups.cfg

BROKER_LOGFILE The location of the broker logfile. Theamount of information recorded in thelog file for the broker depends on thedebug level at which it is running.

Default = logs\brokerACTIVE_FILE The location of the active file, which

contains information about theworkgroups currently running and theusers that are connected to them.

Default = logs\active

BROKER_ALARM The broker alarm is used to indicate howoften to update the active file and howoften to check if the net.cfg orworkgroups.cfg file has been updated.The time is specified in seconds (range 5- 120)

Default = 60 (seconds)


Configuration Variable Description

LISTEN_QUEUE The number of new connections that canbe handled simultaneously.

Default = 5

BROKER_SOCKET_TIMEOUT

The time allowed (in seconds) forcomplete messages to be received. If themessage is not received in less than thespecified time, the broker willdisconnect the socket.

Default = 10 (seconds)BROKER_CLIENT_LOOKUP

Determines whether the broker tries todo a reverse DNS lookup to interpret theclient's IP address as a meaningfulname. This can slow down the brokerwhen set to True.

Default = FalseCHECK_PASSWORDS Determines whether users are forced to

enter a valid user password to get intothe system.

Default = OnDOMAIN On NT networks, password

authentication can be provided by adomain controller. This specifies thename of the domain here.

If this is not specified (the default), thebroker will check for interactive loginson the machine where it is running.

Default = (none)



BROKER_PORTSTART_PORTSERVER_PORT

Service names or numbers; the brokerlistens on• BROKER_PORT is the port on

which the broker listens• START_PORT is the port used to

run a server• SERVER_PORT lists the port(s) on

which the server can listen

Only the last can be changed while thebroker & server are running.

Defaults:BROKER_PORT=1900START_PORT=1901SERVER_PORT=1902

SERVER_LOGFILE The location of the server logfile.

Default = logs\serverSERVER_ALARM The server alarm is used to check on the

status of all connected users and totimeout any idle workgroups. The serversends a 'ping' message to each clientevery time an alarm is signaled andchecks if an idle workgroup hasexceeded its timeout period. The time isspecified in seconds (5 - 120).

Default = 60 (seconds)SERVER_SOCKET_TIMEOUT

The time allowed (in seconds) forcomplete messages to be received. If themessage is not received in less than thespecified time, the server will disconnectthe socket.

Default = 10 (seconds)SERVER_CLIENT_LOOKUP

Determines whether the server tries todo a reverse DNS lookup to interpret theclient's IP address as a meaningfulname. This can slow down the serverwhen set to True.

Default = False



IDLE_TIMEOUT The time that a workgroup can remainidle (no users connected) before it isshutdown by the server. The exact timeat which the workgroup is closed will besometime between idle_timeout andidle_timeout + server_alarm. The time isspecified in seconds (range 0 - 7200).

Default = 60 (seconds)

Production server recommendation:Increase the IDLE_TIMEOUT to belonger than the save time for the largestworkgroup to prevent possible data lossif a network problem disconnects allclients while a workgroup is beingsaved.

LISP The pathname of the schematex.exeprogram that starts a workgroup.

Default = C:\Program Files\AspenTech\Aspen Zyqad\11.1\server\bin\schematex.exe

Very occasionally, the server will beunable to run the schematex.exe. Inthis occurs, the file name should bespecify the filename, using the shortenedDOS form to remove spaces in the path.For example, the default would be:

C:\Progra~1\AspenT~1\AspenZ~1.1\server\bin\schema~1.exe

The Aspen Zyqad broker uses the workgroups.cfg file, whichdefines the workgroups (or projects).

For instructions on configuring the workgroups.cfg file, see theAspen Zyqad Workgroup Components Reference Manual.

The symbol library folder contains the available symbols andlabels for the workgroup. To ensure that these symbols and labelsare accessible to all the workgroup clients, you must define thefolder as a network share.

You define the location of the symbol library folder using theSYMBOLPATH value in the workgroup configuration file.

Configuring theWorkgroups.cfg file

Defining the SymbolLibrary Folder as aNetwork Share


The syntax is:[client]…SYMBOLPATH =<Path>…

For more information on the workgroup configuration file, seeSetting Up and Managing Workgroups in either the online help orBook 8 in the Administrator Reference Manual (pdf).

The symbol library path must refer to the same directory for allclient machines using the workgroup, so you need to use aUniversal Naming Convention (UNC) path to identify the directoryif the workgroup is to be accessed from more than one clientmachine.The UNC path describes the path to a directory that is the same for all clients onthe network., using this format:

\\<machine>\<share name>\<directory path>

Configuring Aspen Zyqad in a CITRIXEnvironmentIn a CITRIX environment, the CITRIX server takes the role of astandard client machine in a typical Aspen Zyqad setup and runsthe same client applications. The server side of a typical AspenZyqad setup would still run on separate server machines.The following table lists the host machine for the various AspenZyqad applications when running in a CITRIX environment:

Aspen Zyqad Application Host

Zyqad broker One of the workgroup serversZyqad server Each workgroup serverZyqad Workbench client CITRIX serverAspen Zyqad PFD client CITRIX serverDatasheet Viewer CITRIX serverSimulator Interface CITRIX serverObject Mapper CITRIX serverEquipment Design ProgramInterface

CITRIX server

Costing Interface CITRIX serverDevelopment Application Each workgroup serverExcel Datasheet Definer CITRIX serverGraphic Definer CITRIX server


Verifying the Aspen ZyqadInstallationThere are many configuration options during installation and it isstrongly recommended that you verify any installation immediatelyon completion.

The following details assume a Standard Install and that:• The local machine is on a network.• The client is configured to connect to the broker.• The user is configured to access one or more workgroups

administered by the broker.

Note: This can be simplified by installing an example project andusing the username(s) specified during the install.

• The computer has been restarted since the most recentinstallation or removal of AspenTech software.

• You have logged-on at least once since the installation as auser with administrator privileges.

To verify the Aspen Zyqad installation:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Zyqad 11.1 | Aspen Zyqad.The Aspen Zyqad main window appears.


2 From the Aspen Zyqad menu bar, click: File ¦ OpenWorkgroup:A dialog box appears, displaying the broker server name in thetitle bar and depending on the type of installation, the usernameand password text boxes.

3 Type a valid username and password, then click OK.

Note: This must be a valid username and password recognized bythe broker. A sample workgroup (az111) is provided to check this.

4 In the Open Workgroup dialog box, select the sampleworkgroup, az111, from the list and click OK.A dialog box appears, displaying the application versionnumber and a message that the workgroup is about to open.

5 Click OK to start the workgroup.

6 From the Aspen Zyqad menu bar, click File ¦ Diagram.The Diagrams dialog box appears.

7 Click New and select New Diagram from the list. Then clickOpen.The Aspen Zyqad Question dialog box appears:

8 Enter a name for the new diagram and click OK.

Opening a workgroup

Selecting a SampleWorkgroup

Selecting a Diagram


The Aspen Zyqad PFD document window appears.

9 On the menu bar click File ¦ New Document

10 Click one of the symbols folders in the Symbol Library tree todisplay its contents and select a symbol.

11 Drag the symbol and drop it onto the diagram in theDocument1 window.If you have completed these instructions, the installation issuccessful.

11 On the menu bar click File ¦ Exit and click Yes to close theworkgroup.


Troubleshooting Aspen ZyqadThere are few common problems or error messages associated withAspen Zyqad at this time. If additional information becomesavailable at a later date, you can access it from AspenTechSupport.

Problem The Zyqad installation hangs.

Solution To resolve the problem:1 Open the Task Manager and end the Zyqad

application task.This causes an install error

2 On the dialog box that appears, click Yes tocontinue the installation.

3 Restart the computer when the install completes.4 Open a Command Prompt (DOS) window and

change to the directory containing zyqadtools.dll.The default location is: C:\ProgramFiles\AspenTech\Aspen Zyqad11.1\shared

5 At the DOS prompt type:regsvr33 zyqadtools.dll

6 Run the AES installer program again, selectingthe same components as the first time (even ifthere is an installed icon next to them).

Problem Users within a domain cannot access Zyqad over theserver.

Cause The broker and server are not properly configured.Solution To configure the server, edit the net.cfg file.

For more information, see “Editing the net.cfg file”on page 28-8.


Problem Users cannot access some Aspen Zyqad features,such as the PFD.

Solution Check the permissions registry keys. To do this:1 Log on to the machine as a user with

administrator privileges.2 On the desktop click Start | Run.3 In the Run dialog box enter Regedt324 Select the HKEY_LOCAL_MACHINE window

and go to:

SOFTWARE | Intergraph | Application |AspenZyqadPFD.Applications

5 On the Security menu, click Permissions.6 If the users are not on the list, click the ADD

button then select the domain you would like togive user privileges.Select Everyone and give them at least Readprivileges.Then click OK

7 Restart the machine.

Problem When trying to use Excel Datasheet Definer, thefollowing Error Message appears:

Unable to locate the Aspen Zyqad datasheetdefiner in the registry. Please check if it isinstalled.

Cause The earlier version of Aspen Zyqad is still selectedeven though a newer version has been installed.

Solution To select the correct version,1 Open the MS Excel application and on the menu

bar click Tools | Add-In.2 Select the correct version of Zyqad and click

OK.


Problem Error Message when trying to use Excel after a fullAspen Zyqad uninstall has taken place.

Cause MS Excel is still looking for Aspen Zyqad.Solution 1 Open the MS Excel application and on the menu

bar click Tools | Add-In.2 Clear the Aspen Zyqad option and click OK.Note: You may have to do this for each machine inthe workgroup after an uninstall.

Problem Reboot messages appear when you try to uninstall.

Solution After installing Aspen Zyqad, the machine must berestarted.When logging on, ensure you use a profile that hasadministrator privileges for the first log in after arestart. Once the initial log in as an administrator hasoccurred, other users will be able to log in with theirusual profile.

Installation Manual_Aspen Engineering Suite 11.1 Batch Plus •••• 29-1

C H A P T E R 29

Batch Plus

This chapter contains the following sections:• Standard Installation Notes• Server Installation Notes• Connecting to a Server after Installation• Troubleshooting Batch Plus

Standard Installation NotesThe Batch Plus standard installation includes all componentsrequired to run Batch Plus in stand-alone mode and all componentsrequired to communicate with a Batch Plus server.

After you select Batch Plus and any other AES products forinstallation, the Batch Plus Server Wizard appears, enabling youto establish a connection to a Batch Plus server in a client-serverinstallation configuration.

You can specify the server connection information at this time orafter you complete the installation. For instructions on connectingto a server after installation, see “Connecting to a Server afterInstallation,” on page 29-5.

Specifying the BatchPlus server

29-2 •••• Batch Plus Installation Manual_Aspen Engineering Suite 11.1

To specify the Batch Plus server during the Standard installation:1 When the Welcome to Batch Plus Server Wizard dialog box

appears, click Select server. Then click Next.

2 On the Server Selection dialog box, enter the Server Nameand select the Server Type. Then click Next.


3 On the Details dialog box, enter your User Name andPassword. Then click Next.

4 On the Finish dialog box, review the Summary informationand click Finish.

The installation proceeds normally.

Server Installation NotesThe Batch Plus server installation creates the necessary databasetables and records. The server installation can run remotely.

After you select Batch Plus and any other AES products forinstallation, the Server Selection dialog box appears, enabling youto create the database tables and records.

To create the database tables and records for Batch Plus:1 When the Server Selection dialog box appears, enter the

Server Name and select the Server Type.

Creating the BatchPlus Server databasetables and records


For example:

Click Next to continue.2 On the Details dialog box enter the User Name and Password.

The user account must have these roles:Server Type Required Roles

Microsoft SQL Server Server Administrator andDatabase Creator

Oracle DBAIf the Server Type is Oracle, enter an initial database size of atleast 150 MB.


Click Next to continue.The Finish dialog box appears, displaying a summary status ofthe database creation process.

3 Click Finish.The installation proceeds normally.

Connecting to a Server afterInstallationYou can connect to the Batch Plus server anytime after theinstallation is complete, using the BPSync.exe tool. The defaultlocation is:

C:\Program Files\AspenTech\Aspen Engineering Suite\BatchPlus 11.1\bin

To set up the Microsoft SQL Server:1 Run BPSync.exe, which is located in the Batch Plus 11.1\bin

directory.The BPSync window appears.

2 In the menu bar click File | Server orin the toolbar click the Server button.The Data Link Properties dialog box appears.

3 On the Provider tab select Microsoft OLE DB Provider forSQL Server. Then click Next.

4 On the Connection tab, enter the following information:• The SQL server name• The log on information, which can be Windows NT

integrated security or a specific user name/passwordprovided by your system administrator.

• The name of the database

Connecting to the MSSQL Server


For example:

5 Click OK.The BPSync Logon dialog box appears.

6 If there are no users in the database, click Cancel and continuewith the next step.Otherwise, enter your user name, password, and domain andclick OK to start using the database.

7 If there are no users in the database, on the BPSync menu bar,click Admin | Roles and enter users to the Administratorsrole.

The database is set up, and you can add roles and users, and startusing the database.


Connecting to the Oracle ServerTo set up the Oracle Server:1 Run BPSync.exe, which is located in the Batch Plus 11.1\bin

directory.The BPSync window appears.

2 On the menu bar click File | Server orin the toolbar click the Server button.The Data Link Properties dialog box appears.

3 On the Provider tab select Oracle Provider for OLE DB.Then click Next.

4 On the Connection tab, enter the following information:• The data source and/or data location• A specific log on User name and Password and click the

Allow saving password checkbox.• The name of the database


For example:

5 Click OK.The BPSync Logon dialog box appears.

6 If there are no users in the database, click Cancel and continuewith the next step.Otherwise, enter your user name, password, and domain andclick OK to start using the database.

7 If there are no users in the database, on the BPSync menu bar,click Admin | Roles and enter users to the Administratorsrole.

The database is set up, and you can add roles and users, and startusing the database.


Troubleshooting Batch PlusBatch Plus has the following special troubleshooting procedures.

Problem You cannot generate Excel reports.

Cause This may occur when certain system files shared byBatch Plus and Excel are not properly registered.

Solution You can avoid this problem by following theinstallation instructions for Excel before installingBatch Plus. Unfortunately, if you already have thisproblem, you must start over:1 Uninstall Batch Plus by following the instructions

in Chapter 8, Removing AES Products.2 Uninstall Microsoft Office.3 From Windows Explorer or File Manager,

manually delete the files in C:\ProgramFiles\Common Files\Microsoft Shared\Dao.These are the system files that are not properlyregistered.

4 Reinstall Microsoft Office, ensuring that the DataAccess option for Excel is selected.

5 Reinstall Batch Plus by following the instructionsin Chapter 7, Adding or Reinstalling Components.

Problem You cannot generate Visio diagrams.

Cause This may occur if the PC has not rebooted after BatchPlus or Visio installation, or if Visio cannot locate theAdd-ons path when it is launched.

Solution You can avoid the first problem by rebooting your PCafter installation.

If Visio cannot locate the ADD-ons path when it islaunched, highlight the checkbox in the Launch Visiodialog that appears when you launch the equipmentdiagram from Batch Plus.

This resets the Visio ADD-ons path and restarts Visio,which should then generate the diagram correctly.

Installation Manual_Aspen Engineering Suite 11.1 Polymers Plus •••• 30-1

C H A P T E R 30

Polymers Plus

This chapter contains the following sections:• Installation Notes• Verifying the Polymers Plus Installation• Troubleshooting Polymers Plus

Installation NotesThe standard, lite client, and client-server installations ofPolymers Plus require the corresponding installation of Aspen Pluson the same machine. Aspen Plus 11.1 must be installed prior to orsimultaneously with Polymers Plus 11.1.

Verifying the Polymers PlusInstallationTo verify an installation of Polymers Plus on a user PC:1 If you have not already done so, restart Windows to activate

the changes made to your configuration during the installation.2 Click Start | Programs | AspenTech | Aspen Engineering

Suite | Aspen Plus 11.1 | Aspen Plus User Interface.The Aspen Plus User Interface window opens.

3 In the Aspen Plus Startup dialog box, select Open anexisting simulation and click more files.

4 Navigate to the test file, polytut.bkp.The default directory location is:C:\Program Files\AspenTech\Aspen Plus 11.1\GUI\xmp\Polymers Plus

30-2 •••• Polymers Plus Installation Manual_Aspen Engineering Suite 11.1

5 On the menu bar click View | Control Panel.The Control Panel window appears.

6 On the Control Panel toolbar, click to run the simulation.During the run, the Control Panel displays simulationdiagnostic messages. The run should finish with no errors orwarnings.The following message indicates a successful verification:

->Simulation calculations completed ...

7 On the Control Panel toolbar, click .The Data Browser window opens to display the ResultsSummary Run Status Summary sheet.The Summary should indicate the calculations completednormally.You are now finished with the verification of the PolymersPlus installation.

8 On the menu bar click File | Exit and click No on the AspenPlus dialog box.

Troubleshooting Polymers PlusProblem You try to perform a Polymers Plus simulation run and

the following message appears:Sorry fatal licensing error. Reason - Feature 15(polymers). Server _name of server_ can't openkeyfile. (Location of the license key is displayed.)

Cause Polymers Plus licensing has not been properlyinstalled.

Solution Install the license key again, using the LicenseManager Key installer.

Installation Manual_Aspen Engineering Suite 11.1 Appendix A – HASP Key Licensing •••• 31-1

Appendix A – HASP Key Licensing

A HASP key is a small hardware device with parallel portconnectors. Aspen B-JAC supports HASP key licensing.

If you install Aspen B-JAC, you are asked if you want to useHASP key licensing or License Manager licensing.

If you select HASP key licensing, you must also specify whetheryou are using a single-user HASP key or a network NetHASP key.

Using a single HASP keyThe installation program installs a single-user HASP driver.

If this driver needs to be manually installed, execute:HINSTALL.EXE –i.

This file is located in the /XEQ folder of the Aspen B-JAC productfolder.

Using NetHASP keysThe installation program prompts you for the type of networkprotocol you are using:• NetBIOS/NetBEUI• IPX (Novell networks)• TCP/IPTo activate the NetHASP drivers, execute the following commandsafter you complete the installation of Aspen B-JAC.

Execute this command:NHSRVWNT.EXE -NETBIOS

Load the HASP Novell driver as follows:1 Copy the HASPSERV.NLM file to the SYS:SYSTEM folder

on your server.

NetBIOS

IPX

31-2 •••• Appendix A – HASP Key Licensing Installation Manual_Aspen Engineering Suite 11.1

2 From your server load the NetHASP driver, using thiscommand:Load HASPSERV –SAPTOFILE

3 Copy the HASPADR.DAT and NEWHADDR.DAT files fromSYS:SYSTEM to the installed Aspen B-JAC folder, XEQ.

The program prompts you for the server IP address. To load theNetHASP network driver, execute this command:

NHSRVWNT.EXE -TCPIP

TCP/IP

Installation Manual_Aspen Engineering Suite 11.1 Appendix B – Using the DETHERM Database •••• 32-1

Appendix B – Using the DETHERMDatabase

Aspen Plus and Aspen Properties users who have DETHERMlicenses can access thermophysical property data included in theDETHERM database. This database is maintained by DECHEMAe. V., Frankfurt, Germany. For more information, see this website:

http://www.dechema.de

If you installed Aspen Plus or Aspen Properties and are licensed touse DETHERM, you must configure your PC to enable access tothe DETHERM database.

To configure Aspen Plus or Aspen Properties to use DETHERM:1 On the desktop click Start | Programs | AspenTech | Aspen

Engineering Suite | Aspen Plus or Aspen Properties 11.1 |Detherm Setup Utility.The DETHERM Server Application Setup dialog box appears:

2 Select Yes, I will be using a local DETHERM Server.3 Enter the location of the DETHERM server as follows:

Installation

http://www.dechema.de/

32-2 •••• Appendix B – Using the DETHERM Database Installation Manual_Aspen Engineering Suite 11.1

Configuration Location

Standard The local machineLite Client The File Server machineClient-Server The remote Server machine

4 Click OK.You may return to this utility later to change the DETHERMconfiguration.

Installation Manual_Aspen Engineering Suite 11.1 Index •••• 33-1

Index

A

Aspen ADSIMinstallation configuration options, 2-15product requirements, 2-4server installation verification, 5-16specifying a remote server, 5-20troubleshooting (client-server), 9-3upgrade preparation, 6-3verifying client-server communication,

5-24verifying the installation, 10-1verifying the installation with Aspen

Properties, 10-2Aspen B-JAC

changing licensing after installation, 11-2HASP key license configuration, 31-1installation configuration options, 2-15product requirements, 2-4related documentation, 1-1upgrade preparation, 6-3verifying the installation, 11-1

Aspen Chromatographyinstallation configuration options, 2-15product requirements, 2-4related documentation, 1-1server installation verification, 5-16specifying a remote server, 5-20troubleshooting (client-server), 9-3upgrade preparation, 6-3

verifying client-server communication,5-24

verifying the installation, 12-1Aspen Custom Modeler

installation configuration options, 2-15product requirements, 2-4related documentation, 1-2server installation verification, 5-16specifying a remote server, 5-20troubleshooting (client-server), 9-3upgrade preparation, 6-2verifying client-server communication,

5-24verifying the installation, 13-1verifying the installation with Aspen

Properties, 13-2Aspen Dynamics

installation configuration options, 2-15related documentation, 1-2server installation verification, 5-16specifying a remote server, 5-20troubleshooting (client-server), 9-3upgrade preparation, 6-2verifying client-server communication,

5-24verifying the installation, 14-1

Aspen Engineering Suiteadding components, 7-2client-server installation, 5-1installation configuration options, 2-14

33-2 •••• Index Installation Manual_Aspen Engineering Suite 11.1

installation overview, 2-1installation sequence, 2-2licensing, 2-13lite client installation, 4-1Plantelligence & Enterprise Optimization

solutions, 2-3pre-installation checklist, 2-10product requirements, 2-4reinstalling components, 7-2related documentation, 1-1standard installation, 3-1system requirements, 2-3technical support, 1-4training services, 1-3uninstalling products, 8-2upgrading products, 6-3

Aspen Framework (AFW) configurationAspen WebModels Author roles, 26-1Aspen WebModels roles, 27-5

Aspen Framework (AFW) Serverchanging, 3-15selecting, 3-10

Aspen Framework Switch Utility, 3-15Aspen Icarus

installation configuration options, 2-15product installation directory guidelines,

15-1product requirements, 2-5

Aspen Icarus Project Manager (IPM)requirements for installation, 15-1

Aspen License Managerrelated documentation, 1-1

Aspen OLIinstallation configuration options, 2-15product requirements, 2-5related documentation, 1-2updating older databanks, 6-5upgrade preparation, 6-2verifying the installation, 16-1

Aspen OnLineclient configuration, 17-5components, 17-1enabling CIM-IO Server security, 17-2installation configuration options, 2-15post-install configuration, 17-3

product requirements, 2-5related documentation, 1-2server configuration, 17-3upgrade preparation, 6-3verifying the installation, 17-6

Aspen PEP Process Libraryinstallation configuration options, 2-15product requirements, 2-6related documentation, 1-2troubleshooting, 18-2verifying the installation, 18-1

Aspen Pinchinstallation configuration options, 2-15product requirements, 2-6related documentation, 1-2standard installation subcomponents, 3-6upgrade preparation, 6-3verifying the installation, 19-1

Aspen PlusDETHERM configuration, 32-1installation configuration options, 2-15installing Aspen Plus Optimizer, 20-1product requirements, 2-6related documentation, 1-2re-registering CAPE-OPEN components,

8-3server installation subcomponents, 5-9specifying a remote server, 5-19standard installation subcomponents, 3-6troubleshooting, 20-2upgrade preparation, 6-2verifying the installation, 20-1

Aspen Plus Onlinechanging startup service, 17-8product requirements, 2-6related documentation, 1-2RTESERV service configuration, 17-7standard installation subcomponents, 3-6

Aspen Plus Optimizer, 20-1Aspen Properties

DETHERM configuration, 32-1installation configuration options, 2-15product requirements, 2-6related documentation, 1-2


re-registering CAPE-OPEN components,8-3

server installation subcomponents, 5-9specifying a remote server, 5-18standard installation subcomponents, 3-6upgrade preparation, 6-2verifying the installation, 21-1

Aspen Splitinstallation configuration options, 2-15installation notes, 22-1product requirements, 2-7related documentation, 1-2standard installation subcomponents, 3-6verifying the installation of the Split

Distillation Analysis component, 22-2verifying the stand-alone configuration,

22-3Aspen Traflow

installation configuration options, 2-15product requirements, 2-7related documentation, 1-2verifying the installation, 23-1

Aspen Utilitiesinstallation configuration options, 2-15product requirements, 2-7setting up Excel interface, 24-1verifying the installation, 24-1

Aspen Waterinstallation configuration options, 2-15related documentation, 1-3server installation verification, 5-16specifying a remote server, 5-20troubleshooting (client-server), 9-3upgrade preparation, 6-3verifying client-server communication,

5-24verifying the installation, 25-1

Aspen WebModels Authoradding users to VSS, 27-4AFW role configuration, 26-1installation configuration options, 2-15Internet Explorer configuration, 26-1product requirements, 2-7related documentation, 1-3

troubleshooting, 26-4verifying the installation, 26-1

Aspen WebModels Serverconfiguring, 27-4, 27-7configuring AFW roles, 27-5configuring AFW security settings for ISS

(Windows 2000), 27-18configuring application servers, 27-8configuring Aspen applications, 27-12configuring DCOM security settings,

27-17configuring DCOM WebModels Server

components, 27-17configuring e-mail addresses, 27-15configuring ISS settings, 27-18configuring the Microsoft Transaction

Server (MTS), 27-16configuring VSS, 27-4configuring WebModels roles, 27-10creating WebModels database, 27-2installation configuration options, 2-15load balancer operations, 27-19maintenance, 27-19prioritizing server resources, 27-14product requirements, 2-8troubleshooting, 27-20updating administrator e-mail ID, 27-15upgrade preparation, 6-3user account, 27-2verifying the installation, 27-19

Aspen WebPropertiesconfiguring IIS, 21-3deploying, 21-3enabling out-of-process components, 21-5setting up userfolders, 21-6

Aspen ZyqadBroker confirmation (Windows NT), 28-5CITRIX configuration, 28-13components and subcomponents, 28-1configuring Workgroups.cfg, 28-12defining Symbol Libray as network share,

28-12editing net.cfg file, 28-8installation configuration options, 2-15pre-installation checklist, 28-3product requirements, 2-8


related documentation, 1-3server configuration, 28-8server installation subcomponents, 5-9server installation verification, 5-17specifying Broker connection, 28-4specifying LispWorks location, 28-7specifying ProVision files location, 28-7specifying Sample Projects users, 28-6standard installation subcomponents, 3-7troubleshooting, 28-17verifying the installation, 28-14

AspenTech root directoryspecifying location(lite-client), 4-7specifying location(server), 5-7specifying location(standard), 3-4

AspenTech uninstallerstarting, 8-2

B

Batch PlusBPSync.exe tool, 29-5connecting to a server, 29-5connecting to the Oracle server, 29-7creating database (server install), 29-3installation configuration options, 2-15MS SQL server connection setup, 29-5product requirements, 2-9related documentation, 1-3specifying Batch Plus server (standard

install), 29-1troubleshooting, 29-9upgrade preparation, 6-3upgrading project files, 6-4

BPSync.exe, 29-5MS SQL server connection setup, 29-5Oracle server connection setup, 29-7

C

CAPE-OPENre-registering components, 8-3

CIM-IO Server securityenabling for Aspen OnLine, 17-2

CITRIXAspen Zyqad configuration, 28-13

client-server installation, 5-4Aspen Zyqad server installation

verification, 5-17client configuration of AES products,

5-17client installation, 5-17combining server/lite client install

options, 5-25configuring server product components,

5-10configuring windows server as AES host,

5-11overview, 5-1pre-installation checklist, 5-3server configuration of AES products,

5-16server installation, 5-5server installation verification, 5-16verifying client-server communication,

5-23configuring Aspen WebModels Server, 27-4

D

DETHERMconfiguring, 32-1

F

filesnet.cfg, 28-8Userfolder.inc (Aspen WebProperties),

21-6Userfolder.js (Aspen WebProperties),

21-6Workgroups.cfg (Aspen Zyqad), 28-12

H

hardware requirementsserver, 2-3

HASP key licenseusing, 31-1


I

installation account privilegestroubleshooting, 9-1

installation accountschecking privileges, 2-12

installation configuration options, 2-14AES products, 2-15

installation verificationAspen ADSIM, 10-1Aspen ADSIM with Aspen Properties,

10-2Aspen B-JAC, 11-1Aspen Chromatography, 12-1Aspen Custom Modeler, 13-1Aspen Custom Modeler with Aspen

Properties, 13-2Aspen Dynamics, 14-1Aspen OLI, 16-1Aspen OnLine, 17-6Aspen PEP Process Library, 18-1Aspen Pinch, 19-1Aspen Plus, 20-1Aspen Properties, 21-1Aspen Split, 22-1Aspen Traflow, 23-1Aspen Utilities, 24-1Aspen Water, 25-1Aspen WebModels Author, 26-1Aspen WebModels Server, 27-19Aspen Zyqad, 28-14Polymers Plus, 30-1

Internet Explorer configurationAspen WebModels Author, 26-1

Internet Information Server (IIS)configuring for Aspen WebProperties,

21-3

L

licensing, 2-13changing, 3-13HASP key, 31-1

lite client installation, 4-3AspenTech root directory location, 4-7file server installation, 4-4

overview, 4-1pre-installation checklist, 4-3specifying file server location, 4-10Aspen ADSIM, 4-10Aspen B-JAC, 4-10Aspen Chromatography, 4-10Aspen Custom Modeler, 4-10Aspen Dynamics, 4-10Aspen Plus, 4-10Aspen Properties, 4-10Aspen Traflow, 4-10Aspen Water, 4-10Aspen Zyqad, 4-10

user PC installation, 4-4verifying, 4-11Working Folders directory location, 4-8

M

map network drive (lite client install), 4-4Microsoft Excel

setting up for Aspen Utilities, 24-1using after removing Aspen Zyqad, 8-3

Microsoft Transaction Server (MTS)configuring for Aspen WebModels, 27-16

MS SQL serverBatch Plus connection setup, 29-5

N

net.cfg (Aspen Zyqad)editing, 28-8

network optimization (Windows NT), 5-15

O

Oracle serverBatch Plus connection setup, 29-7

out-of-process componentsenabling for Aspen WebProperties, 21-5

P

Plantelligence & Enterprise Optimizationsolutions, 2-3

using, 3-9


Polymers Plusinstallation configuration options, 2-15product requirements, 2-9related documentation, 1-3server installation subcomponents, 5-9standard installation subcomponents, 3-7troubleshooting, 30-2verifying the installation, 30-1

pre-installation checklist, 2-10product subcomponents

server installation, 5-9standard installation, 3-6

R

RTESERV serviceconfiguring for Aspen Plus Online, 17-7

S

server installationAspenTech root directory location, 5-7creating Batch Plus database, 29-3Working Folders directory location, 5-8

service packchecking the version, 2-11

software requirements, 2-4standard installation, 3-2

AspenTech root directory location, 3-4configuring installed products, 3-13configuring product components, 3-8overview, 3-1pre-installation checklist, 3-2product subcomponents, 3-6specifying Batch Plus server, 29-1Working Folders directory location, 3-5

system requirements, 2-3

T

technical supportonline support center, 1-4phone, e-mail, 1-5

training services, 1-3

troubleshootingAspen PEP Process Library, 18-2Aspen Plus, 20-2Aspen WebModels Author, 26-4Aspen WebModels Server, 27-20Aspen Zyqad, 28-17Batch Plus, 29-9checking installation account privileges,

9-1error messages (client-server ), 9-3general tips, 9-1Polymers Plus, 30-2

U

UNC paths, 28-13uninstaller

starting, 8-2upgrading AES products, 6-3Userfolder.inc (Aspen WebProperties), 21-6Userfolder.js (Aspen WebProperties), 21-6

V

virtual memorychanging, 2-11

VSS configurationadding WebModels Author users, 27-4Aspen WebModels Server, 27-4

W

WebModels Administratorusing, 27-8

WebModels databasecreating, 27-2

Windows 2000account privileges, 2-12adding server accounts, 5-14service pack version, 2-11virtual memory, 2-11

Windows NTaccount privileges, 2-12adding server accounts, 5-11


network optimization, 5-15service pack version, 2-11virtual memory, 2-11

windows serveradding Windows 2000 server accounts,

5-14adding Windows NT server accounts,

5-11configuring as AES host, 5-11

Working Foldersspecifying location(lite-client), 4-8specifying location(server), 5-8specifying location(standard), 3-5

AES%20111%20Installation%20Manual

Documents

Transcript of AES%20111%20Installation%20Manual